# Ինտեգրացիա iiko-ի հետ — նշումներն ու գրաֆիկը երկու համակարգում

> Միացնել iiko-ն, կապել լոկացիաներն ու աշխատակիցներին. jeCheck-ի նշումները դառնում են iiko-ի ներկայություններ, դրամարկղի հերթափոխերը՝ նշումներ։

Источник: https://jecheck.io/hy/docs/schedule/iiko

iiko-ի հետ ինտեգրացիան աշխատակիցների նշումներն ու հերթափոխերի գրաֆիկը դարձնում է նույնը jeCheck-ում և iiko-ում։ Աշխատակիցը կարող է նշվել jeCheck հավելվածում (գեոլոկացիայով, QR-ով կամ կրպակում) — և iiko-ում կհայտնվի ներկայություն։ Կամ կարող է հերթափոխը բացել քարտով դրամարկղում — և jeCheck-ում կհայտնվի գալու նշում՝ ըստ գրաֆիկի ուշացումով։ Բաժինը բացվում է **Կարգավորումներ → Ինտեգրացիա iiko-ի հետ** ընտրացանկից և հասանելի է «Ցանց» և Enterprise սակագներով։

## Ինչ է պետք

- **Ինտեգրացիա iiko-ի հետ** իրավունքը (ադմինիստրատորն ունի) — տե՛ս [Իրավունքներ և դերեր](/docs/account/access-roles);
- iikoCloud-ի API բանալի։ Այն ստեղծում են **iikoWeb → Կարգավորումներ → Ինտեգրացիաներ → API բանալիներ** բաժնում. ընտրեք կապվող հաստատությունները և թույլատրեք աշխատակիցների բաժինները (աշխատակիցներ, պաշտոններ, ներկայություններ, գրաֆիկ, անձնական հերթափոխեր)։ Ավելի լավ է jeCheck-ի համար առանձին բանալի ստեղծել — այն ավելի հեշտ է չեղարկել, և այն չի խանգարում այլ ինտեգրացիաներին;
- լոկացիաներ jeCheck-ում և աշխատակիցներ՝ հեռախոսով, էլ. փոստով կամ տաբելային համարով — աշխատակիցները դրանցով կգտնվեն ինքնուրույն։

Եթե աշխատում եք iiko-ի մշակողների պորտալի հավելվածով, iikoWeb-ի բանալու փոխարեն ընտրեք **iiko-ի մշակողի հավելված** բանալու տեսակը և մուտքագրեք App ID, Client secret և API key։ Syrve-ի համար (iiko-ն արտերկրում) **Սերվերի այլ հասցե (Syrve)** հղումով նշեք պայմանագրի սերվերի հասցեն։

## Քայլ առ քայլ՝ միացնել iiko-ն

1. **Տեղադրեք բանալին։** Բացեք **Կարգավորումներ → Ինտեգրացիա iiko-ի հետ**, տեղադրեք API բանալին և սեղմեք **Միացնել**։ jeCheck-ը կստուգի բանալին և կբեռնի հաստատությունները, տերմինալների խմբերը, պաշտոնները, ներկայությունների և գրաֆիկի տեսակները։ Բանալին պահվում է գաղտնագրված և պահպանելուց հետո չի ցուցադրվում։
2. **Ստուգեք լոկացիաները։** **Լոկացիաներ** ներդիրում jeCheck-ի յուրաքանչյուր լոկացիայի համար ընտրեք **iiko-ի հաստատություն**։ Նույնանուն լոկացիաները կապվում են ինքնուրույն։ Չկապված լոկացիաների նշումները iiko չեն ուղարկվում։
3. **Համապատասխանեցրեք աշխատակիցներին։** **Աշխատակիցներ** ներդիրում սեղմեք **Թարմացնել iiko-ից**։ jeCheck-ը զույգերը գտնում է ըստ հեռախոսի, էլ. փոստի, տաբելային համարի (այն պետք է համընկնի iiko-ում աշխատակցի կոդի հետ) կամ ԱԱՀ-ի — միայն միանշանակ համընկնման դեպքում։ Մնացածների համար զույգը ձեռքով ընտրեք **jeCheck-ի աշխատակից** սյունակում։
4. **Կարգավորեք կանոնները։** **Փոխանակման կանոններ** ներդիրում ընտրեք, թե ինչպես են նշումները ուղարկվում iiko, նշեք **iiko-ի լռելյայն պաշտոն** և սեղմեք **Պահպանել կանոնները**։
5. **Միացրեք ակնթարթային ընդունումը։** **Քարտ դրամարկղում → jeCheck-ի նշումներ** բլոկում սեղմեք **Միացնել վեբհուքը** — այդ դեպքում դրամարկղում բացված հերթափոխը jeCheck-ում կհայտնվի անմիջապես, ոչ թե 5 րոպեի ընթացքում։

**Ամփոփում** ներդիրում երևում են կարգավորման ցանկը, վերջին 24 ժամի փոխանակման հաշվիչները և վերջին սխալը, եթե այն եղել է։

## Ինչպես են jeCheck-ի նշումները հասնում iiko

**jeCheck-ի նշումներ → iiko** բլոկն ունի երեք ռեժիմ.

- **Ներկայությամբ՝ հեռանալուց հետո** (խորհուրդ ենք տալիս) — երբ աշխատակիցը նշում է հեռանալը, iiko-ում ստեղծվում է պատրաստի ներկայություն՝ գալու և հեռանալու ժամերով։ Աշխատում է նույնիսկ անջատված դրամարկղի դեպքում։ Եթե ղեկավարը jeCheck-ում ուղղի կամ ջնջի նշումը, iiko-ի ներկայությունը նույնպես կուղղվի կամ կջնջվի։
- **Անմիջապես բացել հերթափոխը դրամարկղում** — jeCheck-ում գալու նշումն անմիջապես բացում է աշխատակցի անձնական հերթափոխը iiko-ում, հեռանալը՝ փակում։ Աշխատակիցը կարող է աշխատել դրամարկղում առանց առանձին նշման։ Դրա համար յուրաքանչյուր կապված լոկացիայում **Լոկացիաներ** ներդիրում պետք է ընտրված լինի **Տերմինալների խումբ**, իսկ դրամարկղը՝ միացված։
- **Չուղարկել** — նշումները մնում են միայն jeCheck-ում։

Ներկայության պաշտոնը որոշվում է այսպես. հերթափոխի պաշտոնը ըստ **Պաշտոններ** աղյուսակի (jeCheck-ի պաշտոն → iiko-ի պաշտոն), հակառակ դեպքում՝ աշխատակցի հիմնական պաշտոնը iiko-ում, հակառակ դեպքում՝ **iiko-ի լռելյայն պաշտոն**։ Ներկայության տեսակը կարելի է ընտրել **Ներկայության տեսակ** դաշտում։

Նշումները ուղարկվում են միայն համապատասխանեցված աշխատակիցների և կապված լոկացիաների համար և միայն **Գրառումների փոխանակում՝ սկսած** դաշտի ամսաթվից (լռելյայն՝ միացման օրվանից)։

## Ինչպես են դրամարկղի հերթափոխերը հասնում jeCheck

Միացրեք **Ընդունել iiko-ի ներկայությունները որպես նշումներ**։ Երբ աշխատակիցը տերմինալում քարտով բացում է հերթափոխը, jeCheck-ում հայտնվում է գալու նշում «iiko» եղանակով. այն կապվում է գրաֆիկի հերթափոխին, ուշացումը հաշվվում է սովորական կանոններով։ Հերթափոխը փակելիս հայտնվում են հեռանալու նշումը և աշխատած ժամերը։

Վեբհուքով (**Ակնթարթորեն (վեբհուք)**) նշումը հայտնվում է անմիջապես։ Բացի այդ, jeCheck-ը 5 րոպեն մեկ համեմատում է վերջին երկու օրվա ներկայությունները, իսկ գիշերը՝ վերջին շաբաթվա. այդպես գալիս են նաև iiko-ում ուղղված ներկայությունները, և կապի խափանման դեպքում ոչինչ չի կորչում։ Եթե ժամը ուղղել են iiko-ում, այն կուղղվի նաև jeCheck-ում — բացառությամբ այն նշումների, որոնք ղեկավարն արդեն ձեռքով խմբագրել է։

> [!NOTE]
> iiko-ի մեկ բանալին կարող է ունենալ միայն մեկ վեբհուքի հասցե։ Եթե բանալին արդեն օգտագործում է մեկ այլ ինտեգրացիա, jeCheck-ը կզգուշացնի և կառաջարկի փոխարինել հասցեն — ավելի լավ է jeCheck-ի համար առանձին բանալի ստեղծել։

## Եթե աշխատակիցը նշվել է երկու համակարգում էլ

Միևնույն աշխատակցի նշումները, որոնք համընկնում են ժամանակով կամ սկսվում են գրեթե միաժամանակ, մեկ հերթափոխ են. jeCheck-ը կապում է դրանք և կրկնօրինակներ չի ստեղծում ո՛չ jeCheck-ում, ո՛չ iiko-ում։ Թե որքան կարող է տարբերվել սկիզբը, որոշում է **Համարել մեկ հերթափոխ, եթե սկիզբը տարբերվում է ոչ ավելի, քան** դաշտը (լռելյայն՝ 30 րոպե)։

**Ում ժամն է գերակա** որոշում է, թե որ ժամը կմնա երկու համակարգում.

- **jeCheck (գեո, լուսանկար, QR)** — jeCheck-ի ժամը վերագրում է iiko-ի ներկայությունը;
- **iiko (քարտ դրամարկղում)** — դրամարկղի ժամը վերագրում է jeCheck-ի նշումը։

## Հերթափոխերի գրաֆիկ

- **Ուղարկել հրապարակված գրաֆիկը iiko** — jeCheck-ում գրաֆիկը հրապարակելուց հետո համապատասխանեցված աշխատակիցների հերթափոխերը հայտնվում են iiko-ի գրաֆիկում՝ ընտրված **Գրաֆիկի տեսակը iiko-ում**։ Փոփոխություններն ու ջնջված հերթափոխերը ուղարկվում են հաջորդ հրապարակման ժամանակ։
- **Բեռնել iiko-ի գրաֆիկը սևագրերով** — iiko-ի գրաֆիկի հերթափոխերը jeCheck-ում հայտնվում են սևագրերով. ղեկավարը ստուգում և հրապարակում է դրանք։ Բեռնումը՝ **Փոխանակում ժամանակահատվածի համար** բլոկի **Բեռնել գրաֆիկը iiko-ից** կոճակով։

## Փոխանակում ժամանակահատվածի համար և մատյան

**Փոխանակում ժամանակահատվածի համար** բլոկում ընտրեք ամսաթվերը (ոչ ավելի, քան երկու ամիս) և սեղմեք.

- **Բեռնել ներկայությունները iiko-ից** — ընդունել ժամանակահատվածի ներկայությունները, օրինակ՝ միանալուց հետո;
- **Ուղարկել նշումները iiko** — ուղարկել ժամանակահատվածի փակված նշումները, օրինակ՝ կապի խափանումից հետո;
- **Բեռնել գրաֆիկը iiko-ից** — վերցնել գրաֆիկը սևագրերով։

Այդ ժամանակ կրկնօրինակներ չեն առաջանում։ Յուրաքանչյուր ուղարկում և յուրաքանչյուր ընդունված ներկայություն գրանցվում է **Մատյան** ներդիրում։ Եթե iiko-ն անհասանելի էր, ուղարկումը կրկնվում է ինքնուրույն — 1, 5, 15 րոպե, մեկ ժամ անց և ավելի ուշ. սխալը կարելի է կրկնել նաև ձեռքով՝ **Կրկնել** կամ **Կրկնել բոլոր սխալները** կոճակով։

Փոխանակումը ժամանակավորապես դադարեցնելու համար ընտրեք **Միացում → Դադարեցնել փոխանակումը**։ **Անջատել iiko-ն** ջնջում է կապերը, կանոնները և մատյանը — նշումներն ու հերթափոխերը երկու համակարգում մնում են։

## Ստեղծել jeCheck-ի աշխատակիցներին iiko-ում

Եթե աշխատակիցը կա միայն jeCheck-ում, **Աշխատակիցներ** ներդիրում սեղմեք **Ստեղծել iiko-ում**, նշեք մարդկանց և սեղմեք **Ստեղծել**։ iiko-ի կոդը՝ տաբելային համար (կամ «JC» և աշխատակցի համարը jeCheck-ում), հաստատությունը՝ աշխատակցի հիմնական լոկացիա, պաշտոնը՝ **iiko-ի լռելյայն պաշտոն**։ Զույգը ստեղծվում է ինքնուրույն։

## Հաճախ տրվող հարցեր

### Պե՞տք է ինչ-որ բան տեղադրել դրամարկղում

Ոչ։ jeCheck-ն աշխատում է iiko-ի ամպային API-ով (iikoCloud)՝ iikoWeb-ի բանալիով։ **Անմիջապես բացել հերթափոխը դրամարկղում** ռեժիմի համար դրամարկղը պետք է միացված և ամպին կապված լինի։

### Ինչու՞ աշխատակցի նշումը չուղարկվեց iiko

Ամենից հաճախ աշխատակիցը համապատասխանեցված չէ կամ լոկացիան կապված չէ հաստատությանը — նման գրառումը երևում է **Մատյան** ներդիրում «Բաց է թողնված» կարգավիճակով։ Մեկ այլ պատճառ՝ պաշտոնն ընտրված չէ. նշեք **iiko-ի լռելյայն պաշտոն**։

### iiko-ի ներկայությունը չհայտնվեց jeCheck-ում — ի՞նչ ստուգել

Ստուգեք, որ միացված է **Ընդունել iiko-ի ներկայությունները որպես նշումներ**, աշխատակիցը համապատասխանեցված է, իսկ հաստատությունը կապված է լոկացիային։ Բաց թողնված ներկայությունները նույնպես գրանցվում են մատյանում՝ պատճառով։ Ներկայություններն անմիջապես վերցնելու համար սեղմեք **Համաժամեցնել հիմա** **Ամփոփում** ներդիրում։

### Կարելի՞ է միացնել iiko-ի մի քանի իրավաբանական անձ կամ բանալի

Այո՝ **Միացում → Եվս մեկ iiko միացում**։ Յուրաքանչյուր միացում ունի իր լոկացիաները, աշխատակիցները և կանոնները։

### Կա՞ ինտեգրացիա r_keeper-ի հետ

Դեռ ոչ — հաջորդը կլինի r_keeper-ի ինտեգրացիան։ Եթե այն պետք է ձեր ցանցին, գրեք աջակցությանը։