How do the statuses of LaaS orders change?

The status change diagram shows the stages that the order goes through and the logic of transitions between statuses. This will help you correlate the statuses of Yandex. Market and your system, set up integration with Yandex.Market correctly, and avoid transmitting unnecessary statuses and sub-statuses.

Designations:

  • The diagram shows the order statuses and substates at each stage in the format Status of the Sub-status. For example, PROCESSING STARTED.

  • The arrows show the transitions between the stages, and their color — when this transition occurs:

    • green — The store's status has changed.
    • blue — The market has changed its status.
    • orange — cancellation of an order by one of the parties.

Decoding the scheme

Status, sub-status, and stage description

Who is changing the status

Methods by which the status is changed or information about the order is received in this status

The store has created an order.

Shop

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

RESERVED

The order is reserved.

The store's confirmation is pending.

Yandex. Market

POST v1/businesses/{businessId}/orders

PROCESSING
STARTED

The market processes the order.

Shop

POST v1/businesses/{businessId}/orders

POST notification

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

PROCESSING
PACKAGING

The market collects the order.

Yandex. Market

POST v1/businesses/{businessId}/orders

POST notification

PROCESSING
READY_TO_SHIP

The market has collected the order.

Yandex. Market

POST v1/businesses/{businessId}/orders

POST notification

PROCESSING
SHIPPED

The market has shipped the order.

Yandex. Market

POST v1/businesses/{businessId}/orders

POST notification

DELIVERY
DELIVERY_SERVICE_RECEIVED

The order has been delivered.

Yandex. Market

POST v1/businesses/{businessId}/orders

POST notification

PICKUP
PICKUP_SERVICE_RECEIVED

The order has been accepted at the PVZ.

Yandex. Market

POST v1/businesses/{businessId}/orders

POST notification

DELIVERY
DELIVERY_SERVICE_DELIVERED

The order has been delivered.

Yandex. Market

POST v1/businesses/{businessId}/orders

POST notification

CANCELLED
Substates

The order has been cancelled.

To cancel an order, pass the sub-status SHOP_FAILED.

Yandex. Market

Shop

POST v1/businesses/{businessId}/orders

POST notification

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

Substates when canceling an order

  • RESERVATION_EXPIRED — The store did not confirm the reserved order within 60 minutes.
  • SHOP_FAILED — the store cancelled the order.
  • PICKUP_EXPIRED — the storage period of the order in the PVZ has expired.
  • DELIVERY_PROBLEMS — The market couldn't deliver the order.
  • LOST — the order is lost.

Other values may also be returned. You don't need to process them.