İş ortağı yüzeyi sözleşmesi Okuma PA-29

Fatura listesi

GET/api/partner/v1/invoices

> Künye: TASK-316; REQ-021 KK-7, DEC-253.

Amaç

Hesabın fatura dökümünü okumak. PA-20 ile aynı denetleyici.

Kendi hesap gönderileri bu listede GÖRÜNMEZ ve bu bir eksik DEĞİLDİR

(TASK-413; DEC-363, DEC-372): Sevkora faturası bir BAKİYE YÜKLEME belgesidir ve gönderiyle hiçbir bağı yoktur, dolayısıyla hiçbir gönderi burada satır üretmez. Kendi hesap modelinde (ortak shipment nesnesinde billing_mode değeri carrier_direct) ücreti taşıyıcı kendi müşterisine faturalar; Sevkora ücret almaz, bakiye düşmez ve belge kesmez. Ayrım yapısaldır ve mekanik bir sözleşme testiyle kilitlidir.

Yetki

İki kademeli kimlik: X-App-Key + Authorization: Bearer. Hesap anahtarı partner-api yeteneği taşır ve tek başına /api/v1e giremez.

Başarı 200

sayfalanmış fatura listesi.

Hatalar

401, 403 (askıda ya da köken uyuşmazlığı), 429 (Retry-After).

Idempotency-Key

sözleşmesi yoktur (salt-okuma).

kabuk

curl "{{host}}/api/partner/v1/invoices?page=1&per_page=25" \
  -H "Accept: application/json" \
  -H "X-App-Key: SEVKORA_UYGULAMA_ANAHTARINIZ" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"