Create manual order
create_manual_orderCreate a manual admin-entered order with product or ad-hoc line items, set currency and optional shipping address, and use an idempotency key to safely retry unclear calls.
Instructions
Create a manual (admin-entered) order. Each item references a product recordId or is an ad-hoc line with name+price (minor units of the order's currency). currency picks the order's currency (default currency when omitted); payments and refunds on the order are in that currency. shippingAddress is optional; for a customer of a company with a verified VAT id its country decides whether the order is reverse charge, and the order freezes that tax treatment (get_order taxTreatment). Pass an idempotencyKey and, if the call times out or fails unclearly, retry with the same idempotencyKey so the retry cannot create a second order.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"customerEmail": "<customerEmail>",
"items": "<items>"
},
"name": "create_manual_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| currency | No | The order's currency: omit for the default currency, or one of the workspace's additional currencies. Product lines are priced in it - a product with no price in it is refused (NO_PRICE_IN_CURRENCY) - and ad-hoc line prices are minor units of it | |
| customerId | No | ||
| customerEmail | Yes | Customer email for the order | |
| idempotencyKey | No | Your own unique value for this order (e.g. a UUID you generate), up to 128 characters. If the call times out or its result is unclear, retry with the same idempotencyKey: the repeat returns the order the first call created instead of creating a second one, and ignores the repeat's other input. Use a new value for a different order. Omit it and every call creates. | |
| shippingAddress | No | Delivery address. Its country decides reverse charge for a buyer whose company has a verified VAT id |