К содержанию
TelegaFirst

Для AI-агентов: markdown этой страницы — /docs/mcp-orders.mdиндекс документации — /llms.txt

MCP: orders

Обновлено

MCP: orders

Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.

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.

{
  "description": "Accept the six-field signed quote returned by quote_order. Pass a new idempotency_key to dedupe retries; PRICE_CHANGED returns a fresh quote.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "accepted_pricing_quote": {
        "additionalProperties": false,
        "description": "Value for accepted pricing quote.",
        "properties": {
          "amount": {
            "description": "Value for amount.",
            "minLength": 1,
            "type": "string"
          },
          "cart_version": {
            "anyOf": [
              {
                "description": "Value for cart version option.",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991,
                "type": "integer"
              },
              {
                "description": "Value for cart version option.",
                "type": "null"
              }
            ],
            "description": "Value for cart version."
          },
          "currency": {
            "description": "Value for currency.",
            "enum": [
              "RUB",
              "USD",
              "EUR",
              "XTR",
              "USDT",
              "TON",
              "BTC",
              "ETH",
              "LTC",
              "BNB",
              "TRX",
              "USDC"
            ],
            "type": "string"
          },
          "expires_at": {
            "description": "Value for expires at.",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "pricing_revision": {
            "description": "Value for pricing revision.",
            "minLength": 1,
            "type": "string"
          },
          "signature": {
            "description": "Value for signature.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "cart_version",
          "pricing_revision",
          "amount",
          "currency",
          "expires_at",
          "signature"
        ],
        "type": "object"
      },
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "buyer_email": {
        "description": "Value for buyer email.",
        "format": "email",
        "maxLength": 254,
        "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
        "type": "string"
      },
      "buyer_inn": {
        "description": "Value for buyer inn.",
        "pattern": "^\\d{10}(?:\\d{2})?$",
        "type": "string"
      },
      "buyer_phone": {
        "description": "Value for buyer phone.",
        "maxLength": 32,
        "minLength": 10,
        "type": "string"
      },
      "checkout_notes": {
        "description": "Value for checkout notes.",
        "maxLength": 2000,
        "type": "string"
      },
      "delivery_address": {
        "additionalProperties": false,
        "description": "Value for delivery address.",
        "properties": {
          "apartment": {
            "description": "Value for apartment.",
            "maxLength": 20,
            "type": "string"
          },
          "building": {
            "description": "Value for building.",
            "maxLength": 20,
            "type": "string"
          },
          "city": {
            "description": "Value for city.",
            "maxLength": 100,
            "minLength": 1,
            "type": "string"
          },
          "comment": {
            "description": "Value for comment.",
            "maxLength": 300,
            "type": "string"
          },
          "entrance": {
            "description": "Value for entrance.",
            "maxLength": 10,
            "type": "string"
          },
          "floor": {
            "description": "Value for floor.",
            "maxLength": 10,
            "type": "string"
          },
          "house": {
            "description": "Value for house.",
            "maxLength": 20,
            "minLength": 1,
            "type": "string"
          },
          "intercom": {
            "description": "Value for intercom.",
            "maxLength": 20,
            "type": "string"
          },
          "postal_code": {
            "description": "Value for postal code.",
            "maxLength": 20,
            "type": "string"
          },
          "street": {
            "description": "Value for street.",
            "maxLength": 150,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "city",
          "street",
          "house"
        ],
        "type": "object"
      },
      "external_order_ref": {
        "description": "Value for external order ref.",
        "maxLength": 255,
        "type": "string"
      },
      "idempotency_key": {
        "description": "Value for idempotency key.",
        "maxLength": 255,
        "minLength": 1,
        "type": "string"
      },
      "items": {
        "description": "Value for items.",
        "items": {
          "additionalProperties": false,
          "description": "Value for items item.",
          "properties": {
            "note": {
              "description": "Value for note.",
              "maxLength": 500,
              "type": "string"
            },
            "product_seq_id": {
              "description": "Value for product seq id.",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "type": "integer"
            },
            "quantity": {
              "description": "Value for quantity.",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "type": "integer"
            },
            "selected_options": {
              "additionalProperties": {
                "items": {
                  "description": "Value for selected options item.",
                  "pattern": "^[a-z0-9_]{1,16}$",
                  "type": "string"
                },
                "minItems": 1,
                "type": "array"
              },
              "description": "Value for selected options.",
              "propertyNames": {
                "pattern": "^[a-z0-9_]{1,16}$",
                "type": "string"
              },
              "type": "object"
            }
          },
          "required": [
            "product_seq_id",
            "quantity"
          ],
          "type": "object"
        },
        "minItems": 1,
        "type": "array"
      },
      "metadata": {
        "additionalProperties": {},
        "description": "Value for metadata.",
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "redirect_url": {
        "description": "Value for redirect url.",
        "format": "uri",
        "maxLength": 2048,
        "type": "string"
      },
      "user_seq_id": {
        "description": "Value for user seq id.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      },
      "zone": {
        "description": "Value for zone.",
        "enum": [
          "ru",
          "com"
        ],
        "type": "string"
      }
    },
    "required": [
      "items",
      "zone",
      "accepted_pricing_quote",
      "idempotency_key"
    ],
    "type": "object"
  },
  "name": "create_order",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders"
  ],
  "risk": "write",
  "scope": "orders",
  "title": "Create Order"
}

execute_manual_sale

Create the order from the prepared manual sale. Call this tool only after final human confirmation of the prepared scenario.

{
  "description": "Create the order from the prepared manual sale. Call this tool only after final human confirmation of the prepared scenario.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "payload_hash": {
        "description": "Value for payload hash.",
        "pattern": "^[a-f0-9]{64}$",
        "type": "string"
      },
      "preparation_id": {
        "description": "Value for preparation id.",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "type": "string"
      }
    },
    "required": [
      "preparation_id",
      "payload_hash"
    ],
    "type": "object"
  },
  "name": "execute_manual_sale",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders:write"
  ],
  "risk": "money",
  "scope": "orders:write",
  "title": "Execute Manual Sale"
}

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.

{
  "description": "Execute the prepared order status change and buyer notification. Call this tool only after final human confirmation of the prepared scenario.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "payload_hash": {
        "description": "Value for payload hash.",
        "pattern": "^[a-f0-9]{64}$",
        "type": "string"
      },
      "preparation_id": {
        "description": "Value for preparation id.",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "type": "string"
      }
    },
    "required": [
      "preparation_id",
      "payload_hash"
    ],
    "type": "object"
  },
  "name": "execute_order_status_change",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders:status"
  ],
  "risk": "write",
  "scope": "orders:status",
  "title": "Execute Order Status Change"
}

execute_send_invoice

Queue the prepared invoice through the existing payment planner. Call this tool only after final human confirmation of the prepared scenario.

{
  "description": "Queue the prepared invoice through the existing payment planner. Call this tool only after final human confirmation of the prepared scenario.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "payload_hash": {
        "description": "Value for payload hash.",
        "pattern": "^[a-f0-9]{64}$",
        "type": "string"
      },
      "preparation_id": {
        "description": "Value for preparation id.",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "type": "string"
      }
    },
    "required": [
      "preparation_id",
      "payload_hash"
    ],
    "type": "object"
  },
  "name": "execute_send_invoice",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders:write"
  ],
  "risk": "money",
  "scope": "orders:write",
  "title": "Execute Send Invoice"
}

get_customer

Read one customer by seq_num, the tenant-scoped identifier. Includes restriction, ban, and AI coach access state.

{
  "description": "Read one customer by `seq_num`, the tenant-scoped identifier. Includes restriction, ban, and AI coach access state.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "seq_num": {
        "description": "Value for seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      }
    },
    "required": [
      "seq_num"
    ],
    "type": "object"
  },
  "name": "get_customer",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders"
  ],
  "risk": "read",
  "scope": "orders",
  "title": "Get Customer"
}

Link a previously-anonymous order to a resolved user.

{
  "description": "Link a previously-anonymous order to a resolved user.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      },
      "user_seq_id": {
        "description": "Value for user seq id.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      }
    },
    "required": [
      "user_seq_id",
      "seq_num"
    ],
    "type": "object"
  },
  "name": "link_anonymous_order",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders"
  ],
  "risk": "write",
  "scope": "orders",
  "title": "Link Anonymous Order"
}

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.

{
  "description": "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.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "after_seq_num": {
        "description": "Value for after seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      },
      "limit": {
        "description": "Value for limit.",
        "exclusiveMinimum": 0,
        "maximum": 100,
        "type": "integer"
      }
    },
    "type": "object"
  },
  "name": "list_customers",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders"
  ],
  "risk": "read",
  "scope": "orders",
  "title": "List Customers"
}

mark_paid

Record an explicit manual settlement. switch_to_manual must be true; idempotency_key is required.

{
  "description": "Record an explicit manual settlement. switch_to_manual must be true; idempotency_key is required.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "idempotency_key": {
        "description": "Value for idempotency key.",
        "maxLength": 200,
        "minLength": 1,
        "type": "string"
      },
      "order_seq_num": {
        "description": "Value for order seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      },
      "settlement_note": {
        "description": "Value for settlement note.",
        "maxLength": 500,
        "minLength": 1,
        "type": "string"
      },
      "settlement_type": {
        "description": "Value for settlement type.",
        "enum": [
          "cash",
          "bank_transfer",
          "transfer"
        ],
        "type": "string"
      },
      "switch_to_manual": {
        "const": true,
        "description": "Value for switch to manual.",
        "type": "boolean"
      }
    },
    "required": [
      "order_seq_num",
      "settlement_type",
      "switch_to_manual",
      "idempotency_key"
    ],
    "type": "object"
  },
  "name": "mark_paid",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders:write"
  ],
  "risk": "money",
  "scope": "orders:write",
  "title": "Mark Paid"
}

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.

{
  "description": "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.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "anyOf": [
      {
        "additionalProperties": false,
        "description": "Value for input option.",
        "properties": {
          "amount": {
            "description": "Value for amount.",
            "pattern": "^\\d{1,16}(?:\\.\\d{1,2})?$",
            "type": "string"
          },
          "catalog_seq_num": {
            "description": "Value for catalog seq num.",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "currency": {
            "description": "Value for currency.",
            "pattern": "^[A-Z]{3,5}$",
            "type": "string"
          },
          "provider": {
            "description": "Value for provider.",
            "enum": [
              "robokassa",
              "yookassa",
              "stars",
              "cryptobot",
              "stripe",
              "paypal",
              "paddle",
              "tinkoff",
              "prodamus"
            ],
            "type": "string"
          },
          "user_seq_num": {
            "description": "Value for user seq num.",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "user_seq_num",
          "catalog_seq_num",
          "amount",
          "currency",
          "provider"
        ],
        "type": "object"
      },
      {
        "additionalProperties": false,
        "description": "Value for input option.",
        "properties": {
          "amount": {
            "description": "Value for amount.",
            "pattern": "^\\d{1,16}(?:\\.\\d{1,2})?$",
            "type": "string"
          },
          "currency": {
            "description": "Value for currency.",
            "pattern": "^[A-Z]{3,5}$",
            "type": "string"
          },
          "provider": {
            "description": "Value for provider.",
            "enum": [
              "robokassa",
              "yookassa",
              "stars",
              "cryptobot",
              "stripe",
              "paypal",
              "paddle",
              "tinkoff",
              "prodamus"
            ],
            "type": "string"
          },
          "registration_seq_num": {
            "description": "Value for registration seq num.",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "registration_seq_num",
          "amount",
          "currency",
          "provider"
        ],
        "type": "object"
      },
      {
        "additionalProperties": false,
        "description": "Value for input option.",
        "properties": {
          "catalog_seq_num": {
            "description": "Value for catalog seq num.",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "user_seq_num": {
            "description": "Value for user seq num.",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "user_seq_num",
          "catalog_seq_num"
        ],
        "type": "object"
      },
      {
        "additionalProperties": false,
        "description": "Value for input option.",
        "properties": {
          "registration_seq_num": {
            "description": "Value for registration seq num.",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "registration_seq_num"
        ],
        "type": "object"
      }
    ]
  },
  "name": "prepare_manual_sale",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders:write"
  ],
  "risk": "write",
  "scope": "orders:write",
  "title": "Prepare Manual Sale"
}

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.

{
  "description": "Prepare a tenant order status change and optional operator comment. The execution notifies the buyer through the configured status delivery slot.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "comment": {
        "description": "Value for comment.",
        "maxLength": 1000,
        "minLength": 1,
        "type": "string"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      },
      "status_seq_num": {
        "description": "Value for status seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      }
    },
    "required": [
      "seq_num",
      "status_seq_num"
    ],
    "type": "object"
  },
  "name": "prepare_order_status_change",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders:status"
  ],
  "risk": "write",
  "scope": "orders:status",
  "title": "Prepare Order Status Change"
}

prepare_send_invoice

Prepare invoice dispatch for a tenant-local order_seq_num. Sends nothing until execute_send_invoice is called.

{
  "description": "Prepare invoice dispatch for a tenant-local order_seq_num. Sends nothing until execute_send_invoice is called.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "order_seq_num": {
        "description": "Value for order seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      }
    },
    "required": [
      "order_seq_num"
    ],
    "type": "object"
  },
  "name": "prepare_send_invoice",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders:write"
  ],
  "risk": "write",
  "scope": "orders:write",
  "title": "Prepare Send Invoice"
}

quote_order

Evaluate direct items or an opaque Cart address into the signed quote required by create_order.

{
  "description": "Evaluate direct items or an opaque Cart address into the signed quote required by create_order.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "anyOf": [
      {
        "additionalProperties": false,
        "description": "Value for input option.",
        "properties": {
          "buyer_email": {
            "description": "Value for buyer email.",
            "format": "email",
            "maxLength": 254,
            "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "type": "string"
          },
          "buyer_inn": {
            "description": "Value for buyer inn.",
            "pattern": "^\\d{10}(?:\\d{2})?$",
            "type": "string"
          },
          "buyer_phone": {
            "description": "Value for buyer phone.",
            "maxLength": 32,
            "minLength": 10,
            "type": "string"
          },
          "checkout_notes": {
            "description": "Value for checkout notes.",
            "maxLength": 2000,
            "type": "string"
          },
          "delivery_address": {
            "additionalProperties": false,
            "description": "Value for delivery address.",
            "properties": {
              "apartment": {
                "description": "Value for apartment.",
                "maxLength": 20,
                "type": "string"
              },
              "building": {
                "description": "Value for building.",
                "maxLength": 20,
                "type": "string"
              },
              "city": {
                "description": "Value for city.",
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              },
              "comment": {
                "description": "Value for comment.",
                "maxLength": 300,
                "type": "string"
              },
              "entrance": {
                "description": "Value for entrance.",
                "maxLength": 10,
                "type": "string"
              },
              "floor": {
                "description": "Value for floor.",
                "maxLength": 10,
                "type": "string"
              },
              "house": {
                "description": "Value for house.",
                "maxLength": 20,
                "minLength": 1,
                "type": "string"
              },
              "intercom": {
                "description": "Value for intercom.",
                "maxLength": 20,
                "type": "string"
              },
              "postal_code": {
                "description": "Value for postal code.",
                "maxLength": 20,
                "type": "string"
              },
              "street": {
                "description": "Value for street.",
                "maxLength": 150,
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "city",
              "street",
              "house"
            ],
            "type": "object"
          },
          "external_order_ref": {
            "description": "Value for external order ref.",
            "maxLength": 255,
            "type": "string"
          },
          "items": {
            "description": "Value for items.",
            "items": {
              "additionalProperties": false,
              "description": "Value for items item.",
              "properties": {
                "note": {
                  "description": "Value for note.",
                  "maxLength": 500,
                  "type": "string"
                },
                "product_seq_id": {
                  "description": "Value for product seq id.",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991,
                  "type": "integer"
                },
                "quantity": {
                  "description": "Value for quantity.",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991,
                  "type": "integer"
                },
                "selected_options": {
                  "additionalProperties": {
                    "items": {
                      "description": "Value for selected options item.",
                      "pattern": "^[a-z0-9_]{1,16}$",
                      "type": "string"
                    },
                    "minItems": 1,
                    "type": "array"
                  },
                  "description": "Value for selected options.",
                  "propertyNames": {
                    "pattern": "^[a-z0-9_]{1,16}$",
                    "type": "string"
                  },
                  "type": "object"
                }
              },
              "required": [
                "product_seq_id",
                "quantity"
              ],
              "type": "object"
            },
            "minItems": 1,
            "type": "array"
          },
          "metadata": {
            "additionalProperties": {},
            "description": "Value for metadata.",
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "redirect_url": {
            "description": "Value for redirect url.",
            "format": "uri",
            "maxLength": 2048,
            "type": "string"
          },
          "user_seq_id": {
            "description": "Value for user seq id.",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "zone": {
            "description": "Value for zone.",
            "enum": [
              "ru",
              "com"
            ],
            "type": "string"
          }
        },
        "required": [
          "items",
          "zone"
        ],
        "type": "object"
      },
      {
        "additionalProperties": false,
        "description": "Value for input option.",
        "properties": {
          "cart_code": {
            "description": "Value for cart code.",
            "maxLength": 16,
            "minLength": 16,
            "pattern": "^[A-Za-z0-9_-]{16}$",
            "type": "string"
          },
          "user_seq_id": {
            "description": "Value for user seq id.",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "zone": {
            "description": "Value for zone.",
            "enum": [
              "ru",
              "com"
            ],
            "type": "string"
          }
        },
        "required": [
          "cart_code",
          "zone"
        ],
        "type": "object"
      }
    ]
  },
  "name": "quote_order",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders"
  ],
  "risk": "read",
  "scope": "orders",
  "title": "Quote Order"
}

refresh_payment_urls

Regenerate payment provider URLs for an existing order.

{
  "description": "Regenerate payment provider URLs for an existing order.",
  "domain": "orders",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "payment_providers": {
        "description": "Value for payment providers.",
        "items": {
          "description": "Value for payment providers item.",
          "type": "string"
        },
        "type": "array"
      },
      "redirect_url": {
        "description": "Value for redirect url.",
        "format": "uri",
        "maxLength": 2048,
        "type": "string"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      }
    },
    "required": [
      "seq_num"
    ],
    "type": "object"
  },
  "name": "refresh_payment_urls",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "orders"
  ],
  "risk": "write",
  "scope": "orders",
  "title": "Refresh Payment Urls"
}