Mutabakat Raporu

Sağlayıcınızla mutabakat için bağlantı bazlı poliçe ve prim raporunu API'den alırsınız. Panelin Mutabakat ekranındaki rapor da aynı verilerden oluşur: Sigorta Menüsü › Mutabakat.

Rakamlar sigorta siparişlerinizin kendisinden okunur. Aynı süzgeçle özet uçtaki toplamlar, satır ucundaki ve CSV dosyasındaki satırların toplamına eşittir.
Durumlar raporu aldığınız andaki durumlardır.
Checkout Form'da ve API'de oluşan siparişlerin hepsi rapordadır; prim Lunixi ödemesinde, Lunixi dışında ya da sağlayıcı tarafından tahsil edilmiş olabilir.

Kimlik doğrulama ve imzalama: Akışlar › Kimlik doğrulama.

Süzgeç

Üç uç aynı süzgeci alır:

Sorgu parametresi	Tip	Zorunlu	Açıklama
`from`	string	Evet	Dönemin başı (dahil). ISO 8601, saat dilimi zorunlu (`Z` ya da `±hh:mm`).
`to`	string	Evet	Dönemin sonu (hariç). ISO 8601, saat dilimi zorunlu.
`connectionId`	string (UUID)	Hayır	Yalnız bu sağlayıcı bağlantısının siparişleri.
`insuranceType`	string	Hayır	Yalnız bu sigorta tipinin siparişleri, ör. `TICKET_CANCELLATION`.
`currency`	string	Hayır	Yalnız bu para birimindeki siparişler, ISO 4217.

Dönem siparişin oluşturulma anına göredir ve yarı açıktır: from dahil, to hariç. Dönem en fazla 366 gündür.
Sorgu dizesinde saat dilimindeki + işaretini %2B olarak yazın.

Dönem kuralına uymayan istek 422 insurance.validation.invalid döner:

`field`	`reason`	Anlamı
`filter.from`, `filter.to`	`timezone_required`	Zaman damgasında saat dilimi yok.
`filter.from`, `filter.to`	`invalid_timestamp`	Değer ISO 8601 zaman damgası değil.
`filter.to`	`not_after_from`	`to`, `from`'dan sonra değil.
`filter.to`	`period_too_long`	Dönem 366 günden uzun.

from ya da to gönderilmezse, connectionId UUID değilse ya da currency veya insuranceType biçim dışıysa istek 400 VALIDATION_ERROR döner.

Özet: `GET /api/v1/insurance/reconciliation/summary`

Dönemin toplamlarını bağlantı, para birimi ve primi tahsil eden başına gruplar hâlinde döner.

source lunixi-sign.sh
REQ_PATH="/api/v1/insurance/reconciliation/summary?from=2026-09-01T00:00:00Z&to=2026-10-01T00:00:00Z"
lunixi_sign GET "$REQ_PATH"
 
curl "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"

data şu alanları taşır:

Alan	Tip	Açıklama
`period.from`, `period.to`	string	İstediğiniz dönem.
`filters.connectionId`, `filters.insuranceType`, `filters.currency`	string ya da `null`	Uygulanan süzgeçler; gönderilmediyse `null`.
`groups`	dizi	Bağlantı, para birimi ve primi tahsil eden başına bir grup; alanları aşağıda.
`generatedAt`	string	Raporun oluşturulduğu an, ISO 8601.

groups[]:

Alan	Tip	Açıklama
`provider.code`	string	Sağlayıcının Lunixi kataloğundaki kodu.
`provider.name`	string	Sağlayıcının adı.
`provider.logoUrl`	string ya da `null`	Sağlayıcının logosu.
`provider.connectionId`	string	Sağlayıcı bağlantınızın kimliği.
`currency`	string	Para birimi, ISO 4217.
`premiumCollectedBy`	string	Primi kimin tahsil ettiği: `MERCHANT` ya da `PROVIDER`.
`totals`	nesne	Toplamlar; alanları aşağıda.

totals, tutarlar kuruş:

Alan	Neyi sayar
`orderCount`, `premiumAmount`	Dönemde oluşturulan siparişler ve primleri.
`collectedOrderCount`, `collectedPremiumAmount`	Primi tahsil edilmiş siparişler (`collectionStatus: COLLECTED`).
`policyCount`	Poliçe sayısı.
`inForcePolicyCount`, `inForcePremiumAmount`	Yürürlükteki poliçeler (`ISSUED` ya da `CANCEL_PENDING`) ve primleri. İptal talebi açık poliçe, sağlayıcı iptali kesinleştirene kadar burada sayılır.
`cancelledPolicyCount`, `cancelledPremiumAmount`	Sağlayıcının iptali kesinleştirdiği poliçeler (`CANCELLED`) ve primleri.
`refundedOrderCount`, `refundedPremiumAmount`	Prim iadesi tamamlanmış siparişler (`refundStatus: REFUNDED`).
`refundOpenOrderCount`, `refundOpenPremiumAmount`	Prim iadesi gereken, süren ya da başarısız olan siparişler (`REQUIRED`, `PENDING` ya da `FAILED`).

Tahsilat ve iade toplamları sipariş başına, poliçe toplamları poliçe başınadır.

Satırlar: `GET /api/v1/insurance/reconciliation/orders`

Özetin arkasındaki siparişleri poliçeleriyle birlikte, en yeniden eskiye, cursor tabanlı sayfalar hâlinde döner. Süzgeç parametrelerine ek olarak:

Sorgu parametresi	Tip	Açıklama
`limit`	integer	Sayfa başına sipariş, 1-100. Varsayılan 100.
`cursor`	string	Önceki yanıttaki `pageInfo.nextCursor`. İlk sayfada gönderilmez.

Yanıtta satırlar data.items dizisindedir; sayfalama bilgisi pageInfo alanındadır.

Alan	Tip	Açıklama
`orderId`	string	Sipariş kimliği (`inso_…`).
`merchantOrderId`	string ya da `null`	Kendi sipariş numaranız.
`paymentIntentId`	string ya da `null`	Bağlı Lunixi ödemesinin kimliği.
`externalPaymentId`	string ya da `null`	Lunixi dışında alınan primde bildirdiğiniz ödeme kimliği.
`insuranceType`	string	Sigorta tipi.
`connectionId`	string	Sağlayıcı bağlantınızın kimliği.
`providerCode`	string	Sağlayıcının Lunixi kataloğundaki kodu.
`premiumCollectedBy`	string	`MERCHANT` ya da `PROVIDER`.
`paymentMode`	string	`NO_PAYMENT`, `LUNIXI_PAYMENT` ya da `EXTERNAL_PAYMENT`.
`premiumAmount`	integer	Siparişin primi, kuruş.
`currency`	string	Para birimi, ISO 4217.
`collectionStatus`, `policyStatus`, `refundStatus`	string	Siparişin durum eksenleri: Kavramlar › Sipariş durumları.
`createdAt`	string	Siparişin oluşturulma anı.
`collectedAt`	string ya da `null`	Primin tahsil edildiği an.
`refundedAt`	string ya da `null`	İadenin kesinleştiği an.
`policies`	dizi	Siparişin poliçeleri; alanları aşağıda. Henüz poliçe yoksa boş dizidir.

policies[]:

Alan	Tip	Açıklama
`policyId`	string	Poliçe kimliği (`insp_…`).
`basketItemId`	string	Poliçenin sigortaladığı sepet kalemi.
`policyNumber`	string ya da `null`	Poliçe belgesindeki numara.
`policyStatus`	string	Poliçenin durumu.
`premiumAmount`	integer	Poliçenin primi, kuruş.
`cancelledAt`	string ya da `null`	İptalin kesinleştiği an.

Bozuk bir cursor 422 insurance.validation.invalid (field: cursor) döner.

CSV: `GET /api/v1/insurance/reconciliation/export`

Rapor satırlarını CSV dosyası olarak döner. Süzgeç parametreleri aynıdır; kesilen bir dosyayı sürdürmek için ayrıca cursor alır.

source lunixi-sign.sh
REQ_PATH="/api/v1/insurance/reconciliation/export?from=2026-09-01T00:00:00Z&to=2026-10-01T00:00:00Z"
lunixi_sign GET "$REQ_PATH"
 
curl "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE" \
  -o mutabakat.csv

Başlık	Değer
`Content-Type`	`text/csv; charset=utf-8`
`Content-Disposition`	`attachment; filename="insurance-reconciliation-<YYYY-MM-DD>.csv"`
`Cache-Control`	`no-store`
`X-Export-Order-Cap`	Bir dosyadaki en fazla sipariş sayısı.

Dosya UTF-8'dir ve BOM ile başlar. Tutarlar kuruştur.
Her poliçe bir satırdır. Sipariş sütunları siparişin her poliçe satırında tekrar eder; henüz poliçesi olmayan sipariş, poliçe sütunları boş tek satırdır. Sipariş toplamı için orderPremiumAmountMinor değerini orderId başına bir kez, poliçe toplamı için policyPremiumAmountMinor değerini toplayın.
Bir dosya en fazla 20.000 sipariş içerir. Sınıra ulaşılırsa dosyanın son satırı # truncated=true orderCap=20000 nextCursor=<imleç> olur; kalan siparişler için isteği aynı süzgeç ve cursor=<imleç> ile tekrarlayın.
Dışa aktarım yarıda kesilirse dosyanın son satırı # export-aborted=true olur ve dosya eksiktir; dosyayı yeniden indirin.
İstek doğrulanamazsa yanıt CSV değil, JSON hata zarfıdır. Yanıtın Content-Type başlığına bakın.

Sütun grubu	Sütunlar
Sipariş	`orderId`, `merchantOrderId`, `paymentIntentId`, `externalPaymentId`, `orderCreatedAt`, `collectedAt`, `insuranceType`, `connectionId`, `providerCode`, `premiumCollectedBy`, `paymentMode`, `currency`, `orderPremiumAmountMinor`, `collectionStatus`, `orderPolicyStatus`, `refundStatus`, `refundedAt`
Poliçe	`policyId`, `policyNumber`, `basketItemId`, `policyStatus`, `policyPremiumAmountMinor`, `cancelledAt`

Hatalar

HTTP	`code`	Ne yapmalı
`400`	`VALIDATION_ERROR`	Sorgu parametrelerinin biçimini düzeltin.
`422`	`insurance.validation.invalid`	Dönemi düzeltin; `details.errors[]` alanına bakın (Süzgeç).

Ortak kodlar: Akışlar › Yanıt ve hatalar.

İlgili

Sigorta Menüsü › Mutabakat: paneldeki rapor
Sipariş ve Ödeme Bağlama: sipariş nesnesi
Kavramlar ve Durumlar: durum eksenleri

Talep Uç Referansı