Создание отгрузки

GET /api/v1/shipments/out

Отгрузка (shipment) — партия заказов, которую вы отправляете со своего склада на склад Lamoda.

Процесс создания отгрузки

Шаг 1: Сгенерировать pack numbers

GET /api/v1/orders/{orderNr}/pack-numbers

Pack number — уникальный код посылки для идентификации на складе.

curl -X POST "https://api-b2b.lamoda.ru/api/v1/orders/CZ123456789/pack-numbers" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"packQuantity": 1}'

Ответ:

{
  "packNumbers": ["FBS7E5A016DB"]
}

Когда нужно несколько pack numbers?

Если заказ не помещается в одну коробку, укажите "packQuantity": 2 или больше. Каждая посылка получит свой pack number и этикетку.

Шаг 2: Создать отгрузку

curl -X POST "https://api-b2b.lamoda.ru/api/v1/shipments/out" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "MMJ20250909001",
    "type": "Sale",
    "shippedAt": "2025-09-09",
    "destination": "PPBykovo",
    "containers": [
      {
        "barcode": "PALMMJ20250909001",
        "type": "pallet",
        "containers": [
          {
            "barcode": "FBS7E5A016DB",
            "type": "pack",
            "items": [
              {
                "orderNr": "RU250909-123456789",
                "sku": "SELLER-SKU-001",
                "unitload": "RU250909-123456789-001",
                "datamatrix": "010460043993125621JgXJ5.T>Ap1LQ"
              }
            ]
          }
        ]
      }
    ]
}'

Параметры запроса

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Номер отправления (поставки), уникальный в рамках партнёра. Структура: partnerId + number, где partnerId — уникальный идентификатор партнёра из 2–3 латинских символов, генерируется при подключении
`type`	string	Да	Тип отправления, всегда `"Sale"`
`shippedAt`	date	Да	Дата отправления (YYYY-MM-DD)
`destination`	string	Нет	Склад-назначение. Для FBS: `"PPBykovo"`
`containers`	array	Да	Список контейнеров (палет) в отгрузке

Структура палеты (контейнер 1-го уровня)

Поле	Тип	Обязательный	Описание
`barcode`	string	Да	Штрихкод палеты, уникальный в рамках партнёра. Структура: `PAL` + partnerId + number
`type`	string	Да	Тип контейнера, всегда `"pallet"`
`containers`	array	Да	Список паков внутри палеты

Структура пака (контейнер 2-го уровня)

Поле	Тип	Обязательный	Описание
`barcode`	string	Да	Штрихкод пака. Генерируется методом `POST /api/v1/orders/{sellerOrderNr}/pack-numbers` (поле `packNumbers[]` в ответе)
`type`	string	Да	Тип контейнера, всегда `"pack"`
`items`	array	Да	Товары в паке

Структура товара

Поле	Тип	Обязательный	Описание
`orderNr`	string	Да	Номер заказа
`sku`	string	Да	Артикул поставщика
`unitload`	string	Да	Уникальный номер конкретной единицы товара, максимум 26 символов, уникален в рамках всех поставок
`datamatrix`	string\|null	Нет	Код DataMatrix (либо UIT). Длина UIT: 31 символ (без ТН ВЭД) или 38 символов (с ТН ВЭД). Передача опциональна — партнёр обязан сам следить за корректностью данного поля (подробнее)

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

{
  "id": "MMJ20250909001",
  "status": "initial",
  "createdAt": "2025-09-09T10:30:00Z"
}

После создания отгрузка получает статус initial. Подробнее о статусах и подтверждении: Подтверждение отгрузки.

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

Проблема	Причина	Решение
Ошибка валидации	Состав заказа не совпадает	Проверить orderNr, sku и unitload
Неуникальный unitload	unitload повторяется в рамках поставок	Убедиться, что unitload уникален в рамках всех поставок (макс. 26 символов)
Заказ не найден	Заказ отменён или уже отгружен	Проверить статус заказа
Превышен срок	Прошло более 6 дней	Заказ нужно отменить

См. также

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

Да Нет

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

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

Отмена заказов через API

Преимущества и функционал товарной рекламы

Создание отгрузки FBS через API