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

Для корректной обработки отгрузки на складе Lamoda необходимо три типа этикеток.

Типы этикеток

Тип	Метод	Куда клеить	Размер по умолчанию
Товарная	`GET /api/v1/label/items`	На каждый товар	`s` (58×40 мм)
Паковая	`GET /api/v1/label/packs`	На упаковку посылки	`m` (75×120 мм)
Паллетная	`GET /api/v1/label/pallets`	На короб/паллету	`m` (75×120 мм)

Размеры этикеток

Код	Габариты	Применение
`s`	58×40 мм	Товарные этикетки
`m`	75×120 мм	Паковые и паллетные
`l`	100×150 мм	Улучшенное качество печати

1. Товарные этикетки

GET /api/v1/label/items

curl -X POST "https://api-b2b.lamoda.ru/api/v1/label/items" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "itemNrs": ["RU250216-884060-001", "RU250216-884060-002"],
    "size": "s"
}'

Параметр	Описание
`itemNrs`	Номера товаров из GET /orders, поле `items[].id`. Максимум 100.
`size`	Размер: `s`, `m`, `l`. По умолчанию `s`.

2. Паковые этикетки

GET /api/v1/label/packs

Сначала сгенерируйте pack numbers

Вызовите GET /api/v1/orders/{orderNr}/pack-numbers. Этикетка доступна сразу — задержка не нужна.

curl -X POST "https://api-b2b.lamoda.ru/api/v1/label/packs" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "packNumbers": ["FBS7E5A016DB"],
    "size": "m"
}'

Параметр	Описание
`packNumbers`	Коды посылок из POST /pack-numbers. Максимум 100.
`size`	Размер: `s`, `m`, `l`. По умолчанию `m`.

3. Паллетные этикетки

GET /api/v1/label/pallets

Сначала создайте отгрузку

Паллетные этикетки доступны только после GET /api/v1/shipments/out. Баркоды паллет берутся из ответа.

curl -X POST "https://api-b2b.lamoda.ru/api/v1/label/pallets" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "barcodes": ["PALJVB054485225"],
    "size": "m"
}'

Параметр	Описание
`barcodes`	Баркоды паллет из POST /shipments/out, поле `pallets[].barcode`. Максимум 100.
`size`	Размер: `s`, `m`, `l`. По умолчанию `m`.

Формат баркода: PAL + partnerId + число. Пример: PALJVB054485225

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

{
  "url": "https://storage.yandexcloud.net/.../labels.pdf?...",
  "excludedPackNumbers": []
}

Поле	Описание
`url`	Ссылка на PDF (временная, скачивайте сразу)
`excluded*`	Номера, не включённые в PDF (не найдены или не принадлежат партнёру)

Требования к этикеткам

Штрих-код/QR должен сканироваться — иначе отказ в приёмке
Этикетка должна быть хорошо пропечатана — без размытий и полос
Если качество плохое — попробуйте больший размер (m или l)

Ссылки на этикетки временные!
URL действует 1-2 дня. Скачивайте файлы сразу после получения. Если ссылка истекла — запросите этикетку повторно.

Устаревший метод

Метод GET /api/v1/reports/label/stream устарел. Используйте новые методы GET /api/v1/label/*.

См. также

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

Да Нет

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

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

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

Обзор FBS в API

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