Работа с этикетками в API

Новость на модерации

Обновлено

18.12.2025

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

B2B Platform API 
FBS 
Новое с 01.11.2025 
 
 
Для FBS-отгрузок доступны три типа этикеток. Каждый тип генерируется отдельным методом и возвращает ссылку на PDF-файл. 
 
 Дата релиза: 1 ноября 2025 
Методы доступны на Production. 
<h2>Типы этикеток</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Тип</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Метод</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Назначение</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Товарные</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_items_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_items_get_label</a>" target="_blank">POST /api/v1/label/items</a></code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Наклеиваются на каждый товар</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Паковые</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_packs_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_packs_get_label</a>" target="_blank">POST /api/v1/label/packs</a></code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Наклеиваются на упаковку (коробку)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Паллетные</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_pallets_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_pallets_get_label</a>" target="_blank">POST /api/v1/label/pallets</a></code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Наклеиваются на паллету</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Общие параметры</h2> 
 
Все три метода принимают одинаковые параметры: 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Параметр</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Тип</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Обязательный</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>codes</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">array[string]</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Да</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Массив кодов (item numbers, pack numbers или pallet numbers)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>size</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Размер этикетки: <code>s</code>, <code>m</code>, <code>l</code>. По умолчанию: <code>m</code></td> 
</tr> 
</tbody> 
</table> 
 
<h3>Размеры этикеток</h3> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Размер</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Код</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Рекомендуется для</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Маленький</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>s</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Мелкие товары, ограниченное место</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Средний</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>m</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Стандартные упаковки (по умолчанию)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Большой</td> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>l</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Крупные коробки, паллеты</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Товарные этикетки</h2> 
 
<h4><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_items_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_items_get_label</a>" target="_blank">POST /api/v1/label/items</a></h4> 
Генерирует PDF с этикетками для товаров. 
 
POST <a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/label/items">https://api-b2b.lamoda.ru/api/v1/label/items</a><h3>Запрос</h3> 
 
<pre><code>curl -X POST <a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/label/items">https://api-b2b.lamoda.ru/api/v1/label/items</a> \ 
 -H "Authorization: Bearer YOUR_TOKEN" \ 
 -H "Content-Type: application/json" \ 
 -d '{ 
 "codes": [ 
 "ITEM001", 
 "ITEM002", 
 "ITEM003" 
 ], 
 "size": "m" 
}'</code></pre> 
 
<h3>Ответ</h3> 
 
<pre><code>{ 
 "url": "<a class="txttohtmllink" href="https://storage.lamoda.ru/labels/items/abc123.pdf">https://storage.lamoda.ru/labels/items/abc123.pdf</a>", 
 "expires_at": "2025-12-01T15:30:00Z" 
}</code></pre> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Поле</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Тип</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>url</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Прямая ссылка на PDF-файл с этикетками</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>expires_at</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string (ISO 8601)</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Время, до которого ссылка активна</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Паковые этикетки</h2> 
 
<h4><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_packs_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_packs_get_label</a>" target="_blank">POST /api/v1/label/packs</a></h4> 
Генерирует PDF с этикетками для упаковок (коробок). 
 
POST <a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/label/packs">https://api-b2b.lamoda.ru/api/v1/label/packs</a><h3>Запрос</h3> 
 
<pre><code>curl -X POST <a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/label/packs">https://api-b2b.lamoda.ru/api/v1/label/packs</a> \ 
 -H "Authorization: Bearer YOUR_TOKEN" \ 
 -H "Content-Type: application/json" \ 
 -d '{ 
 "codes": [ 
 "PACK001", 
 "PACK002" 
 ], 
 "size": "l" 
}'</code></pre> 
 
<h3>Ответ</h3> 
 
<pre><code>{ 
 "url": "<a class="txttohtmllink" href="https://storage.lamoda.ru/labels/packs/def456.pdf">https://storage.lamoda.ru/labels/packs/def456.pdf</a>", 
 "expires_at": "2025-12-01T15:30:00Z" 
}</code></pre> 
 
 Подсказка: Для получения pack numbers используйте метод <code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9F%D0%B0%D0%BA%D0%BE%D0%B2%D1%8B%D0%B5%20%D1%8D%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_post_generate_pack_numbers">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9F%D0%B0%D0%BA%D0%BE%D0%B2%D1%8B%D0%B5%20%D1%8D%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_post_generate_pack_numbers</a>" target="_blank">POST /api/v1/orders/{orderNr}/pack-numbers</a></code>. Подробнее: <a href="6_3_pack_numbers.html">Генерация pack numbers</a> 
<h2>Паллетные этикетки</h2> 
 
<h4><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_pallets_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_pallets_get_label</a>" target="_blank">POST /api/v1/label/pallets</a></h4> 
Генерирует PDF с этикетками для паллет. 
 
POST <a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/label/pallets">https://api-b2b.lamoda.ru/api/v1/label/pallets</a><h3>Запрос</h3> 
 
<pre><code>curl -X POST <a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/label/pallets">https://api-b2b.lamoda.ru/api/v1/label/pallets</a> \ 
 -H "Authorization: Bearer YOUR_TOKEN" \ 
 -H "Content-Type: application/json" \ 
 -d '{ 
 "codes": [ 
 "PALLET001" 
 ], 
 "size": "l" 
}'</code></pre> 
 
<h3>Ответ</h3> 
 
<pre><code>{ 
 "url": "<a class="txttohtmllink" href="https://storage.lamoda.ru/labels/pallets/ghi789.pdf">https://storage.lamoda.ru/labels/pallets/ghi789.pdf</a>", 
 "expires_at": "2025-12-01T15:30:00Z" 
}</code></pre> 
 
 Важно: Для генерации паллетных этикеток необходимо сначала создать поставку с паллетами через <code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BE%D1%82%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0%D0%BC%D0%B8%20FBS/post_api_1_post_shipment_out">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BE%D1%82%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0%D0%BC%D0%B8%20FBS/post_api_1_post_shipment_out</a>" target="_blank">POST /api/v1/shipments/out</a></code>. 
<h2>Ограничения</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Параметр</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Лимит</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Максимум кодов в одном запросе</td> 
<td style="border: 1px solid #ddd; padding: 8px;">100</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Время жизни ссылки на PDF</td> 
<td style="border: 1px solid #ddd; padding: 8px;">~1 час</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Типичные ошибки</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Код</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Сообщение</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Причина</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Решение</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">400</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Invalid codes</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Переданы несуществующие коды</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Проверьте, что коды существуют в системе</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">400</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Too many codes</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Превышен лимит 100 кодов</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Разбейте запрос на несколько</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">400</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Invalid size</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Неверный размер этикетки</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Используйте <code>s</code>, <code>m</code> или <code>l</code></td> 
</tr> 
</tbody> 
</table> 
 
<h2>Пример полного флоу</h2> 
 
<pre><code># 1. Получаем заказ 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_order_by_order_nr">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_order_by_order_nr</a>" target="_blank">GET /api/v1/orders/{orderId}</a> 
 
# 2. Подтверждаем сборку 
PUT /api/v1/orders/{orderId}/collected 
 
# 3. Генерируем pack numbers 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9F%D0%B0%D0%BA%D0%BE%D0%B2%D1%8B%D0%B5%20%D1%8D%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_post_generate_pack_numbers">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9F%D0%B0%D0%BA%D0%BE%D0%B2%D1%8B%D0%B5%20%D1%8D%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_post_generate_pack_numbers</a>" target="_blank">POST /api/v1/orders/{orderNr}/pack-numbers</a> 
{ 
 "count": 2 
} 
# Ответ: ["PACK001", "PACK002"] 
 
# 4. Получаем паковые этикетки 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_packs_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_packs_get_label</a>" target="_blank">POST /api/v1/label/packs</a> 
{ 
 "codes": ["PACK001", "PACK002"], 
 "size": "m" 
} 
# Ответ: {"url": "<a class="txttohtmllink" href="https://storage.lamoda.ru/labels/">https://storage.lamoda.ru/labels/</a>."} 
 
# 5. Скачиваем PDF и печатаем этикетки 
 
# 6. Создаём отгрузку 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BE%D1%82%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0%D0%BC%D0%B8%20FBS/post_api_1_post_shipment_out">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BE%D1%82%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0%D0%BC%D0%B8%20FBS/post_api_1_post_shipment_out</a>" target="_blank">POST /api/v1/shipments/out</a> 
{ 
 ... 
}</code></pre> 
 
 Подсказка: Этикетка доступна сразу после получения pack number — задержка не требуется. 
<h2>Устаревший метод</h2> 
 
 Deprecated: Старый метод <code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9F%D0%B0%D0%BA%D0%BE%D0%B2%D1%8B%D0%B5%20%D1%8D%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/get_api_1_get_reports_label_stream">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9F%D0%B0%D0%BA%D0%BE%D0%B2%D1%8B%D0%B5%20%D1%8D%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/get_api_1_get_reports_label_stream</a>" target="_blank">GET /api/v1/reports/label/stream</a></code> устарел. Используйте новые методы <code>/api/v1/label/*</code>. 
<h2>См. также</h2> 
 
<ul> 
<li><a href="5_5_1_item_labels.html">Товарные этикетки (подробно)</a></li> 
<li><a href="5_5_2_pack_labels.html">Паковые этикетки (подробно)</a></li> 
<li><a href="5_5_3_pallet_labels.html">Паллетные этикетки (подробно)</a></li> 
<li><a href="6_3_pack_numbers.html">Генерация pack numbers</a></li> 
<li><a href="5_2_create_shipment_fbs.html">Создание отгрузки FBS</a></li> 
</ul>

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

Да Нет

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

Отправить

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

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