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

POST /api/v1/shipments/out/{code}/events

После создания поставки через POST /api/v1/shipments/out её нужно подтвердить — или она будет подтверждена автоматически, если включено автоподтверждение.

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

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

Если у вас включена опция автоподтверждения поставок, отгрузка подтверждается автоматически сразу после создания. В этом случае метод /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	string (path)	Да	Идентификатор поставки (shipmentId из POST /api/v1/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": {}
}'

Когда можно отменить отгрузку?

Отменить поставку можно только до того, как документы будут сверены в ЭДО. После физической приёмки на складе отмена невозможна.

Статусы поставки FBS

Created → Confirmed → Shipped → Received ↓ Cancelled

Статус	Описание
created	Поставка создана, ожидает подтверждения (если автоподтверждение выключено)
confirmed	Поставка подтверждена, можно передавать курьеру
shipped	Поставка отправлена (файл отгрузки загружен в ЛК)
received	Поставка принята на складе Lamoda
cancelled	Поставка отменена

Полный флоу отгрузки

# 1. Получить заказы со статусом Confirmed
GET /api/v1/orders?status=confirmed

# 2. Собрать заказы на складе

# 3. Сгенерировать pack numbers
POST /api/v1/orders/{orderNr}/pack-numbers

# 4. Получить этикетки
POST /api/v1/label/packs
POST /api/v1/label/items

# 5. Создать отгрузку
POST /api/v1/shipments/out

# 6. Подтвердить (если нет автоподтверждения)
POST /api/v1/shipments/out/{code}/events
{"type": "confirm", "data": {}}

# 7. Передать курьеру Lamoda

Получение информации об отгрузке

GET /api/v1/shipments

Для получения информации о поставках используйте метод получения списка поставок с фильтром:

curl -X GET "https://api-b2b.lamoda.ru/api/v1/shipments?direction=out" \
-H "Authorization: Bearer YOUR_TOKEN"

Фильтр direction=out возвращает только FBS-поставки (на доставку).

Важные правила

Ограничения по отгрузке

• Срок: Разница между датой создания заказа и датой отгрузки — не более 6 дней
• Дозагрузка: После отправки поставки нельзя добавить новые заказы
• cutOff = null: Если параметр cutOff равен null — отгружайте заказ в ближайшей поставке
• Отмена: Отменить поставку можно только до сверки в ЭДО

Нотификации об изменении статуса

При изменении статуса поставки Lamoda отправляет вебхук-нотификацию типа fulfilmentShipmentStatusChanged:

{
  "type": "fulfilmentShipmentStatusChanged",
  "trackingId": "SHIP-001",
  "data": {
    "id": "MPG20017",
    "shipmentId": "SHIP-001",
    "date": "2025-12-02",
    "status": "confirmed",
    "itemQuantity": 5,
    "priceSum": 25000,
    "updatedAt": "2025-12-02 14:05:38"
  }
}

Настройка нотификаций

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

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

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

См. также

• Создание отгрузки FBS
• Этикетки отгрузки
• Настройка вебхуков
• Типы нотификаций