Müşavir

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/api/musavir/v1/faturalar

Fatura list

Oturum
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/faturalar/{id}/esmm

Kes

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/esmm" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/{id}/gecikme-faizi

GET — seçili sağlayıcı + sağlık paneli verisi (BLE2-8271).

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/gecikme-faizi" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/faturalar/{id}/gecikme-faizi

Tahakkuk — mukellef.manage. Geri alınamaz bir para kaydı yazıyor, rutin okuma değil.

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/gecikme-faizi" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/{id}/gecikme-hatirlatma

Sözleşme değişiklik geçmişi (BLE-7292) — çekirdek blesyum_audit üzerinden okunur.

OturumYol parametresi: id

Modü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.

İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/gecikme-hatirlatma" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/{id}/odeme-linki

Link list

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/odeme-linki" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/faturalar/{id}/odeme-linki

Link

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/odeme-linki" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/faturalar/{id}/tahsilat

Tahsilat

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/tahsilat" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/{id}/tahsilat

Tahsilat list

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/tahsilat" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/faturalar/{id}/taksit-plani

Taksit kur

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/taksit-plani" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/{id}/taksitler

Taksit list

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/<id>/taksitler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/gecikenler

Geciken

Oturum
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/gecikenler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/faturalar/gecikme-hatirlatma/calistir

Gecikme taramasını elle tetikle (zamanlanmış iş MÜF22'de aynı fonksiyonu çağıracak).

Oturum

🔴 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.

İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/gecikme-hatirlatma/calistir" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/hareketler

Yaşlandırma satırının drill-down'ı: tek müvekkilin fatura + ödeme dökümü (BLE-7464).

Oturum
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/hareketler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/faturalar/kes

Fatura kes

Oturum
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/kes" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/ozet

Uyum özeti — BÜRO GENELİ sayılar.

Oturum

🔴 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.

İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/ozet" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/faturalar/toplu-kes

Toplu dönemsel faturalama (BLE-7364).

Oturum

🔴 İ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.

İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/toplu-kes" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/yaslandirma

Yaslandirma

Oturum
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/yaslandirma" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/faturalar/yaslandirma/export

Yaslandirma export

Oturum
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/faturalar/yaslandirma/export" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?