Выпуск DataMatrix
| Дата | Магазин | Штрихкод | Название | Причина | ДатаМатрикс | Выпуск | Действия |
|---|
ТСД магазинов
Проверки марок, выпуск новых кодов и доступ терминалов.
Время проверки — ожидание ответа ЧЗ; время запроса — вся обработка запроса терминала. Выпуск марки учитывается отдельно.
Для каждого магазина используется отдельный ключ. Он даёт терминалу доступ только к операциям этого магазина. Полный ключ показывается один раз после создания.
Запросы: POST /api/integrations/tsd/v1/check. Передавайте ключ в Authorization: Bearer с сервера ТСД. В приложение терминала или PWA ключ не добавляйте.
Если старой марки нет
POST /api/integrations/tsd/v1/missing-label — отдельный запрос выпуска по штрихкоду товара (EAN). Терминал явно выбирает сценарий «Нет старой марки».
Передавайте стабильный unitId для каждой физической единицы товара. При повторе того же запроса используйте прежние unitId и requestId; у двух одинаковых товаров с одним EAN должны быть разные unitId.
Сохраните ключ в настройках сервера ТСД. После закрытия этого раздела посмотреть его повторно нельзя.
Склад Major
Проверки и запросы
Выпуск и доставка
Скорость работы
Время в Москве. Проверки отбираются по дате запроса, заявки — по дате создания; их дальнейший результат показан на момент построения. Повторы не считаются новыми проверками. FTP — файл загружен на сервер; WMS — Major подтвердил LOAD + OK.
| Этап | Среднее | 95% быстрее | Замеров |
|---|
Среднее и 95% рассчитаны только по известным завершённым этапам. Нет замеров — «нет данных», а не нулевая длительность. Чистое время проверки ЧЗ фиксируется с этого обновления; время ответа API включает обработку запроса и повторы. Полный путь от запроса включает проверку, очередь, выпуск и ожидание доставки.
По дням
| Дата | Запросов | Повторов | Сбоев API (5xx) | Новых заявок | Выпущено | Проверка ЧЗ · среднее | Выпуск с очередью · среднее | Запрос → FTP · среднее |
|---|
«Выпуск» показывает готовность марки в Честном знаке, «Доставка» — получение файла складом Major.
| Дата | Штрихкод | Название | Причина | ДатаМатрикс | Выпуск | Доставка | Действия |
|---|
| Время | Направление | HTTP | Заказ | Запрос | Ответ |
|---|
От проверки до готовой марки
- Major отправляет отсканированный DataMatrix в сервис по API. Сервис проверяет сведения о марке в Честном знаке и возвращает результат складу.
- Если проверка показала, что нужна новая марка, запрос с
autoIssue: trueсоздаёт заявку. Штрихкод товара без DataMatrix используется для заказа марки взамен утраченной. - В разделе Заявки и марки → Выпуск виден текущий этап. Код готов к передаче после подтверждения Честного знака. Ожидание ЧЗ продолжается автоматически.
- Готовые марки передаются в Major файлом MTXML HonestSignReserve. Выпуск марки и доставка файла — отдельные этапы.
Передача файла на склад
Пока реквизиты FTP не заполнены и автообмен не включён, сервис не отправляет файлы в Major. Подключение настраивается в Справочники → Склад Major. Загрузка состояния обмена…
- Ручная проверка файла. ИТ-сотрудник может выбрать период, нажать «XML для склада», проверить содержимое и выбрать «Скачать XML». Файл содержит полные коды DataMatrix; артикул (
Article) добавляется, если заполнен. Файл можно передать Major для проверки и загрузки. - Автоматическая отправка. После заполнения реквизитов, проверки подключения и включения автообмена новые готовые марки отправляются файлами в
PROD/IN. Ответы склада читаются изPROD/OUT; пути можно изменить в настройках. - Подтверждение загрузки.
TRANSFER + OKозначает приём файла промежуточной системой. ТолькоLOAD + OKподтверждает загрузку кодов в WMS — тогда доставка получает статус «Загружено в WMS».
Старые заявки, ручные выгрузки и доставки без однозначного подтверждения могут требовать допуска. Сначала уточните у Major, что коды ещё не загружены; затем ИТ-сотрудник может нажать «Допустить к отправке» или разрешить повтор доставки. Это помогает избежать повторной загрузки одних и тех же марок.
Если выпуск остановился
В колонке «Выпуск» показаны причина и доступное действие. «Журнал заявки» открывает подробности. Если причина исправлена и доступна кнопка «Продолжить выпуск», сервис продолжит эту же заявку с сохранёнными результатами.
При статусе «Нужна проверка» обратитесь в ИТ: запрос в ЧЗ мог выполниться без подтверждённого ответа. Новую заявку для того же товара создавать не нужно до сверки.
Получатели уведомлений об ошибках и ежедневного отчёта в 9:00 МСК задаются отдельно в Справочники → Склад Major, адреса — через запятую.
Что означают ответы проверки
| Ответ | Действие на складе |
|---|---|
{ "valid": true } | Марка прошла проверку сервиса. |
{ "valid": false } | Марка не прошла проверку; товар остаётся в карантине. |
{ "valid": false, "orderId": "…" } | Товар остаётся в карантине; заявка на новую марку создана. Её можно найти по orderId. |
HTTP 503 | Достоверный результат проверки не получен. Повторите проверку; новый код из-за недоступности ЧЗ не заказывается. |
Подключение API для разработчиков Major
POST https://datamatrix.anta-sport.ru/api/integrations/major/v1/check
Входящий API-ключ задаётся в справочнике Major и передаётся в заголовке Authorization: Bearer <ключ>. —
request — Base64 полной строки со сканера, включая GS-разделители, либо EAN-13. autoIssue по умолчанию false: выполняется только проверка.
При заказе марки передавайте уникальный requestId. Повтор того же запроса с тем же ID возвращает прежнюю заявку. Для другой единицы товара нужен новый ID. Повтор ID с другими данными возвращает 409.
Полная документация и примеры — docs/MAJOR_API.md в репозитории. «Лог обмена» содержит запросы и ответы; двойной клик по строке открывает подробности.