Для AI-агентов: markdown этой страницы — /docs/mcp-orders.mdиндекс документации — /llms.txt
MCP: orders
Обновлено
Определения инструментов. Обновляйте tools/list после изменения прав. required_scopes: ALL.
create_order
Accept the six-field signed quote returned by quote_order. Pass a new idempotency_key to dedupe retries; PRICE_CHANGED returns a fresh quote.
Scopes (ALL): ["orders"]. Risk: "write".
execute_manual_sale
Create the order from the prepared manual sale. Call this tool only after final human confirmation of the prepared scenario.
Scopes (ALL): ["orders:write"]. Risk: "money".
execute_order_status_change
Execute the prepared order status change and buyer notification. Call this tool only after final human confirmation of the prepared scenario.
Scopes (ALL): ["orders:status"]. Risk: "write".
execute_send_invoice
Queue the prepared invoice through the existing payment planner. Call this tool only after final human confirmation of the prepared scenario.
Scopes (ALL): ["orders:write"]. Risk: "money".
get_customer
Read one customer by `seq_num`, the tenant-scoped identifier. Includes restriction, ban, and AI coach access state.
Scopes (ALL): ["orders"]. Risk: "read".
link_anonymous_order
Link a previously-anonymous order to a resolved user.
Scopes (ALL): ["orders"]. Risk: "write".
list_customers
List customers of the current tenant by their tenant-scoped sequence number. Returns conversation state and access state, including restriction, ban, and AI coach access. 0-cost read.
Scopes (ALL): ["orders"]. Risk: "read".
mark_paid
Record an explicit manual settlement. switch_to_manual must be true; idempotency_key is required.
Scopes (ALL): ["orders:write"]. Risk: "money".
prepare_manual_sale
Prepare a manual sale by user+catalog or frozen registration. Optionally declare amount, currency and provider together. Returns the frozen scenario for final human review; creates no order.
Scopes (ALL): ["orders:write"]. Risk: "write".
prepare_order_status_change
Prepare a tenant order status change and optional operator comment. The execution notifies the buyer through the configured status delivery slot.
Scopes (ALL): ["orders:status"]. Risk: "write".
prepare_send_invoice
Prepare invoice dispatch for a tenant-local order_seq_num. Sends nothing until execute_send_invoice is called.
Scopes (ALL): ["orders:write"]. Risk: "write".
quote_order
Evaluate direct items or an opaque Cart address into the signed quote required by create_order.
Scopes (ALL): ["orders"]. Risk: "read".
refresh_payment_urls
Regenerate payment provider URLs for an existing order.
Scopes (ALL): ["orders"]. Risk: "write".