CIS-коды

CIS (Code of Individual Serialization) — уникальный код идентификации единицы товара в системе "Честный ЗНАК". В контексте Lamoda API используется формат UIT (Unique Identification Token).

Формат UIT для API

При работе с Lamoda API используется нормализованный формат UIT:

Полный DataMatrix-код автоматически нормализуется до UIT при получении через API. Подробнее о структуре DataMatrix и нормализации: Работа с DataMatrix.

Разбор структуры UIT

Рассмотрим код: 010467003301005321gJk6o54AQBJfX2406401

⚠ Примечание о серийном номере: Серийный номер (AI 21) может содержать не только буквы и цифры, но и спецсимволы из набора GS1 (ASCII 33–122: !, ", %, &, / и др.). Lamoda ожидает серийный номер длиной ровно 13 символов.

Передача в API

Поставка FBO с маркировкой

Поле datamatrixes (множественное число) — массив строк. Количество элементов должно совпадать с quantity.

curl -X POST "https://api-b2b.lamoda.ru/api/v1/shipments/fulfilment" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "SHIP-2025-001",
    "items": [
      {
        "sku": "SELLER-SHOES-001",
        "ean": "4670033010053",
        "quantity": 2,
        "price": 5000.00,
        "datamatrixes": [
          "010467003301005321gJk6o54AQBJfX2406401",
          "010467003301005321hKl7p65BRCKgY2406401"
        ]
      }
    ]
  }'

На стороне Lamoda каждый DataMatrix хранится с типом: RECEIVED (переданный продавцом) или ACCEPTED (подтверждённый WMS).

Отгрузка FBS с маркировкой

Поле datamatrix (единственное число) — строка, один код на item.

curl -X POST "https://api-b2b.lamoda.ru/api/v1/shipments/out" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "OUT-2025-001",
    "containers": [
      {
        "barcode": "FBS123456",
        "type": "pack",
        "items": [
          {
            "orderNr": "CZ117391950",
            "sku": "XD001XW03JMM",
            "unitload": "RU250909-123456-001",
            "datamatrix": "010467003301005321gJk6o54AQBJfX2406401"
          }
        ]
      }
    ]
  }'

Получение UIT из нотификаций

Lamoda возвращает UIT в webhook-нотификациях. Коды маркировки не возвращаются в ответах на GET-запросы к API.

Нотификация о статусе товара (FBS)

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

Нотификация о поставке (FBO)

{
  "type": "fulfilmentShipmentStatusChanged",
  "data": {
    "shipmentId": "SHIP-2025-001",
    "status": "received",
    "items": [
      {
        "sku": "SELLER-SHOES-001",
        "quantity": 3,
        "receipt": 3,
        "datamatrixes": [
          "010467003301005321gJk6o54AQBJfX2406401",
          "010467003301005321hKl7p65BRCKgY2406401",
          "010467003301005321iMm8q76CSELhZ2406401"
        ]
      }
    ]
  }
}

Обратите внимание на разницу в именах полей: datamatrixes (массив) для FBO-поставок и datamatrix (строка) для FBS-заказов.

Ошибки при передаче кодов

См. также

• Обзор маркировки — категории, статусы, обязательность
• DataMatrix — структура, валидация, нормализация
• Создание поставки FBO
• Создание отгрузки FBS