faturalar
19 uç · /api/musavir/v1/faturalar
İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 19 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.
GET — seçili sağlayıcı + sağlık paneli verisi (BLE2-8271).
idcurl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/gecikme-faizi" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Tahakkuk — mukellef.manage. Geri alınamaz bir para kaydı yazıyor, rutin okuma değil.
idcurl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/gecikme-faizi" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Sözleşme değişiklik geçmişi (BLE-7292) — çekirdek blesyum_audit üzerinden okunur.
idModül kendi log tablosunu YAZMAZ: kendi tablosunu yazan bir modül çekirdeğin WORM garantilerini kaybeder ve "denetim izi" adını hak etmeyen, silinebilir bir log elde eder.
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/gecikme-hatirlatma" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Gecikme taramasını elle tetikle (zamanlanmış iş MÜF22'de aynı fonksiyonu çağıracak).
🔴 mukellef.manage — .view DEĞİL. Uç kalıcı kayıt yazar ve personele bildirim atar;
makine seam'idir, rutin okuma değil. Damga geri alınamaz.
🔴 Kapsam süzgeci YOK — ve bu BİLEREK (1001 ile aynı gerekçe): tarama BÜRO GENELİNDE koşar.
Kapsamlı koşsaydı bir uyarının üretilip üretilmemesi, işi TETİKLEYEN personelin portföyüne
bağlı olurdu; aynı fatura bir personel tetiklediğinde uyarı üretir, başkası tetiklediğinde
üretmezdi. Alacak büronundur, tetikleyenin değil. Uç yalnız SAYI döndürür (hangi müvekkil,
hangi fatura bilgisini SIZDIRMAZ); ayrıntıyı herkes kendi kapsamlı listesinden görür.
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/gecikme-hatirlatma/calistir" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Yaşlandırma satırının drill-down'ı: tek müvekkilin fatura + ödeme dökümü (BLE-7464).
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/hareketler" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Uyum özeti — BÜRO GENELİ sayılar.
🔴 aktarim_uyum_ozeti security definerdır: kapsam kilidi DETAYI gizler (bir müvekkilin
adı, onu göremeyen personele sızmaz) ama uyum SAYISI eksik okunmamalıdır. Kapsamlı bir
personel "3 dayanaksız aktarım" yerine "0" görseydi, gördüğü sıfır bir güvence olurdu —
P7'nin 72 saat sayacının birebir aynı ayrımı. Fonksiyon hiçbir müvekkil kimliği döndürmez.
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/ozet" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Toplu dönemsel faturalama (BLE-7364).
🔴 İzin fatura_kes ile AYNI (mukellef.manage) ve kapsam süzgeci ZORUNLU. Tek tek
faturalamayı kapsam dışı müvekkil için reddedip toplu ucu süzmeseydik, aynı yasak iş
tek istekle ve DAHA BÜYÜK ölçekte yapılabilirdi: yan kapı, ana kapıdan geniş olurdu.
Kapsam burada bir 403/404 üretmez — süzgeçtir. Yabancı sözleşmeler aday kümesine hiç
girmez, dolayısıyla "kaç fatura üretildi" sayısı bile kapsam dışının VARLIĞINI sızdırmaz.
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/toplu-kes" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}