Sigorta Teklifi Oluştur

Sistemde bir deklarasyon için yeni bir sigorta teklifi oluşturur.

İstek

POST /api/v1/declarations/{declaration_id}/insurances

Parametreler

İsim	Tip	Yer	Açıklama
declaration_id	string	path	Gerekli. Deklarasyonun ID'si
username	string	body	Gerekli. Sigorta sağlayıcı kullanıcı adı
password	string	body	Gerekli. Sigorta sağlayıcı şifresi
owner_identity_number	string	body	Gerekli. Poliçe sahibinin kimlik numarası
policy_number	string	body	Gerekli. Poliçe numarası
policy_renewal_number	number	body	Gerekli. Poliçe yenileme numarası
policy_currency_type	string	body	Gerekli. Poliçenin para birimi (örn. USD)
policy_asset_description	string	body	Gerekli. Poliçedeki varlığın açıklaması
policy_reference_number	string	body	Gerekli. Poliçenin referans numarası
flotan_policy_number	string	body	İsteğe bağlı. Flotan poliçe numarası
asset_value	number	body	Gerekli. Varlığın değeri
asset_value_currency_type	string	body	Gerekli. Varlık değerinin para birimi
asset_description_english	string	body	Gerekli. Varlığın İngilizce açıklaması
is_asset_used	boolean	body	Gerekli. Varlığın kullanılmış olup olmadığı
transport_license_plate	string	body	Gerekli. Taşıma aracının plakası
goods_to_be_printed_on_policy	string	body	Gerekli. Poliçeye yazılacak malların açıklaması
from_country	string	body	Gerekli. Menşei ülke
from_city	string	body	Gerekli. Menşei şehir
from_region	string	body	Gerekli. Menşei bölge
to_country	string	body	Gerekli. Varış ülkesi
to_city	string	body	Gerekli. Varış şehri
to_region	string	body	Gerekli. Varış bölgesi
transport_type	string	body	Gerekli. Taşıma türü
transport_vehicle_count	number	body	Gerekli. Taşıma araç sayısı
loading_date	string	body	Gerekli. Yükleme tarihi (YYYY-MM-DD)
beneficiary_name	string	body	İsteğe bağlı. Lehtarın adı
letter_of_credit_number	string	body	İsteğe bağlı. Akreditif numarası
imo_number	string	body	İsteğe bağlı. IMO numarası
policy_description_turkish	string	body	Gerekli. Poliçenin Türkçe açıklaması
policy_description_english	string	body	Gerekli. Poliçenin İngilizce açıklaması

Başlıklar

İsim	Açıklama
Authorization	Gerekli. Kimlik doğrulama için Bearer token
Content-Type	Gerekli. application/json olmalıdır
X-Target-Server	Gerekli. Hedef sunucu tanımlayıcısı

Örnek

curl --request POST \
  --url '{{HOST}}/api/v1/declarations/67db101b6f7e65dcdd379d6f/insurances' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'Content-Type: application/json' \
  --header 'X-Target-Server: declaration' \
  --data '{
    "username": "A4882222",
    "password": "NKL123456!",
    "owner_identity_number": "3241047192",
    "policy_number": "1077607962",
    "policy_renewal_number": 0,
    "policy_currency_type": "USD",
    "policy_asset_description": "Policeye Basilacak Emtia",
    "policy_reference_number": "24-00025",
    "flotan_policy_number": "",
    "asset_value": 1000,
    "asset_value_currency_type": "USD",
    "asset_description_english": "Personal belongings and electronics",
    "is_asset_used": false,
    "transport_license_plate": "34ABC123",
    "goods_to_be_printed_on_policy": "Policeye Basilacak Emtia",
    "from_country": "ÇİN",
    "from_city": "WOHAM",
    "from_region": "WOHAM",
    "to_country": "TÜRKİYE",
    "to_city": "ISTANBUL",
    "to_region": "AHL",
    "transport_type": "vehicle",
    "transport_vehicle_count": 1,
    "loading_date": "2025-05-20",
    "beneficiary_name": "",
    "letter_of_credit_number": "",
    "imo_number": "",
    "policy_description_turkish": "Kişisel eşyalar ve elektronik ürünler için sigorta poliçesi",
    "policy_description_english": "Insurance policy for personal belongings and electronics"
  }'

Yanıt

Başarılı bir istek, "OK" yanıtı ile birlikte HTTP 200 durum kodu döndürür.

Durum Kodları

Durum Kodu	Açıklama
200	Başarılı
400	Hatalı İstek - Geçersiz parametreler
401	Yetkisiz - Geçersiz veya eksik kimlik doğrulama tokeni
404	Bulunamadı - Deklarasyon ID'si mevcut değil
500	Sunucu Hatası

Notlar

Sigorta teklifi isteğini gönderdikten sonra, durumunu sigorta teklifi arama endpoint'i kullanarak takip edebilirsiniz.