# iiko integratsiyasi — belgilar va jadval ikkala tizimda

> iiko’ni ulash, lokatsiya va xodimlarni bog‘lash: jeCheck belgilari iiko davomatiga, kassadagi smenalar belgilarga aylanadi.

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

iiko integratsiyasi xodimlar belgilari va smenalar jadvalini jeCheck va iiko’da bir xil qiladi. Xodim jeCheck ilovasida (geolokatsiya, QR yoki kiosk orqali) belgilansa — iiko’da davomat paydo bo‘ladi. Kassada karta bilan smena ochsa — jeCheck’da jadval bo‘yicha kechikish bilan kelish belgisi paydo bo‘ladi. Bo‘lim **Sozlamalar → iiko integratsiyasi** menyusidan ochiladi, «Tarmoq» va Enterprise tariflarida mavjud.

## Nima kerak

- **iiko integratsiyasi** huquqi (administratorda bor) — [Huquqlar va rollar](/docs/account/access-roles) ga qarang;
- iikoCloud API kaliti. U **iikoWeb → Sozlamalar → Integratsiyalar → API kalitlari** bo‘limida yaratiladi: bog‘lanadigan muassasalarni tanlang va xodimlar bo‘limlariga (xodimlar, lavozimlar, davomat, jadval, shaxsiy smenalar) ruxsat bering. jeCheck uchun alohida kalit yaratgan ma’qul — uni bekor qilish oson va u boshqa integratsiyalarga xalaqit bermaydi;
- jeCheck’dagi lokatsiyalar hamda telefoni, pochtasi yoki tabel raqami bor xodimlar — xodimlar shular bo‘yicha o‘zi topiladi.

Agar iiko dasturchilar portalidagi ilova bilan ishlasangiz, iikoWeb kaliti o‘rniga **iiko dasturchi ilovasi** kalit turini tanlang va App ID, Client secret hamda API key kiriting. Syrve (xorijdagi iiko) uchun **Boshqa server manzili (Syrve)** havolasi orqali shartnomadagi server manzilini kiriting.

## Bosqichma-bosqich: iiko’ni ulash

1. **Kalitni joylashtiring.** **Sozlamalar → iiko integratsiyasi** bo‘limini oching, API kalitini joylashtiring va **Ulash** tugmasini bosing. jeCheck kalitni tekshiradi, muassasalar, terminal guruhlari, lavozimlar, davomat va jadval turlarini yuklaydi. Kalit shifrlangan holda saqlanadi va saqlangandan keyin ko‘rsatilmaydi.
2. **Lokatsiyalarni tekshiring.** **Lokatsiyalar** yorlig‘ida har bir jeCheck lokatsiyasi uchun **iiko muassasasi** ni tanlang. Nomi bir xil lokatsiyalar o‘zi bog‘lanadi. Bog‘lanmagan lokatsiyalarning belgilari iiko’ga yuborilmaydi.
3. **Xodimlarni moslashtiring.** **Xodimlar** yorlig‘ida **iiko’dan yangilash** tugmasini bosing. jeCheck juftlarni telefon, pochta, tabel raqami (u iiko’dagi xodim kodiga mos bo‘lishi kerak) yoki F.I.Sh. bo‘yicha topadi — faqat moslik bir ma’noli bo‘lsa. Qolganlari uchun **jeCheck xodimi** ustunida juftni qo‘lda tanlang.
4. **Qoidalarni sozlang.** **Almashinuv qoidalari** yorlig‘ida belgilar iiko’ga qanday yuborilishini tanlang, **iiko’dagi standart lavozim** ni ko‘rsating va **Qoidalarni saqlash** tugmasini bosing.
5. **Darhol qabul qilishni yoqing.** **Kassadagi karta → jeCheck belgilari** blokida **Vebhukni ulash** tugmasini bosing — shunda kassada ochilgan smena jeCheck’da 5 daqiqa ichida emas, darhol paydo bo‘ladi.

**Umumiy koʻrinish** yorlig‘ida sozlash ro‘yxati, sutkalik almashinuv hisoblagichlari va oxirgi xato (bo‘lsa) ko‘rinadi.

## jeCheck belgilari iiko’ga qanday tushadi

**jeCheck belgilari → iiko** blokida uchta rejim bor:

- **Ketgandan keyin davomat sifatida** (tavsiya etamiz) — xodim ketishini belgilaganda, iiko’da kelish va ketish vaqti bilan tayyor davomat yaratiladi. Kassa o‘chiq bo‘lsa ham ishlaydi. Rahbar jeCheck’da belgini tuzatsa yoki o‘chirsa, iiko’dagi davomat ham tuzatiladi yoki o‘chiriladi.
- **Kassada smenani darhol ochish** — jeCheck’dagi kelish belgisi iiko’da xodimning shaxsiy smenasini darhol ochadi, ketish — yopadi. Xodim kassada alohida belgilanmasdan ishlay oladi. Buning uchun har bir bog‘langan lokatsiyada **Lokatsiyalar** yorlig‘ida **Terminal guruhi** tanlangan va kassa yoqilgan bo‘lishi kerak.
- **Yubormaslik** — belgilar faqat jeCheck’da qoladi.

Davomat lavozimi shunday aniqlanadi: smena lavozimi **Lavozimlar** jadvali bo‘yicha (jeCheck lavozimi → iiko lavozimi), aks holda xodimning iiko’dagi asosiy lavozimi, aks holda **iiko’dagi standart lavozim**. Davomat turini **Davomat turi** maydonida tanlash mumkin.

Belgilar faqat moslashtirilgan xodimlar va bog‘langan lokatsiyalar bo‘yicha va faqat **Yozuvlar almashinuvi boshlanish sanasi** maydonidagi sanadan boshlab yuboriladi (standart — ulangan kun).

## Kassadagi smenalar jeCheck’ga qanday tushadi

**iiko davomatini belgi sifatida qabul qilish** ni yoqing. Xodim terminalda karta bilan smena ochganda, jeCheck’da «iiko» usuli bilan kelish belgisi paydo bo‘ladi: u jadvaldagi smenaga bog‘lanadi, kechikish odatiy qoidalar bo‘yicha hisoblanadi. Smena yopilganda ketish belgisi va ishlangan soatlar paydo bo‘ladi.

Vebhuk bilan (**Darhol (vebhuk)**) belgi darhol paydo bo‘ladi. Bundan tashqari jeCheck har 5 daqiqada oxirgi ikki sutkadagi davomatni, tunda esa haftalik davomatni solishtiradi: shu tariqa iiko’da tuzatilgan davomat ham tushadi, aloqa uzilganda ham hech narsa yo‘qolmaydi. iiko’da vaqt tuzatilsa, u jeCheck’da ham tuzatiladi — rahbar qo‘lda tahrirlagan belgilar bundan mustasno.

> [!NOTE]
> Bitta iiko kalitida faqat bitta vebhuk manzili bo‘lishi mumkin. Kalitdan boshqa integratsiya foydalansa, jeCheck ogohlantiradi va manzilni almashtirishni taklif qiladi — jeCheck uchun alohida kalit yaratgan ma’qul.

## Agar xodim ikkala tizimda ham belgilangan bo‘lsa

Bir xodimning vaqt bo‘yicha kesishgan yoki deyarli bir vaqtda boshlangan belgilari — bitta smena: jeCheck ularni bog‘laydi va na jeCheck’da, na iiko’da dublikat yaratmaydi. Boshlanish vaqti qanchalik farq qilishi mumkinligini **Boshlanishi quyidagidan ko‘p farq qilmasa, bitta smena deb hisoblash** maydoni belgilaydi (standart — 30 daqiqa).

**Kimning vaqti ustun** ikkala tizimda qaysi vaqt qolishini hal qiladi:

- **jeCheck (geo, foto, QR)** — jeCheck vaqti iiko’dagi davomatni qayta yozadi;
- **iiko (kassadagi karta)** — kassa vaqti jeCheck’dagi belgini qayta yozadi.

## Smenalar jadvali

- **E’lon qilingan jadvalni iiko’ga yuborish** — jeCheck’da jadval e’lon qilingach, moslashtirilgan xodimlarning smenalari tanlangan **iiko’dagi jadval turi** bilan iiko jadvalida paydo bo‘ladi. O‘zgarishlar va o‘chirilgan smenalar keyingi e’lon qilishda yuboriladi.
- **iiko jadvalini qoralama sifatida yuklash** — iiko jadvalidagi smenalar jeCheck’da qoralama sifatida paydo bo‘ladi; rahbar ularni tekshirib, e’lon qiladi. Yuklash — **Davr bo‘yicha almashinuv** blokidagi **iiko’dan jadvalni yuklash** tugmasi bilan.

## Davr bo‘yicha almashinuv va jurnal

**Davr bo‘yicha almashinuv** blokida sanalarni (ikki oydan oshmasin) tanlang va bosing:

- **iiko’dan davomatni olish** — davr uchun davomatni qabul qilish, masalan ulangandan keyin;
- **Belgilarni iiko’ga yuborish** — davr uchun yopilgan belgilarni yuborish, masalan aloqa uzilgandan keyin;
- **iiko’dan jadvalni yuklash** — jadvalni qoralama sifatida olish.

Bunda dublikatlar paydo bo‘lmaydi. Har bir yuborish va har bir qabul qilingan davomat **Jurnal** yorlig‘ida yoziladi. iiko mavjud bo‘lmasa, yuborish o‘zi qayta urinadi — 1, 5, 15 daqiqa, bir soat va undan keyin; xatoni **Qayta urinish** yoki **Barcha xatolarni qayta urinish** tugmasi bilan qo‘lda ham takrorlash mumkin.

Almashinuvni vaqtincha to‘xtatish uchun **Ulanish → Almashinuvni to‘xtatish** ni tanlang. **iiko’ni uzish** bog‘lanishlar, qoidalar va jurnalni o‘chiradi — ikkala tizimdagi belgilar va smenalar qoladi.

## jeCheck xodimlarini iiko’da yaratish

Agar xodim faqat jeCheck’da bo‘lsa, **Xodimlar** yorlig‘ida **iiko’da yaratish** tugmasini bosing, odamlarni belgilang va **Yaratish** tugmasini bosing. iiko’dagi kod — tabel raqami (yoki «JC» va xodimning jeCheck’dagi raqami), muassasa — xodimning asosiy lokatsiyasi, lavozim — **iiko’dagi standart lavozim**. Juft o‘zi yaratiladi.

## Koʻp beriladigan savollar

### Kassaga biror narsa o‘rnatish kerakmi?

Yo‘q. jeCheck iikoWeb kaliti orqali iiko bulutli API (iikoCloud) bilan ishlaydi. **Kassada smenani darhol ochish** rejimi uchun kassa yoqilgan va bulutga ulangan bo‘lishi kerak.

### Nega xodimning belgisi iiko’ga yuborilmadi?

Ko‘pincha xodim moslashtirilmagan yoki lokatsiya muassasa bilan bog‘lanmagan — bunday yozuv **Jurnal** yorlig‘ida «O‘tkazib yuborildi» holati bilan ko‘rinadi. Yana bir sabab — lavozim tanlanmagan: **iiko’dagi standart lavozim** ni ko‘rsating.

### iiko’dagi davomat jeCheck’da paydo bo‘lmadi — nimani tekshirish kerak?

**iiko davomatini belgi sifatida qabul qilish** yoqilganini, xodim moslashtirilganini va muassasa lokatsiya bilan bog‘langanini tekshiring. O‘tkazib yuborilgan davomat ham jurnalga sababi bilan yoziladi. Davomatni darhol olish uchun **Umumiy koʻrinish** yorlig‘ida **Hozir sinxronlash** tugmasini bosing.

### Bir nechta iiko yuridik shaxsi yoki kalitini ulash mumkinmi?

Ha: **Ulanish → Yana bitta iiko ulanishi**. Har bir ulanishning o‘z lokatsiyalari, xodimlari va qoidalari bor.

### r_keeper bilan integratsiya bormi?

Hozircha yo‘q — keyingisi r_keeper integratsiyasi bo‘ladi. Tarmog‘ingizga kerak bo‘lsa, qo‘llab-quvvatlashga yozing.