# Integracija sa iiko — dolasci i raspored u oba sistema

> Povezivanje iiko, lokacija i zaposlenih: dolasci iz jeCheck-a postaju prisustva u iiko, a smene sa kase postaju dolasci.

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

Integracija sa iiko održava dolaske zaposlenih i raspored smena istim u jeCheck-u i u iiko. Zaposleni može da prijavi dolazak u aplikaciji jeCheck (geolokacijom, QR kodom ili na kiosku) — i u iiko se pojavljuje prisustvo. Ili može da otvori smenu karticom na kasi — i u jeCheck-u se pojavljuje dolazak sa kašnjenjem po rasporedu. Odeljak se otvara iz menija **Podešavanja → Integracija sa iiko** i dostupan je u paketima „Mreža“ i Enterprise.

## Šta vam je potrebno

- pravo **Integracija sa iiko** (administrator ga ima) — vidi [Prava i uloge](/docs/account/access-roles);
- iikoCloud API ključ. Pravi se u **iikoWeb → Podešavanja → Integracije → API ključevi**: izaberite objekte koje povezujete i dozvolite odeljke zaposlenih (zaposleni, radna mesta, prisustva, raspored, lične smene). Najbolje je napraviti poseban ključ za jeCheck — lakše ga je opozvati i ne smeta drugim integracijama;
- lokacije u jeCheck-u i zaposleni sa telefonom, e-poštom ili evidencionim brojem — po njima se zaposleni sami pronalaze.

Ako radite sa aplikacijom sa iiko portala za programere, umesto iikoWeb ključa izaberite tip ključa **iiko aplikacija za programere** i unesite App ID, Client secret i API key. Za Syrve (iiko u inostranstvu) preko linka **Druga adresa servera (Syrve)** unesite adresu servera iz ugovora.

## Korak po korak: povežite iiko

1. **Nalepite ključ.** Otvorite **Podešavanja → Integracija sa iiko**, nalepite API ključ i kliknite **Poveži**. jeCheck proverava ključ i učitava objekte, grupe terminala, radna mesta, tipove prisustva i rasporeda. Ključ se čuva šifrovano i ne prikazuje se posle čuvanja.
2. **Proverite lokacije.** Na kartici **Lokacije** za svaku lokaciju u jeCheck-u izaberite **iiko objekat**. Lokacije istog naziva povezuju se same. Dolasci nepovezanih lokacija ne idu u iiko.
3. **Uparite zaposlene.** Na kartici **Zaposleni** kliknite **Osveži iz iiko**. jeCheck pronalazi parove po telefonu, e-pošti, evidencionom broju (mora da se poklapa sa šifrom zaposlenog u iiko) ili imenu i prezimenu — samo ako je podudaranje jednoznačno. Za ostale izaberite par ručno u koloni **Zaposleni u jeCheck-u**.
4. **Podesite pravila.** Na kartici **Pravila razmene** izaberite kako dolasci idu u iiko, navedite **Podrazumevano radno mesto u iiko** i kliknite **Sačuvaj pravila**.
5. **Uključite trenutni prijem.** U bloku **Kartica na kasi → dolasci u jeCheck-u** kliknite **Poveži webhook** — tada se smena otvorena na kasi pojavljuje u jeCheck-u odmah, a ne u roku od 5 minuta.

Na kartici **Pregled** vide se kontrolna lista podešavanja, brojači razmene za poslednja 24 sata i poslednja greška, ako je bilo.

## Kako dolasci iz jeCheck-a stižu u iiko

Blok **Dolasci iz jeCheck-a → iiko** ima tri režima:

- **Kao prisustvo posle odlaska** (preporučujemo) — kada zaposleni prijavi odlazak, u iiko se kreira gotovo prisustvo sa vremenom dolaska i odlaska. Radi i kad je kasa isključena. Ako rukovodilac ispravi ili obriše dolazak u jeCheck-u, prisustvo u iiko se takođe ispravlja ili briše.
- **Odmah otvori smenu na kasi** — prijava dolaska u jeCheck-u odmah otvara ličnu smenu zaposlenog u iiko, odlazak je zatvara. Zaposleni može da radi na kasi bez posebne prijave. Za to svaka povezana lokacija na kartici **Lokacije** mora imati izabranu **Grupu terminala**, a kasa mora biti uključena.
- **Ne slati** — dolasci ostaju samo u jeCheck-u.

Radno mesto prisustva određuje se ovako: radno mesto smene prema tabeli **Radna mesta** (radno mesto u jeCheck-u → radno mesto u iiko), inače glavno radno mesto zaposlenog u iiko, inače **Podrazumevano radno mesto u iiko**. Tip prisustva birate u polju **Tip prisustva**.

Dolasci se šalju samo za uparene zaposlene i povezane lokacije i samo od datuma u polju **Razmenjuj zapise počev od** (podrazumevano — dan povezivanja).

## Kako smene sa kase stižu u jeCheck

Uključite **Primaj prisustva iz iiko kao dolaske**. Kada zaposleni otvori smenu karticom na terminalu, u jeCheck-u se pojavljuje dolazak sa načinom „iiko“: vezuje se za smenu iz rasporeda, a kašnjenje se računa po uobičajenim pravilima. Kada zatvori smenu — pojavljuju se odlazak i odrađeni sati.

Sa webhookom (**Odmah (webhook)**) dolazak se pojavljuje odmah. Pored toga, jeCheck na svakih 5 minuta proverava prisustva za poslednja dva dana, a noću za poslednju nedelju: tako stižu i prisustva ispravljena u iiko, i ništa se ne gubi pri prekidu veze. Ako je vreme ispravljeno u iiko, ispraviće se i u jeCheck-u — osim dolazaka koje je rukovodilac već ručno menjao.

> [!NOTE]
> Jedan iiko ključ može imati samo jednu adresu webhooka. Ako ključ već koristi druga integracija, jeCheck će upozoriti i ponuditi zamenu adrese — bolje je napraviti poseban ključ za jeCheck.

## Ako je zaposleni prijavio dolazak u oba sistema

Dolasci istog zaposlenog koji se vremenski preklapaju ili počinju skoro istovremeno su jedna smena: jeCheck ih povezuje i ne pravi duplikate ni kod sebe ni u iiko. Koliko početak sme da se razlikuje određuje polje **Smatraj jednom smenom ako se početak razlikuje najviše za** (podrazumevano 30 minuta).

**Čije vreme ima prednost** odlučuje koje vreme ostaje u oba sistema:

- **jeCheck (geo, foto, QR)** — vreme iz jeCheck-a prepisuje prisustvo u iiko;
- **iiko (kartica na kasi)** — vreme sa kase prepisuje dolazak u jeCheck-u.

## Raspored smena

- **Šalji objavljeni raspored u iiko** — posle objavljivanja rasporeda u jeCheck-u smene uparenih zaposlenih pojavljuju se u rasporedu u iiko sa izabranim **Tipom rasporeda u iiko**. Izmene i obrisane smene šalju se pri sledećem objavljivanju.
- **Učitavaj raspored iz iiko kao nacrte** — smene iz rasporeda u iiko pojavljuju se u jeCheck-u kao nacrti; rukovodilac ih proverava i objavljuje. Učitavanje — dugmetom **Učitaj raspored iz iiko** u bloku **Razmena za period**.

## Razmena za period i dnevnik

U bloku **Razmena za period** izaberite datume (najviše dva meseca) i kliknite:

- **Preuzmi prisustva iz iiko** — primi prisustva za period, na primer posle povezivanja;
- **Pošalji dolaske u iiko** — pošalji zatvorene dolaske za period, na primer posle prekida veze;
- **Učitaj raspored iz iiko** — preuzmi raspored kao nacrte.

Pri tome se duplikati ne pojavljuju. Svako slanje i svako primljeno prisustvo upisuje se na kartici **Dnevnik**. Ako iiko nije bio dostupan, slanje se samo ponavlja — posle 1, 5 i 15 minuta, sat vremena i kasnije; grešku možete ponoviti i ručno dugmetom **Pokušaj ponovo** ili **Ponovi sve greške**.

Da biste privremeno zaustavili razmenu, izaberite **Veza → Pauziraj razmenu**. **Prekini vezu sa iiko** briše veze, pravila i dnevnik — dolasci i smene ostaju u oba sistema.

## Kreiranje zaposlenih iz jeCheck-a u iiko

Ako zaposleni postoji samo u jeCheck-u, na kartici **Zaposleni** kliknite **Kreiraj u iiko**, označite ljude i kliknite **Kreiraj**. Šifra u iiko je evidencioni broj (ili „JC“ i broj zaposlenog u jeCheck-u), objekat je matična lokacija zaposlenog, radno mesto je **Podrazumevano radno mesto u iiko**. Par se kreira sam.

## Česta pitanja

### Da li je potrebno nešto instalirati na kasu?

Ne. jeCheck radi preko iiko API-ja u oblaku (iikoCloud) sa ključem iz iikoWeb-a. Za režim **Odmah otvori smenu na kasi** kasa mora biti uključena i povezana sa oblakom.

### Zašto dolazak zaposlenog nije otišao u iiko?

Najčešće zaposleni nije uparen ili lokacija nije povezana sa objektom — takav zapis se vidi na kartici **Dnevnik** sa statusom „Preskočeno“. Drugi razlog je da radno mesto nije izabrano: navedite **Podrazumevano radno mesto u iiko**.

### Prisustvo iz iiko se nije pojavilo u jeCheck-u — šta proveriti?

Proverite da je uključeno **Primaj prisustva iz iiko kao dolaske**, da je zaposleni uparen i da je objekat povezan sa lokacijom. Preskočena prisustva se takođe upisuju u dnevnik sa razlogom. Kliknite **Sinhronizuj sada** na kartici **Pregled** da odmah preuzmete prisustva.

### Mogu li da povežem više iiko pravnih lica ili ključeva?

Da: **Veza → Još jedna iiko veza**. Svaka veza ima svoje lokacije, zaposlene i pravila.

### Postoji li integracija sa r_keeper?

Još ne — sledeća je integracija sa r_keeper. Ako je potrebna vašoj mreži, pišite podršci.