> 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 Policy POST https://testgatewayapi.insurapps.net/api/Offline/jobs/{jobId}/Policies/batch Content-Type: application/json ## Toplu Poliçe Kaydet ### Endpoint Bilgileri | Alan | Değer | | ----------------- | ----------------------------------------------------- | | **Method** | `POST` | | **URL** | `{{baseUrl}}/api/Offline/jobs/{jobId}/Policies/batch` | | **Content-Type** | `application/json` | | **Yetkilendirme** | Bearer Token + `Create` politikası | *** Sigorta şirketinin, acentenin toplu poliçe talebine karşılık **kesilen poliçe bilgilerini** kaydetmesi için kullanılır. Başarılı istekte iş `Toplu Poliçe Gerçekleşti` (`BatchPolicyMade`) aşamasına geçer, poliçe ve prim bilgileri platform servisine yazılır ve aksiyon kaydı oluşturulur. > İşin aşaması `Toplu Poliçe İsteği` (`BatchPolicyRequested`) olmalıdır; aksi halde geçiş reddedilir. *** ### Route Parametreleri | Parametre | Tip | Zorunlu | Açıklama | | --------- | --------- | ------- | --------------------------------------- | | `jobId` | `integer` | Evet | Poliçeleri 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 > İşin sigorta şirketi, token'daki sigorta şirketi listesinde bulunmalıdır. Ayrıca `InsuranceCompanyAPIUser` yalnızca kendi sahibi olduğu işleri işleyebilir; `InsuranceCompanyAPIAdmin` ve `Supervizor` şirketin tüm işlerine erişebilir. *** ### İstek Modeli — `MakeBatchPolicyRequest` | Alan | Tip | Zorunlu | Açıklama | Doğrulama | | ------------------- | --------------------------- | ------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------ | | `ProductId` | `integer` | Evet | Poliçelerin kesildiği ürün Id | 0'dan büyük olmalı: `"ProductId must be greater than zero."` | | `IsPremiumDiscount` | `boolean` | Hayır | Toplu poliçenin revize (indirim) akışına ait olup olmadığı | — | | `Message` | `string` | Hayır | Toplu poliçeye iliştirilen not | Maks. 500 karakter: `"Message cannot exceed 500 characters."` | | `Premiums` | `BatchPolicyEntryRequest[]` | Evet | Poliçe 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."` #### Poliçe Girişi — `BatchPolicyEntryRequest` | Alan | Tip | Zorunlu | Açıklama | Doğrulama | | ----------------------------------- | --------- | ------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------- | | `InsuranceCompanyPolicyNumber` | `string` | Evet | Sigorta şirketi poliçe numarası | Boş olamaz: `"InsuranceCompanyPolicyNumber is required."` | | `InsuranceCompanyProposalNumber` | `string` | Hayır | Sigorta şirketi teklif numarası | — | | `InsuranceCompanyEndorsementNumber` | `string` | Hayır | Sigorta şirketi zeyil numarası | — | | `RenewalNumber` | `integer` | Evet | Yenileme numarası | 0'dan büyük veya eşit olmalı: `"RenewalNumber 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."` | | `Commission` | `decimal` | Evet | Komisyon | 0'dan büyük veya eşit olmalı: `"Commission must be greater than or equal to 0."` | | `PaymentOptionType` | `integer` | Evet | Ödeme tipi | `1` (Hesaptan) veya `2` (KrediKarti) olmalı: `"PaymentOptionType must be Hesaptan (1) or KrediKarti (2)."` | | `CurrencyType` | `integer` | Evet | Para birimi | Tanımlı bir değer olmalı: `"CurrencyType must be a valid currency type."` | #### 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; herhangi biri başarısız olursa istek reddedilir: 1. İş `Toplu Poliçe İ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 başka bir sigorta şirketi tarafından poliçeleştirilmiş olmamalıdır. 4. Teklif + ürün için `GetPolicy` operasyon kaydı bulunmalıdır ve daha önce başarıyla poliçeleştirilmemiş olmalıdır. 5. Poliçe ve prim bilgileri platform servisine yazılabilmelidir. > **Geri alma davranışı:** 5. kural başarısız olursa `OperationWatch` başarısız işaretlenir ve iş `Toplu Poliçe İsteği` aşamasına geri döndürülür. *** ### Yanıt #### `201 Created` — 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": "ProductId must be greater than zero." }, { "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` — İşin Sigorta Şirketi Kapsam Dışı İşin sigorta şirketi, token'daki sigorta şirketi listesinde yoksa döner. ```json { "Status": false, "Code": "OfflineJobs.JobInsuranceCompanyDenied", "Message": "You do not have permission to access jobs of this insurance company.", "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, teklif başka şirketten poliçeleşmişse, operasyon kaydı bulunamazsa veya teklif daha önce poliçeleştirilmişse döner. `Message` alanı iş kuralı hatasının detayını içerir. ```json { "Status": false, "Code": "JobState.UnknownBusinessRule", "Message": "An unknown business rule error occurred: Job Id : 100931 geçerli durumu Toplu Poliçe İsteği'nde olmalıdır.", "Response": null } ``` *** #### `500 Internal Server Error` — Platform Servisi Hatası Poliçe ve prim bilgileri platform servisine yazılamadığında döner. ```json { "Status": false, "Code": "JobState.PlatformServiceFailure", "Message": "Failed to write premium information to the platform service. Platform returned: Poliçe, Prim ve taksit bilgileri platform servisine yazdırılamadı! Servisten dönen hata: Timeout", "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-policy ## 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 ### 201 Created ## 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, "IsPremiumDiscount": false, "Message": "Toplu poliçe bilgileri iletilmiştir.", "Premiums": [ { "InsuranceCompanyProposalNumber": "SKT2026001", "InsuranceCompanyPolicyNumber": "POL2026000123", "InsuranceCompanyEndorsementNumber": null, "RenewalNumber": 0, "GrossPremium": 5000, "NetPremium": 4500, "Commission": 500, "PaymentOptionType": 1, "CurrencyType": 1 } ] } ``` **Response** ```json "" ``` **SDK Code** ```python Offline_madeBatchPolicy_example import requests url = "https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Policies/batch" payload = { "ProductId": 2321, "IsPremiumDiscount": False, "Message": "Toplu poliçe bilgileri iletilmiştir.", "Premiums": [ { "InsuranceCompanyProposalNumber": "SKT2026001", "InsuranceCompanyPolicyNumber": "POL2026000123", "InsuranceCompanyEndorsementNumber": None, "RenewalNumber": 0, "GrossPremium": 5000, "NetPremium": 4500, "Commission": 500, "PaymentOptionType": 1, "CurrencyType": 1 } ] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Offline_madeBatchPolicy_example const url = 'https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Policies/batch'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"ProductId":2321,"IsPremiumDiscount":false,"Message":"Toplu poliçe bilgileri iletilmiştir.","Premiums":[{"InsuranceCompanyProposalNumber":"SKT2026001","InsuranceCompanyPolicyNumber":"POL2026000123","InsuranceCompanyEndorsementNumber":null,"RenewalNumber":0,"GrossPremium":5000,"NetPremium":4500,"Commission":500,"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_madeBatchPolicy_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Policies/batch" payload := strings.NewReader("{\n \"ProductId\": 2321,\n \"IsPremiumDiscount\": false,\n \"Message\": \"Toplu poliçe bilgileri iletilmiştir.\",\n \"Premiums\": [\n {\n \"InsuranceCompanyProposalNumber\": \"SKT2026001\",\n \"InsuranceCompanyPolicyNumber\": \"POL2026000123\",\n \"InsuranceCompanyEndorsementNumber\": null,\n \"RenewalNumber\": 0,\n \"GrossPremium\": 5000,\n \"NetPremium\": 4500,\n \"Commission\": 500,\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_madeBatchPolicy_example require 'uri' require 'net/http' url = URI("https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Policies/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 \"IsPremiumDiscount\": false,\n \"Message\": \"Toplu poliçe bilgileri iletilmiştir.\",\n \"Premiums\": [\n {\n \"InsuranceCompanyProposalNumber\": \"SKT2026001\",\n \"InsuranceCompanyPolicyNumber\": \"POL2026000123\",\n \"InsuranceCompanyEndorsementNumber\": null,\n \"RenewalNumber\": 0,\n \"GrossPremium\": 5000,\n \"NetPremium\": 4500,\n \"Commission\": 500,\n \"PaymentOptionType\": 1,\n \"CurrencyType\": 1\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Offline_madeBatchPolicy_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/Policies/batch") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"ProductId\": 2321,\n \"IsPremiumDiscount\": false,\n \"Message\": \"Toplu poliçe bilgileri iletilmiştir.\",\n \"Premiums\": [\n {\n \"InsuranceCompanyProposalNumber\": \"SKT2026001\",\n \"InsuranceCompanyPolicyNumber\": \"POL2026000123\",\n \"InsuranceCompanyEndorsementNumber\": null,\n \"RenewalNumber\": 0,\n \"GrossPremium\": 5000,\n \"NetPremium\": 4500,\n \"Commission\": 500,\n \"PaymentOptionType\": 1,\n \"CurrencyType\": 1\n }\n ]\n}") .asString(); ``` ```php Offline_madeBatchPolicy_example request('POST', 'https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Policies/batch', [ 'body' => '{ "ProductId": 2321, "IsPremiumDiscount": false, "Message": "Toplu poliçe bilgileri iletilmiştir.", "Premiums": [ { "InsuranceCompanyProposalNumber": "SKT2026001", "InsuranceCompanyPolicyNumber": "POL2026000123", "InsuranceCompanyEndorsementNumber": null, "RenewalNumber": 0, "GrossPremium": 5000, "NetPremium": 4500, "Commission": 500, "PaymentOptionType": 1, "CurrencyType": 1 } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Offline_madeBatchPolicy_example using RestSharp; var client = new RestClient("https://testgatewayapi.insurapps.net/api/Offline/jobs/1/Policies/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 \"IsPremiumDiscount\": false,\n \"Message\": \"Toplu poliçe bilgileri iletilmiştir.\",\n \"Premiums\": [\n {\n \"InsuranceCompanyProposalNumber\": \"SKT2026001\",\n \"InsuranceCompanyPolicyNumber\": \"POL2026000123\",\n \"InsuranceCompanyEndorsementNumber\": null,\n \"RenewalNumber\": 0,\n \"GrossPremium\": 5000,\n \"NetPremium\": 4500,\n \"Commission\": 500,\n \"PaymentOptionType\": 1,\n \"CurrencyType\": 1\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Offline_madeBatchPolicy_example import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "ProductId": 2321, "IsPremiumDiscount": false, "Message": "Toplu poliçe bilgileri iletilmiştir.", "Premiums": [ [ "InsuranceCompanyProposalNumber": "SKT2026001", "InsuranceCompanyPolicyNumber": "POL2026000123", "InsuranceCompanyEndorsementNumber": , "RenewalNumber": 0, "GrossPremium": 5000, "NetPremium": 4500, "Commission": 500, "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/Policies/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() ```