Usta akışı

Bir usta anahtarıyla (role: usta) iş almak ve yürütmek.

GET /jobs → POST /jobs/{id}/accept → POST /jobs/{id}/on-the-way → POST /jobs/{id}/start → (gerekirse POST /extra-work) → POST /jobs/{id}/completion-code → POST /jobs/{id}/complete → GET /payouts → POST /payouts/{id}/approve

İş alabilmek için

Dükkân (POST /shop) açılmış, en az bir kategori seçilmiş ve çağrı merkezi onayı alınmış olmalı. İş alınamıyorsa GET /jobs boş döner ve usta_block sebebi söyler: PENDING_ADMIN_APPROVAL, SERVICE_CATEGORIES_REQUIRED, CATEGORY_DOCUMENTS_REQUIRED … Eksikler GET /shop/onboarding listesinde.

1. İşi görün ve kabul edin

GET /jobs ustanın işlerini ve alabileceği açık işleri döner. Kabul etmeden önce adres yalnızca il düzeyindedir. POST /jobs/{id}/accept: ilk kabul eden alır. İstemiyorsanız POST /jobs/{id}/reject — iş diğer ustalara açık kalır.

2. Yola çıkın, kodla başlayın

POST /jobs/{id}/on-the-way müşteriye bildirim gönderir ve başlangıç kodunu üretir. Kod yalnızca müşterinin ekranındadır; usta kapıda müşteriden okuyup POST /jobs/{id}/start ile gönderir:

{ "code": "482913" }

Yanlış kod 400 VISIT_CODE_INVALID.

3. Ek iş (gerekirse)

İş başında ek bir iş çıkarsa POST /extra-work ile kalem kalem müşterinin onayına sunun. Müşteri reddederse daha düşük bir teklif (/counter-offer, en çok 2 kez) ya da ekibe itiraz (/escalate).

4. Kodla bitirin

POST /jobs/{id}/completion-code müşteriye bitiş kodunu SMS ve bildirimle gönderir. POST /jobs/{id}/complete:

{
  "code": "907145",
  "note": "Klima bakımı yapıldı, filtreler temizlendi, gaz basıncı ölçüldü.",
  "photos": [{ "url": "https://…/store/ug/files/shared/…" }]
}

Not en az 50 karakter, 1–5 fotoğraf (POST /uploads/photo). İş müşterinin onayına gider; onayla ödeme serbest bırakılır.

5. Hakediş

Haftalık dökümler GET /payouts. POST /payouts/{id}/approve (money izni) dökümü onaylar; geçerli IBAN yoksa 409 PAYOUT_DETAILS_REQUIRED — IBAN'ı POST /shop ile girin.

Keşifli işler

Fiyatı keşifle belli olan işlerde POST /quotes ile teklif verin (hizmetin fiyat aralığında); müşteri kabul edince tutar rezervasyona yazılır.