mukellefler

68 uç · /api/musavir/v1/mukellefler

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

List

Oturum

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler

Personel ekle. Koltuk kotası (`musavir.staff_seats`) burada zorlanır: kota dolduysa

Oturum

403 MUSAVIR/CAP/1 (upsell). Kota kapısı YAZMADAN ÖNCE — aksi halde plan aşılır ve geri alınması gereken bir kayıt doğar.

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}

Get

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PATCH/api/musavir/v1/mukellefler/{id}

Patch

OturumYol parametresi: id

İstek

curl -X PATCH "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/musavir/v1/mukellefler/{id}

Delete

OturumYol parametresi: id

İstek

curl -X DELETE "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/360

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

OturumYol parametresi: id

🔴 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/mukellefler/<id>/360" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/atama

Atama list

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/atama" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/atama

Atama ekle

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/atama" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/musavir/v1/mukellefler/{id}/atama/{aid}

Atama kaldir

OturumYol parametresi: idaid

İstek

curl -X DELETE "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/atama/<aid>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/devir-paketi

Devir

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/devir-paketi" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{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/mukellefler/<id>/durum" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/durum-gecmisi

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/mukellefler/<id>/durum-gecmisi" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/earsiv-kanali

Kanal getir

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/earsiv-kanali" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/earsiv-kanali

Kanal ayarla

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/earsiv-kanali" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/etiketler

Etiket list

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/etiketler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/etiketler

Etiket ekle

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/etiketler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/musavir/v1/mukellefler/{id}/etiketler/{etiket}

Etiket kaldir

OturumYol parametresi: idetiket

İstek

curl -X DELETE "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/etiketler/<etiket>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/faaliyetler

Listele

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/faaliyetler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/faaliyetler

Ekle

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/faaliyetler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/musavir/v1/mukellefler/{id}/faaliyetler/{kod}

Sil

OturumYol parametresi: idkod

İstek

curl -X DELETE "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/faaliyetler/<kod>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/geri-al

Geri al

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/geri-al" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/grup

Baglar

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/grup" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/grup/agac

Agac

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/grup/agac" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/grup/konsolide

Konsolide

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/grup/konsolide" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/hizmet-kapsam

Kapsam list

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/hizmet-kapsam" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PUT/api/musavir/v1/mukellefler/{id}/hizmet-kapsam

Kapsam yaz

OturumYol parametresi: id

İstek

curl -X PUT "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/hizmet-kapsam" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/musavir/v1/mukellefler/{id}/hizmet-kapsam/{kod}

Kapsam sil

OturumYol parametresi: idkod

İstek

curl -X DELETE "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/hizmet-kapsam/<kod>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/iletisim

Iletisim list

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/iletisim" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/iletisim

Iletisim ekle

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/iletisim" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PATCH/api/musavir/v1/mukellefler/{id}/iletisim/{kid}

Iletisim guncelle

OturumYol parametresi: idkid

İstek

curl -X PATCH "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/iletisim/<kid>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/musavir/v1/mukellefler/{id}/iletisim/{kid}

Iletisim sil

OturumYol parametresi: idkid

İstek

curl -X DELETE "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/iletisim/<kid>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/imza-sirkuleri

Sirkuler listele

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/imza-sirkuleri" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/imza-sirkuleri

Sirkuler ekle

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/imza-sirkuleri" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/iz

`GET /api/musavir/v1/gorevler/{id}/denetim`

OturumYol parametresi: id

İzin .view — kardeş uçlarla (detay/durum/ilerleme) aynı sınıf: kendi işini gören personel o işin geçmişini de görmeli. IP/user-agent bu yüzden [IzSatiri]'nda hiç YOK.

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/iz" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/kimlikler

Şablon listesi — her tür için ETKİN metin, kaynağıyla birlikte.

OturumYol parametresi: id

Ekran "büro yazdı" ile "hazır kütüphane"yi ayırt edebilmelidir: ayırt edemeseydi, hiç metin yazmamış bir büro kendi yazdığını sanır ve Blesyum kütüphaneyi güncellediğinde mektubu "kendiliğinden değişmiş" görünürdü.

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/kimlikler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/kimlikler

Upsert

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/kimlikler" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/musavir/v1/mukellefler/{id}/kimlikler/{kid}

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

OturumYol parametresi: idkid

İstek

curl -X DELETE "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/kimlikler/<kid>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/notlar

Not list

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/notlar" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/notlar

Not ekle

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/notlar" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/nps

Nps oku

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/nps" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/nps

Nps kaydet

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/nps" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/ortaklar

Ortak listele

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/ortaklar" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/ortaklar

Ortak ekle

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/ortaklar" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/ortaklar/{oid}/kapat

Ortak kapat

OturumYol parametresi: idoid

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/ortaklar/<oid>/kapat" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/portal

GET — belgeyi görüntüle (görünüm + ham XML birlikte).

OturumYol parametresi: id

Ham XML de döner: görüntüleyicinin gösterdiğinden şüphelenen kullanıcı belgenin kendisine bakabilmeli. Yalnız yorumlanmış görünüm dönmek, ayrıştırıcı hatasını denetlenemez kılardı.

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/portal" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/portal-yazisma

Büro: bir müvekkille yazışma + onay defteri.

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/portal-yazisma" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/portal-yazisma

Buro mesaj

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/portal-yazisma" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/portal-yazisma/okundu

Buro okundu

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/portal-yazisma/okundu" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/portal/davet

Davet AÇ — bağlantı e-postaya gider, yanıta basılmaz.

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/portal/davet" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/risk

Risk get

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/risk" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PUT/api/musavir/v1/mukellefler/{id}/risk

Risk manuel

OturumYol parametresi: id

İstek

curl -X PUT "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/risk" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/risk-profili

Tek müvekkilin risk profili (detay paneli).

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/risk-profili" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/risk/degerlendir

Risk degerlendir

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/risk/degerlendir" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/temsilci

Temsilci list

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/temsilci" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/temsilci

Temsilci ekle

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/temsilci" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/temsilci/{tid}/kapat

Temsilci kapat

OturumYol parametresi: idtid

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/temsilci/<tid>/kapat" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/usul-davranisi

Davranis

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/usul-davranisi" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/vis-sablonu

Atama oku

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/vis-sablonu" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PUT/api/musavir/v1/mukellefler/{id}/vis-sablonu

Atama yaz

OturumYol parametresi: id

İstek

curl -X PUT "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/vis-sablonu" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/yazismalar/senkron

Elle bir senkron turu — ekran açılışında da çağrılır.

OturumYol parametresi: id

🔴 CHAN-01 (*"kurulumun SON adımı kullanıcıya ödev bırakılmaz"*): worker bayrağı kapalı bir kurulumda gelen kutusu ebediyen boş kalmasın diye ekran bu ucu açılışta çağırır. Kullanıcının bir "senkronla" düğmesi ARAMASI gerekmez; düğme yine vardır, ama yolun tamamı ona bağlı değildir.

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/yazismalar/senkron" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/{id}/yukumluluk

Şablon listesi — her tür için ETKİN metin, kaynağıyla birlikte.

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/yukumluluk" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/{id}/yukumluluk/uret

🔴 "Bugün" İSTEKTEN GELMEZ (MÜF22 · BLE22-15280): `?tarih=` ile GELECEK dönemin faturaları

OturumYol parametresi: id

erken kesilebiliyordu (dönem tekilliği yalnız ikinci kesimi önler, erkenini değil). Saati sunucu verir (worker ile aynı); zamanı ileri alan test ureti doğrudan çağırır.

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/<id>/yukumluluk/uret" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/churn-riski

Churn

Oturum

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/churn-riski" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/export

Export

Oturum

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/export" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/grid

Grid

Oturum

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/grid" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/import

CSV gövdesi düz metin olarak alınır (multipart gerekmez; Next tarafı dosyayı okuyup

Oturum

gönderir). 1 MiB body tavanı apply_standard_middleware'den gelir. ?onizleme=true ile AYNI uç, yazmadan çalışır: sihirbazın "önce göster" adımı gerçek akışın kod yolundan geçer (bkz. [Kip::Dogrula]) — ayrı bir doğrulama ucu yazsaydık iki kural kümesi ayrışır ve ön izleme yalan söylerdi.

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/import" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/musavir/v1/mukellefler/import/sablon

Sablon

Oturum

İstek

curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/import/sablon" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/musavir/v1/mukellefler/risk-profili

Liste rozeti için TOPLU risk.

Oturum

🔴 **POST, çünkü gövde id LİSTESİDİR.** 100 UUID bir query string'e sığmaz (≈3,7 KB) ve kenardaki WAF uzun sorguları kesebilir. Uç hiçbir şey YAZMAZ; POST burada bir taşıma kararıdır, bir mutasyon değil — bu yüzden izni de okuma iznidir. 🔴 Kapsam kapısı **HEPSİ ya da HİÇBİRİ** (hepsi_gorunur_mu): kapsam dışı id'yi sessizce elemek, ekranda rozeti eksik bir satır bırakır ve müşavir bunu "risk ölçülmedi" sanardı.

İstek

curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/mukellefler/risk-profili" \
  -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

List

Personel ekle. **Koltuk kotası** (musavir.staff_seats) burada zorlanır: kota dolduysa

Get

Patch

Delete

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

Atama list

Atama ekle

Atama kaldir

Devir

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

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

Kanal getir

Kanal ayarla

Etiket list

Etiket ekle

Etiket kaldir

Listele

Ekle

Sil

Geri al

Baglar

Agac

Konsolide

Kapsam list

Kapsam yaz

Kapsam sil

Iletisim list

Iletisim ekle

Iletisim guncelle

Iletisim sil

Sirkuler listele

Sirkuler ekle

GET /api/musavir/v1/gorevler/{id}/denetim

Şablon listesi — her tür için ETKİN metin, kaynağıyla birlikte.

Upsert

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

Not list

Not ekle

Nps oku

Nps kaydet

Ortak listele

Ortak ekle

Ortak kapat

GET — belgeyi görüntüle (görünüm + ham XML birlikte).

Büro: bir müvekkille yazışma + onay defteri.

Buro mesaj

Buro okundu

Davet AÇ — bağlantı e-postaya gider, yanıta basılmaz.

Risk get

Risk manuel

Tek müvekkilin risk profili (detay paneli).

Risk degerlendir

Temsilci list

Temsilci ekle

Temsilci kapat

Davranis

Atama oku

Atama yaz

Elle bir senkron turu — ekran açılışında da çağrılır.

Şablon listesi — her tür için ETKİN metin, kaynağıyla birlikte.

🔴 "Bugün" İSTEKTEN GELMEZ (MÜF22 · BLE22-15280): ?tarih= ile GELECEK dönemin faturaları

Churn

Export

Grid

CSV gövdesi düz metin olarak alınır (multipart gerekmez; Next tarafı dosyayı okuyup

Sablon

Liste rozeti için TOPLU risk.

Personel ekle. Koltuk kotası (`musavir.staff_seats`) burada zorlanır: kota dolduysa

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

`GET /api/musavir/v1/gorevler/{id}/denetim`

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

🔴 "Bugün" İSTEKTEN GELMEZ (MÜF22 · BLE22-15280): `?tarih=` ile GELECEK dönemin faturaları