Статусы поставок FBO

Поставка FBO (Fulfillment by Operator) проходит несколько статусов — от создания до закрытия после проверки качества. Документация актуальна для workflow fulfilment_fbo.

Схема переходов статусов

Описание статусов

Таблица переходов

Полная карта допустимых переходов между статусами.

Доступные действия по статусам

Получение статуса поставки

1. Через REST API — детали поставки

GET /api/v1/shipments/fulfilment/{code}
Authorization: Bearer YOUR_TOKEN

Ответ содержит поле status с текущим статусом.

2. Через REST API — история статусов

GET /api/v1/shipments/fulfilment/{code}/statuses
Authorization: Bearer YOUR_TOKEN

Параметры:

• with_related_shipments — 0 или 1. Если 1, вернёт статусы связанных версий поставки.

Пример ответа:

[
  {
    "id": 2562111603,
    "statusName": "draft",
    "createdAt": "2025-10-13 00:45:43",
    "userName": null
  },
  {
    "id": 2562111604,
    "statusName": "validation",
    "createdAt": "2025-10-13 01:00:00",
    "userName": null
  },
  {
    "id": 2562111605,
    "statusName": "ready_for_shipment",
    "createdAt": "2025-10-13 02:15:22",
    "userName": null
  }
]

3. Через Seller Gateway (JSON-RPC)

POST /v1/shipments-fulfilment.list
POST /v1/shipments-fulfilment.get

Возвращают ту же структуру с полем status.

4. Через вебхуки

Нотификация fulfilmentShipmentStatusChanged отправляется при каждой смене статуса поставки. Подробнее — Настройка вебхуков.

Отклонение поставки через API

Единственное действие, доступное партнёру через API — отклонение поставки. Партнёр отправляет запрос с type: "reject", а система сама определяет переход: если поставка в ready_for_shipment, она сначала перейдёт в cancel_pending; из остальных статусов — сразу в rejected. После перехода в складские статусы (unloading_needed и далее) отмена через API невозможна.

REST API

POST /api/v1/shipments/fulfilment/{code}/events
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "type": "reject",
  "rejectReasonId": "actuality"
}

Seller Gateway (JSON-RPC)

POST /v1/shipments-fulfilment.update-events

{
  "id": "SHIP-CODE",
  "type": "reject",
  "rejectReasonId": "actuality"
}

Допустимые причины отклонения

Типичные сценарии

Успешная поставка (happy path)

Поставка с ошибками валидации

Отмена поставки до отгрузки

Отмена не удалась — товар уже приехал

Полная сводка API-эндпоинтов для FBO-поставок

См. также

• Поставки FBO: обзор
• Статусы заказов (FBS и FBO)
• Настройка вебхуков
• Типы нотификаций