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

Для корректной обработки отгрузки на складе Lamoda необходимо три типа этикеток. Все этикетки можно получить через API — Telegram-бот больше не обязателен.

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

1. Товарная этикетка (Item Label)

Наклеивается на каждый товар. Содержит QR-код для идентификации товара в заказе.

Метод: POST /api/v1/label/items

Размер по умолчанию: 58×40 мм (s)

2. Паковая этикетка (Pack Label)

Наклеивается на упаковку посылки. Содержит штрих-код pack number для идентификации посылки.

Метод: POST /api/v1/label/packs

Размер по умолчанию: 75×120 мм (m)

3. Паллетная этикетка (Pallet Label)

Наклеивается на транспортировочный короб/паллету. Содержит штрих-код грузоместа.

Метод: POST /api/v1/label/pallets

Размер по умолчанию: 75×120 мм (m)

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

Размер	Параметр	Габариты	Применение
Малая	s	58×40 мм	Товарные этикетки (по умолчанию)
Средняя	m	75×120 мм	Паковые и паллетные этикетки (по умолчанию)
Большая	l	100×150 мм	Для улучшенного качества печати

Можно использовать другой размер!

Если штрих-код/QR сканируется — допустимо использовать этикетки большего размера. Например, 75×120 вместо 58×40, если на вашем принтере лучше качество печати.

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

POST /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	array[string]	Да	Номера товаров в заказе (из GET /api/v1/orders/{id}, поле items[].id). Максимум 100.
size	string	Нет	Размер этикетки: s (58×40), m (75×120), l (100×150). По умолчанию s.

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

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

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

POST /api/v1/label/packs

Получение этикеток для посылок (паков).

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

Перед запросом этикеток нужно вызвать POST /api/v1/orders/{orderNr}/pack-numbers для генерации кодов посылок. Этикетка доступна сразу после генерации pack number — задержка не нужна.

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	array[string]	Да	Коды посылок из POST /api/v1/orders/{orderNr}/pack-numbers. Максимум 100.
size	string	Нет	Размер этикетки: s, m, l. По умолчанию m.

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

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

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

POST /api/v1/label/pallets

Получение этикеток для паллет (грузовых мест).

Сначала создайте поставку!

Паллетные этикетки доступны только после создания поставки через POST /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	array[string]	Да	Баркоды паллет из ответа на POST /api/v1/shipments/out, поле pallets[].barcode. Максимум 100.
size	string	Нет	Размер этикетки: s, m, l. По умолчанию m.

Формат паллетного штрих-кода

Формат: PAL + partnerId + произвольное число.

Пример: PALJVB054485225, где JVB — идентификатор партнёра.

Порядок получения этикеток

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

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

# 3. Получить товарные этикетки
POST /api/v1/label/items
{"itemNrs": ["RU250216-884060-001"], "size": "s"}

# 4. Получить паковые этикетки
POST /api/v1/label/packs
{"packNumbers": ["FBS7E5A016DB"], "size": "m"}

# 5. Создать поставку
POST /api/v1/shipments/out
{...}

# 6. Получить паллетные этикетки
POST /api/v1/label/pallets
{"barcodes": ["PALJVB054485225"], "size": "m"}

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

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

Срок действия ссылок

Ссылки на этикетки временные!

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

Обработка исключенных элементов

Если некоторые номера не найдены в системе, они возвращаются в массиве excludedItemNrs / excludedPackNumbers / excludedBarcodes:

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

Причины исключения: номер не существует в базе, принадлежит другому партнёру, уже отменён.

Если все номера исключены
Поле url будет пустой строкой "" — документ не может быть сгенерирован.

Альтернативный метод (устаревший)

Есть также метод GET /api/v1/reports/label/stream, но рекомендуем использовать новые методы — они поддерживают выбор размера и batch-операции.

См. также

• Создание отгрузки FBS
• Общие принципы работы с этикетками
• Подтверждение отгрузки