Жизненный цикл посылки

Статусы посылки

Текущий статус посылки — поле currentStatus.type, история — statuses.

Статус	Значение
AWAITING	Посылка создана и ожидает поступления на склад
RECEIVED	Посылка принята на склад
READYTOSHIP	Посылка готова к отправке
COURIER_RECEIVED	Курьер забрал посылку
SENT	Посылка отправлена (в пути)
REDIRECT_TO_PVZ	Посылка переадресована в другой пункт выдачи или постомат
RECALL	Посылка отозвана
ARRIVED	Посылка прибыла в пункт назначения (в том числе заложена в постомат)
TRANSFERRED	Посылка передана получателю (в том числе забрана из постомата)
COMPLETED	Посылка завершена
LOST	Посылка утеряна

Доставка в постомат

Для посылок со способом доставки «в постомат» платформа отслеживает два события: закладку в ячейку и выдачу получателю.

Событие	Когда происходит	Статус посылки	Вебхук партнёру
Посылка заложена в постомат	Постомат подтвердил закладку, или курьер завершил заказ на доставку посылок в постомат	ARRIVED	type = PARCEL, subtype = DELIVERED_TO_POSTOMAT, тело {"postomatOrderId": "...", "status": 0}
Посылка выдана получателю	Постомат подтвердил, что получатель забрал посылку	TRANSFERRED	type = PARCEL, subtype = TRANSFERRED_TO_CLIENT, тело {"postomatOrderId": "...", "status": 1}

postomatOrderId — ID заявки в сервисе постоматов, связанной с посылкой (поле postomatOrderId посылки). Подробнее о настройке и формате — Вебхуки.

Упрощённые статусы для маркетплейсов

GET /api/v1/integrations/market-company/parcel/track-code/{trackCode}/status сворачивает статус посылки в одно из четырёх значений:

Статус маркетплейса	Статус посылки
REDIRECTED	REDIRECT_TO_PVZ
TRANSFERRED_TO_CLIENT	TRANSFERRED или COMPLETED
ARRIVED	ARRIVED, а также RECEIVED с назначением в пункт выдачи
CREATED	Любой другой статус

Как отслеживать

• Подпишитесь на вебхуки DELIVERED_TO_POSTOMAT и TRANSFERRED_TO_CLIENT.
• Вебхуки не повторяются при ошибке доставки, поэтому периодически сверяйте статусы запросами: маркетплейсам — через GET .../parcel/track-code/{trackCode}/status, логистическим компаниям — через GET /api/v1/integrations/logistic-company/parcel/list.