Отменить заказ
cancel_orderCancel an order irreversibly by choosing refund and restock options. Submits a background job; verify result by fetching the order. Returns error if already fulfilled.
Instructions
НЕОБРАТИМО отменяет заказ. Два решения обязательны и не имеют значений по умолчанию: refund — вернуть ли деньги покупателю, restock — вернуть ли позиции на склад. notifyCustomer управляет письмом покупателю. Отмена выполняется фоновой задачей: в ответе job, а не обновлённый заказ — итог стоит проверить через get_order. Уже выданный (fulfilled) заказ Shopify отменить не даст — это придёт ошибкой userErrors. Расформировать отмену нельзя; частичные возвраты этот инструмент не делает.
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>",
"reason": "<reason>",
"refund": "<refund>",
"restock": "<restock>"
},
"name": "cancel_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | Причина отмены: CUSTOMER (просьба покупателя), DECLINED (платёж отклонён), FRAUD, INVENTORY (нет товара), STAFF (ошибка персонала), OTHER. | |
| refund | Yes | Вернуть ли платёж покупателю. Обязательное решение. | |
| orderId | Yes | Id заказа: число или gid://shopify/Order/<id>. | |
| restock | Yes | Вернуть ли позиции заказа на склад. Обязательное решение. | |
| staffNote | No | Внутренняя заметка к отмене (покупателю не видна). | |
| notifyCustomer | No | Отправить ли покупателю письмо об отмене. |