Insurance Company Job Changed Notification

InsurGateway, sigorta şirketine ait bir işin (job) kendi bilgileri değiştiğinde bu bildirim ile sigorta şirketine haber verir. Bu bildirimde işin aşaması değişmez; değişen, işin durumu, atandığı kullanıcılar veya sigorta şirketi teklif numarasıdır.

Bildirim, aşağıdaki alanlardan en az biri değiştiğinde gönderilir:

Aynı kayıtta birden fazla alan değişirse tek bildirim gönderilir; değişen alanların tamamı ChangedFields içinde listelenir. Yukarıdaki alanlar dışında kalan değişiklikler bu bildirimi üretmez. İşin aşama değişiklikleri ise Insurance Company Job Notification sayfasındaki 100–106 tipleriyle bildirilir.

Endpoint, kimlik doğrulama, beklenen cevap ve retry kuralları 100–106 tipleriyle aynıdır. Ayrıntılar için: Insurance Company Job Notification.

Endpoint

Bildirim, diğer tiplerle aynı /notification adresine gönderilir; tip, gövdedeki NotificationType alanından anlaşılır.

Örnek İstek

curl -X POST "{baseUrl}/notification" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -d '{
    "ReferenceNo": "GW-REF-0005",
    "NotificationType": 107,
    "EventType": "JobUpdated",
    "JobId": 42,
    "Stage": 9,
    "StageName": "Poliçe Gerçekleşti",
    "IsBatch": false,
    "InsuranceCompanyId": 12,
    "ProductId": 118,
    "ProductBranchId": 3,
    "OccurredAt": "2026-08-12T09:15:00",
    "Payload": "{\"ChangedFields\":[\"Status\",\"OwnerId\"],\"Status\":\"Closed\",\"OwnerId\":\"7c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\"ManagerId\":\"3f2a9c14-8b71-4e02-9d55-6c1e77a3b912\",\"InsuranceCompanyProposalNumber\":\"TKF-2026-0001\"}"
  }'

Referans numarası ve sabit alanlar üstte, tipe göre değişen içerik Payload alanındadır. Payload, JSON olarak serialize edilmiş bir string gönderilir: önce NotificationType değeri okunur, ardından Payload string’i JobChanged modeline deserialize edilir.

Ortak Alanlar

Ortak alanların anlamı 100–106 tipleriyle aynıdır. Bu tipe özgü değerler:

Payload Modeli

Model, takip edilen alanların hepsinin güncel değerini taşır; ChangedFields bu bildirimle hangilerinin değiştiğini belirtir. Değişmeyen alanlar da güncel değerleriyle gönderilir.

Status değerleri

Parse Edilmiş Gövde Örnekleri

Aşağıdaki örneklerde Payload, okunabilirlik için parse edilmiş (nesne) haliyle gösterilmiştir. Gerçek gövdede Payload bu nesnenin serialize edilmiş string halidir; gerçek biçim için yukarıdaki “Örnek İstek” bölümüne bakın.

İş kapatıldı ve başka kullanıcıya atandı:

{
  "ReferenceNo": "GW-REF-0005",
  "NotificationType": 107,
  "EventType": "JobUpdated",
  "JobId": 42,
  "Stage": 9,
  "StageName": "Poliçe Gerçekleşti",
  "IsBatch": false,
  "InsuranceCompanyId": 12,
  "ProductId": 118,
  "ProductBranchId": 3,
  "OccurredAt": "2026-08-12T09:15:00",
  "Payload": {
    "ChangedFields": ["Status", "OwnerId"],
    "Status": "Closed",
    "OwnerId": "7c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
    "ManagerId": "3f2a9c14-8b71-4e02-9d55-6c1e77a3b912",
    "InsuranceCompanyProposalNumber": "TKF-2026-0001"
  }
}

Sigorta şirketi teklif numarası değişti:

{
  "ReferenceNo": "GW-REF-0006",
  "NotificationType": 107,
  "EventType": "JobUpdated",
  "JobId": 43,
  "Stage": 3,
  "StageName": "Prim Verildi",
  "IsBatch": false,
  "InsuranceCompanyId": 12,
  "ProductId": 118,
  "ProductBranchId": 3,
  "OccurredAt": "2026-08-12T10:40:00",
  "Payload": {
    "ChangedFields": ["InsuranceCompanyProposalNumber"],
    "Status": "InProcess",
    "OwnerId": "7c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
    "ManagerId": null,
    "InsuranceCompanyProposalNumber": "TKF-2026-0002"
  }
}

Örneklerdeki ReferenceNo ve kullanıcı Id değerleri temsilidir.

Beklenen Cevap ve Retry

100–106 tipleriyle aynıdır: 2xx durum kodu başarı sayılır, cevap gövdesi değerlendirilmez. 2xx dışındaki her durum kodu, bağlantı hatası veya zaman aşımı yeniden gönderimi başlatır. Her deneme aynı gövdeyle, dolayısıyla aynı ReferenceNo ile gönderilir. Ayrıntılar: Insurance Company Job Notification.

Dikkat Edilmesi Gerekenler

Değerleri ChangedFields’a göre değil, gövdedeki güncel değerlere göre güncelleyin. Model her zaman takip edilen alanların tamamını taşır. ChangedFields neyin değiştiğini göstermek içindir; kayıt güncellenirken gövdedeki değerler esas alınabilir.

Yeni işin ilk durum değişikliği de bildirilir. İş ilk kez işleme alındığında durumu New’dan InProcess’e geçer ve bu da 107 bildirimi üretir.

Sıralama garantisi yoktur. 107 bildirimi, aynı işin aşama bildirimlerinden (100–106) önce veya sonra ulaşabilir. İşin güncel durumu belirlenirken OccurredAt alanı kullanılmalı ve daha eski bir olay daha yeni bir olayın üzerine yazılmamalıdır.

Kayıtlı olmayan bir iş için bildirim gelebilir. İşin ilk bildirimi teslim edilememişse 107 bildirimi, iş sizde henüz yokken ulaşabilir. Bu durumda iş JobId ile oluşturulabilmeli veya bildirim 2xx dönülerek atlanabilmelidir.

Aynı bildirim birden çok kez ulaşabilir. İşleme idempotent olmalıdır; tekilleştirme anahtarı ReferenceNo alanıdır.