Fatura listesi

Amaç

Ön ödemeli yükleme faturalarının sayfalı dökümü, en yeni önce. SALT OKUMA ve yan etkisiz (CQS): fatura kaydı yalnız başarılı yükleme akışında açılır, bu uç hiçbir şey oluşturmaz ve Idempotency-Key sözleşmesi yoktur. Uç TASK-316'da açıldı ve sebebi kayıtlıdır: fatura okuma TASK-038 B4'ten beri yalnız SPA grubundaydı ve bir oturum istiyordu; REQ-021'in kapalı yetki kümesi iş ortağına fatura okuma verir, iş ortağı ise oturum değil anahtar taşır. Aynı denetleyici iş ortağı yüzeyinde de kullanılır ve ikinci bir okuma mantığı yazılmaz.

Yetki

Bearer anahtar; döküm anahtarın tenant'ına sunucu tarafında sınırlanır (başka tenant'ın faturası görünmez).

Başarı 200

{"data": [{"id": "...", "amount_minor": 25000, "currency": "TRY", "status": "pending_issue", "number": null, "issued_at": null, "created_at": "..."}], "links": {...}, "meta": {...}}; açık projeksiyon: tenant_id ve top_up_id hiçbir yanıta giremez. Satır alanları GET /invoices (SPA) ile aynı beyaz listedir (tek projeksiyon); zarf ise v1 sayfalama sözleşmesidir ve SPA ucunun çerçeve varsayılanı olan şeklinden bilerek farklıdır. number ve issued_at yalnız e-arşiv kesildiğinde dolar (TASK-046); o zamana dek null ve durum pending_issue.

Sorgu

per_page 1..100 (varsayılan 15), page. Sınır aşımı 422.

Hatalar

401, 422, 429.

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.

curl "{{base_url}}/invoices?per_page=15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"