Генерация этикеток

Для FBS-отгрузок доступны три типа этикеток. Каждый тип генерируется отдельным методом и возвращает ссылку на PDF-файл.

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

Тип	Метод	Назначение	Самостоятельная генерация
Товарные	GET /api/v1/label/items	Наклеиваются на каждый товар	Возможна (по согласованию)
Паковые	GET /api/v1/label/packs	Наклеиваются на упаковку (коробку)	Невозможна
Паллетные	GET /api/v1/label/pallets	Наклеиваются на паллету/короб	Возможна (по согласованию)

Важно: собственные форматы этикеток

Паковые этикетки нельзя генерировать самостоятельно.

Паковая этикетка содержит параметры маршрутизации (выход номера сортера, транзитные хабы доставки), которые передаются внутренними сервисами Lamoda. Самостоятельная генерация невозможна — используйте только API. Категорически не рекомендуем собственные форматы.

Для товарных и паллетных этикеток технически возможна самостоятельная генерация, но мы настоятельно рекомендуем использовать API. Причины: сотрудники склада привыкают к единому формату этикетки, что минимизирует операционные потери и унифицирует поток. Собственный формат также усложняет идентификацию возвратов. Если всё же требуется собственный формат — необходимо согласование со складом Быково (контактное лицо по FBS: Марина Михина).

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

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

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

GET /api/v1/label/items

Генерирует PDF с этикетками для товаров.

Параметры

Параметр	Тип	Обязательный	Описание
itemNrs	array[string]	Да	Массив инвентарных номеров товаров (от 1 до 100)
size	string	Нет	Размер этикетки: s, m, l. По умолчанию: s

Формат itemNr

Инвентарный номер товара (itemNr) формируется из номера заказа с добавлением суффикса:

{orderNr}-001, {orderNr}-002, {orderNr}-003, ...

Например, для заказа RU250216-884060:

• Первый товар: RU250216-884060-001
• Второй товар: RU250216-884060-002
• Третий товар: RU250216-884060-003

Получить itemNr можно из ответа GET /api/v1/orders/{orderNr} — поле items[].id.

Запрос

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"
}'

Ответ

{
  "url": "https://storage.yandexcloud.net/yc-s3-prod-print-service01/abc123.pdf?...",
  "excludedItemNrs": []
}

Поле	Тип	Описание
url	string	Прямая ссылка на PDF-файл с этикетками
excludedItemNrs	array[string]	Номера товаров, не включённые в PDF (не найдены или не принадлежат партнёру)

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

GET /api/v1/label/packs

Генерирует PDF с этикетками для упаковок (посылок).

Только через API.

Паковые этикетки содержат данные маршрутизации от внутренних сервисов Lamoda. Самостоятельная генерация невозможна.

Параметры

Параметр	Тип	Обязательный	Описание
packNumbers	array[string]	Да	Массив номеров упаковок (от 1 до 100)
size	string	Нет	Размер этикетки: s, m, l. По умолчанию: m

Предварительный шаг: генерация pack numbers

Перед запросом этикеток нужно сгенерировать коды посылок:

GET /api/v1/orders/{orderNr}/pack-numbers
{
  "packQuantity": 5
}

// Ответ:
{
  "packNumbers": ["FBS7E5A016DB", "FBS7E5A016DC", "FBS7E5A016DD", "FBS7E5A016DE", "FBS7E5A016DF"]
}

✓ Можно запросить больше, чем нужно.

Если запросили 5 этикеток, а использовали только 2 — это нормально. При создании отгрузки (GET /api/v1/shipments/out) указывайте только реально использованные 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", "FBS7E5A016DC"],
    "size": "m"
}'

Ответ

{
  "url": "https://storage.yandexcloud.net/yc-s3-prod-print-service01/def456.pdf?...",
  "excludedPackNumbers": []
}

Примечание: Этикетка доступна сразу после получения pack number — задержка не требуется.

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

GET /api/v1/label/pallets

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

Параметры

Параметр	Тип	Обязательный	Описание
barcodes	array[string]	Да	Массив баркодов паллет (от 1 до 100)
size	string	Нет	Размер этикетки: s, m, l. По умолчанию: m

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

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

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

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

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

Запрос

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", "PALJVB054485226"],
    "size": "m"
}'

Ответ

{
  "url": "https://storage.yandexcloud.net/yc-s3-prod-print-service01/ghi789.pdf?...",
  "excludedBarcodes": []
}

Полный процесс получения этикеток

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

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

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

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

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

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

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

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

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

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

Сводная таблица параметров

Метод	Параметр	Размер по умолчанию	Excluded в ответе
GET /api/v1/label/items	itemNrs	s (58×40 мм)	excludedItemNrs
GET /api/v1/label/packs	packNumbers	m (75×120 мм)	excludedPackNumbers
GET /api/v1/label/pallets	barcodes	m (75×120 мм)	excludedBarcodes

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

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

См. также

• Создание отгрузки FBS
• FBS: обзор процесса
• Этикетки для отгрузок