Кейс: Веб‑платформа для КИЗ (Честный Знак): заказы, коды и этикетки
Система для централизованной работы с кодами маркировки: от авторизации и создания заказов до получения кодов, генерации DataMatrix и печати этикеток.
Создание заказа КИЗ
Список заказов и статус
Генерация DataMatrix
Скриншоты интерфейса КИЗ‑WEB
🧩 Задача
Нужно было автоматизировать весь цикл работы с КИЗ: авторизацию по ЭЦП, получение токенов, создание заказов по GTIN, получение кодов, генерацию DataMatrix и управление справочником GTIN/товарных групп. Важны контроль ошибок, удобный веб‑интерфейс и быстрые выгрузки для печати.
🛠 Реализация
- Веб‑интерфейс на Flask для авторизации и операционных действий
- Получение
client_tokenиbearer_tokenчерез API Честного Знака; кэширование в файлах и памяти - Учет нескольких аккаунтов:
thumbprint,oms_conn,oms_idс быстрым выбором - Создание заказов по списку GTIN: авто‑группировка по
productGroup, отправка батчами по 10 позиций, подпись через CryptoProcsptest - Локальные комментарии к заказам и логирование
releaseMethodType - Получение кодов КИЗ по заказам и сохранение в CSV
- Гибкие выгрузки: TXT/CSV с нормализацией управляющих символов для совместимости с Excel и принтерами
- Генерация DataMatrix PNG по кодам, пакетная обработка и скачивание ZIP‑архивом
- Шаблоны этикеток (в т.ч. 58×40 мм) на ReportLab для печати; подписи (01)…(21) и «сырой» код
- Справочник GTIN в Excel: пополнение из API (product info), редактирование
packageType, импорт/экспорт XLSX - Справочник «Поддерживаемые товарные группы»:
templateId, редактирование и сохранение в XLSX - Вкладка заказов: фильтр «скрыть обработанные», счётчики полученных кодов
- REST‑точки для интеграции: загрузка XLSX с позициями, обновления справочников, пакетная генерация DM и закрытие заказов
📈 Результат
Бизнес получил единое окно для работы с КИЗ: операторам больше не нужно переключаться между разными инструментами. Время на создание заказов и получение кодов сократилось в разы, стала доступна быстрая печать этикеток, а ошибки за счёт валидаций и логирования снизились.