Подтверждение отгрузки

После создания отгрузки через GET /api/v1/shipments/out её нужно подтвердить с помощью GET /api/v1/shipments/out/{code}/events — или она будет подтверждена автоматически.

Автоподтверждение

По умолчанию автоподтверждение включено

Отгрузка подтверждается автоматически сразу после создания. Метод /events вызывать не нужно.

Проверить настройку можно в Личном кабинете Lamoda или уточнить у вашего KAM.

Когда нужен ручной вызов

Метод /events используется в двух случаях:

Подтверждение — если автоподтверждение отключено
Отмена — если нужно отменить созданную отгрузку

Подтверждение вручную

curl -X POST "https://api-b2b.lamoda.ru/api/v1/shipments/out/SHIP-001/events" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "confirm",
    "data": {}
}'

Параметры

Параметр	Тип	Описание
`code` (path)	string	shipmentId из POST /shipments/out. Макс. 20 символов.
`type`	string	`confirm` или `cancel`
`data`	object	Дополнительные данные (обычно пустой объект `{}`)

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

{
  "name": "confirm",
  "id": 201810,
  "message": "Shipment confirmed successfully",
  "status": "ok",
  "createdAt": "2025-12-02",
  "errors": [],
  "data": []
}

Отмена отгрузки

curl -X POST "https://api-b2b.lamoda.ru/api/v1/shipments/out/SHIP-001/events" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "cancel",
    "data": {}
}'

Когда можно отменить?
Только до сверки документов в ЭДО. После физической приёмки на складе отмена невозможна — свяжитесь с KAM.

Статусы отгрузки FBS

Статус	Описание
`initial`	Отгрузка создана, идёт первичная обработка
`new`	Отгрузка принята, ожидает подтверждения (если автоподтверждение выключено)
`confirmed`	Отгрузка подтверждена, можно передавать курьеру
`sent`	Отгрузка отправлена на склад Lamoda
`rejected`	Отгрузка отклонена (ошибки валидации данных)
`cancelPending`	Запрос на отмену в обработке
`cancelled`	Отгрузка отменена

Нотификации

При изменении статуса отгрузки отправляется нотификация fulfilmentShipmentStatusChanged:

{
  "type": "fulfilmentShipmentStatusChanged",
  "createdAt": "2025-01-21T09:15:00+03:00",
  "data": {
    "id": 98765,
    "shipmentId": "SHIP-001",
    "direction": "out",
    "status": "confirmed",
    "itemQuantity": 15,
    "priceSum": 45000.00
  }
}

Подробнее: Настройка вебхуков, Примеры нотификаций.

Частые ошибки

Ошибка	Причина	Решение
Shipment not found	Неверный `code` или отгрузка отменена	Проверить ID отгрузки
Already confirmed	Отгрузка уже подтверждена	Не нужно подтверждать повторно
Cannot cancel	Отгрузка уже обработана на складе	Связаться с KAM
Invalid event type	Неверное значение `type`	Используйте `confirm` или `cancel`

См. также

Помогла эта информация?

Да Нет

Спасибо за отзыв

0/1000 Отправить

Отчеты FBO в API

Этикетки отгрузки в API

Подтверждение отгрузки в API