Заказы #

Зал, самовывоз и доставка отправляются одним методом — тип задаётся полем order_type_id. Отдельных эндпоинтов для разных типов нет.

Расчёт корзины #

POST /orders/calculate

Возвращает итоговую сумму без создания заказа. Вызывайте перед показом кнопки «Заказать»: здесь же проверяется стоп-лист, поэтому вы узнаете о недоступной позиции до того, как пользователь нажмёт оплату.

{
  "point_id": "f40d9ea6-bb66-4d8a-9185-219916b68224",
  "items": [
    { "product_id": 777, "quantity": 2, "modifiers": [{ "product_id": 3884, "quantity": 1 }] }
  ]
}

{
  "items": [
    { "product_id": 777, "name": "Fanta 1 l", "quantity": 2, "price": 12000, "total": 24000, "is_modifier": false },
    { "product_id": 3884, "name": "Соус барбекю", "quantity": 1, "price": 2500, "total": 2500, "is_modifier": true }
  ],
  "total_amount": 26500
}

Модификаторы приходят отдельными строками с is_modifier: true — так же, как они попадут в чек.

Создание заказа #

POST /orders

{
  "point_id": "f40d9ea6-bb66-4d8a-9185-219916b68224",
  "order_type_id": 3,
  "payment_type_id": 59,
  "external_id": "my-app-order-1",
  "comment": "Не звонить в домофон",
  "persons": 2,
  "client": { "name": "Азиз", "phone": "998901112233" },
  "address": {
    "street": "Амира Темура 15",
    "apartment": "42",
    "floor": "4",
    "entrance": "2",
    "intercom": "42K",
    "latitude": 41.311,
    "longitude": 69.279
  },
  "items": [
    {
      "product_id": 777,
      "quantity": 2,
      "comment": "без льда",
      "modifiers": [{ "product_id": 3884, "quantity": 1 }]
    }
  ]
}

Параметры #

Ответ #

{
  "order_id": 11537716,
  "external_id": "my-app-order-1",
  "point_id": "f40d9ea6-bb66-4d8a-9185-219916b68224",
  "status": "CREATED",
  "status_name": "Создан",
  "order_type_id": 3,
  "order_type_sub_id": 65,
  "payment_type_id": 59,
  "client": { "name": "Азиз", "phone": "998901112233" },
  "persons": 2,
  "comment": "Не звонить в домофон",
  "total_amount": 26500,
  "total_amount_service": 26500,
  "delivery_price": 0,
  "discount": 0,
  "created_at": "2026-08-18 23:06:29",
  "scheduled_at": null,
  "items": [
    {
      "product_id": 777,
      "name": "Fanta 1 l",
      "quantity": 2,
      "price": 12000,
      "total": 24000,
      "comment": "без льда",
      "modifiers": [
        { "product_id": 3884, "name": "Соус барбекю", "quantity": 1, "price": 2500, "total": 2500, "comment": null }
      ]
    }
  ]
}

order_id — идентификатор заказа в Mison, по нему запрашивается статус. В ответе модификаторы вложены в свою позицию, а не идут отдельными строками.

Идемпотентность #

Присылайте external_id всегда. Повторный запрос с тем же external_id на ту же точку вернёт уже созданный заказ, а не создаст второй.

Это значит, что при таймауте, обрыве связи или 502 можно спокойно повторить запрос тем же телом — дубля не будет. Без external_id такой защиты нет, и повтор создаст второй заказ.

Цены #

Сумма считается по ценам заведения. Если вы пришлёте цену в запросе, она будет проигнорирована — заказ по своей цене отправить нельзя.

Расхождение вашей суммы с total_amount в ответе означает, что кеш меню устарел. Перезагрузите меню.

Предзаказ #

scheduled_at — заказ к определённому времени:

{ "scheduled_at": "2026-08-19T19:30:00+05:00" }

Требования: формат ISO-8601 с указанием часового пояса, время минимум на 30 минут вперёд от текущего. Заказ попадёт в статус PREORDER и уйдёт на кухню ближе к сроку.

Статус заказа #

GET /orders/{order_id}

Ответ — тот же объект, что при создании, с актуальными status и составом.

Опрашивайте раз в 30 секунд, пока заказ не придёт в конечное состояние (CLOSED или DELETED). Чаще смысла нет.

Статусы заказа #

Обычный путь доставки: CREATED → UNCONFIRMED_ORDER → COOKING → PACKED → TAKEN_BY_COURIER → DELIVERED → CLOSED.

Для зала и самовывоза курьерских статусов не будет: CREATED → UNCONFIRMED_ORDER → COOKING → CLOSED.

Порядок не гарантирован: заказ может перескочить статус, если на точке работают быстро. Ориентируйтесь на текущее значение, а не на ожидаемую последовательность.

Отмена заказа #

POST /orders/{order_id}/cancel

{ "cancel_cause_id": 12, "comment": "Клиент передумал" }

Оба поля необязательны, но cancel_cause_id из GET /cancel-causes лучше передавать: без него отмена не попадёт в отчёт заведения по причинам.

В ответе — заказ со статусом DELETED.

{ "message": "Заказ уже принят на точке, отмена возможна только через кассу" }

Заказ в зале и самовывоз #

Отличаются от доставки только полями:

Зал (order_type_id: 1) — адрес не нужен, можно указать table_id:

{
  "point_id": "f40d9ea6-bb66-4d8a-9185-219916b68224",
  "order_type_id": 1,
  "payment_type_id": 59,
  "table_id": 14,
  "persons": 4,
  "external_id": "my-app-order-2",
  "client": { "phone": "998901112233" },
  "items": [{ "product_id": 777, "quantity": 1 }]
}

С собой (order_type_id: 2) — ни адреса, ни стола:

{
  "point_id": "f40d9ea6-bb66-4d8a-9185-219916b68224",
  "order_type_id": 2,
  "payment_type_id": 59,
  "external_id": "my-app-order-3",
  "client": { "phone": "998901112233" },
  "items": [{ "product_id": 777, "quantity": 1 }]
}

Клиент #

Клиент определяется по телефону: если гость с таким номером у заведения уже есть, заказ привяжется к нему, а имя обновится. Отдельно создавать клиента не нужно.

Телефон присылайте в любом формате — лишние символы отбрасываются. 998901112233 и +998 90 111-22-33 дадут одного и того же клиента.