ESP Logo

ESM Checkmarks Emulator

Эмулятор единого сервисного модуля

Инструкция по использованию эмулятора

Добро пожаловать в эмулятор системы маркировки! Здесь вы можете тестировать различные сценарии работы с маркированными товарами.
Быстрый старт
Как начать работу:
  1. Выберите категорию марки во вкладках выше
  2. Скопируйте Data Matrix код нажатием на него
  3. Протестируйте API используя примеры ниже
  4. Проверьте различные сценарии с помощью специальных кодов ошибок
Тестовые марки

Для тестирования используйте следующие разделы:

  • Общий - марки общего назначения (тег #classic)
  • Аптеки - лекарственные препараты (тег #heal)
  • Легкая промышленность - товары ЛП (тег #LI)
Ошибки и таймауты

В эмуляторе реализованы специальные коды для тестирования:

  • HTTP ошибки (400, 500, 504)
  • Таймауты ответа
  • Аварийный режим (203)
  • Специальные коды ответа (5000)
REST API Endpoints
Доступные методы API для тестирования:
Метод URL Описание Пример тела запроса
POST /api/v1/codes/check Онлайн проверка марок {
"codes": ["MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg=="],
"client_info": {
"name": "Name",
"version": "1.0",
"id": "12343",
"token": "xxxx-yyyy-xzzzz"
}
}
POST /api/v2/codes/check Онлайн проверка марок {
"codes": ["MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg=="],
"client_info": {
"name": "Name",
"version": "1.0",
"id": ""8866a527-8da1-4ac9-b48b-b2b88f692a29",
"token": "xxxx-yyyy-xzzzz"
}
}
POST /api/v1/info Информация о кассовом аппарате {
"tspiotId": "00106322849758",
"kktSerial": "00106322849258",
"fnSerial": "9999078902016936",
"kktInn": "9717169621",
"codesCheckTimeout": 1800
}
Пример использования API:
Запрос
POST /api/v1/codes/check
Content-Type: application/json

{
  "codes": ["MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg=="],
  "client_info": {
    "name": "1c Управление торговлей",
    "version": "7.7",
    "id": "12343",
    "token": "xxxx-yyyy-xzzzz"
  }
}
Ответ
HTTP/1.1 200 OK
Content-Type: application/json

{
  "codesResponse": {
    "codesResponse": [{
      "code": 0,
      "description": "ok",
      "codes": [{
        "cis": "0104670540176099215'W9Um93dGVz",
        "dataMatrix": "MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg==",
        "found": true,
        "valid": true,
        "printView": "0104670540176099215'W9Um",
        "gtin": "04670540176099",
        "groupIds": [8],
        "verified": true,
        "realizable": false,
        "utilised": false,
        "isBlocked": false,
        "ogvs": [],
        "errorCode": 0,
        "isTracking": false,
        "sold": false,
        "grayZone": false,
        "packageType": "UNIT",
        "producerInn": "7725344604"
      }],
      "reqId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "reqTimestamp": 1704067200000,
      "isCheckedOffline": false
    }]
  }
}
Запрос
POST /api/v2/codes/check
Content-Type: application/json

{
  "codes": ["MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg=="],
  "client_info": {
    "name": "1c Управление торговлей",
    "version": "7.7",
    "id": "12343",
    "token": "xxxx-yyyy-xzzzz"
  }
}
Ответ
HTTP/1.1 200 OK
Content-Type: application/json

{
    "codesResponse": [{
      "code": 0,
      "description": "ok",
      "codes": [{
        "cis": "0104670540176099215'W9Um93dGVz",
        "dataMatrix": "MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg==",
        "found": true,
        "valid": true,
        "printView": "0104670540176099215'W9Um",
        "gtin": "04670540176099",
        "groupIds": [8],
        "verified": true,
        "realizable": false,
        "utilised": false,
        "isBlocked": false,
        "ogvs": [],
        "errorCode": 0,
        "isTracking": false,
        "sold": false,
        "grayZone": false,
        "packageType": "UNIT",
        "producerInn": "7725344604"
      }],
      "reqId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "reqTimestamp": 1704067200000,
      "isCheckedOffline": false
    }]
}
Специальные марки для тестирования ошибок

Следующие Data Matrix коды возвращают специальные ответы для тестирования обработки ошибок:

Data Matrix код Тип ошибки HTTP Статус Категория Описание и поведение
400 Ошибка 400 Общая Bad Request - некорректный запрос от клиента. Неверный формат или параметры запроса.
MDEwNDY3MDU0MDE3NjA5OTIxNUxwR0t5HTkzZEdWeg== 203 Ошибка 203 Общая Аварийный режим работы системы. Возвращает простой формат ответа с кодом ошибки.
MDEwNDYwMTkwNzAwMjgwNTIxNXdKblVXeXFFRUczeB05MUYwMTMdOTJFUFBjSTNhSGY0K1hUeURhMVVSZWptRmxxRU93d1RsUjlnZG5kU25FZHdrPQ== 203 Ошибка 203 Аптеки Аварийный режим для лекарственных препаратов. Возвращает простой формат ответа.
MDEwNDYwNzgwOTU5NjIzNzIxNWNocFZLdk1PRkl0TB05MUZGRDAdOTJkR1Z6ZEZ4dS9MOTYwTVc2SU5rbzhMWjBMbk1mQldwTmo0SHh1VlNSaDRZPQ== 203 Ошибка 203 Легкая пром. Аварийный режим для товаров легкой промышленности. Возвращает простой формат ответа.
MDEwNDgxMzQ0NTAwMzI5MzIxNVRtaVYsZx05M2RHVno= 5000 Ошибка 200 Общая Специальная ошибка для тестирования нестандартных кодов ответа в формате codesResponse.
MDEwNDYwMTkwNzAwMjgwNTIxNUlVcVVXdmp4bnVTTh05MUYwMTMdOTJFaTF4V1pNMVllMlFPYi9tbWtMdXlyQWxYelB3SFNuWlNSRHB6VVUrcUNBPQ== 5000 Ошибка 200 Аптеки Специальная ошибка для лекарственных препаратов в формате codesResponse.
MDEwNDYwNzgwOTU5NjIzNzIxNTwocSFtTHAqakliMx05MUZGRDAdOTJkR1Z6ZER5dnRxdWlXUEV3cStiaGVmNjd5Qm11K3BpQTI4em9PZHBXYkNZPQ== 5000 Ошибка 200 Легкая пром. Специальная ошибка для товаров легкой промышленности в формате codesResponse.
MDEwNDY3MDU0MDE3NjA5OTIxNSFwR0t5HTkzZEdWeg== 504 Ошибка 200 Общая Gateway Timeout - превышено время ожидания ответа от upstream сервиса.
MDEwNDY3MDU0MDE3NjA5OTIxNVBwR0t5HTkzZEdWeg== 500 Ошибка 200 Общая Internal Server Error - внутренняя ошибка сервера при обработке запроса.
MDEwNDgxMzQ0NTAwMzI5MzIxNVRtaVYsZ1x1MDAxZDkzZEdWeg== 514 Ошибка 514 Общая Таймаут соединения. Не удалось получить ответ от ГИС МТ или ЛМ ЧЗ за 1800мс.
MDEwNDY3MDU0MDE3NjA5OTIxNU1wR0t5HTkzZEdWeg== Таймаут 200 Общая Имитация длительной обработки запроса с последующим успешным ответом.
MDEwNDYwNzAxMDM1MDI0NjIxNWtSZEctMSVXKFVtbh05M2RHVno= 5000 Ошибка 200 Общая Дополнительная марка для тестирования 5000 ошибки.