«Честный Знак» — это государственная система маркировки лекарств в России. На каждой упаковке есть уникальный код. При продаже его сканируют на кассе, факт продажи улетает в систему государства. Если этого не делать — штрафы, в худшем случае отзыв лицензии.
У этой интеграции среди айтишников плохая репутация. Когда я только взялся, я и сам морально готовился к двум месяцам мучений — все статьи в интернете на эту тему написаны как страшилки. Залез — оказалось не страшно. Просто скучная бюрократия, обёрнутая в технические термины.
Внутри это обычное REST API. Единственная заковыка — авторизация через ГОСТ-сертификат. Это криптографический ключ, выпущенный аккредитованным удостоверяющим центром. Звучит пугающе, на деле — настроил один раз, ключ лежит на сервере, всё остальное работает само. День мороки и забыл.
Дальше начинаются методы — их штук пятнадцать. Регистрация продажи, перемаркировка, передача между юрлицами, возвраты. На реальной аптеке из них нужны два-три, остальное — для оптовиков и производителей. Документация есть, она тяжёлая в чтении, но если методично разобраться — за неделю всё будет работать.
Главный лайфхак, который не написан в их документации. Не отправляй продажу в ЧЗ синхронно. Никогда.
Если каждая продажа в кассе ждёт ответа от ЧЗ — кассир будет страдать. У них бывают медленные часы, технические работы, просто плохое настроение у сервера. Кассир в этот момент стоит с покупателем и не может закрыть чек.
Правильный путь: продажа фиксируется локально и сразу идёт в очередь. Очередь раз в минуту-две отправляет накопившиеся продажи в ЧЗ пачкой. Если что-то не дошло — ретрай через минуту. Кассир ничего не замечает. Государство получает данные с задержкой в минуту-две, что им абсолютно нормально.
Большинство «адских интеграций» оказываются адом из-за неправильного подхода. Если делать через очередь и ретраи — превращается в обычный кусок инфраструктуры. Скучный и работающий.