Десять лет протокола интеграции ՀԴՄ Армении

Два параллельных потока документов

КГД публикует (и переиздаёт) две разные категории кассовой документации:

• Пользовательские мануалы — для продавца / бухгалтера: как зарегистрировать кассу, как печатать счета, как настраивается WiFi-модуль, как строятся X / Z отчёты. Onboarding и мануал по налоговым счетам 2013–2014 — Ашота Петросянаarchive; инструкция по WiFi-VPN от 27 февраля 2014archive — Гургена Нерсесяна, его самый ранний известный артефакт по ՀԴՄ от КГД, за год до того как он подхватил интеграционную линию в 2015. Поздние добавления: руководство пользователя по налоговым счетам, июнь 2017archive (Анна Бучацкая), руководство пользователя ПО ККМ v3.0, февраль 2019archive (без персональной подписи) и операционная заметка по расщеплённой оплате, март 2019archive (Лусине Айвазян).
• Интеграционные мануалы — для разработчика, который связывает POS / учётную / e-commerce-систему с кассой. Автор — Гурген Нерсесян, 2015–2022; затем «Stefan» — с 2021 (первый мануал по электронному ՀԴՄ) и с 2023 (основная линия).

У двух потоков разные аудитории, разный ритм и разные конвенции версионирования. Изначально они публиковались рядом на petekamutner.am, в общей папке «New Generation CCMs» внутри дерева оперативных документов налоговой — пролистать архивную директорию на Wayback Machine. Современный HDM-хаб КГД на src.am/144 сегодня хостит только текущие версии (v0.72 и v0.73 интеграционного мануала, апрельский 2026 мануал электронного ՀԴՄ и пару легаси-PDF по операциям); всё историческое ниже доступно только через Internet Archive.

Самые ранние документы (2013–2014)

• 16 августа 2013 — «Приобретение, регистрация и снятие с регистрации ККМ нового типа»archive, автор — Ашот Петросян. 15 страниц. Первое onboarding-руководство в архиве — опубликовано примерно когда ГНКО «Бюро внедрения ККМ» проработало около года и рынок знакомили с «новым типом» касс.
• 27 мая 2014 — руководство пользователя по регистрации налоговых счетовarchive, автор — Ашот Петросян. 36 страниц. Заголовок PDF всё ещё «Государственная налоговая служба», хотя её включили в КГД пятью годами раньше — старое название долго оставалось во внутренних документах подразделений.

Релизы интеграционного протокола (2015–2025)

Каждый найденный релиз — с датой из PDF-метаданных (не из имени файла, иногда расходится на месяцы) и автором из PDF-полей:

Самая ранняя спецификация — v0.3, апрель 2015 — уже задаёт ту форму, которую протокол использует и сегодня: TCP между кассой и POS, JSON-кодированные запросы и ответы, шифрование 3DES, базовый набор verb-ов «логин оператора / печать чека / печать отчёта». Последующие версии добавили flow-ы предоплаты / постоплаты, формы счетов, возвраты и корректировки, а с v0.7+ — более богатые метаданные. Объём вырос с 17 до 37 страниц — примерно в 2,2 раза — за десять лет.

Два названных ведущих автора

Здесь метаданные показывают то, что регулятор публично нигде не комментировал:

• Гурген Нерсесян — автор каждого интеграционного мануала с 2015 по декабрь 2022, восемь лет непрерывного развития под одной подписью. Эволюция v0.3 → v0.4 → v0.5 → v0.51 → v0.6 → v0.61 → v0.7 — его.
• «Stefan» — автор первого electronic-HDM мануала (12 июля 2021) и затем всей пост-Нерсесяновской линии интеграционного протокола: v0.71 (июнь 2023), v0.72 (сентябрь 2023), ноябрьская 2024 редакция eHDM, переизданный v0.72 (апрель 2025), v0.73 (апрель 2025) и eHDM апреля 2026. Шесть релизов за три года, поочерёдно между железной и электронной линиями.

Ни одно имя не аннотировано как автор где-либо на самом src.am — оба восстановлены из PDF-полей метаданных, что любой читатель может перепроверить через pdfinfo на связанных артефактах. Имена приведены как факт об источнике, не как утверждение о формальном авторстве или текущей занятости.

2021: виртуальный ՀԴՄ отделяется от железного

Самый крупный разрыв в этом архиве — мануал «electronic HDM» от 12 июля 2021archive, 22 страницы, автор — Stefan, опубликован в декабре 2021. Здесь виртуальный / программный ՀԴՄ отделился от протокола железной кассы — за три года до того как поправка N 1720-Լ от 25 декабря 2024 формально оформила регуляторную рамку под нового адресата.

Политическое намерение оформилось ещё раньше — в сентябре 2019 КГД публично обсуждал «Электронную торговлю и виртуальный ՀԴՄ» (подробно — на Железная или виртуальная касса). Хронология: политическая рамка 2019 → техническая спецификация середина-2021 → публикация декабрь-2021 → регуляторная поправка конец-2024.

После 2021 сосуществуют два протокола: классический интеграционный мануал продолжает развиваться (v0.7 в 2022, v0.71 в 2023, v0.73 в 2025), а у eHDM-линии — свой отдельный мануал, который существенно переработали — с 22 страниц в декабре 2021 до 37 страниц в ноябре 2024 — перед текущей версией от апреля 2026.

Одна странность, которую стоит зафиксировать: ярлык «v0.72» был применён к двум разным файлам — один опубликован 15 сентября 2023 (33 страницы), другой переиздан 1 апреля 2025 (34 страницы). Временные метки и хеши контента различаются, но КГД сохранил один и тот же номер версии. Если у вас лежит локальная копия «v0.72» и вы хотите понять, версия 2023 или 2025 — сравните размер файла или число страниц.

Что это значит для интеграторов

Если вы строите софт против кассы сегодня, вы читаете v0.73 (или текущую опубликованную версию на HDM-хабе КГД). Но понимание истории версий полезно тремя практическими способами:

• Семантика полей дрейфует. Чек v0.61 может включать или не включать поля, которые v0.7 сделала обязательными. Если у вас интеграции, обслуживающие чеки со старых устройств, знание когда каждое поле появилось помогает в дебаге.
• Преемственность авторства реальна. Восемь лет под одной ведущей подписью означали стабильный design vocabulary. Передача в 2023 другому автору — момент, когда стоит ожидать больше shape-изменений на релиз.
• Совместимость железа и виртуала. С 2021 у двух треков отдельные документы и в принципе они могут разойтись; на практике они делят JSON-конверт и verb-ы оператора/логина, но убедиться что ваша интеграция корректно обрабатывает оба, можно только пройдя оба мануала параллельно.

Источники

• Все PDF версий выше слинкованы через реестр артефактов с Wayback-снимками petekamutner.am.
• Текущий мануал v0.73 опубликован на HDM-хабе КГД и заархивирован как артефактarchive.
• Атрибуция авторов взята из полей Author и CreationDate каждого PDF, читаемых через pdfinfo. Мы не сверяли её ни с каким внешним источником.