Müşavir

denetim

36 uç · /api/musavir/v1/denetim

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 36 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/denetim/dosyalar

Bakiye + defter.

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

Ac

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

Bir beyannamenin mükellefe görünen tam hâli.

OturumYol parametresi: id

🔴 404 mesajı "yetkiniz yok" DEMEZ ve dememeli: RLS satırı zaten elediği için başka bir müvekkilin beyannamesi ile hiç var olmayan bir id **ayırt edilemez** — ayırt edilebilseydi uç, "bu büroda şu id'de bir beyanname var mı" sorusunu cevaplayan bir sızıntı olurdu.

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

Adim

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

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

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

Goster

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

Ac

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

Bakiye + defter.

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

🔴 .view yeterli — .manage DEĞİL. MÜF1'in rol matrisi dersi: ölçüt "mutasyon mu?" değil

OturumYol parametresi: id

"bu ROLÜN RUTİN İŞİ mi?". Not düşmek muhasebe_elemani/stajyerin günlük işidir ve ellerindeki tek izin V_MUKELLEF'tir; .manage istemek not defterini onlara kapatır. Not WORM olduğu için yanlış yazılan bir not "geri alınamaz idari eylem" de değildir — düzeltmesi yeni bir nottur.

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

Bakiye + defter.

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

Elle "şimdi çek" — canlı API bağlantısı.

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

Sinyal

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

🔴 Beyanname AÇMADAN defterin ne dediğini göster.

OturumYol parametresi: id

Önizleme olmadan müşavirin tek yolu taslak açıp bakmaktı; beğenmezse silmesi gerekirdi ve by_asil_uniq yüzünden aynı dönemde ikinci bir deneme ancak silme sonrası olurdu. Bir soruyu cevaplamak için kayıt açtırmak, kaydı soru işaretine çevirir.

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

Yayimla

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

Bakiye + defter.

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

Teyide aday cariler — bakiyesi **teyit tarihinde** sıfırdan farklı olanlar.

OturumYol parametresi: id

🔴 Aday listesi BUGÜNKÜ bakiyeye göre kurulamaz: yıl içinde kapanmış bir cari bugün sıfırdır ama 31.12'de bakiyesi vardı ve teyit edilmesi gereken tam odur. Tersi de doğrudur — yıl sonundan sonra açılan cari listeye girmemeli.

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

Bakiye + defter.

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

Hazirla

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

Gosterge

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

Envanteri geri doldur — P12'den ÖNCE yüklenmiş nesneler için.

OturumYol parametresi: id

🔴 Ayrı bir uç, turun içine gömülü bir adım DEĞİL: tam tarama 100 bin nesnede 6,2 saniye (ölçüldü) ve her turda koşamaz. Parçalıdır; devam_var doğruysa istemci tekrar çağırır.

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

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

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

Oturumu getir — **açmaz**. Ekran "yarım kalmış sihirbaz var mı" sorusunu buradan sorar.

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

Envanteri geri doldur — P12'den ÖNCE yüklenmiş nesneler için.

OturumYol parametresi: id

🔴 Ayrı bir uç, turun içine gömülü bir adım DEĞİL: tam tarama 100 bin nesnede 6,2 saniye (ölçüldü) ve her turda koşamaz. Parçalıdır; devam_var doğruysa istemci tekrar çağırır.

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

Imza

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

Katalog — ekran alan seçicisini BUNDAN çizer, kendi listesini UYDURMAZ.

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

Çekimden ÖNCE evrenin büyüklüğünü söyler.

Oturum

🔴 Evren tavanını ancak "Çek"e bastıktan sonra öğrenen kullanıcı, parametrelerini körlemesine dener. Önizleme kayıt AÇMAZ.

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

Bir beyannamenin mükellefe görünen tam hâli.

OturumYol parametresi: id

🔴 404 mesajı "yetkiniz yok" DEMEZ ve dememeli: RLS satırı zaten elediği için başka bir müvekkilin beyannamesi ile hiç var olmayan bir id **ayırt edilemez** — ayırt edilebilseydi uç, "bu büroda şu id'de bir beyanname var mı" sorusunu cevaplayan bir sızıntı olurdu.

İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/denetim/orneklem/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/musavir/v1/denetim/orneklem/{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/denetim/orneklem/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/denetim/orneklem/{id}/sonuclandir

Sonuclandir

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

Satir

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

Özlük belgesini indir — **genel arşiv ucundan AYRI kapı**.

OturumYol parametresi: rid

🔴 GET /belgeler/{id} bu belgeyi 404 görür (belge::sahibi ozluk kategorisini düşürür). Tek okuma yolu burasıdır ve kapısı musavir.bordro.view'dur.

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

Bir beyannamenin mükellefe görünen tam hâli.

OturumYol parametresi: id

🔴 404 mesajı "yetkiniz yok" DEMEZ ve dememeli: RLS satırı zaten elediği için başka bir müvekkilin beyannamesi ile hiç var olmayan bir id **ayırt edilemez** — ayırt edilebilseydi uç, "bu büroda şu id'de bir beyanname var mı" sorusunu cevaplayan bir sızıntı olurdu.

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

POST — belgeyi kuyruğa al ve HEMEN gönder.

OturumYol parametresi: id

🔴 e-İrsaliye MALIN ÖNÜNDEN GİDER: araç yola çıkmadan gönderilmesi gerekir, bu yüzden düğme bir tur bekletmez — kuyruk yalnız yeniden deneme içindir.

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

Çekimden ÖNCE evrenin büyüklüğünü söyler.

OturumYol parametresi: id

🔴 Evren tavanını ancak "Çek"e bastıktan sonra öğrenen kullanıcı, parametrelerini körlemesine dener. Önizleme kayıt AÇMAZ.

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

Sonuc

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

Büronun elden girdiği yanıt (kâğıt/e-posta) — § 5 · kanıt gücü daha zayıftır ve satırda

OturumYol parametresi: id

öyle yazar.

İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/denetim/teyitler/<id>/yanit" \
  -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