# iiko-სთან ინტეგრაცია — აღნიშვნები და გრაფიკი ორივე სისტემაში

> iiko-ს დაკავშირება, ლოკაციები და თანამშრომლები: jeCheck-ის აღნიშვნები ხდება iiko-ს გამოცხადებები, სალაროს ცვლები — აღნიშვნები.

Источник: https://jecheck.io/ka/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-თან ინტეგრაცია. თუ ის თქვენს ქსელს სჭირდება, მისწერეთ მხარდაჭერას.