> Documentation index: https://www.xekta.com/llms.txt

# cart_create

> Open an empty cart at one shop.

Use it when the buyer picks items one by one instead of giving a list.

| | |
| - | - |
| Type | Write: changes a cart or an order |
| Needs a cart the buyer approved | No |
| Moves money | No |

**Tool description (what the assistant sees)**

```text
Opens a cart for one buyer and one shop. Idempotent: returns the existing open cart when one is already open for this pair. Nothing is reserved or charged.
```

## Parameters

| Name | Type | Required | Description |
| - | - | - | - |
| `merchant_id` | `uuid` | Yes | The shop, from a search result. |
| `near` | `object` | No | Where the buyer is right now, in the same form as `product_search`'s `near`. The approval box shows the shop's distance from it. Left out: distance is measured from the buyer's saved home address. |

## What to call next

[`cart_add`](https://www.xekta.com/docs/tools/cart-add.md), one call per item.
