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

iiko интеграциясы қызметкерлердің белгілері мен ауысым кестесін jeCheck пен iiko-да бірдей етеді. Қызметкер jeCheck қосымшасында (геолокациямен, QR арқылы немесе киоскіде) белгіленсе — iiko-да келу пайда болады. Ал кассада картамен ауысым ашса — jeCheck-те кесте бойынша кешігуімен келу белгісі пайда болады. Бөлім Баптаулар → iiko интеграциясы мәзірінен ашылады, «Желі» және Enterprise тарифтерінде қолжетімді.

Не қажет

• iiko интеграциясы құқығы (әкімшіде бар) — Құқықтар мен рөлдер қараңыз;
• 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-те де түзетіледі — басшы қолмен түзеткен белгілерден басқасы.

Қызметкер екі жерде де белгіленсе

Бір қызметкердің уақыты қиылысатын немесе бір мезгілде дерлік басталатын белгілері — бір ауысым: 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-дағы әдепкі лауазым. Жұп өздігінен жасалады.

Жиі қойылатын сұрақтар