Ինտեգրումներ, REST API և webhook-ներ

1. Սկզբունք

1.1. Այն ամենը, ինչ երևում է «n7kel Vakhta»-յի վեբ միջերեսում, հասանելի է արտաքին համակարգերին։ Նախատեսված է փոխանակման երկու եղանակ՝

• REST API՝ արտաքին համակարգն ինքն է պահանջում տվյալներ կամ դրանք փոխանցում հարթակին․
• webhook-ներ և ծանուցումներ՝ հարթակն ինքն է հայտնում իրադարձությունների մասին՝ ձեր համակարգին, էլեկտրոնային փոստին, Telegram-ին։

1.2. Ինտեգրումը հնարավոր է պատվիրատուի գործնականում ցանկացած համակարգի հետ․ եթե համակարգն ունի API, տվյալների բազա, ֆայլային արտահանում կամ հաղորդագրությունների հերթ, այն կարելի է միացնել (10 բաժին)։

1.3. Միջերեսի մեքենայընթեռնելի նկարագրությունը և մշակողների համար հրահանգները փոխանցվում են պատվիրատուի ՏՏ ծառայությանը միացման ժամանակ։ Ինքնավար տարբերակում բոլոր միջերեսներն աշխատում են պատվիրատուի ցանցի ներսում։

3. Մուտքի բանալիներ և իրավունքներ

• յուրաքանչյուր արտաքին համակարգի տրվում է իր բանալին՝ իրավունքների առանձին հավաքածուով․ բանալին ստեղծում է կազմակերպության ադմինիստրատորը․
• բանալին ցուցադրվում է մեկ անգամ․ սերվերում պահվում է միայն դրա դրոշմը․
• բանալին կապված է կազմակերպությանը․ այլ կազմակերպությունների տվյալներն այդ բանալու համար գոյություն չունեն․
• հարցումների հաճախականությունը սահմանափակվում է յուրաքանչյուր բանալու համար առանձին․
• յուրաքանչյուր հարցում, ներառյալ մերժվածները, գրանցվում է հարցումների մատյանում․
• բանալու հետկանչն ուժի մեջ է մտնում անմիջապես․ կարելի է սահմանել բանալու գործողության ժամկետ։

5. REST API-ի հնարավորությունները

• իրադարձություններ՝ զտիչներով ըստ օբյեկտի, տեսախցիկի, աշխատատեղի, աշխատակցի, տեսակի, մակարդակի, ժամանակահատվածի․ միայն նոր տվյալների պարբերական հարցում․
• իրադարձության քարտ՝ ապացուցողական մասով՝ ստորագրության, շղթայի և ֆայլերի ստուգման արդյունքներ․ կադրի և տեսահատվածի ներբեռնում՝ իրավունքի առկայության դեպքում․
• խախտումներ՝ զտիչներով ըստ կարգավիճակի, առաջնահերթության, պատասխանատուի, արձագանքման ժամկետի խախտման, իրավական պահման․
• վերլուծություն և հաշվետվություններ, այդ թվում՝ «Դրամարկղ»՝ ըստ դրամարկղերի, գանձապահների և հերթափոխերի․
• ամբողջականության ստուգման հաշվետվություններ․
• դրամարկղային գործառնությունների ընդունում։

Պատասխանները և սխալների տեքստերը՝ ռուսերենով։ CSV աղյուսակները բացվում են Excel-ում առանց կարգավորման, սյունակների վերնագրերը՝ ռուսերենով։ Մարդկանց մուտքագրած կամ դրամարկղի փոխանցած տեքստը երբեք բանաձևի չի վերածվում արտահանումը բացելիս։

7. Ծանուցումների առաքում

• յուրաքանչյուր հաղորդագրություն ստորագրված է ալիքի գաղտնի բանալիով․ ստացողը ստուգում է, որ այն ուղարկված է ձեր տեղակայման կողմից և փոփոխված չէ․
• ալիքի զտիչներ՝ թեմաներ, կարևորության նվազագույն մակարդակ, օբյեկտներ․
• յուրաքանչյուր հաղորդագրություն առաքվում է առնվազն մեկ անգամ․ յուրաքանչյուր հաղորդագրություն ունի նույնացուցիչ՝ կրկնակի մշակումից պաշտպանվելու համար․
• անհաջող առաքումները կրկնվում են աճող դադարով․ երկար ժամանակ հաղորդագրություններ չընդունող ալիքն ինքնաշխատ անջատվում է, պատճառը տեսանելի է ադմինիստրատորին․
• առաքումների մատյանը թույլ է տալիս համադրել՝ արդյոք ընդունիչը բաց չի թողել հաղորդագրություններ, և ձեռքով կրկնել առաքումը․
• հաղորդագրություններում պատկերների հղումներ չկան․ կադրերը ստացվում են միայն առանձին իրավունքով բանալիով․
• եթե փոստի կամ Telegram-ի ալիքը կարգավորված չէ, առաքումը նշվում է որպես սխալ․ համակարգը չի ձևացնում, թե հաղորդագրությունն ուղարկվել է։

Առաջարկություն՝ «ավելի լավ է լռել, քան սխալ մեղադրել» սկզբունքի ոգով․ մարդկանց՝ փոստով և Telegram-ով, ուղարկել միայն բարձր առաջնահերթության խախտումները, իսկ իրադարձությունների ամբողջական հոսքը՝ մեքենաներին՝ webhook-ների միջոցով։

8. Դրամարկղային համակարգի միացում

8.1. «Լցակայանի դրամարկղ» մոդուլին անհրաժեշտ են դրամարկղային գործառնություններ։ Միացումը կատարվում է երկու եղանակներից մեկով՝

• API-ով՝ դրամարկղային համակարգը կամ միջանկյալ ծառայությունը փոխանցում է գործառնությունները մինչև 500 հատից բաղկացած փաթեթներով․ նույն գործառնության կրկնակի փոխանցումը կրկնօրինակներ չի ստեղծում․
• CSV կամ XLSX ֆայլով՝ եթե դրամարկղային ծրագիրը չի կարողանում հարցումներ ուղարկել։ Հարթակն առաջարկում է սյունակների համապատասխանեցում, ստուգում առանց պահպանման, ինքն է ճանաչում կոդավորումը, բաժանիչը և գործառնությունների ռուսերեն անվանումները։

8.2. Գործառնության պարտադիր դաշտեր՝ գործառնության նույնացուցիչ, դրամարկղի համար, գործառնության տեսակ, ժամանակ։ Ցանկալի դաշտեր՝ գանձապահի մուտքանուն, կտրոնի համար, գումար, վճարման եղանակ։

8.3. Դրամարկղերի ժամացույցները հաճախ տարբերվում են ճշգրիտ ժամանակից։ Հարթակն ինքն է գնահատում յուրաքանչյուր դրամարկղի ժամացույցի ուղղումը և հաշվի առնում այն համադրման ժամանակ․ ուղղումը կարելի է սահմանել ձեռքով։ Դրամարկղերում ժամանակի համաժամեցումը խորհուրդ է տրվում։

8.4. Հարթակը սպասում է ուշացած դրամարկղային տվյալներին․ քանի դեռ ստուգվող պահի համար տվյալներ չկան, «առանց կտրոնի» խախտումը չի բացվում։ Խախտումը բացելուց հետո ստացված կտրոնն ինքնաշխատ հանում է այն։

8.5. Ընդունված դրամարկղային գործառնությունները պաշտպանված են նույն կերպ, ինչ n7kel սարքերի իրադարձությունները․ ընդունված գործառնությունն աննկատ փոխել կամ ջնջել հնարավոր չէ։

9. «n7kel Լցակայանների վերահսկում»-ի ինտեգրումներ

Լցակայանների ցանցի վերահսկման և չարաշահումներից պաշտպանության հարթակը նախատեսված է հարյուրավոր կայաններից բաղկացած ցանցի համար՝

• դրամարկղի կտրոնների և ֆիսկալ տվյալների համադրում գրանցված գործառնությունների հետ՝ համընկնում, կտրոն առանց գործառնության, կրկնօրինակ, գումարի անհամապատասխանություն՝ տարբերության նշումով․
• վահանակ իրական ժամանակում և դրամարկղային գործառնությունների մատյան․
• ծանուցումներ էլ. փոստով, Telegram-ով և SMS-ով՝ առաքման ստուգելի կարգավիճակով․
• հաշվետվություններ Excel և PDF ձևաչափերով․
• խոսքի վերլուծություն n7kel Voice-ի միջոցով՝ սպասարկման սցենարի պահպանում, արգելված արտահայտություններ, կոնֆլիկտներ ռուսերենով, ղազախերենով և ցանկացած այլ լեզվով․ արժեքը կախված է լեզուների քանակից․
• կայանների սարքավորումների հեռաչափություն․
• դրամարկղային կիոսկ՝ գանձապահի մուտք հերթափոխ աշխատակցի կոդով և PIN կոդով․ դեմքով մուտքը՝ պատվիրատուի որոշմամբ և միայն գանձապահի գրավոր համաձայնությամբ․
• կենտրոնը տեսնում է յուրաքանչյուր դրամարկղի կապի վիճակը․ կենտրոնի հետ կապի երկարատև կորստի ժամանակ դրամարկղերի աշխատանքն ապահովում է դրամարկղի բնիկ հավելվածը, և այն համաձայնեցվում է զննման ընթացքում։

Կոնկրետ դրամարկղային համակարգի և ERP-ի հետ ինտեգրումների կազմը որոշվում է զննման ընթացքում։

10. Ինտեգրում ցանկացած համակարգի հետ

10.1. Տիպային ինտեգրումներից բացի, n7kel-ը միացնում է պատվիրատուի գործնականում ցանկացած համակարգ, այդ թվում՝ սեփական և ժառանգված համակարգեր՝

• API՝ REST, SOAP և այլ արձանագրություններ․
• տվյալների բազաներ՝ ընթերցում և գրառում համաձայնեցված սխեմայով, առանձին հաշվով և նվազագույն իրավունքներով․
• ֆայլային փոխանակում՝ CSV, XLSX, XML, JSON՝ ժամանակացույցով կամ իրադարձությամբ․
• հաղորդագրությունների բաշխման համակարգեր և հերթեր՝ իրադարձությունների հոսքն իրական ժամանակում փոխանցելու համար․
• ERP և 1C, դրամարկղային համակարգեր, մուտքի վերահսկման համակարգեր, պահպանության վահանակներ, այլ արտադրողների տեսահսկման համակարգեր․
• ժառանգված համակարգեր՝ միջանկյալ ծառայության միջոցով, որը մշակվում է նախագծում։

10.2. Ինտեգրման կազմը և եղանակը որոշվում են զննման ընթացքում և ամրագրվում նախագծում։ Բոլոր փոխանակումներն ընթանում են պատվիրատուի միջավայրի ներսում կամ նրա համաձայնեցրած ալիքներով․ n7kel-ի արտաքին ծառայություններ դրա համար պետք չեն։

10.3. n7kel-ի արտադրանքների բոլոր իրադարձությունները կարող են միավորվել n7kel Atlas հարթակում՝ որոնման, կապերի և առաջադրանքների բաշխման համար։

11. Պետական բազաներ

11.1. Եթե դա անհրաժեշտ է պատվիրատուին, n7kel-ի արտադրանքները միացվում են Ներքին գործերի նախարարության, Ազգային անվտանգության կոմիտեի և այլ լիազորված մարմինների հետախուզվողների բազաներին՝ ավտոմեքենաների համարանիշները և այցելուների դեմքերը ստուգելու համար։

11.2. Միացումը հնարավոր է միայն համապատասխան պետական մարմինների հետ պատվիրատուի համաձայնագրի առկայությամբ և օրենքով ու այդ համաձայնագրով սահմանված կարգով։ Փոխանակման եղանակը որոշում է մարմինը․ փոխանակումը կատարում է հարթակի սերվերը պատվիրատուի միջավայրում, ստուգումների մատյանը պահվում է պատվիրատուի սերվերում։

11.3. Համընկնման դեպքում ծանուցումը ստանում է պատվիրատուի անվտանգության ծառայության լիազորված աշխատակիցը և՝ համաձայնագրին համապատասխան, մարմինը։ Յուրաքանչյուր ստուգում և յուրաքանչյուր համընկնում գրանցվում է մատյանում։