Müşavir

satis-faturalari

19 uç · /api/musavir/v1/satis-faturalari

İ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/satis-faturalari

List

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

Create

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

Taslak faturayı düzenle (BLE2-7893).

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

Taslak faturayı sil (BLE2-7893). **Onaylı fatura silinmez** — iptal edilir.

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

Iptal

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

Faturayı mali mühürle imzala → XAdES zarfına sar (BLE2-7876).

OturumYol parametresi: id

🔴 Bu uç, seam'i **yetim bırakmamak** için var: MÜF8 Paket 6/7'de tanımlanıp hiçbir yerden çağrılmayan üç seam çıktı ve üçü de "yapıldı" sayılmıştı. Bugün mühür bağlı olmadığı için dürüst bir 400 dönüyor (`muhur_yok:*`) — ama yol GERÇEK: MÜF22'de canlı adaptör takıldığı anda imzalı belge üretmeye başlar, ayrıca bir kablolama gerekmez.

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

Onayla

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

Pdf

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

Portal tamamla

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

Profil

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

Ticari ac

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

Ticari yanit

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

Ubl

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

Kuyruk list

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

UBL'i hazır belgeleri GİB'e gönder (BLE2-7906).

Oturum

🔴 Bu uç `kuyruk_gonder`i **çağıran** yoldur. Çağıransız bırakılsaydı `gonderildi` durumu yine hiç yazılmaz ve belge `uretiliyor`da takılı kalırdı — Paket 1'in aynı arızası. ## 🔴 Sağlayıcı ARTIK ÇAĞRI YERİNDE SABİT DEĞİL (MÜF9 Paket 10 · BLE2-7859) Burası `&StubGibGonderim` yazıyordu: seam parametreliydi ama tek çağıranı sabitliyordu, yani büro entegratörünü kursa bile belge oraya gitmezdi. Sağlayıcı artık [`crate::entegrator::router_kur`] ile **seçimden** çözülür. ## 🔴 YAPILANDIRMA HATASI BELGEYE YAZILMAZ Entegratör seçilmemişse uç **erken durur** ve kuyruğa dokunmaz. Eskiden bu durumda kuyruktaki her belge `basarisiz` damgalanır, `deneme` sayacı yanar ve operatör kalıcı bir belge arızası sanardı — oysa eksik olan tek şey ayarlardaki sağlayıcı seçimiydi. `kuyruk_isle`in "hata satıra ait, partiye değil" kuralının bir üst basamağı: hata **ayara** aitse belgeye hiç yazılmaz.

İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/satis-faturalari/kuyruk/gonder" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/satis-faturalari/kuyruk/isle

Kuyruğu işle: bekleyen faturaların UBL'ini üret (BLE2-7878).

Oturum

🔴 Bu uç `kuyruk_isle`'yi **çağıran** yoldur. Fonksiyon yazılmıştı ama hiçbir uçtan, worker'dan ya da zamanlayıcıdan çağrılmıyordu: onaylanan her fatura kuyrukta `bekliyor` durumunda sonsuza kadar kalıyor ve ekranda "kuyrukta" göründüğü için bu fark edilmiyordu. (MÜF8 Paket 6/7'nin "tanımlı ama çağrılmıyor" dersinin beşinci tekrarı.)

İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/satis-faturalari/kuyruk/isle" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/satis-faturalari/kuyruk/yeniden-dene

Başarısız kuyruk satırlarını yeniden denemeye al (BLE2-7878).

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

POST — seçili belgelerin ham UBL'lerini zip olarak indir (BLE2-8286).

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

Toplu yazdır: seçili faturaları TEK birleşik PDF olarak döndür (BLE2-8062).

Oturum
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/satis-faturalari/toplu-yazdir" \
  -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