Update order details
update_order_detailsUpdates selected order details—customer email, internal notes, PO number, delivery address, and custom fields—without changing omitted fields. Rejects country edits that alter frozen tax treatment.
Instructions
Update order metadata: customer email, internal notes, PO number, delivery address and custom order fields. Only provided fields change. A delivery address whose country would change the order's frozen tax treatment (taxTreatment in get_order, e.g. reverse_charge to standard) is refused (BAD_USER_INPUT, TAX_TREATMENT_CHANGED); cancel the order and place it again instead.
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": {
"orderId": "<orderId>"
},
"name": "update_order_details"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Internal note, never shown to the buyer | |
| orderId | Yes | ||
| poNumber | No | Buyer's purchase-order reference | |
| customFields | No | Order custom fields by key (keys from the cart config's orderFields). A value sets the field, null removes it; keys not named stay as they are. | |
| customerEmail | No | ||
| shippingAddress | No | Correct the delivery address; omitted leaves it unchanged |