Qabullar bilan ishlash

Umumiy ma'lumot

Qabullar — Bronjoy'ning asosidir. Ushbu qo'llanma xodim/ega nuqtai nazarini qamrab oladi: qabullarni yaratish, ko'rib chiqish, yangilash va ularning butun hayot sikli davomida boshqarish.

Mijoz tomonidagi yozilish jarayoni uchun Yozilish jarayoni bo'limiga qarang.

Qabul holatlari oqimi

Draft → Pending → Confirmed → Completed
                     ↓            ↓
                  Cancelled    NoShow

Qabullarni yaratish (xodimlar)

Xodimlar mijozlar nomidan qabullar yaratishi mumkin:

POST /api/org/appointments
Authorization: Bearer your-token
Content-Type: application/json

{
  "client_id": 42,
  "service_id": 1,
  "staff_id": 3,
  "branch_id": 1,
  "start_time": "2026-04-01T10:00:00Z",
  "notes": "Regular client, prefers extra pressure"
}

Maslahatlar:

• Maxsus istaklari yoki tibbiy jihatlari bo'lgan mijozlar uchun doim notes ni to'ldiring
• Agar mijoz hali mavjud bo'lmasa, avval uni POST /api/org/clients orqali yarating
• Xodim yaratgan qabullar sukut bo'yicha Confirmed holatida boshlanadi (to'lovni chetlab o'tib)

Qabullar ro'yxati

Barcha qabullar

GET /api/org/appointments
Authorization: Bearer your-token

Sana oralig'i, holat yoki xodim bo'yicha filtrlash:

GET /api/org/appointments?start_date=2026-04-01&end_date=2026-04-30&status=Confirmed&staff_id=3

Kutilayotgan qabullar

Harakat kutilayotgan (tasdiqlash, to'lov) qabullarni ko'ring:

GET /api/org/appointments/pending

Bu ro'yxatni muntazam ko'rib chiqing — uzoq vaqt kutib turgan qabullar to'lov muammolari yoki unutilgan tasdiqlarni anglatishi mumkin.

Kalendar ko'rinishi

GET /api/org/appointments/calendar?start=2026-04-01&end=2026-04-30

Kalendarni chizishga mos tuzilgan ko'rinishni qaytaradi. Boshqaruv paneli kalendarini shu endpoint orqali ishlating.

Qabulni yangilash

PUT /api/org/appointments/{appointment}
Content-Type: application/json

{
  "notes": "Updated preference: light pressure only",
  "staff_id": 4
}

Qabul yakunlanmagan yoki bekor qilinmagan bo'lsa, undagi ko'pchilik maydonlarni yangilashingiz mumkin.

Holat o'zgarishlari

Qabulni tasdiqlash

Kutilayotgan qabulni qo'lda tasdiqlang (masalan, to'lov naqd qabul qilingan bo'lsa):

POST /api/org/appointments/{appointment}/submit

Bekor qilish

POST /api/org/appointments/{appointment}/cancel
Content-Type: application/json

{
  "reason": "Staff unavailable due to illness"
}

Bekor qilganingizda mijoz bildirishnoma oladi. Agar to'lov olingan bo'lsa, pulni qaytarishni alohida boshlang (To'lovlar bo'limiga qarang).

Vaqtni qayta belgilash

POST /api/org/appointments/{appointment}/reschedule
Content-Type: application/json

{
  "start_time": "2026-04-02T11:00:00Z",
  "staff_id": 3
}

Mijozga yangi vaqt haqida xabar beriladi.

Ommaviy amallar

Bir vaqtning o'zida bir nechta qabulni samarali boshqaring:

Ommaviy yangilash

POST /api/org/appointments/batch-update
Content-Type: application/json

{
  "ids": [101, 102, 103],
  "data": { "status": "Completed" }
}

Kun oxiridagi qabullarni yakunlangan deb belgilash uchun qulay.

Ommaviy o'chirish

POST /api/org/appointments/batch-destroy
Content-Type: application/json

{
  "ids": [104, 105]
}

O'chirish o'rniga bekor qilishni afzal ko'ring. O'chirilgan qabullar tarixda ham, hisobotlarda ham ko'rinmaydi.

Mijoz haqida izohlar

Mijoz profiliga ichki izohlar biriktiring — ular xodimlarga ko'rinadi, mijozlarga esa yo'q:

POST /api/org/clients/{client}/notes
Content-Type: application/json

{
  "note": "Allergic to certain hair dyes. Always check before service."
}

Izohlar mijozning qabuli ko'rilganda har safar ko'rsatiladi va xodimlarga tayyorgarlik ko'rishga yordam beradi.

Eng yaxshi amaliyotlar

Kundalik ish tartibi

1. Ertalab — Kalendar ko'rinishida bugungi qabullarni ko'rib chiqing. Tasdiqlash kerak bo'lgan Pending qabullar bor-yo'qligini tekshiring.
2. Kun davomida — Xizmat ko'rsatilgach, qabullarni Completed deb belgilang.
3. Kun oxirida — Kunning qolgan barcha qabullarini yakunlash uchun ommaviy yangilashdan foydalaning.

Kelmagan mijozlar bilan ishlash

Agar mijoz kelmasa, qabulni bekor qilish o'rniga NoShow deb belgilang. Bu kelmaganlik bo'yicha ma'lumotlaringizni saqlaydi va qonuniyatlarni aniqlashga yordam beradi.

Kelmaganlik holatidagi qabullar bekor qilish sifatida hisoblanmaydi va pul qaytarish mantig'ini ishga tushirmaydi.

Ortiqcha yozilishning oldini olish

Slot kalkulyatori ikki marta band qilishning oldini avtomatik oladi. Biroq:

• Qabullarni qo'lda yaratsangiz, start_time bilan ehtiyot bo'ling — qo'lda yaratish jarayonida u mavjud yozilishlarga qarshi tekshirilmaydi
• Muayyan vaqtga qo'lda qabul yaratishdan oldin doim kalendarni tekshiring

So'nggi daqiqadagi bekor qilishlar

Mijozlar qancha vaqt oldin bekor qila olishini nazorat qilish uchun sozlamalaringizda cancellation_hours ni belgilang. Bu muddat o'tgach, mijozlar bekor qilishni baribir so'rashi mumkin, lekin xodimlar uni qo'lda ko'rib chiqishi kerak bo'ladi.

Hisobotlar va tahlillar

GET /api/org/dashboard

Boshqaruv paneli quyidagi asosiy ko'rsatkichlarni qaytaradi:

• Bugungi qabullar soni
• Shu haftadagi kelgusi qabullar
• Daromad xulosasi
• So'nggi bekor qilishlar va kelmaganlik holatlari

Batafsil tranzaksiya hisobotlari uchun:

GET /api/org/transactions
GET /api/org/transactions/summary
GET /api/org/transactions/export