setup — Müşavir API

GET/api/musavir/v1/setup

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

Oturum

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

Yanıt

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

POST/api/musavir/v1/setup/apply

Uygula

Oturum

İstek

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

Yanıt

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

POST/api/musavir/v1/setup/complete

Sihirbazı tamamla: beyannameyi AÇ ve oturumu ona bağla.

Oturum

🔴 Beyanname [`crate::beyanname::hazirla_aktorlu`] ile açılır — sihirbaz kendi INSERT'ünü YAZMAZ. Yazsaydı son gün hesabı, mükellefiyet penceresi kapısı, damga çözümü ve doğrulama motoru bu yoldan atlanırdı; hazırlamanın on kuralı iki kapıdan yalnız birinde işlerdi (`beyanname_parti`'nin aynı kararı).

İstek

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

Yanıt

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

POST/api/musavir/v1/setup/dismiss

Kapat

Oturum

İstek

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

Yanıt

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

POST/api/musavir/v1/setup/step

Sicili elle işaretle (canlı sorgu MÜF22'ye kadar).

Oturum

🔴 `kaynak = 'manuel'` yazılır ve gizlenmez: denetimde "bu bilgi nereden geldi?" sorusunun cevabı, GİB'den mi geldiği yoksa büronun mu işaretlediği ayrımıdır.

İstek

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

Yanıt

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

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

Uygula

Sihirbazı tamamla: beyannameyi AÇ ve oturumu ona bağla.

Kapat

Sicili **elle** işaretle (canlı sorgu MÜF22'ye kadar).

Sicili elle işaretle (canlı sorgu MÜF22'ye kadar).