Հայաստանի ՀԴՄ-ի ինտեգրման արձանագրության տասը տարի

Փաստաթղթերի երկու զուգահեռ հոսք

ՊԵԿ-ը հրապարակում է (և վերահրապարակում) կասսայի փաստաթղթավորման երկու տարբեր կատեգորիա.

• Օգտվողի ձեռնարկներ — վաճառողի / հաշվապահի համար. ինչպես գրանցել կասսա, ինչպես տպել հաշիվ, ինչպես է կարգավորվում WiFi-մոդուլը, ինչպես են կազմվում X / Z հաշվետվությունները։ 2013–2014-ի onboarding-ը և հարկային հաշիվների ուղեցույցը Աշոտ Պետրոսյանիarchive աշխատանքն է. 2014 թվականի փետրվարի 27-ի WiFi-VPN-ի կարգաբերման նշումըarchive Գուրգեն Ներսեսյանի ամենավաղ ՊԵԿ-ի ՀԴՄ-արտեֆակտն է, ինտեգրման գիծը 2015-ին վերցնելուց մեկ տարի առաջ։ Հետագա հավելումներ՝ 2017 թվականի հունիսի՝ հարկային հաշիվների օգտվողի ձեռնարկarchive (Աննա Բուչացկայա), 2019 թվականի փետրվարի՝ ՀԴՄ ծրագրաշարի օգտվողի ուղեցույց v3.0archive (առանց անհատական ստորագրության) և 2019 թվականի մարտի՝ պառակտված-վճարման գործառնական նշումըarchive (Լուսինե Այվազյան)։
• Ինտեգրման ուղեցույցներ — ծրագրավորողի համար, որը կասսան կապում է 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)

• 2013 թվականի օգոստոսի 16 — «Նոր տեսակի ՀԴՄ-ների ձեռքբերում, գրանցում և գրանցումից հանում»archive, հեղինակ՝ Աշոտ Պետրոսյան։ 15 էջ։ Արխիվում առաջին onboarding-ուղեցույցը — հրապարակվել է մոտավորապես այն ժամանակ, երբ «ՀԴՄ ներդրման գրասենյակ» ՊՈԱԿ-ն աշխատել էր մոտ մեկ տարի, և շուկան ծանոթացնում էին «նոր տեսակի» կասսաների հետ։
• 2014 թվականի մայիսի 27 — Հարկային հաշիվների գրանցման օգտվողի ձեռնարկ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 ուղեցույցի (2021 հուլիս 12) հեղինակը, և ապա ողջ հետ-Ներսեսյանյան ինտեգրման գծի հեղինակը՝ v0.71 (2023 հունիս), v0.72 (2023 սեպտեմբեր), 2024 թվականի նոյեմբերի eHDM վերանայում, վերահրապարակված v0.72 (2025 ապրիլ), v0.73 (2025 ապրիլ) և 2026 ապրիլի eHDM։ Վեց թողարկում երեք տարում, հերթականությամբ՝ սարքավորման և էլեկտրոնային գծերի միջև։

Ոչ մի անուն չի վերագրված որպես հեղինակ որևէ տեղ ինքը src.am-ում — երկուսն էլ վերականգնված են PDF-մետատվյալների դաշտերից, որը ցանկացած ընթերցող կարող է վերաստուգել կապված արտեֆակտների վրա pdfinfo-ով։ Անունները ներկայացնում ենք որպես աղբյուրի վերաբերյալ փաստ, ոչ թե որպես պաշտոնական հեղինակության կամ ընթացիկ զբաղվածության մասին հայտարարություն։

2021. վիրտուալ ՀԴՄ-ն բաժանվում է սարքավորման ՀԴՄ-ից

Արխիվում ամենամեծ ընդհատումը 2021 թվականի հուլիսի 12-ի «electronic HDM» ուղեցույցն էarchive, 22 էջ, հեղինակ՝ Stefan, հրապարակվել է 2021 դեկտեմբերին։ Այստեղ վիրտուալ / ծրագրային ՀԴՄ-ն բաժանվել է կասսայի սարքավորման արձանագրությունից — երեք տարի շուտ, քան 2024 թվականի դեկտեմբերի 25-ի N 1720-Լ փոփոխությունը ձևակերպեց կարգավորիչ դաշտը նոր հասցեատիրոջ համար։

Քաղաքականության մտադրությունը ձևակերպվել է էլ ավելի շուտ — 2019 սեպտեմբերին ՊԵԿ-ը հանրորեն քննարկել է «Էլեկտրոնային առևտուր և վիրտուալ ՀԴՄ» (մանրամասն՝ Սարքավորման թե վիրտուալ կասսա էջում)։ Ժամանակագրությունը՝ քաղաքականության ձևավորում 2019 → տեխնիկական ճշգրտում 2021 մյուս կեսին → հրապարակում 2021 դեկտեմբերին → կարգավորիչ փոփոխություն 2024 վերջին։

2021-ից հետո գոյակցում են երկու արձանագրություններ՝ դասական ինտեգրման ուղեցույցը շարունակում է զարգանալ (v0.7՝ 2022, v0.71՝ 2023, v0.73՝ 2025), իսկ eHDM-գծի մոտ՝ առանձին ուղեցույց է, որը էականորեն վերանայվել է — 2021 թվականի դեկտեմբերի 22 էջից մինչև 2024 թվականի նոյեմբերի 37 էջ — մինչ ընթացիկ 2026 ապրիլյան թողարկումը։

Մեկ հետաքրքիր մանրուք, որը արժե նշել. «v0.72» տարբերակի պիտակը կիրառվել է երկու տարբեր ֆայլերի վրա — մեկը հրապարակվել է 2023 սեպտեմբերի 15 (33 էջ), մյուսը՝ վերահրապարակվել 2025 ապրիլի 1 (34 էջ)։ Ժամանակային նշիչներն ու բովանդակության հեշերը տարբեր են, բայց ՊԵԿ-ը պահպանել է նույն տարբերակի համարը։ Եթե ձեզ մոտ կա «v0.72»-ի լոկալ պատճեն և ուզում եք իմանալ՝ 2023 թե 2025 տարբերակն է, համեմատեք ֆայլի չափը կամ էջերի քանակը։

Ինչ նշանակություն ունի ինտեգրողների համար

Եթե այսօր կասսայի համար ծրագրաշար եք կառուցում, կարդում եք v0.73-ը (կամ ՊԵԿ-ի HDM-հաբում ընթացիկ հրապարակված տարբերակը)։ Բայց տարբերակների պատմությունը հասկանալը գործնական երեք առումով օգտակար է.

• Դաշտերի սեմանտիկան շեղվում է։ v0.61 կտրոնը կարող է ներառել կամ բացակայել այնպիսի դաշտեր, որոնք v0.7-ը պարտադիր է դարձրել։ Եթե ձեր ինտեգրումները սպասարկում են ավելի հին սարքավորումներից ստացված կտրոններ, յուրաքանչյուր դաշտի հայտնվելու ժամանակը իմանալը օգնում է կարգաբերման մեջ։
• Հեղինակային շարունակականությունը իրական է։ Ութ տարի մեկ հիմնական ստորագրության ներքո նշանակել է կայուն դիզայնի բառապաշար։ 2023-ի փոխանցումը տարբեր ստորագրության — այն պահն է, երբ ակնկալելու եք ձևի ավելի շատ փոփոխություններ յուրաքանչյուր թողարկման մեջ։
• Սարքավորման և վիրտուալի փոխհամատեղելիություն։ 2021-ից երկու ճանապարհներն ունեն առանձին փաստաթղթեր և սկզբունքորեն կարող են շեղվել իրարից. գործնականում նրանք կիսում են JSON-ծրարը և օպերատորի/մուտքի verb-երը, բայց վստահ լինելու համար, որ ձեր ինտեգրումը ճիշտ է մշակում երկուսն էլ, պետք է անցնել երկու ուղեցույցներով զուգահեռ։

Աղբյուրներ

• Վերը նշված տարբերակների բոլոր PDF-ները կապված են արտեֆակտների ռեեստրի միջոցով petekamutner.am-ի Wayback-դրոշմներով։
• Ընթացիկ v0.73 ուղեցույցը հրապարակված է ՊԵԿ-ի HDM-հաբում և արխիվացված որպես արտեֆակտarchive։
• Հեղինակների վերագրումը վերցված է յուրաքանչյուր PDF-ի Author և CreationDate դաշտերից, որոնք ընթեռնելի են pdfinfo-ով։ Որևէ արտաքին աղբյուրի հետ չենք համեմատել։