order_create
Create an unpaid draft order with quotes: uploads and checks the PDF, validates the address and returns a quote per shipping method. Nothing is bought; use order_purchase for that.
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": {
"file": "<file>",
"product": "<product>",
"qty": "<qty>",
"ship_to": "<ship_to>"
},
"name": "order_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| qty | Yes | Quantity; must be one the product offers. | |
| file | Yes | Print-ready PDF, as an https URL it can be downloaded from (at most 32 MB), or the id (fil_…) of a file sent before. | |
| fold | No | Filter by fold. | |
| note | No | Your note, kept on the order. | |
| size | No | Filter by size. | |
| sides | No | Filter by sides. | |
| stock | No | Filter by stock. | |
| finish | No | Filter by finish. | |
| option | No | Filter by any option, as key=value. Repeatable. | |
| pickup | No | Collect from a pickup point instead of door delivery: a pkp_… id from `pickup-points`, "nearest", or "door" to switch back. | |
| product | Yes | Product id or alias, e.g. flyer. | |
| ship_to | Yes | Delivery address: a JSON file, inline JSON, or - for stdin. As an object: US {name, line1, city, state, postal_code}; Hong Kong {name, line1, district, area, phone, email, country: "HK"}. | |
| max_total | No | Budget in the order's currency (USD, in the US and Hong Kong), e.g. 450; quotes above it are flagged. | |
| client_ref | No | Your reference; re-running create with the same one returns the same order. | |
| deliver_by | No | Deadline (YYYY-MM-DD); used to rank quotes, never a guarantee. | |
| orientation | No | Filter by orientation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | ||
| error | No | ||
| summary | No | ||
| warnings | No | ||
| next_actions | Yes |