documents — ERP API

GET/api/erp/v1/documents

List documents

Oturum

İstek

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

Yanıt

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

POST/api/erp/v1/documents

Create document

Oturum

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/approval

Document approval status

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/approval

Decide document approval

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/archive

Belgeyi yasal arşive al (immutable, 10 yıl WORM). Yalnız confirmed + ETTN'li e-Belge.

OturumYol parametresi: id

erp.einvoice.manage.

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/archive/verify

Belgenin arşiv bütünlüğünü doğrula (arşiv-hash vs canlı-belge yeniden-hash). erp.einvoice.view.

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/assign

Reroute

OturumYol parametresi: id

İstek

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

Yanıt

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

DELETE/api/erp/v1/documents/{id}/assignment

Release assignment

OturumYol parametresi: id

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/assignments

Assignment history

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/budget-allocation

Belgeyi bütçe satırına tahsis et. İki izin birden aranır: belgeyi düzenleyebilmek

OturumYol parametresi: id

(`documents.create`) **ve** yazacağı bütçeyi görebilmek (`budget.view`) — kimse göremediği bir bütçeyi tüketemez.

İstek

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

Yanıt

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

DELETE/api/erp/v1/documents/{id}/budget-allocation

Deallocate budget

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/cancel

Belgeyi iptal et (cancelled): confirmed ise telafi edici ters ledger yazılır.

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/confirm

Taslağı onayla (draft → confirmed): ledger postlanır.

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/contract-allocation

Link contract

OturumYol parametresi: id

İstek

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

Yanıt

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

DELETE/api/erp/v1/documents/{id}/contract-allocation

Unlink contract

OturumYol parametresi: id

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/e-gider-pusulasi

Onaylı e-Gider Pusulası belgesinin UBL-TR 1.2 XML'ini üret (EF5 · BLE-2668).

OturumYol parametresi: id

Alıcı = düzenleyen işletme (query param); satıcı = belge party'si (mükellef-olmayan karşı taraf). document_mm_handler simetriği (build_ubl_gider_pusulasi → InvoiceTypeCode GIDERPUSULASI).

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/e-irsaliye

Onaylı satış belgesinin UBL-TR 1.2 e-İrsaliye (DespatchAdvice) XML'ini üret (EF5 · BLE-2585).

OturumYol parametresi: id

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/e-mm

Onaylı e-MM belgesinin UBL-TR 1.2 e-Müstahsil Makbuzu XML'ini üret (EF5 · BLE-2650).

OturumYol parametresi: id

Alıcı = düzenleyen işletme (query param, e-Fatura UblQuery deseni); satıcı = belge party'si (müstahsil/çiftçi). build_ubl_smm handler simetriği (party yerleşimi build_ubl_mm'de terslenir).

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/e-smm

Onaylı e-SMM belgesinin UBL-TR 1.2 e-Serbest Meslek Makbuzu XML'ini üret (EF5 · BLE-2643).

OturumYol parametresi: id

Satıcı = serbest meslek erbabı (query param, e-Fatura UblQuery deseni).

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/earsiv-meta

e-Arşiv internet-satış meta ekle/güncelle (belge id). erp.einvoice.manage.

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/einvoice

Queue einvoice

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/exchange-rate

Dövizli belgenin defter kurunu (R1) kaydet. erp.documents.create.

OturumYol parametresi: id

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/pdf

PDF. ⭐⭐⭐ Motor yapılandırılmadığı için bugün 400 döner (EF15) — sahte bir PDF

OturumYol parametresi: id

üretmektense "motor yok" demek doğrudur; HTML önizleme çalışır.

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/post-gl

Belgeyi GL'ye mahsupla (dengeli yevmiye fişi üret).

OturumYol parametresi: id

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/render

Canlı önizleme (HTML). ⭐ Varsayılan şablon yoksa rastgele biriyle basmaz; NE eksik

OturumYol parametresi: id

olduğunu söyler.

İstek

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

Yanıt

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

POST/api/erp/v1/documents/{id}/route

Belgeyi kurallara göre yönlendir. ⭐ Aktif ataması varsa DOKUNMAZ (kullanıcının elinden

OturumYol parametresi: id

üzerinde çalıştığı belge alınmaz); eşleşen kural yoksa atama yapmaz ve NEDENİNİ söyler.

İstek

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

Yanıt

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

GET/api/erp/v1/documents/{id}/ubl

Onaylı satış belgesinin UBL-TR 1.2 e-Fatura/e-Arşiv XML'ini üret (EF5 · BLE-1410).

OturumYol parametresi: id

İstek

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

Yanıt

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

POST/api/erp/v1/documents/bundled

Create bundled document

Oturum

İstek

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

Yanıt

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