# iiko интеграциясы — белгілер мен кесте екі жүйеде де

> iiko-ны қосу, нүктелер мен қызметкерлерді байланыстыру: jeCheck белгілері iiko келулеріне, кассадағы ауысымдар белгілерге айналады.

Источник: https://jecheck.io/kk/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 минут ішінде емес, бірден пайда болады.

**Шолу** қойындысында баптау тізімі, тәуліктегі алмасу есептегіштері және соңғы қате (болса) көрсетіледі.

## 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 iikoWeb кілті арқылы iiko бұлттық API-імен (iikoCloud) жұмыс істейді. **Кассада ауысымды бірден ашу** режимі үшін касса қосулы және бұлтқа қосылған болуы керек.

### Неліктен қызметкердің белгісі iiko-ға жіберілмеді?

Көбіне қызметкер сәйкестендірілмеген немесе нүкте мекемемен байланыспаған — мұндай жазба **Журнал** қойындысында «Өткізілді» мәртебесімен көрінеді. Тағы бір себеп — лауазым таңдалмаған: **iiko-дағы әдепкі лауазым** көрсетіңіз.

### iiko-дағы келу jeCheck-те пайда болмады — нені тексеру керек?

**iiko келулерін белгі ретінде қабылдау** қосулы екенін, қызметкер сәйкестендірілгенін және мекеме нүктемен байланысқанын тексеріңіз. Өткізілген келулер де журналға себебімен жазылады. Келулерді бірден алу үшін **Шолу** қойындысында **Қазір синхрондау** батырмасын басыңыз.

### Бірнеше iiko заңды тұлғасын немесе кілтін қосуға бола ма?

Иә: **Қосылым → Тағы бір iiko қосылымы**. Әр қосылымның өз нүктелері, қызметкерлері және ережелері болады.

### r_keeper-мен интеграция бар ма?

Әзірге жоқ — келесі r_keeper интеграциясы болады. Желіңізге қажет болса, қолдау қызметіне жазыңыз.