FaceID ProFaceID ProAPI

FaceID Pro API

Xodimlar, filiallar va davomat ma’lumotlarini o‘z tizimingizga (1C, Bitrix24, ERP, BI) ulash uchun REST API va webhooklar.REST API и вебхуки для подключения сотрудников, филиалов и посещаемости к вашим системам (1С, Bitrix24, ERP, BI).

Asosiy manzilБазовый адресhttps://api.faceidpro.uz/integrations/v1
FormatФорматJSON, UTF-8
VaqtВремяToshkent, ISO 8601 (+05:00)Ташкент, ISO 8601 (+05:00)

AutentifikatsiyaАутентификация

  1. FaceID Pro → Sozlamalar → Integratsiya → Yangi kalit.FaceID Pro → Настройки → Интеграция → Новый ключ.
  2. Kalit faqat bir marta ko‘rsatiladi — xavfsiz joyda saqlang.Ключ показывается только один раз — сохраните его в надёжном месте.
  3. Har bir so‘rovga sarlavha qo‘shing:Добавляйте заголовок к каждому запросу:
Authorization: Bearer fid_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Muqobil: X-API-Key: <kalit>.Альтернатива: X-API-Key: <ключ>.

RuxsatПравоImkoniyatЧто даёт
readFilial, bo‘lim, smena, xodim va davomatni o‘qishЧтение филиалов, отделов, смен, сотрудников и посещаемости
writeXodim qo‘shish, tahrirlash, holatini o‘zgartirishДобавление и изменение сотрудников, смена статуса
photosXodimning asosiy yuz surati (biometrik ma’lumot — alohida belgilanadi)Основное фото лица сотрудника (биометрия — выдаётся отдельно)
face_verifySurat yuborib, shu xodim ekanini tekshirish (surat saqlanmaydi)Проверка по фото, что это именно этот сотрудник (фото не сохраняется)
face_identifySurat yuborib, qaysi xodim ekanini topish — 1:N (surat saqlanmaydi)Поиск сотрудника по фото — 1:N (фото не сохраняется)
kpi_readDo‘kon KPI ishtirokchilari ro‘yxati va guruhi (bonus summasi va maosh berilmaydi)Список участников KPI магазина и их группы (суммы бонусов и зарплата не передаются)
kpi_writeDo‘kon KPI ro‘yxatini saqlash va oylik bonus natijasini yuborish (yopilgan oy bonusi tabelga tushadi)Сохранение списка KPI магазина и отправка месячного бонуса (бонус закрытого месяца попадает в табель)

Kalit uni yaratgan foydalanuvchi nomidan va uning ruxsatlari doirasida ishlaydi (filial admini — faqat o‘z filiali). Maosh ma’lumotlari API orqali berilmaydi.Ключ работает от имени создавшего его пользователя и в пределах его прав (админ филиала — только свой филиал). Данные о зарплате через API не передаются.

curl -H "Authorization: Bearer $FACEID_KEY" https://api.faceidpro.uz/integrations/v1/me

Cheklov va xatolarЛимиты и ошибки

Har bir kalit uchun daqiqasiga 120 so‘rov. Oshsa — 429 va Retry-After sarlavhasi.Не более 120 запросов в минуту на ключ. При превышении — 429 и заголовок Retry-After.

Xato javobi:Формат ошибки:

{
  "detail": "API kalit noto‘g‘ri, bekor qilingan yoki muddati o‘tgan"
}
KodКодMa’nosiЗначение
401Kalit yo‘q, noto‘g‘ri, bekor qilingan yoki muddati o‘tganКлюч отсутствует, неверен, отозван или истёк
402Kompaniya obunasi faol emasПодписка компании неактивна
403Ruxsat yetarli emas yoki kompaniya bloklanganНедостаточно прав или компания заблокирована
404Obyekt topilmadi (yoki sizning doirangizda emas)Объект не найден (или вне вашей зоны доступа)
409Ziddiyat: external_id yoki telefon band, yoki shu Idempotency-Key bilan so‘rov hali bajarilmoqda (Retry-After)Конфликт: external_id или телефон заняты, либо запрос с этим Idempotency-Key ещё выполняется (Retry-After)
422Parametr noto‘g‘ri — qayta yubormang, ma’lumotni tuzatingНеверный параметр — не повторяйте, исправьте данные
429So‘rovlar chegarasi oshdiПревышен лимит запросов
5xxVaqtinchalik xato — biroz kutib, xuddi shu Idempotency-Key bilan qayta yuboringВременная ошибка — повторите позже с тем же Idempotency-Key

O‘qish metodlariМетоды чтения

GET/meread / write

Kalit va tashkilot haqida ma’lumot — ulanishni tekshirish uchun (har qanday REST kalit).Информация о ключе и организации — для проверки подключения (любой REST-ключ).

{
  "tenant": {
    "id": 7,
    "name": "Kompaniya MChJ"
  },
  "key": {
    "name": "1C",
    "prefix": "fid_live_a1b2c3d4",
    "scopes": [
      "read"
    ]
  },
  "server_time": "2026-09-23T16:02:11+05:00"
}

GET/branchesread

Filiallar ro‘yxati.Список филиалов.

{
  "items": [
    {
      "id": 21,
      "name": "Bosh ofis",
      "address": "Toshkent",
      "timezone": "Asia/Tashkent"
    }
  ]
}

GET/departmentsread

Bo‘limlar.Отделы.

ParametrПараметрTuriТипTavsifОписание
branch_idintFilial bo‘yichaФильтр по филиалу
include_inactiveboolNofaollarni ham qo‘shishВключить неактивные

GET/shiftsread

Smenalar va ish vaqti.Смены и рабочее время.

ParametrПараметрTuriТипTavsifОписание
department_idintBo‘lim bo‘yichaФильтр по отделу

GET/employeesread

Xodimlar ro‘yxati (sahifalab).Список сотрудников (с пагинацией).

ParametrПараметрTuriТипTavsifОписание
statusactive | terminated | allStandart: activeПо умолчанию: active
branch_idint
department_idint
searchstringIsm, kod yoki telefonФИО, код или телефон
external_idstringTashqi tizimdagi ID bo‘yichaПо ID во внешней системе
updated_sinceISO 8601Faqat shu vaqtdan keyin o‘zgarganlar (updated_at bo‘yicha, tartib: updated_at, id)Только изменённые после этого времени (по updated_at, порядок: updated_at, id)
limitint ≤ 500Standart: 100По умолчанию: 100
offsetint
{
  "items": [
    {
      "id": 1136,
      "external_id": "0b3c2f4e-1c00-4a1b-9d7e-5f0a2c9e7d11",
      "employee_code": "K7Q2M9X4B1N8R5T3W6",
      "full_name": "Aliyev Ali Valiyevich",
      "phone": "+998901234567",
      "position": "Hisobchi",
      "branch_id": 21,
      "branch_name": "Bosh ofis",
      "department_id": 54,
      "department": "Menejment",
      "shift_id": 88,
      "employment_status": "working",
      "employment_started_on": null,
      "employment_reason": null,
      "is_active": true,
      "hire_date": "2025-03-01",
      "birth_date": null,
      "telegram_linked": true,
      "has_photo": true,
      "photo_updated_at": "2026-09-30T10:00:00+05:00",
      "created_at": "2025-03-01T10:12:40+05:00",
      "updated_at": "2026-10-01T09:12:00+05:00"
    }
  ],
  "total": 37,
  "limit": 100,
  "offset": 0
}

has_photo — asosiy yuz surati bormi; photo_updated_at — surat oxirgi marta qachon almashgan (suratni faqat shu qiymat o‘zgarganda qayta yuklang). updated_at — xodim kartasi oxirgi o‘zgargan vaqt.has_photo — есть ли основное фото; photo_updated_at — когда фото менялось в последний раз (загружайте заново только при его изменении). updated_at — время последнего изменения карточки.

GET/employees/{id}read

Bitta xodim.Один сотрудник.

GET/employees/external/{external_id}read

Xodimni 1C dagi ID si (GUID yoki tabel raqami) bo‘yicha topish. Topilmasa — 404.Найти сотрудника по ID из 1С (GUID или табельный номер). Если нет — 404.

GET/employees/{id}/photophotos

Xodimning asosiy (tasdiqlangan) yuz surati. Javob har doim image/jpeg, uzun tomoni ≤ 640 px. Telegram selfi va terminal kadrlari berilmaydi.Основное (подтверждённое) фото лица сотрудника. Ответ всегда image/jpeg, длинная сторона ≤ 640 px. Селфи из Telegram и кадры терминала не отдаются.

curl -H "Authorization: Bearer $FACEID_KEY" -H "If-None-Match: $ETAG" https://api.faceidpro.uz/integrations/v1/employees/1136/photo -o 1136.jpg

Sarlavhalar: ETag (fayl sha256), Last-Modified, Cache-Control: private, max-age=0. If-None-Match mos kelsa — 304. Surat yo‘q — 404 {"detail": "photo_not_found"}. Kalitda photos ruxsati bo‘lmasa — 403 {"detail": "scope_required", "scope": "photos"}. 1C ID si bo‘yicha: GET /employees/external/{external_id}/photo.Заголовки: ETag (sha256 файла), Last-Modified, Cache-Control: private, max-age=0. При совпадении If-None-Match — 304. Нет фото — 404 {"detail": "photo_not_found"}. Без права photos — 403 {"detail": "scope_required", "scope": "photos"}. По ID из 1С: GET /employees/external/{external_id}/photo.

POST/employees/{id}/face/verifyface_verify

Yuborilgan kadr shu xodimniki ekanini tekshirish (ArcFace, Telegram selfi-davomatdagi mantiq). Kadrda bitta yuz bo‘lishi kerak; boshqa xodimga ko‘proq o‘xshasa ham mismatch. Surat saqlanmaydi.Проверка, что присланный кадр принадлежит этому сотруднику (ArcFace, как в селфи-отметке Telegram). В кадре должно быть одно лицо; если кадр больше похож на другого сотрудника — тоже mismatch. Фото не сохраняется.

{
  "images": [
    "data:image/jpeg;base64,/9j/4AAQ..."
  ],
  "context": {
    "source": "savol",
    "reference": "a1b2c3"
  }
}
{
  "status": "match",
  "matched": true,
  "score": 0.62,
  "threshold": 0.42,
  "frames": 1,
  "matched_frames": 1,
  "employee_id": 1136,
  "checked_at": "2026-10-08T10:15:00+05:00"
}

images — 1…5 ta data URL (jpeg, png, webp; har biri ≤ 3 MB), aks holda 422. status: match, mismatch, no_gallery (xodimda namuna surat yo‘q), no_face, multiple_faces, unavailable (AI ishlamadi), disabled. Javob har doim 200; score — faqat shu xodimning o‘z suratlariga o‘xshashlik. Ruxsat yo‘q — 403 {"detail": "scope_required", "scope": "face_verify"}. 1C ID si bo‘yicha: POST /employees/external/{external_id}/face/verify.images — 1…5 data URL (jpeg, png, webp; каждый ≤ 3 МБ), иначе 422. status: match, mismatch, no_gallery (у сотрудника нет образца фото), no_face, multiple_faces, unavailable (ИИ не сработал), disabled. Ответ всегда 200; score — сходство только с фото этого сотрудника. Без права — 403 {"detail": "scope_required", "scope": "face_verify"}. По ID из 1С: POST /employees/external/{external_id}/face/verify.

POST/face/identifyface_identify

Yuborilgan kadrdan xodimni topish (1:N): kalit ko‘radigan filiallardagi faol xodimlar orasidan qidiriladi, ishdan ketganlar kirmaydi. Chegara va farq face/verify bilan bir xil — topilgan xodim 1:1 tekshiruvdan ham o‘tadi. Surat saqlanmaydi.Поиск сотрудника по присланному кадру (1:N): среди активных сотрудников филиалов, доступных ключу, уволенные не участвуют. Порог и отрыв как у face/verify — найденный сотрудник проходит и проверку 1:1. Фото не сохраняется.

{
  "images": [
    "data:image/jpeg;base64,/9j/4AAQ..."
  ],
  "context": {
    "source": "savol",
    "reference": "t/xodimlar-testi"
  }
}
{
  "status": "match",
  "matched": true,
  "score": 0.63,
  "threshold": 0.42,
  "frames": 1,
  "checked_at": "2026-10-16T10:15:00+05:00",
  "employee": {
    "id": 1136,
    "external_id": "0b3c2f4e-1c00-4a1b-9d7e-5f0a2c9e7d11",
    "employee_code": "K7Q2M9X4B1N8R5T3W6",
    "full_name": "Aliyev Ali Valiyevich",
    "phone": "+998901234567",
    "position": "Hisobchi",
    "branch_id": 21,
    "branch_name": "Bosh ofis",
    "department_id": 54,
    "department": "Menejment",
    "shift_id": 88,
    "employment_status": "working",
    "employment_started_on": null,
    "employment_reason": null,
    "is_active": true,
    "hire_date": "2025-03-01",
    "birth_date": null,
    "telegram_linked": true,
    "has_photo": true,
    "photo_updated_at": "2026-09-30T10:00:00+05:00",
    "created_at": "2025-03-01T10:12:40+05:00",
    "updated_at": "2026-10-01T09:12:00+05:00"
  }
}

images — 1…5 ta data URL (jpeg, png, webp; har biri ≤ 3 MB), aks holda 422. status: match, not_found, ambiguous (ikki xodimga deyarli bir xil o‘xshaydi), no_face, multiple_faces, no_gallery (hech kimda namuna surat yo‘q), unavailable (AI ishlamadi), disabled. Javob har doim 200. employee (GET /employees elementi bilan bir xil) va score — faqat match da, boshqa holatda null; boshqa nomzodlar haqida ma’lumot qaytmaydi. Kalitga daqiqasiga 60 ta so‘rov. Ruxsat yo‘q — 403 {"detail": "scope_required", "scope": "face_identify"}.images — 1…5 data URL (jpeg, png, webp; каждый ≤ 3 МБ), иначе 422. status: match, not_found, ambiguous (почти одинаково похож на двух сотрудников), no_face, multiple_faces, no_gallery (ни у кого нет образца фото), unavailable (ИИ не сработал), disabled. Ответ всегда 200. employee (как элемент GET /employees) и score — только при match, иначе null; о других кандидатах ничего не возвращается. Не более 60 запросов в минуту на ключ. Без права — 403 {"detail": "scope_required", "scope": "face_identify"}.

GET/attendanceread

Kunlik davomat: har xodim/kun uchun keldi, ketdi, ishlagan va kechikkan daqiqalar. Tabel uchun.Посещаемость по дням: приход, уход, отработанные минуты и опоздания по каждому сотруднику. Для табеля.

ParametrПараметрTuriТипTavsifОписание
date_fromYYYY-MM-DDBoshlanish (standart: bugun)Начало (по умолчанию: сегодня)
date_toYYYY-MM-DDTugash; oraliq ≤ 93 kunКонец; диапазон ≤ 93 дней
employee_idint
branch_idint
limitint ≤ 500
offsetint
{
  "items": [
    {
      "id": 18978,
      "employee_id": 1136,
      "employee_external_id": "0b3c2f4e-1c00-4a1b-9d7e-5f0a2c9e7d11",
      "branch_id": 21,
      "work_date": "2026-09-23",
      "first_in": "2026-09-23T08:27:14+05:00",
      "last_out": "2026-09-23T18:04:51+05:00",
      "status": "closed",
      "worked_minutes": 577,
      "late_minutes": 0,
      "early_leave_minutes": 0
    }
  ],
  "total": 612,
  "limit": 500,
  "offset": 0,
  "date_from": "2026-09-01",
  "date_to": "2026-09-30"
}

GET/eventsread

Keldi/ketdi hodisalari (terminal va Telegram). Yangilarini olish uchun javobdagi next_since_id ni keyingi so‘rovda since_id sifatida yuboring.События прихода/ухода (терминал и Telegram). Для получения новых передавайте next_since_id из ответа как since_id.

ParametrПараметрTuriТипTavsifОписание
since_idintShu ID dan keyingilar (standart 0)События после этого ID (по умолчанию 0)
date_from, date_toYYYY-MM-DDIxtiyoriy oraliqНеобязательный диапазон
employee_idint
limitint ≤ 500Standart: 200По умолчанию: 200
{
  "items": [
    {
      "id": 43681,
      "event_time": "2026-09-23T08:27:14+05:00",
      "direction": "in",
      "type": "keldi",
      "source": "terminal",
      "employee_id": 1136,
      "employee_external_id": "0b3c2f4e-1c00-4a1b-9d7e-5f0a2c9e7d11",
      "employee_code": "K7Q2M9X4B1N8R5T3W6",
      "employee_name": "Aliyev Ali Valiyevich",
      "branch_id": 21,
      "device": {
        "id": 17,
        "name": "Kirish-1"
      },
      "received_at": "2026-09-23T08:27:18+05:00"
    }
  ],
  "next_since_id": 43681,
  "has_more": false
}

Hodisa kursorga ~30 soniya kechikib chiqadi — parallel yozilayotgan hodisalar o‘tkazib yuborilmasligi uchun. has_more: true bo‘lsa darhol keyingi sahifani so‘rang.События попадают в курсор с задержкой ~30 секунд — чтобы не пропустить параллельно записываемые. Если has_more: true — сразу запросите следующую страницу.

direction: in — keldi, out — ketdi. source: terminal, telegram, manual.direction: in — приход, out — уход. source: terminal, telegram, manual.

GET/kpi/store-memberskpi_read

Do‘kon KPI’da qatnashadigan xodimlar va ularning guruhi. Ro‘yxat FaceID Pro’da (Ish haqi → Do‘kon KPI) yuritiladi; bonus summasi va qoidalari bu yerda yo‘q.Сотрудники, участвующие в KPI магазина, и их группы. Список ведётся в FaceID Pro (Зарплата → KPI магазина); суммы и правила бонусов здесь не хранятся.

{
  "groups": [
    {
      "key": "menejerlar",
      "label": "Menejerlar",
      "sort_order": 0
    },
    {
      "key": "xodimlar",
      "label": "Xodimlar (Sotuvchi, Qadoqlovchi)",
      "sort_order": 1
    }
  ],
  "items": [
    {
      "employee_id": 1136,
      "external_id": "0b3c2f4e-1c00-4a1b-9d7e-5f0a2c9e7d11",
      "full_name": "Aliyev Ali Valiyevich",
      "phone": "+998901234567",
      "position": "Sotuvchi",
      "branch_id": 21,
      "branch_name": "Bosh ofis",
      "department": "Savdo",
      "employment_status": "working",
      "is_active": true,
      "group_key": "xodimlar",
      "group_label": "Xodimlar (Sotuvchi, Qadoqlovchi)",
      "updated_at": "2026-10-24T12:00:00+05:00"
    }
  ],
  "updated_at": "2026-10-24T12:00:00+05:00"
}

Faqat faol guruhlardagi faol a’zolar. Ishdan ketgan yoki nofaol xodim ham employment_status va is_active bilan qaytadi — qaror sizning tizimingizda. Hech narsa saqlanmagan bo‘lsa ikki standart guruh, bo‘sh items va updated_at: null. Kalit filial chegarasi GET /employees dagidek. Ruxsat yo‘q — 403 {"detail": "scope_required", "scope": "kpi_read"}.Только активные участники активных групп. Уволенные и неактивные сотрудники тоже возвращаются с employment_status и is_active — решение за вашей системой. Если ничего не сохранено — две стандартные группы, пустой items и updated_at: null. Ограничение по филиалу — как в GET /employees. Без права — 403 {"detail": "scope_required", "scope": "kpi_read"}.

Yozish metodlariМетоды записи

Xodim metodlari: kalitda write ruxsati va kalit egasida xodimlarni qo‘shish/tahrirlash huquqi bo‘lishi kerak. Do‘kon KPI metodlari: kpi_write ruxsati, kalit egasida Do‘kon KPI ro‘yxatini boshqarish va ish haqiga bonus kiritish huquqi.Методы сотрудников: право write у ключа и права на добавление/изменение сотрудников у владельца ключа. Методы KPI магазина: право kpi_write, у владельца ключа — управление списком KPI магазина и право вносить бонусы в зарплату.

POST/employeeswrite

Xodim qo‘shish. employee_code bo‘sh bo‘lsa avtomatik yaratiladi.Добавить сотрудника. Если employee_code пуст — создаётся автоматически.

curl -X POST https://api.faceidpro.uz/integrations/v1/employees \
  -H "Authorization: Bearer $FACEID_KEY" \
  -H "Content-Type: application/json" \
  -d '{"branch_id":21,"department_id":54,"shift_id":88,"full_name":"Aliyev Ali","phone":"+998901234567","position":"Hisobchi","hire_date":"2026-09-23"}'
ParametrПараметрTuriТипTavsifОписание
branch_id, department_id, shift_idintMajburiyОбязательно
full_name, phone, positionstringMajburiy; telefon +998XXXXXXXXXОбязательно; телефон +998XXXXXXXXX
employee_codestring6–32 lotin harf/raqam, ixtiyoriy6–32 латинских букв/цифр, необязательно
external_idstring ≤ 1001C dagi ID; tashkilot ichida takrorlanmaydiID в 1С; уникален в рамках организации
birth_date, hire_dateYYYY-MM-DDIxtiyoriyНеобязательно

PUT/employees/external/{external_id}write

1C uchun tavsiya etilgan usul. Shu external_id li xodim bo‘lsa — yuborilgan maydonlar yangilanadi (200), bo‘lmasa — yaratiladi (201). Necha marta yuborilsa ham bitta xodim bo‘ladi. Yaratish uchun POST dagi majburiy maydonlar kerak.Рекомендуемый способ для 1С. Если сотрудник с этим external_id есть — обновляются переданные поля (200), если нет — создаётся (201). Сколько бы раз ни отправили — сотрудник один. Для создания нужны обязательные поля как в POST.

curl -X PUT https://api.faceidpro.uz/integrations/v1/employees/external/0b3c2f4e-1c00-4a1b-9d7e-5f0a2c9e7d11 \
  -H "Authorization: Bearer $FACEID_KEY" \
  -H "Content-Type: application/json" \
  -d '{"branch_id":21,"department_id":54,"shift_id":88,"full_name":"Aliyev Ali","phone":"+998901234567","position":"Hisobchi"}'

PATCH/employees/{id}write

Faqat yuborilgan maydonlar o‘zgaradi. external_id ni ham shu yerda bog‘lash yoki ("" bilan) uzish mumkin.Меняются только переданные поля. Здесь же можно привязать external_id или отвязать ("").

{
  "position": "Bosh hisobchi",
  "department_id": 55,
  "external_id": "TAB-000123"
}

PUT/employees/{id}/employment-statuswrite

Holat: working, annual_leave, temporary_leave, terminated. Ishlashdan boshqa holat uchun reason majburiy.Статус: working, annual_leave, temporary_leave, terminated. Для всех кроме working обязателен reason.

{
  "employment_status": "terminated",
  "reason": "Shartnoma muddati tugadi",
  "started_on": "2026-09-30"
}

1C ID si bo‘yicha: PUT /employees/external/{external_id}/employment-status.По ID из 1С: PUT /employees/external/{external_id}/employment-status.

GET/kpi/store-candidateskpi_write

Do‘kon KPI ro‘yxatiga qo‘shish mumkin bo‘lgan faol xodimlar (ishdan ketganlar kirmaydi).Активные сотрудники, которых можно добавить в список KPI магазина (уволенные не входят).

{
  "items": [
    {
      "id": 1136,
      "full_name": "Aliyev Ali Valiyevich",
      "position": "Sotuvchi",
      "department": "Savdo",
      "branch_name": "Bosh ofis"
    }
  ]
}

PUT/kpi/store-memberskpi_write

Do‘kon KPI guruhlari va a’zolarini to‘liq almashtiradi (Ish haqi → Do‘kon KPI dagi saqlash bilan bir xil). Yangi guruhga key yubormang — server beradi. Javob — GET /kpi/store-members ko‘rinishi.Полностью заменяет группы и участников KPI магазина (как сохранение в Зарплата → KPI магазина). Для новой группы не передавайте key — его выдаст сервер. Ответ — как GET /kpi/store-members.

{
  "groups": [
    {
      "key": "menejerlar",
      "label": "Menejerlar"
    },
    {
      "label": "Kassirlar"
    }
  ],
  "members": [
    {
      "employee_id": 1136,
      "group_key": "menejerlar"
    }
  ]
}

Xato — 400 (sabab o‘zbekcha detail da), baza o‘zgarmaydi. Kalit egasida payroll.kpi_store.manage bo‘lishi kerak.Ошибка — 400 (причина в detail), база не меняется. У владельца ключа должно быть payroll.kpi_store.manage.

PUT/kpi/store-resultskpi_write

Oylik Do‘kon KPI bonusi (so‘m, butun son) — har xodim uchun. Bir oy uchun to‘liq almashtirish: yuborilmagan xodim natijasi 0 bo‘ladi. live — joriy hisob (xodim kabinetida «~» bilan); final — oy yopildi: bonus tabelga «Do‘kon KPI» bonusi bo‘lib yoziladi (0 bo‘lsa olib tashlanadi).Месячный бонус KPI магазина (сумы, целое число) по каждому сотруднику. Полная замена за месяц: у неотправленных сотрудников результат становится 0. live — текущий расчёт (в кабинете сотрудника с «~»); final — месяц закрыт: бонус записывается в табель как бонус «KPI магазина» (при 0 — удаляется).

{
  "period": "2026-10",
  "status": "final",
  "computed_at": "2026-11-02T09:00:00+05:00",
  "items": [
    {
      "employee_id": 1136,
      "bonus": 1250000
    }
  ]
}
{
  "period": "2026-10",
  "status": "final",
  "saved": 1,
  "zeroed": 0,
  "skipped": [],
  "total_amount": 1250000,
  "payroll": {
    "state": "ok",
    "posted": 1,
    "removed": 0,
    "pending": 0
  },
  "computed_at": "2026-11-02T09:00:00+05:00"
}

payroll.state: ok, not_final (live), locked — oy tabeli tasdiqlangan, tabelga tegilmadi; no_permission — kalit egasida ish haqiga bonus kiritish huquqi yo‘q. pending > 0 bo‘lsa keyinroq qayta yuboring. final faqat o‘tgan oy uchun. Boshqa tashkilot yoki filial xodimi skipped da.payroll.state: ok, not_final (live), locked — табель месяца утверждён, табель не изменён; no_permission — у владельца ключа нет права вносить бонусы. Если pending > 0 — повторите позже. final — только для прошедшего месяца. Сотрудники другой организации или филиала — в skipped.

Ishonchlilik: qayta yuborish va takrorlarНадёжность: повторы и дубликаты

Tarmoq uzilsa, 1C javobni olmay qolishi mumkin — so‘rov bajarilgan-bajarilmaganini bilmaydi. Ikki marta xodim yaratilmasligi uchun:При обрыве связи 1С может не получить ответ и не знать, выполнен ли запрос. Чтобы не создать сотрудника дважды:

  • Har bir yozish amaliga noyob Idempotency-Key sarlavhasini qo‘shing (masalan hujjat GUID si). Xuddi shu kalit bilan 24 soat ichida kelgan takroriy so‘rov qayta bajarilmaydi — birinchi javob qaytadi (Idempotent-Replayed: true).Добавляйте к каждой записи уникальный заголовок Idempotency-Key (например GUID документа). Повтор с тем же ключом в течение 24 часов не выполняется повторно — возвращается первый ответ (Idempotent-Replayed: true).
  • Xato javob saqlanmaydi: ma’lumotni tuzatib, xuddi shu kalit bilan qayta yuborish mumkin. Bir kalitni boshqa tanali so‘rovga ishlatsangiz — 422.Ошибочный ответ не сохраняется: исправьте данные и повторите с тем же ключом. Тот же ключ с другим телом — 422.
  • Eng ishonchlisi — PUT /employees/external/{external_id}: u tabiatan takrorga chidamli.Надёжнее всего — PUT /employees/external/{external_id}: он устойчив к повторам по своей природе.
  • Qayta yuborish kerak: 409 (Retry-After dan keyin), 429, 5xx va tarmoq xatosi. Qayta yubormang: 400, 401, 403, 404, 422.Повторять: 409 (после Retry-After), 429, 5xx и сетевые ошибки. Не повторять: 400, 401, 403, 404, 422.
Idempotency-Key: 7f9c1e2a-5b3d-4e8f-9a0b-1c2d3e4f5a6b

WebhooklarВебхуки

Sozlamalar → Integratsiya → Ilovalar dan manzilingizni qo‘shing. Hodisa yuz berishi bilan FaceID Pro POST so‘rov yuboradi.Добавьте адрес в Настройки → Интеграция → Приложения. При событии FaceID Pro отправит POST-запрос.

HodisaСобытиеQachonКогда
attendance.eventXodim keldi yoki ketdi (terminal, Telegram)Сотрудник пришёл или ушёл (терминал, Telegram)
attendance.record.updatedDavomat qo‘lda o‘zgartirildiПосещаемость изменена вручную
employee.createdYangi xodimНовый сотрудник
employee.updatedXodim ma’lumoti o‘zgardiИзменены данные сотрудника
employee.status_changedTa’til, qaytish yoki ishdan bo‘shatishОтпуск, возврат или увольнение
employee.photo_updatedXodimning asosiy yuz surati yangilandi (data.employee.photo_updated_at o‘zgaradi)Обновлено основное фото сотрудника (меняется data.employee.photo_updated_at)

So‘rov tanasiТело запроса

{
  "id": "7b1c3f0e-3a2d-4c55-9a51-0f1c7e0a9b12",
  "event": "attendance.event",
  "tenant_id": 7,
  "created_at": "2026-09-23T08:27:19+05:00",
  "data": {
    "id": 43681,
    "event_time": "2026-09-23T08:27:14+05:00",
    "direction": "in",
    "type": "keldi",
    "source": "terminal",
    "employee_id": 1136,
    "employee_external_id": "0b3c2f4e-1c00-4a1b-9d7e-5f0a2c9e7d11",
    "employee_code": "K7Q2M9X4B1N8R5T3W6",
    "employee_name": "Aliyev Ali Valiyevich",
    "branch_id": 21,
    "device": {
      "id": 17,
      "name": "Kirish-1"
    },
    "received_at": "2026-09-23T08:27:18+05:00",
    "attendance_result": "created",
    "employee": {
      "id": 1136,
      "full_name": "Aliyev Ali Valiyevich",
      "…": "…"
    },
    "attendance_record": {
      "id": 18978,
      "employee_id": 1136,
      "employee_external_id": "0b3c2f4e-1c00-4a1b-9d7e-5f0a2c9e7d11",
      "branch_id": 21,
      "work_date": "2026-09-23",
      "first_in": "2026-09-23T08:27:14+05:00",
      "last_out": "2026-09-23T18:04:51+05:00",
      "status": "closed",
      "worked_minutes": 577,
      "late_minutes": 0,
      "early_leave_minutes": 0
    }
  }
}

SarlavhalarЗаголовки

X-FaceID-Event: attendance.event
X-FaceID-Delivery: 7b1c3f0e-3a2d-4c55-9a51-0f1c7e0a9b12
X-FaceID-Timestamp: 1790140039
X-FaceID-Signature: sha256=5d41402abc4b2a76b9719d911017c592…

AvtorizatsiyaАвторизация

Qabul qiluvchi server login/parol yoki token so‘rasa (1C HTTP-servis odatda shunday), ulanish sozlamasida Avtorizatsiya ni tanlang: login va parol (Authorization: Basic …), Bearer token yoki maxsus sarlavha (masalan X-Api-Key). Parol shifrlangan holda saqlanadi va qayta ko‘rsatilmaydi.Если принимающий сервер требует логин/пароль или токен (HTTP-сервис 1С обычно требует), выберите Авторизацию в настройках подключения: логин и пароль (Authorization: Basic …), Bearer-токен или свой заголовок (например X-Api-Key). Пароль хранится зашифрованным и больше не показывается.

Imzoni tekshirishПроверка подписи

HMAC-SHA256(sir, timestamp + "." + xom_tana). Sir webhook qo‘shilganda bir marta ko‘rsatiladi.HMAC-SHA256(секрет, timestamp + "." + сырое_тело). Секрет показывается один раз при добавлении вебхука.

import hmac, hashlib

def is_valid(secret: str, headers, raw_body: bytes) -> bool:
    ts = headers["X-FaceID-Timestamp"]
    expected = "sha256=" + hmac.new(secret.encode(), ts.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, headers["X-FaceID-Signature"])
<?php
$body = file_get_contents('php://input');
$ts = $_SERVER['HTTP_X_FACEID_TIMESTAMP'];
$expected = 'sha256=' . hash_hmac('sha256', $ts . '.' . $body, $secret);
if (!hash_equals($expected, $_SERVER['HTTP_X_FACEID_SIGNATURE'])) { http_response_code(401); exit; }
const crypto = require("crypto");
const expected = "sha256=" + crypto.createHmac("sha256", secret)
  .update(req.headers["x-faceid-timestamp"] + "." + rawBody).digest("hex");
const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(req.headers["x-faceid-signature"]));

Yetkazish qoidalariПравила доставки

  • 2xx javob — yetkazildi. 5xx, 408, 409, 429 yoki 10 soniyada javob bo‘lmasa — qayta urinish: 30 s, 2 daq, 10 daq, 30 daq, 1, 3, 6 soat.Ответ 2xx — доставлено. 5xx, 408, 409, 429 или нет ответа за 10 секунд — повтор: 30 с, 2 мин, 10 мин, 30 мин, 1, 3, 6 ч.
  • Server o‘chiq bo‘lsa, navbatdagi xabarlar urinish sarflamasdan kutadi va server tiklanishi bilan (≤ 5 daqiqa) hammasi yuboriladi. Hech narsa yo‘qolmaydi.Если сервер недоступен, остальные сообщения ждут без траты попыток и отправляются сразу после восстановления (≤ 5 минут). Ничего не теряется.
  • 3xx, 401, 403, 404, 400, 422 — qayta urinilmaydi (sozlamani tuzatish kerak). Tuzatgach «Tarix» → Xatolarni qayta yuborish.3xx, 401, 403, 404, 400, 422 — без повторов (нужно исправить настройку). После исправления: «История» → Повторить ошибки.
  • Qayta urinishlar tufayli xabarlar tartibi o‘zgarishi mumkin — event_time bo‘yicha saralang.Из-за повторов порядок может нарушаться — сортируйте по event_time.
  • Bir hodisa takror kelishi mumkin — id bo‘yicha takrorni e’tiborsiz qoldiring.Событие может прийти повторно — игнорируйте дубликаты по id.
  • Faqat ommaviy manzillar: localhost va ichki tarmoq (10.x, 192.168.x) qabul qilinmaydi.Только публичные адреса: localhost и внутренние сети (10.x, 192.168.x) не принимаются.

Bitrix24

Har bir keldi-ketdi Bitrix24 chatiga xabar bo‘lib tushadi.Каждый приход и уход приходит сообщением в чат Bitrix24.

  1. Bitrix24 → Ilovalar → Dasturchilar uchun → Boshqa → Kiruvchi webhook.Bitrix24 → Приложения → Разработчикам → Другое → Входящий вебхук.
  2. Ruxsatlardan im (Chat va bildirishnomalar) ni belgilang, saqlang va manzilni nusxalang.Отметьте право im (Чат и уведомления), сохраните и скопируйте адрес.
  3. Chat ID: guruh chati uchun chat123, shaxsiy xabar uchun foydalanuvchi ID si.ID чата: chat123 для группового чата или ID пользователя для личных сообщений.
  4. FaceID Pro → Sozlamalar → Integratsiya → Bitrix24 → manzil va chat ID → Test.FaceID Pro → Настройки → Интеграция → Bitrix24 → адрес и ID чата → Тест.
https://kompaniya.bitrix24.ru/rest/1/a1b2c3d4e5f6g7h8/

Istalgan Bitrix24 portali ishlaydi: bitrix24.uz, .ru, .kz, .by, .com, .de va boshqalar yoki o‘z serveringizdagi Bitrix24 (box) — manzil /rest/<ID>/<kod>/ bilan tugashi kifoya.Подходит любой портал Bitrix24: bitrix24.uz, .ru, .kz, .by, .com, .de и другие, а также коробочная версия на своём сервере — достаточно, чтобы адрес заканчивался на /rest/<ID>/<код>/.

  • Webhook yaratgan Bitrix24 foydalanuvchisi o‘sha chat a’zosi bo‘lishi kerak, aks holda «chatga yoza olmaydi» xatosi chiqadi.Пользователь Bitrix24, создавший вебхук, должен состоять в этом чате — иначе будет ошибка «нет доступа к чату».
  • Bitrix24 chegarasi — soniyasiga 2 so‘rov. FaceID Pro shunga moslab yuboradi; ertalabki oqimda xabarlar bir necha soniya kechikishi normal.Лимит Bitrix24 — 2 запроса в секунду. FaceID Pro соблюдает его; в утренний пик задержка в несколько секунд — норма.
  • Xato matni panelda tushunarli ko‘rinadi: noto‘g‘ri kod, «im» ruxsati yo‘qligi, tarifda REST yopiqligi va h.k.Причина ошибки видна в панели: неверный код, нет права «im», REST закрыт на тарифе и т.д.

Ish vaqti (timeman)Учёт рабочего времени (timeman)

Xodim terminaldan kirganda uning Bitrix24 dagi ish kuni ochiladi, chiqqanda yopiladi — Bitrix24 dagi «Ish kunini boshlash» tugmasini bosish shart emas.При входе через терминал рабочий день сотрудника в Bitrix24 открывается, при выходе — закрывается; нажимать «Начать рабочий день» не нужно.

  1. Bitrix24 administratori nomidan kiruvchi webhook yarating, ruxsatlar: timeman va user.Создайте входящий вебхук от имени администратора Bitrix24 с правами timeman и user.
  2. FaceID Pro → Integratsiya → Bitrix24 → Ish vaqti → manzil → Test (ruxsatlar tekshiriladi).FaceID Pro → Интеграция → Bitrix24 → Учёт времени → адрес → Тест (проверяются права).
  3. Xodimlar tugmasi: telefon raqami mos kelganlar avtomatik bog‘lanadi, qolganlarini ro‘yxatdan tanlang. Qo‘lda tanlangan bog‘lanishni avtomatik moslash o‘zgartirmaydi.Кнопка Сотрудники: совпавшие по телефону связываются автоматически, остальных выберите из списка. Ручную привязку автоматическое сопоставление не меняет.
  • Hodisa kechikib yetib kelsa (terminal oflayn edi), ish kuni terminaldagi vaqt bilan ochiladi va izohga «FaceID Pro: terminal vaqti» yoziladi.Если событие пришло с опозданием (терминал был офлайн), день открывается со временем терминала и комментарием «FaceID Pro: terminal vaqti».
  • Kechagi hodisalar yuborilmaydi — Bitrix24 faqat joriy ish kunini qabul qiladi. Bog‘lanmagan xodim «O‘tkazib yuborildi» bo‘lib qoladi, xato hisoblanmaydi.Вчерашние события не отправляются — Bitrix24 принимает только текущий день. Непривязанный сотрудник помечается «Пропущено», это не ошибка.

1C

1-usul: 1C o‘zi so‘raydi (tavsiya)Способ 1: 1С запрашивает сама (рекомендуется)

Reglament vazifa har 5–10 daqiqada yangi hodisalarni oladi va oxirgi next_since_id ni saqlaydi.Регламентное задание каждые 5–10 минут забирает новые события и сохраняет последний next_since_id.

Функция ПолучитьСобытияFaceID(КлючAPI, ПоследнийID) Экспорт
    Соединение = Новый HTTPСоединение("api.faceidpro.uz", 443,,,, 30, Новый ЗащищенноеСоединениеOpenSSL);
    Запрос = Новый HTTPЗапрос("/integrations/v1/events?limit=500&since_id=" + Формат(ПоследнийID, "ЧГ=0"));
    Запрос.Заголовки.Вставить("Authorization", "Bearer " + КлючAPI);
    Ответ = Соединение.Получить(Запрос);
    Если Ответ.КодСостояния <> 200 Тогда
        ВызватьИсключение Ответ.ПолучитьТелоКакСтроку();
    КонецЕсли;
    Чтение = Новый ЧтениеJSON;
    Чтение.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку());
    Возврат ПрочитатьJSON(Чтение); // items, next_since_id, has_more
КонецФункции

Oylik tabel uchun GET /attendance?date_from=…&date_to=… — har xodim/kun uchun tayyor hisob.Для месячного табеля — GET /attendance?date_from=…&date_to=…: готовый расчёт по каждому сотруднику и дню.

1C server FaceID Pro ga faqat chiquvchi ulanish qiladi — 1C ichki tarmoqda (ofisda) tursa ham ishlaydi, port ochish shart emas.1С сама обращается к FaceID Pro — работает, даже если 1С стоит во внутренней сети офиса, открывать порты не нужно.

2-usul: FaceID Pro 1C ga yuboradiСпособ 2: FaceID Pro отправляет в 1С

1C da HTTP-servis yarating, uni veb-serverda (IIS/Apache) ommaviy manzil bilan e’lon qiling va manzilini Integratsiya → 1C ga kiriting. HTTP-servis login/parol so‘rasa — Avtorizatsiya → Login va parol da 1C foydalanuvchisini kiriting. Imzoni «Webhooklar» bo‘limidagidek tekshiring.Создайте HTTP-сервис в 1С, опубликуйте его на веб-сервере (IIS/Apache) по публичному адресу и укажите адрес в Интеграция → 1С. Если сервис требует логин/пароль — укажите пользователя 1С в Авторизация → Логин и пароль. Подпись проверяйте как в разделе «Вебхуки».

https://1c.kompaniya.uz/zup/hs/faceid/event

Ichki tarmoq manzillari (192.168.x, 10.x) qabul qilinmaydi — bunday holatda 1-usuldan foydalaning.Внутренние адреса (192.168.x, 10.x) не принимаются — в этом случае используйте способ 1.

Kadrlar sinxroniСинхронизация кадров

Har bir xodimni 1C dagi GUID yoki tabel raqami bilan bog‘lang va PUT /employees/external/{external_id} ishlating: bor bo‘lsa yangilaydi, yo‘q bo‘lsa yaratadi. Ishdan bo‘shatish — PUT /employees/external/{external_id}/employment-status (terminated). Davomat va hodisalarda ham employee_external_id qaytadi — 1C da qidirish shart emas. write ruxsatli kalit kerak.Свяжите каждого сотрудника с GUID или табельным номером из 1С и используйте PUT /employees/external/{external_id}: обновит, если есть, или создаст. Увольнение — PUT /employees/external/{external_id}/employment-status (terminated). В посещаемости и событиях тоже возвращается employee_external_id — искать в 1С не нужно. Нужен ключ с правом write.

Функция СинхронизироватьСотрудника(КлючAPI, Сотрудник) Экспорт
    Соединение = Новый HTTPСоединение("api.faceidpro.uz", 443,,,, 30, Новый ЗащищенноеСоединениеOpenSSL);
    Запрос = Новый HTTPЗапрос("/integrations/v1/employees/external/" + Строка(Сотрудник.УникальныйИдентификатор()));
    Запрос.Заголовки.Вставить("Authorization", "Bearer " + КлючAPI);
    Запрос.Заголовки.Вставить("Content-Type", "application/json");
    Запрос.Заголовки.Вставить("Idempotency-Key", Строка(Сотрудник.УникальныйИдентификатор()) + "-" + Сотрудник.ВерсияДанных);
    Данные = Новый Структура("full_name,phone,position,branch_id,department_id,shift_id",
        Сотрудник.Наименование, Сотрудник.Телефон, Сотрудник.Должность, 21, 54, 88);
    Запись = Новый ЗаписьJSON; Запись.УстановитьСтроку();
    ЗаписатьJSON(Запись, Данные);
    Запрос.УстановитьТелоИзСтроки(Запись.Закрыть(), КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
    Ответ = Соединение.ВызватьHTTPМетод("PUT", Запрос);
    Если Ответ.КодСостояния <> 200 И Ответ.КодСостояния <> 201 Тогда
        ВызватьИсключение Ответ.ПолучитьТелоКакСтроку();
    КонецЕсли;
КонецФункции

Google Sheets / Excel

Davomat, oylik tabel, bugungi holat va xodimlar ro‘yxati jadvalga o‘zi tushadi va yangilanib turadi. Google yoki Microsoft hisobida hech narsa sozlash shart emas.Посещаемость, месячный табель, текущее состояние и список сотрудников сами попадают в таблицу и обновляются. Ничего настраивать в Google или Microsoft не нужно.

  1. Integratsiya → Google Sheets / Excel → Havola yaratish. Tayyor formulalar bir marta ko‘rsatiladi.Интеграция → Google Sheets / Excel → Создать ссылку. Готовые формулы показываются один раз.
  2. Google Sheets: formulani A1 katagiga qo‘ying — jadval taxminan har soatda o‘zi yangilanadi.Google Sheets: вставьте формулу в ячейку A1 — таблица обновляется примерно раз в час.
  3. Excel: Ma’lumot → Veb’dan, manzilni (formulasiz) qo‘ying; «Hammasini yangilash» yoki avtomatik yangilashni yoqing.Excel: Данные → Из Интернета, вставьте адрес (без формулы); «Обновить всё» или автообновление.
=IMPORTDATA("https://api.faceidpro.uz/integrations/feeds/fid_live_…/timesheet.csv?month=current")
JadvalТаблицаMazmuniСодержимое
attendance.csvHar xodim, har kun: keldi, ketdi, ishlagan vaqt, kechikish, erta ketishКаждый сотрудник и день: приход, уход, отработано, опоздание, ранний уход
timesheet.csvOylik tabel: jami ko‘rsatkichlar va har kun uchun alohida ustun (+ — hali ishda)Месячный табель: итоги и отдельная колонка на каждый день (+ — ещё на работе)
today.csvBugun: ishda, ketgan, kelmagan, ta’tildaСегодня: на работе, ушёл, не пришёл, в отпуске
employees.csvXodimlar ro‘yxati (maosh yo‘q)Список сотрудников (без зарплат)
ParametrПараметрTuriТипTavsifОписание
monthcurrent | previous | YYYY-MMattendance va timesheet uchun oyМесяц для attendance и timesheet
date_from, date_toYYYY-MM-DDIxtiyoriy oraliq, ≤ 93 kunПроизвольный период, ≤ 93 дня
branch_idintFaqat bitta filialТолько один филиал
languz | ruUstun nomlari tiliЯзык заголовков
bom1Excelda faylni to‘g‘ridan-to‘g‘ri ochish uchun (kirill harflari buzilmasin)Для прямого открытия файла в Excel (чтобы не ломалась кириллица)

Havola parol kabi sir: uni bilgan har kim jadvalni ko‘radi. Kerak bo‘lmasa — API kalitlar ro‘yxatidan bekor qiling.Ссылка секретна как пароль: любой, кто её знает, видит таблицу. Если не нужна — отзовите в списке API-ключей.

Kalendar: Google Calendar va OutlookКалендарь: Google Calendar и Outlook

Bayramlar va korxona dam olish kunlari, ta’tillar, tasdiqlangan erta ketishlar va tug‘ilgan kunlar jamoa kalendarida ko‘rinadi.Праздники и выходные компании, отпуска, одобренные ранние уходы и дни рождения видны в календаре команды.

  1. Integratsiya → Google Calendar / Outlook → Havola yaratish: nimalar tushishini belgilang.Интеграция → Google Calendar / Outlook → Создать ссылку: отметьте, что показывать.
  2. Google Calendar: Boshqa kalendarlar → + → URL orqali → havolani qo‘ying.Google Calendar: Другие календари → + → Добавить по URL → вставьте ссылку.
  3. Outlook: Kalendar qo‘shish → Vebdan obuna bo‘lish → havolani qo‘ying.Outlook: Добавить календарь → Подписаться из Интернета → вставьте ссылку.
https://api.faceidpro.uz/integrations/feeds/fid_live_…/calendar.ics?kinds=holidays,leaves
  • Google kalendarni bir necha soatda bir yangilaydi, Outlook — odatda tezroq. Bu ularning o‘z qoidasi.Google обновляет подписной календарь раз в несколько часов, Outlook — обычно быстрее. Это их собственное правило.
  • Ta’til sababi va maosh kalendarga chiqmaydi — faqat xodim ismi va sana.Причина отпуска и зарплата в календарь не попадают — только имя и даты.

Bito

Bito ERP dagi xodimlar FaceID Pro ga avtomatik sinxronlanadi: Bito — kadrlar bo‘yicha asosiy manba, FaceID — davomat.Сотрудники из Bito ERP автоматически синхронизируются в FaceID Pro: Bito — основной источник кадровых данных, FaceID — посещаемость.

  1. Bito → Sozlamalar → Integratsiyalar → Maxsus integratsiya: nom, xodimlar bo‘limiga ruxsatli rol → saqlang va api_key ni nusxalang (ko‘rinishi kompaniya:kalit).Bito → Настройки → Интеграции → Своя интеграция: название, роль с доступом к сотрудникам → сохраните и скопируйте api_key (вид компания:ключ).
  2. FaceID Pro → Integratsiya → Bito → Ulash: api_key ni kiriting. Kerak bo‘lsa «yangi xodimlarni qo‘shish» ni yoqib, ular tushadigan filial, bo‘lim va smenani tanlang.FaceID Pro → Интеграция → Bito → Подключить: введите api_key. При необходимости включите «добавлять новых сотрудников» и выберите филиал, отдел и смену для них.
  3. Hozir sinxronlash — natija darhol ko‘rinadi: nechta bog‘landi, qo‘shildi, yangilandi va qaysilari mos kelmadi.Синхронизировать сейчас — сразу видно, сколько связано, добавлено, обновлено и кто не сопоставлен.
  • Bog‘lash telefon raqami bo‘yicha; ism va telefon Bito’dan yangilanadi. Bito’da o‘chirilgan xodimni ishdan bo‘shatish — alohida belgilanadigan tanlov.Сопоставление по номеру телефона; ФИО и телефон обновляются из Bito. Увольнение удалённых в Bito сотрудников — отдельная опция.
  • O‘zgarishlar Bito webhooki orqali darhol keladi (akkaunt egasi kaliti bilan). Bito webhooklari bir martalik bo‘lgani uchun FaceID har soatda to‘liq solishtiradi ham — hech narsa yo‘qolmaydi.Изменения приходят сразу через вебхук Bito (ключ владельца аккаунта). Так как вебхуки Bito одноразовые, FaceID ещё и сверяет всё раз в час — ничего не теряется.

REGOS

REGOS (savdo/ERP) bilan ikki yo‘nalish: REGOS foydalanuvchilari FaceID Pro xodimlariga sinxronlanadi, kassa smenalari va sotuvlar esa xodim KPI’siga (Ish haqi → KPI) yoziladi.Два направления с REGOS (торговля/ERP): пользователи REGOS синхронизируются с сотрудниками FaceID Pro, а кассовые смены и продажи записываются в KPI сотрудника (Зарплата → KPI).

  1. REGOS.Online → Integratsiyalar → Lokal integratsiyalar → Yaratish: nom «FaceID Pro» → saqlang va API qiymatini nusxalang (https://integration.regos.uz/gateway/out/…/v1/). Tarifda API ruxsati bo‘lishi kerak.REGOS.Online → Интеграции → Локальные интеграции → Создать: название «FaceID Pro» → сохраните и скопируйте значение API (https://integration.regos.uz/gateway/out/…/v1/). В тарифе должен быть доступ к API.
  2. FaceID Pro → Integratsiya → REGOS → Ulash: API qiymatini kiriting. Kerak bo‘lsa «yangi xodimlarni qo‘shish» (filial, bo‘lim, smena), «o‘chirilganlarni bo‘shatish» va «KPI» ni yoqing.FaceID Pro → Интеграция → REGOS → Подключить: введите значение API. При необходимости включите «добавлять новых сотрудников» (филиал, отдел, смена), «увольнять удалённых» и «KPI».
  3. Ulangandan keyin oynada chiqqan webhook manzilini REGOS lokal integratsiyasining «URL обработчика» maydoniga qo‘ying va UserAdded, UserAddedGlobal, UserEdited, UserDeleted webhooklarini belgilang.После подключения вставьте показанный адрес вебхука в поле «URL обработчика» локальной интеграции REGOS и отметьте вебхуки UserAdded, UserAddedGlobal, UserEdited, UserDeleted.
  • Bog‘lash telefon raqami bo‘yicha (asosiy va qo‘shimcha raqamlar); ism va telefon REGOS’dan yangilanadi, yangi xodimning lavozimi — REGOS guruhi. Webhookka qo‘shimcha FaceID har soatda to‘liq solishtiradi.Сопоставление по номеру телефона (основной и дополнительные); ФИО и телефон обновляются из REGOS, должность нового сотрудника — группа REGOS. Помимо вебхука FaceID раз в час делает полную сверку.
  • KPI: yopilgan cheklar kassir yoki sotuvchi bo‘yicha yig‘iladi (sotuv yoki qaytarishlar ayirilgan jami), har chek xodimning o‘sha paytdagi smenasiga yoziladi va KPI stavkasi belgilangan xodimlarga hisoblanadi. Joriy oy savdo yangilanganda (har 30 daqiqada) qayta hisoblanadi; qo‘lda yuklangan KPI fayli almashtirilmaydi; tasdiqlangan tabel oyi o‘zgarmaydi.KPI: закрытые чеки суммируются по кассиру или продавцу (продажа или итого за вычетом возвратов), каждый чек относится к смене сотрудника в момент продажи, и KPI начисляется сотрудникам со ставкой KPI. Текущий месяц пересчитывается при обновлении продаж (каждые 30 минут); загруженный вручную файл KPI не заменяется; месяц с утверждённым табелем не меняется.
  • Davomatni REGOS’ga yozib bo‘lmaydi: REGOS API ish smenasini faqat foydalanuvchining o‘zi boshlashiga ruxsat beradi. REGOS VCR (fiskal kassa dasturi) xodimlarga aloqador emas va bulutdan ochilmaydi.Записать посещаемость в REGOS нельзя: API REGOS разрешает начинать рабочую смену только самому пользователю. REGOS VCR (фискальная касса) не связана с сотрудниками и недоступна из облака.

Eskiz SMS

Xodim kelganda yoki ketganda SMS yuboriladi: xodimning o‘ziga yoki rahbar raqamiga. Bir nechta rahbar uchun bir nechta xabarnoma qo‘shing.SMS при приходе или уходе сотрудника: самому сотруднику или на номер руководителя. Для нескольких руководителей добавьте несколько уведомлений.

  1. Integratsiya → Eskiz SMS → Ulash: Eskiz email, SMS shlyuz yashirin kaliti va tasdiqlangan yuboruvchi nomi.Интеграция → Eskiz SMS → Подключить: email Eskiz, секретный ключ SMS-шлюза и одобренное имя отправителя.
  2. Xabarnoma: kimga, qachon (keldi/ketdi) va matn. O‘rinbosarlar: {ism} {holat} {vaqt} {sana} {qurilma}.Уведомление: кому, когда (приход/уход) и текст. Подстановки: {ism} {holat} {vaqt} {sana} {qurilma}.

Shablon yaratish va moderatsiyaСоздание шаблона и модерация

Xabarnoma oynasida Shablon turi (xodimga yoki rahbarga; keldi, ketdi yoki ikkalasi) va Til (o‘zbek lotin, o‘zbek kirill, rus) ni tanlang — kompaniya nomi bilan tayyor matn yaratiladi. Belgilar va SMS soni ko‘rsatiladi (lotin — 160, kirill — 70 belgi bitta SMS).В окне уведомления выберите Тип шаблона (сотруднику или руководителю; приход, уход или оба) и Язык (узбекский латиница/кириллица, русский) — будет создан готовый текст с названием компании. Показывается число символов и SMS (латиница — 160, кириллица — 70 символов в одном SMS).

Eskizga moderatsiyaga yuborish tugmasi shablonni Eskiz kabinetiga yuboradi: o‘zgaruvchi qismlar %w (so‘z) va %d (raqam, vaqt) bilan belgilanadi. Holat (moderatsiyada, tasdiqlangan, rad etilgan) shu oynada Eskizdan olinib ko‘rsatiladi.Кнопка Отправить на модерацию в Eskiz отправляет шаблон в кабинет Eskiz: переменные части обозначаются %w (слово) и %d (число, время). Статус (на модерации, одобрен, отклонён) берётся из Eskiz и показывается в этом же окне.

{ism}, siz {sana} kuni soat {vaqt} da ishga keldingiz. Kompaniya
→ %w{1,4}, siz %d kuni soat %d da ishga keldingiz. Kompaniya

4546 — Eskizning test raqami: u bilan faqat Eskiz test matnlari yetkaziladi. Haqiqiy xabarnoma uchun Eskizda o‘z yuboruvchi nomingizni (nickname) oling.4546 — тестовый номер Eskiz: с него доставляются только тестовые тексты Eskiz. Для реальных уведомлений оформите своё имя отправителя (nickname) в Eskiz.

  • Eskiz faqat tasdiqlangan shablonga mos matnni yuboradi — shablonni Eskiz kabinetida moderatsiyadan o‘tkazing.Eskiz отправляет только текст, совпадающий с одобренным шаблоном — пройдите модерацию шаблона в кабинете Eskiz.
  • Eskiz tokeni 30 kunda eskiradi — FaceID Pro uni saqlangan login bilan avtomatik yangilaydi (Avans SMS uchun ham).Токен Eskiz истекает через 30 дней — FaceID Pro обновляет его автоматически по сохранённому логину (и для SMS аванса).
  • 30 daqiqadan eski hodisalarga SMS yuborilmaydi: terminal oflayndan qaytganda eski hodisalar SMS yomg‘iriga aylanmaydi. Javob aniq bo‘lmasa SMS qayta yuborilmaydi — ikki marta to‘lov bo‘lmaydi.На события старше 30 минут SMS не отправляется: после офлайна терминала не будет лавины SMS. При неясном ответе SMS не повторяется — двойной оплаты не будет.

MCP server (AI yordamchilar)MCP-сервер (AI-ассистенты)

Model Context Protocol orqali Claude, ChatGPT, Cursor va boshqa AI yordamchilar FaceID Pro ma’lumotlariga savol bera oladi: «Bugun kim kechikdi?», «Sentabr oyida qaysi filialda davomat past?». Hamma amallar faqat o‘qish.Через Model Context Protocol Claude, ChatGPT, Cursor и другие AI-ассистенты могут задавать вопросы к данным FaceID Pro: «Кто опоздал сегодня?», «В каком филиале низкая посещаемость в сентябре?». Все действия — только чтение.

  1. Integratsiya → MCP Server → Ulash. AI ga nima ochilishini tanlang: faqat umumiy statistika (standart), xodim ismlari va profillari, maosh.Интеграция → MCP Server → Подключить. Выберите, что откроется AI: только общая статистика (по умолчанию), имена и профили сотрудников, зарплата.
  2. Ko‘rsatilgan manzilni nusxalang — u bir marta ko‘rsatiladi va parol kabi sir.Скопируйте показанный адрес — он показывается один раз и секретен как пароль.
  3. AI ilovada: Claude → Settings → Connectors → Add custom connector; ChatGPT → Settings → Connectors; Cursor → MCP → Add server.В AI-приложении: Claude → Settings → Connectors → Add custom connector; ChatGPT → Settings → Connectors; Cursor → MCP → Add server.
https://api.faceidpro.uz/mcp/fid_live_xxxxxxxx_xxxxxxxxxxxxxxxx

Sarlavha qo‘ya oladigan klientlar uchun (Claude Code, Cursor) kalitsiz manzil va sarlavha:Для клиентов с поддержкой заголовков (Claude Code, Cursor) — адрес без ключа и заголовок:

claude mcp add --transport http faceid https://api.faceidpro.uz/mcp --header "Authorization: Bearer fid_live_…"
{
  "mcpServers": {
    "faceid": {
      "url": "https://api.faceidpro.uz/mcp",
      "headers": {
        "Authorization": "Bearer fid_live_…"
      }
    }
  }
}
  • Maxfiylik chegarasi serverda tekshiriladi: yopiq daraja toollari AI ga umuman ko‘rinmaydi, yig‘ma rejimda javobdan ism va telefonlar olib tashlanadi.Граница конфиденциальности проверяется на сервере: инструменты закрытого уровня AI не видит вовсе, в режиме сводной статистики имена и телефоны удаляются из ответа.
  • Kalit uni yaratgan admin huquqlari va filial chegarasi bilan ishlaydi. Kerak bo‘lmasa — Integratsiya → API kalitlar → Bekor qilish.Ключ работает с правами и границами филиала создавшего его администратора. Если больше не нужен — Интеграция → API-ключи → Отозвать.