> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.insurgateway.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.insurgateway.com/_mcp/server. # Made Batch Endorsement POST https://testgatewayapi.insurapps.net/api/Offline/jobs/{jobId}/Endorsements/batch Content-Type: application/json ## Toplu Zeyil Kaydet ### Endpoint Bilgileri | Alan | Değer | | ----------------- | --------------------------------------------------------- | | **Method** | `POST` | | **URL** | `{{baseUrl}}/api/Offline/jobs/{jobId}/Endorsements/batch` | | **Content-Type** | `application/json` | | **Yetkilendirme** | Bearer Token + `Create` politikası | *** Sigorta şirketinin, acentenin toplu zeyil talebine karşılık **kesilen zeyil bilgilerini** kaydetmesi için kullanılır. Başarılı istekte iş `Toplu Zeyil Gerçekleşti` (`BatchEndorsementMade`) aşamasına geçer, zeyil ve prim bilgileri platform servisine yazılır ve aksiyon kaydı oluşturulur. > İşin aşaması `Toplu Zeyil İsteği` (`BatchEndorsementRequested`) olmalıdır; aksi halde geçiş reddedilir. *** ### Route Parametreleri | Parametre | Tip | Zorunlu | Açıklama | | --------- | --------- | ------- | -------------------------------------- | | `jobId` | `integer` | Evet | Zeyilleri kaydedilecek işin Id bilgisi | *** ### 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 `Create` yetkisi * Geçerli bir sigorta şirketi ataması * Çözümlenebilir bir kullanıcı kimliği > `InsuranceCompanyAPIUser` yalnızca kendi sahibi olduğu işleri işleyebilir. `InsuranceCompanyAPIAdmin` ve `Supervizor` şirketin tüm işlerine erişebilir. *** ### İstek Modeli — `MakeBatchEndorsementRequest` | Alan | Tip | Zorunlu | Açıklama | Doğrulama | | ----------- | -------------------------------- | ------- | ---------------------------- | -------------------------------------------------------------------------------------------------- | | `ProductId` | `integer` | Evet | Zeyilin ait olduğu ürün Id | Zorunlu: `"Product ID is required."` 0'dan büyük olmalı: `"Product ID must be greater than zero."` | | `Message` | `string` | Hayır | Toplu zeyile iliştirilen not | Maks. 500 karakter: `"Message cannot exceed 500 characters."` | | `Premiums` | `BatchEndorsementEntryRequest[]` | Evet | Zeyil prim girişleri | Zorunlu: `"Premium list is required."` Boş olamaz: `"Premium list cannot be empty."` | > `JobId` gövdeden alınmaz (`[JsonIgnore]`); route parametresinden set edilir. 0'dan büyük olmalıdır: `"JobId must be greater than zero."` #### Zeyil Girişi — `BatchEndorsementEntryRequest` | Alan | Tip | Zorunlu | Açıklama | Doğrulama | | ----------------------------------- | --------- | ------- | --------------------------------------- | ------------------------------------------------------------------------------------ | | `InsuranceCompanyPolicyNumber` | `string` | Evet | Sigorta şirketi poliçe numarası | Boş olamaz: `"Insurance company policy number is required."` | | `InsuranceCompanyEndorsementNumber` | `string` | Evet | Sigorta şirketi zeyil numarası | Boş olamaz: `"Insurance company endorsement number is required."` | | `InsuranceCompanyProposalNumber` | `string` | Hayır | Sigorta şirketi teklif numarası | — | | `RenewalNumber` | `integer` | Evet | Yenileme numarası | 0'dan büyük veya eşit olmalı: `"Renewal number must be greater than or equal to 0."` | | `GrossPremium` | `decimal` | Evet | Brüt prim | 0'dan büyük olmalı: `"GrossPremium must be greater than 0."` | | `NetPremium` | `decimal` | Evet | Net prim | 0'dan büyük olmalı: `"NetPremium must be greater than 0."` | | `Commision` | `decimal` | Evet | Komisyon (alan adı tek `s` ile yazılır) | 0'dan büyük veya eşit olmalı: `"Commision must be greater than or equal to 0."` | | `PaymentOptionType` | `integer` | Evet | Ödeme tipi | Tanımlı bir değer olmalı: `"PaymentOptionType must be a valid payment type."` | | `CurrencyType` | `integer` | Evet | Para birimi | Tanımlı bir değer olmalı: `"CurrencyType must be a valid currency type."` | #### Ödeme Tipi Değerleri | Değer | Ödeme Tipi | | ----- | ----------- | | `1` | Hesaptan | | `2` | Kredi Kartı | | `3` | Tümü | #### Para Birimi Değerleri | Değer | Para Birimi | | ----- | ---------------- | | `1` | TL | | `2` | Dolar | | `3` | Euro | | `4` | İngiliz Sterlini | | `5` | Japon Yeni | | `6` | İsviçre Frangı | | `7` | İsveç Kronu | *** ### İş Kuralları State geçişi sırasında sırasıyla aşağıdaki kontroller yapılır: 1. İş `Toplu Zeyil İsteği` aşamasında olmalıdır. 2. İsteği yapan kullanıcı sigorta şirketi kullanıcı eşleşmesinde kayıtlı olmalıdır. 3. Teklif + ürün için `PolicyEndorsement` operasyon kaydı bulunmalıdır ve daha önce başarıyla tamamlanmamış olmalıdır. 4. Zeyil ve prim bilgileri platform servisine yazılabilmelidir. > **Geri alma davranışı:** 4. kural başarısız olursa `OperationWatch` başarısız işaretlenir ve iş `Toplu Zeyil İsteği` aşamasına geri döndürülür. *** ### 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. ```json { "Status": false, "Code": "Validation.General", "Message": "One or more validation errors occurred", "Response": [ { "Field": "ProductId", "Message": "Product ID is required." }, { "Field": "Premiums", "Message": "Premium list cannot be empty." } ] } ``` *** #### `403 Forbidden` — Geçerli Sigorta Şirketi Ataması Bulunamadı Token'da geçerli bir sigorta şirketi ataması bulunmadığında döner. ```json { "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. ```json { "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. ```json { "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 `Create` 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. ```json { "Status": false, "Code": "OfflineJobs.JobNotFound", "Message": "No job found for the requested JobId: 100931.", "Response": null } ``` *** #### `500 Internal Server Error` — İş Kuralı İhlali İş uygun aşamada değilse, kullanıcının yetkisi yoksa, operasyon kaydı bulunamazsa veya zeyil bilgileri platform servisine yazılamazsa döner. `Message` alanı iş kuralı hatasının detayını içerir. ```json { "Status": false, "Code": "OfflineEndorsements.BatchEndorsementFailed", "Message": "Batch endorsement failed: Job Id : 100931 geçerli durumu Toplu Zeyil İsteği'nde olmalıdır.", "Response": null } ``` *** #### `500 Internal Server Error` — Beklenmeyen Hata Geçiş sırasında iş kuralı dışında bir hata oluştuğunda döner. ```json { "Status": false, "Code": "JobState.TransitionError", "Message": "An unexpected error occurred during job state transition.", "Response": null } ``` Reference: https://docs.insurgateway.com/insurgateway-api/offline/made-batch-endorsement ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Servers - `https://testgatewayapi.insurapps.net` (https://testgatewayapi.insurapps.net, default) - `https://gatewayapi.insurapps.net` (https://gatewayapi.insurapps.net) ## Request ### Path parameters - `jobId` (integer, required) ## Response ### 204 No Content ## Errors ### 400 Bad Request Error Bad Request ### 403 Forbidden Error Forbidden ### 404 Not Found Error Not Found ### 500 Internal Server Error Internal Server Error ## Examples **Request** ```json { "ProductId": 2321, "Message": "Toplu zeyil bilgileri iletilmiştir.", "Premiums": [ { "InsuranceCompanyProposalNumber": "SKT2026001", "InsuranceCompanyPolicyNumber": "POL2026000123", "InsuranceCompanyEndorsementNumber": "ZYL2026000045", "RenewalNumber": 0, "GrossPremium": 1200, "NetPremium": 1000, "Commision": 120, "PaymentOptionType": 1, "CurrencyType": 1 } ] } ``` **Response** ```json "" ``` **SDK Code** ```python Offline_madeBatchEndorsement_example import requests url = "https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Endorsements/batch" payload = { "ProductId": 2321, "Message": "Toplu zeyil bilgileri iletilmiştir.", "Premiums": [ { "InsuranceCompanyProposalNumber": "SKT2026001", "InsuranceCompanyPolicyNumber": "POL2026000123", "InsuranceCompanyEndorsementNumber": "ZYL2026000045", "RenewalNumber": 0, "GrossPremium": 1200, "NetPremium": 1000, "Commision": 120, "PaymentOptionType": 1, "CurrencyType": 1 } ] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Offline_madeBatchEndorsement_example const url = 'https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Endorsements/batch'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"ProductId":2321,"Message":"Toplu zeyil bilgileri iletilmiştir.","Premiums":[{"InsuranceCompanyProposalNumber":"SKT2026001","InsuranceCompanyPolicyNumber":"POL2026000123","InsuranceCompanyEndorsementNumber":"ZYL2026000045","RenewalNumber":0,"GrossPremium":1200,"NetPremium":1000,"Commision":120,"PaymentOptionType":1,"CurrencyType":1}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Offline_madeBatchEndorsement_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Endorsements/batch" payload := strings.NewReader("{\n \"ProductId\": 2321,\n \"Message\": \"Toplu zeyil bilgileri iletilmiştir.\",\n \"Premiums\": [\n {\n \"InsuranceCompanyProposalNumber\": \"SKT2026001\",\n \"InsuranceCompanyPolicyNumber\": \"POL2026000123\",\n \"InsuranceCompanyEndorsementNumber\": \"ZYL2026000045\",\n \"RenewalNumber\": 0,\n \"GrossPremium\": 1200,\n \"NetPremium\": 1000,\n \"Commision\": 120,\n \"PaymentOptionType\": 1,\n \"CurrencyType\": 1\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Offline_madeBatchEndorsement_example require 'uri' require 'net/http' url = URI("https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Endorsements/batch") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"ProductId\": 2321,\n \"Message\": \"Toplu zeyil bilgileri iletilmiştir.\",\n \"Premiums\": [\n {\n \"InsuranceCompanyProposalNumber\": \"SKT2026001\",\n \"InsuranceCompanyPolicyNumber\": \"POL2026000123\",\n \"InsuranceCompanyEndorsementNumber\": \"ZYL2026000045\",\n \"RenewalNumber\": 0,\n \"GrossPremium\": 1200,\n \"NetPremium\": 1000,\n \"Commision\": 120,\n \"PaymentOptionType\": 1,\n \"CurrencyType\": 1\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Offline_madeBatchEndorsement_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Endorsements/batch") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"ProductId\": 2321,\n \"Message\": \"Toplu zeyil bilgileri iletilmiştir.\",\n \"Premiums\": [\n {\n \"InsuranceCompanyProposalNumber\": \"SKT2026001\",\n \"InsuranceCompanyPolicyNumber\": \"POL2026000123\",\n \"InsuranceCompanyEndorsementNumber\": \"ZYL2026000045\",\n \"RenewalNumber\": 0,\n \"GrossPremium\": 1200,\n \"NetPremium\": 1000,\n \"Commision\": 120,\n \"PaymentOptionType\": 1,\n \"CurrencyType\": 1\n }\n ]\n}") .asString(); ``` ```php Offline_madeBatchEndorsement_example request('POST', 'https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Endorsements/batch', [ 'body' => '{ "ProductId": 2321, "Message": "Toplu zeyil bilgileri iletilmiştir.", "Premiums": [ { "InsuranceCompanyProposalNumber": "SKT2026001", "InsuranceCompanyPolicyNumber": "POL2026000123", "InsuranceCompanyEndorsementNumber": "ZYL2026000045", "RenewalNumber": 0, "GrossPremium": 1200, "NetPremium": 1000, "Commision": 120, "PaymentOptionType": 1, "CurrencyType": 1 } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Offline_madeBatchEndorsement_example using RestSharp; var client = new RestClient("https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Endorsements/batch"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"ProductId\": 2321,\n \"Message\": \"Toplu zeyil bilgileri iletilmiştir.\",\n \"Premiums\": [\n {\n \"InsuranceCompanyProposalNumber\": \"SKT2026001\",\n \"InsuranceCompanyPolicyNumber\": \"POL2026000123\",\n \"InsuranceCompanyEndorsementNumber\": \"ZYL2026000045\",\n \"RenewalNumber\": 0,\n \"GrossPremium\": 1200,\n \"NetPremium\": 1000,\n \"Commision\": 120,\n \"PaymentOptionType\": 1,\n \"CurrencyType\": 1\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Offline_madeBatchEndorsement_example import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "ProductId": 2321, "Message": "Toplu zeyil bilgileri iletilmiştir.", "Premiums": [ [ "InsuranceCompanyProposalNumber": "SKT2026001", "InsuranceCompanyPolicyNumber": "POL2026000123", "InsuranceCompanyEndorsementNumber": "ZYL2026000045", "RenewalNumber": 0, "GrossPremium": 1200, "NetPremium": 1000, "Commision": 120, "PaymentOptionType": 1, "CurrencyType": 1 ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Endorsements/batch")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```