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

Статья на модерации

Обновлено

26.12.2025

Содержание статьи

B2B Platform API FBS Новое с 01.11.2025

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

Дата релиза: 1 ноября 2025
Методы доступны на Production.

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

Тип	Метод	Назначение
Товарные	`POST /api/v1/label/items`	Наклеиваются на каждый товар
Паковые	`POST /api/v1/label/packs`	Наклеиваются на упаковку (коробку)
Паллетные	`POST /api/v1/label/pallets`	Наклеиваются на паллету

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

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

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

POST /api/v1/label/items

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

Параметры

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

Запрос

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 (не найдены или не принадлежат партнёру)

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

POST /api/v1/label/packs

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

Параметры

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

Запрос

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 numbers используйте метод POST /api/v1/orders/{orderNr}/pack-numbers.

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

POST /api/v1/label/pallets

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

Параметры

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

Запрос

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": []
}

Важно: Для генерации паллетных этикеток необходимо сначала создать поставку с паллетами через POST /api/v1/shipments/out.

Ограничения

Параметр	Лимит
Максимум элементов в одном запросе	100
Время жизни ссылки на PDF	~42 часа

Типичные ошибки

Код	Сообщение	Причина	Решение
400	Invalid codes	Переданы несуществующие коды	Коды попадут в excluded* массив, PDF сгенерируется без них
400	Too many codes	Превышен лимит 100 элементов	Разбейте запрос на несколько
400	Invalid size	Неверный размер этикетки	Используйте `s`, `m` или `l`
—	url = ""	Все коды невалидны	Проверьте, что коды существуют и принадлежат вашему партнёру

Пример полного флоу

# 1. Получаем заказы
GET /api/v1/orders?status=Confirmed

# 2. Генерируем pack numbers для заказа
POST /api/v1/orders/{orderNr}/pack-numbers
{"packQuantity": 1}
# Ответ: {"packNumbers": ["FBS7E5A016DB"]}

# 3. Получаем паковые этикетки
POST /api/v1/label/packs
{"packNumbers": ["FBS7E5A016DB"], "size": "m"}
# Ответ: {"url": "https://storage.yandexcloud.net/..."}

# 4. Скачиваем PDF и печатаем этикетки

# 5. Создаём отгрузку
POST /api/v1/shipments/out
{...}

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

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

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

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

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

См. также

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

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

Да Нет

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

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