Change Waiting Information Stage

Bilgi Bekleniyor Aşamasını Değiştir

Endpoint Bilgileri

Bir işi bilgi bekleniyor aşamalarına alır veya bu aşamadan çıkarır. Üç geçişin tamamı tek endpoint üzerinden yapılır; hedef aşama JobActionType alanıyla seçilir.

Bu geçişler her aşamadan yapılabilir; kaynak aşama kısıtı yoktur.

Hedef Aşamalar

Route Parametreleri

Kimlik Doğrulama

Geçerli bir bearer token gerektirir. Token şunları içermelidir:

• Tanınan bir rol (InsuranceCompanyAPIUser, InsuranceCompanyAPIAdmin veya Supervizor)
• İlgili route için Update yetkisi
• Geçerli bir sigorta şirketi ataması
• Çözümlenebilir bir kullanıcı kimliği

InsuranceCompanyAPIUser yalnızca kendi sahibi olduğu işlerde aksiyon alabilir. InsuranceCompanyAPIAdmin ve Supervizor şirketin tüm işlerine erişebilir.

İstek Modeli — WaitingInformationRequest

JobId gövdeden alınmaz; route parametresinden set edilir. 0’dan büyük olmalıdır: "JobId must be greater than zero."

Message alanı, kısıtlı sigorta şirketleri için 17 (Kurum Dışı Bilgi Bekleniyor) geçişinde zorunludur — detay aşağıda.

İş Kuralları

State geçişi sırasında aşağıdaki kontroller yapılır:

1. Aksiyonu alan kullanıcı işin sahibi olmalıdır ya da şirket admini/supervizör olmalıdır.
2. 17 (Kurum Dışı Bilgi Bekleniyor) geçişinde, işin sigorta şirketi kısıtlı şirketler listesindeyse Message boş olamaz.

Kısıtlı şirketler listesi portal ayar grubundaki restrict-waitingforinformationfromagent-null-msg ayarından okunur; virgülle ayrılmış sigorta şirketi Id listesidir. Listede olmayan şirketler için Message opsiyoneldir.

Yanıt

204 No Content — Başarılı Yanıt

Gövde boştur.

Hata Senaryoları

400 Bad Request — Doğrulama Hatası

İstek modeli doğrulamadan geçemediğinde döner. Hatalı alanlar Response içinde listelenir.

{
  "Status": false,
  "Code": "Validation.General",
  "Message": "One or more validation errors occurred",
  "Response": [
    {
      "Field": "JobActionType",
      "Message": "JobActionType must be one of WaitingForInformationFromCompany, WaitingForInformationFromAgent or WaitingForInfoCancel."
    }
  ]
}

403 Forbidden — Geçerli Sigorta Şirketi Ataması Bulunamadı

Token’da geçerli bir sigorta şirketi ataması bulunmadığında döner.

{
  "Status": false,
  "Code": "OfflineUsers.InsuranceCompanyNotFound",
  "Message": "No valid insurance company assignment found in token.",
  "Response": null
}

403 Forbidden — Kullanıcı Kimliği Çözümlenemedi

Token’dan kullanıcı kimliği okunamadığında döner.

{
  "Status": false,
  "Code": "OfflineUsers.UserIdentityNotResolved",
  "Message": "User identity could not be resolved from token.",
  "Response": null
}

403 Forbidden — İşe Erişim Reddedildi

İş, çağıranın sahipliğinde değilse döner.

{
  "Status": false,
  "Code": "OfflineJobs.JobOwnershipDenied",
  "Message": "You do not have permission to access this job.",
  "Response": null
}

403 Forbidden — Rol veya Yetki Yetersiz

Kullanıcı tanınan rollerden birine sahip değilse ya da Update yetkisi yoksa döner. Gövde boştur.

401 Unauthorized — Token Yok veya Geçersiz

Token gönderilmediğinde, geçersiz olduğunda veya süresi dolduğunda döner. Gövde boştur.

404 Not Found — İş Bulunamadı

Belirtilen jobId ile bir iş bulunamadığında döner.

{
  "Status": false,
  "Code": "OfflineJobs.JobNotFound",
  "Message": "No job found for the requested JobId: 100931.",
  "Response": null
}

409 Conflict — Durum Notu Zorunlu

Kısıtlı sigorta şirketleri için 17 geçişinde Message gönderilmediğinde döner.

{
  "Status": false,
  "Code": "OfflineWaitingInformation.StateTransitionFailed",
  "Message": "Waiting-information stage transition failed: Kurum Dışı Bilgi Bekleniyor durumuna almak için 'Durum Notu' girilmesi gerekmektedir.",
  "Response": null
}

409 Conflict — Aksiyon Yetkisi Yok

Kullanıcı işin sahibi değilse ve şirket admini/supervizör de değilse döner.

{
  "Status": false,
  "Code": "OfflineWaitingInformation.StateTransitionFailed",
  "Message": "Waiting-information stage transition failed: İstekte bulunulan (100931) numaralı iş için yalnızca 'İş Sahibi' veya 'Admin' kullanıcısı aksiyon alabilir!",
  "Response": null
}

500 Internal Server Error — Beklenmeyen Hata

Geçiş sırasında iş kuralı dışında bir hata oluştuğunda döner.

{
  "Status": false,
  "Code": "JobState.TransitionError",
  "Message": "An unexpected error occurred during job state transition.",
  "Response": null
}