Обзор маркировки в API

В России действует обязательная маркировка товаров средствами идентификации через систему "Честный ЗНАК". Lamoda B2B Platform поддерживает работу с маркированными товарами через API.

Категории товаров с обязательной маркировкой

На текущий момент обязательной маркировке на Lamoda подлежат:

Основные понятия

DataMatrix

Двумерный штрих-код, содержащий уникальный идентификатор товара. Состоит из нескольких частей:

• GTIN (14 символов) — глобальный идентификатор товара
• Серийный номер (13 символов) — уникальный номер единицы товара
• Код ТН ВЭД (опционально, 6 символов) — код товарной номенклатуры
• Криптохвост — электронная подпись

UIT (Unique Identification Token)

Сокращённая версия DataMatrix без криптохвоста. Именно UIT используется в API Lamoda.

Важно: Полный DataMatrix-код не хранится в системах Lamoda. При передаче через API код автоматически нормализуется до UIT.

Структура кода маркировки

Полный DataMatrix (с криптохвостом)

010467003301005321gJk6o54AQBJfX\u001d2406401\u001d91ffd0\u001d92LGYcm3FRQrRdNOO+8t0pz78QTyxxBmYKhLXaAS03jKV7oy+DWGy1SeU+BZ8o7B8+hs9LvPdNA7B6NPGjrCm34A==

Где:

• 01 — идентификатор применения (AI) для GTIN
• 0467003301005 — GTIN товара
• 21 — AI для серийного номера
• gJk6o54AQBJfX — серийный номер
• \u001d — GS-разделитель (Group Separator)
• 240 — AI для кода ТН ВЭД
• 6401 — код ТН ВЭД
• 91...92... — криптохвост

UIT (нормализованный для API)

# UIT с ТН ВЭД (38 символов)
010467003301005321gJk6o54AQBJfX2406401

# UIT без ТН ВЭД (31 символ)
010467003301005321gJk6o54AQBJfX

Передача маркировки через API

При создании поставки FBO

Код маркировки передаётся в поле datamatrixes при создании поставки:

POST /api/v1/shipments/fulfilment

{
  "id": "SHIP-2025-001234",
  "items": [
    {
      "sku": "SELLER-SKU-001",
      "ean": "4600000000001",
      "quantity": 2,
      "price": 5000.00,
      "datamatrixes": [
        "010467003301005321gJk6o54AQBJfX2406401",
        "010467003301005321hKl7p65BRCKgY2406401"
      ]
    }
  ]
}

При создании отгрузки FBS

Код маркировки передаётся на уровне товара:

POST /api/v1/shipments/out

{
  "id": "OUT-2025-005678",
  "containers": [
    {
      "barcode": "FBS123456",
      "type": "pack",
      "items": [
        {
          "orderNr": "CZ117391950",
          "sku": "XD001XW03JMM",
          "unitload": "RU250909-123456-001",
          "datamatrix": "010467003301005321gJk6o54AQBJfX2406401"
        }
      ]
    }
  ]
}

Получение кодов маркировки

Lamoda возвращает UIT товаров в следующих случаях:

В нотификациях о поставках FBO

{
  "type": "fulfilmentShipmentStatusChanged",
  "data": {
    "shipmentId": "SHIP-2025-001234",
    "status": "received",
    "items": [
      {
        "sku": "SELLER-SKU-001",
        "datamatrixes": [
          "010467003301005321gJk6o54AQBJfX2406401",
          "010467003301005321hKl7p65BRCKgY2406401"
        ]
      }
    ]
  }
}

В нотификациях о заказах

{
  "type": "itemStatusChanged",
  "data": {
    "id": "CZ117391950",
    "items": [
      {
        "sku": "SELLERSKU104",
        "status": "Delivered",
        "datamatrix": "010467003301005321gJk6o54AQBJfX2406401"
      }
    ]
  }
}

Статусы товаров с маркировкой

При проблемах с кодом маркировки товар получает специальные статусы:

Обработка скрытых символов

При передаче DataMatrix через API учитывайте скрытые символы-разделители:

Услуги маркировки на складе Lamoda

Для FBO-партнёров доступна услуга маркировки русской этикеткой на складе Lamoda:

• Одежда — согласно ТР ТС 017/2011
• Обувь — согласно ТР ТС 017/2011
• Детские товары — согласно ТР ТС 007/2011
• Парфюмерия и косметика — согласно ТР ТС 009/2011
• Игрушки — согласно ТР ТС 008/2011

Для подключения услуги обратитесь к своему менеджеру.

Нотификации о проблемах с маркировкой

Lamoda отправляет email-уведомления о блокировке товаров с проблемами маркировки. В письме содержится ссылка на раздел "Датаматрикс" в Личном кабинете, где можно:

• Просмотреть список заблокированных товаров
• Экспортировать отчёт в XLSX
• Загрузить новые коды маркировки

Best practices

1. Валидируйте коды — проверяйте длину и формат UIT перед отправкой
2. Сохраняйте соответствие — храните связку SKU → DataMatrix на своей стороне
3. Обрабатывайте GS-символы — убедитесь, что JSON-парсер корректно обрабатывает \u001d
4. Мониторьте статусы — отслеживайте нотификации о проблемах с маркировкой
5. Используйте UIT — не передавайте полный DataMatrix с криптохвостом

См. также

• Коды маркировки CIS
• Работа с DataMatrix
• Создание поставки FBO
• Создание отгрузки FBS