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

Hatırlatma 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 işi değil. (MÜF1'de `takvim POST /hatirlatilacaklar` aynı gerekçeyle `.manage`e alınmıştı: damga geri alınamaz.) 🔴 Kapsam süzgeci YOK — ve bu BİLEREK: tarama BÜRO GENELİNDE koşar. Kapsamlı koşsaydı hatırlatmanın üretilip üretilmemesi, işi TETİKLEYEN personelin portföyüne bağlı olurdu; aynı sözleşme bir personel tetiklediğinde uyarı üretir, başkası tetiklediğinde üretmezdi. Yükümlülük büronundur, tetikleyenin değil. Uç yalnız SAYI döndürür (hangi müvekkil, hangi sözleşme 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

🔴 Portal, **personelinkiyle AYNI** `satis_fatura::fatura_kes` yolunu kullanır. O yol:

Oturum

doğrula → (tx YOKKEN) numara al → yaz; senaryoyu GİB'e sorar ve cevap alamazsa fatura **kesilmez** (uydurmaz); onaylı faturanın içeriği donar. Portala özel bir kesme yolu yazmak, bu kuralların hepsini atlamanın en kolay yoluydu — ve mükellefin resmî fatura serisinde boşluk/mükerrerlik demekti.

İ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

Paketin künyesi (indirmeden önce "ne çıkacak?" sorusunun cevabı).

Oturum
İ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ı?
Hâlâ takıldın mı? Destek al