Обзор маркировки
В России действует обязательная маркировка товаров средствами идентификации через систему "Честный ЗНАК". Lamoda B2B Platform Partner API поддерживает работу с маркированными товарами через API.
Категории товаров с обязательной маркировкой
На текущий момент обязательной маркировке на Lamoda подлежат:
| Категория | Дата введения | Статус |
| Обувь | 1 июля 2020 | Обязательно |
| Одежда (отдельные категории) | 1 января 2021 | Обязательно |
| Парфюмерия | 1 октября 2020 | Обязательно |
| Товары лёгкой промышленности | Поэтапно с 2021 | Обязательно |
Основные понятия
| Термин | Описание |
| DataMatrix | Полный двумерный штрих-код с криптохвостом (~150 символов). Содержит GTIN, серийный номер, опционально код ТН ВЭД и электронную подпись. |
| UIT | Unique Identification Token — сокращённая версия DataMatrix без криптохвоста. Длина 31 символ (без ТН ВЭД) или 38 символов (с ТН ВЭД). Именно UIT используется в API Lamoda. |
| CIS | Code of Individual Serialization — уникальный код идентификации единицы товара в системе "Честный ЗНАК". В контексте API Lamoda эквивалентен UIT. |
Полный DataMatrix-код не хранится в системах Lamoda — при передаче через API он автоматически нормализуется до UIT. Подробнее о формате: CIS-коды, о структуре и парсинге: Работа с DataMatrix.
Как передавать коды маркировки
| Сценарий | Поле API | Тип | Подробнее |
| Поставка FBO |
datamatrixes
|
Массив строк (количество = quantity)
|
Примеры запросов |
| Отгрузка FBS |
datamatrix
|
Строка (один код на item) | Примеры запросов |
| Получение кодов | Через нотификации | — | Примеры нотификаций |
⚠ Важно: Коды маркировки возвращаются только через webhook-нотификации, а не через GET-запросы к API (например, GET /api/v1/shipments/fulfilment/{id}/items не содержит DataMatrix).
Обязательность маркировки (DataMatrixNecessity)
Для каждого товара в поставке/отгрузке Lamoda сообщает уровень обязательности маркировки через поле dataMatrixNecessity (FBS) / dataMatrixMarkingNecessity (FBO):
| Значение | Описание | Нужно ли передавать DM? |
REQUIRED
|
Маркировка обязательна по закону для данной категории товара | Да |
OPTIONAL
|
Маркировка рекомендована (например, товар в переходном периоде) | Да — Lamoda ожидает DataMatrix и при статусе OPTIONAL |
NOT_REQUIRED
|
Маркировка не требуется для данного товара | Нет |
⚠ Важно: И REQUIRED, и OPTIONAL предполагают передачу кодов маркировки.
Статусы товаров с маркировкой
При проблемах с кодом маркировки товар получает специальные статусы:
| Статус API | Отображение в ЛК | Описание |
Need DM
|
Требуется код маркировки | Товар заблокирован, требуется перемаркировка. Ожидайте нотификацию. |
Waiting DM
|
Ожидает код маркировки | Партнёру отправлена нотификация. Загрузите новый код. |
Received DM
|
Получен новый код | Новый код получен, товар направлен на перемаркировку. |
Waiting for assignation
|
Ожидает наклейки | Выполняется перемаркировка на складе. |
Lost DM
|
Потерян код маркировки | Партнёр не может предоставить новый код. Требуется коммуникация с менеджером. |
Нотификации о проблемах с маркировкой
Lamoda отправляет email-уведомления о блокировке товаров с проблемами маркировки. В письме содержится ссылка на раздел "Датаматрикс" в Личном кабинете, где можно:
- Просмотреть список заблокированных товаров
- Экспортировать отчёт в XLSX
- Загрузить новые коды маркировки
Услуги маркировки на складе Lamoda
Для FBO-партнёров доступна услуга маркировки русской этикеткой на складе Lamoda:
- Одежда — согласно ТР ТС 017/2011
- Обувь — согласно ТР ТС 017/2011
- Детские товары — согласно ТР ТС 007/2011
- Парфюмерия и косметика — согласно ТР ТС 009/2011
- Игрушки — согласно ТР ТС 008/2011
Для подключения услуги обратитесь к своему менеджеру.
Рекомендации по использованию
- Валидируйте коды — проверяйте длину (31 или 38 символов) и формат UIT перед отправкой (правила валидации)
- Проверяйте
dataMatrixNecessity— передавайте коды для товаров со значениемREQUIREDиOPTIONAL - Сохраняйте соответствие — храните связку SKU → DataMatrix на своей стороне
- Обрабатывайте GS-символы — убедитесь, что JSON-парсер корректно обрабатывает
\u001d(подробнее) - Мониторьте статусы — отслеживайте нотификации о проблемах с маркировкой
- Используйте UIT — не передавайте полный DataMatrix с криптохвостом (нормализация)
- Получайте DM из нотификаций — коды маркировки возвращаются только через webhook-нотификации
См. также
Помогла эта информация?
Спасибо за отзыв
