Как изменяются статусы LaaS-заказов

Схема по изменению статусов показывает этапы, которые проходит заказ, и логику переходов между статусами. Это поможет соотнести статусы Маркета и вашей системы, корректно настроить интеграцию с Маркетом и не передавать лишние статусы и подстатусы.

Обозначения:

  • На схеме отражены статусы и подстатусы заказа на каждом этапе в формате Статус Подстатус. Например, PROCESSING STARTED.

  • Стрелки показывают переходы между этапами, а их цвет — когда происходит этот переход:

    • зеленый — магазин изменил статус;
    • синий — Маркет изменил статус;
    • оранжевый — отмена заказа одной из сторон.

Расшифровка схемы

Статус, подстатус и описание этапа

Кто меняет статус

Методы, с помощью которых меняется статус или приходит информация о заказе в этом статусе

Магазин создал заказ.

Магазин

POST v1/campaigns/{campaignId}/orders/create

RESERVED

Заказ зарезервирован.

Ожидается подтверждение магазина.

Маркет

POST v1/businesses/{businessId}/orders

PROCESSING
STARTED

Маркет обрабатывает заказ.

Магазин

POST v1/businesses/{businessId}/orders

POST notification

PUT v2/campaigns/{campaignId}/orders/{orderId}/status

PROCESSING
PACKAGING

Маркет собирает заказ.

Маркет

POST v1/businesses/{businessId}/orders

POST notification

PROCESSING
READY_TO_SHIP

Маркет собрал заказ.

Маркет

POST v1/businesses/{businessId}/orders

POST notification

PROCESSING
SHIPPED

Маркет отгрузил заказ.

Маркет

POST v1/businesses/{businessId}/orders

POST notification

DELIVERY
DELIVERY_SERVICE_RECEIVED

Заказ передан в доставку.

Маркет

POST v1/businesses/{businessId}/orders

POST notification

PICKUP
PICKUP_SERVICE_RECEIVED

Заказ принят в ПВЗ.

Маркет

POST v1/businesses/{businessId}/orders

POST notification

DELIVERY
DELIVERY_SERVICE_DELIVERED

Заказ доставлен.

Маркет

POST v1/businesses/{businessId}/orders

POST notification

CANCELLED
Подстатусы

Заказ отменен.

Чтобы отменить заказ, передайте подстатус SHOP_FAILED.

Маркет

Магазин

POST v1/businesses/{businessId}/orders

POST notification

PUT v2/campaigns/{campaignId}/orders/{orderId}/status

Подстатусы при отмене заказа

  • RESERVATION_EXPIRED — магазин не подтвердил оформление зарезервированного заказа в течение 60 минут.
  • SHOP_FAILED — магазин отменил заказ.
  • PICKUP_EXPIRED — закончился срок хранения заказа в ПВЗ.
  • DELIVERY_PROBLEMS — Маркет не смог доставить заказ.
  • LOST — заказ утерян.

Также могут возвращаться другие значения. Обрабатывать их не нужно.