ERP

e-defter

14 uç · /api/erp/v1/e-defter

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 14 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

POST/api/erp/v1/e-defter/berat

Dönem yevmiye defterini MÜHÜRLE → dönem-kilit (yevmiye/kebir değişmez). erp.gl.manage.

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

e-Defter berat mühürlerini listele (opsiyonel ?year; no-silent-cap truncated). erp.gl.view.

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

Tek e-Defter berat mührü. erp.gl.view.

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

Mühürlenen defterin **BERAT BELGESİNİ** indir (defterin kendisi için `/xml`). erp.gl.view.

OturumYol parametresi: id

0970 öncesi mühürlenmiş beratlarda belge yoktur → 409 (sessiz boş belge ÜRETİLMEZ).

İstek
curl -X GET "https://{slug}.erp.blesyum.app/api/erp/v1/e-defter/berat/<id>/berat-xml" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/erp/v1/e-defter/berat/{id}/events

Berat durum-makinesinin denetim izi (en yeni önce, keyset sayfalı). erp.gl.view.

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.erp.blesyum.app/api/erp/v1/e-defter/berat/<id>/events" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/erp/v1/e-defter/berat/{id}/gib-response

GİB yanıtını ELLE kaydet → gönderim durum-makinesini terminale taşı. erp.gl.manage.

OturumYol parametresi: id

⚠ Bu uç olmadan durum-makinesinin terminali ÜRÜN İÇİNDE ERİŞİLEMEZDİ: stub provider asla terminal durum üretmez (`remote_status: null`) ve `poll` da bu yüzden hiç ilerletmez → EF15 öncesi her gönderim sonsuza dek 'queued'da kalıyor, GİB'den kâğıt/portal üzerinden gelen onay sisteme işlenemiyordu. Kardeş modül bu ihtiyacı 0433'te 'manual' kanalıyla zaten öngörmüştü.

İstek
curl -X POST "https://{slug}.erp.blesyum.app/api/erp/v1/e-defter/berat/<id>/gib-response" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/erp/v1/e-defter/berat/{id}/poll

Berat GİB durumunu sorgula/ilerlet (poll; stub → değişmez, canlı EF15). erp.gl.manage.

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

Berat gönderim/onay durumu (henüz gönderilmediyse data=null). erp.gl.view.

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

Mühürlü berat'ı GİB e-Defter'e YÜKLE (gönderim durum-makinesi; stub → queued, canlı EF15). erp.gl.manage.

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

e-Defter berat bütünlük doğrulaması (hash yeniden-türet + karşılaştır). erp.gl.view.

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

Mühürlenen defterin SAKLI XML artefaktını indir (birebir mühürlenen baytlar). erp.gl.view.

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

e-Defter dönem bütünlük özeti (Σborç == Σalacak + fiş/satır sayısı). erp.gl.view.

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

e-Defter defter-i kebir XBRL-GL sorgusu (dönem + firma kimliği; yevmiye deseni). erp.gl.view.

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

Edefter yevmiye

Oturum
İstek
curl -X GET "https://{slug}.erp.blesyum.app/api/erp/v1/e-defter/yevmiye" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?