ERP

imports

16 uç · /api/erp/v1/imports

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

GET/api/erp/v1/imports

List imports

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

Create import

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

Get import

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

Önerilen eşlemeyi UYGULA (elle kurulmuş bağlar korunur; committed işte 400). erp.imports.manage.

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

Commit import

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

Set import mapping

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

Commit-öncesi kuru-çalıştırma (dry-run) doğrulama raporu — YAZMA YOK.

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

Stok açılış mutabakatı (kaynak↔hedef bakiye farkları; dry-run, yalnız stock_balances). erp.imports.view.

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

Başarısız/bekleyen satırları YENİDEN yükle (resume; BLE-2399 DoD-5). Kaynak-veri/eksik-referans

OturumYol parametresi: id

düzeltildikten sonra committed işin hatalı satırları tekrar denenir (idempotent). erp.imports.manage.

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

Add import rows

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

Göç işi satır-raporu (hata/uyumsuzluk + durum; BLE-2399 DoD-5). Başarısız satırların nedenini

OturumYol parametresi: id

(`error`) + kod ipucunu operatöre gösterir. erp.imports.view.

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

CSV gövdesini (text/csv) staging satırlarına çevirip işe ekler — JSON `rows` ucunun CSV karşılığı.

OturumYol parametresi: id

İlk satır başlık; ayraç `;`/`,`/tab otomatik sezilir; mapping/preview/upsert hattı aynen çalışır. Gövde çekirdek API sınırıyla (~1 MiB, DefaultBodyLimit + content_length_guard) korunur; satır ≤5000 (JSON ucuyla aynı). Geçersiz UTF-8 lossy çevrilir; UTF-16/binary (başlıkta NUL) temiz 400 döner (Windows-1254/UTF-16 için Excel "CSV UTF-8" dışa-aktarımı önerilir).

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

XLSX gövdesini (Excel, ilk sayfa) staging satırlarına çevirip işe ekler — `rows-csv` ucunun XLSX

OturumYol parametresi: id

karşılığı. İlk satır başlık; boş hücre absent; sayı→string. mapping/preview/upsert hattı aynen çalışır. Gövde çekirdek API sınırıyla (~1 MiB) korunur; satır ≤5000. Bozuk/parola-korumalı dosya → temiz 400.

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

**Kolon eşlemesi önerisi** (salt-okuma): yüklenen dosyanın başlıklarını tanır (Logo/Mikro/Netsis

OturumYol parametresi: id

kolon adları + Türkçe Excel başlıkları) ve `{alan: kolon}` önerir. Tahmin YOK — tanımadığı kolonu bağlamaz, söyler. erp.imports.view.

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

Set import upsert

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

Genel göç mutabakat/doğrulama raporu (BLE-2399 DoD-4): kayıt-sayısı + stok bakiye, kaynak↔hedef;

OturumYol parametresi: id

TÜM entity. (Stok per-satır dry-run `/reconcile`'dan farklı: bu commit-sonrası özet doğrulama.) erp.imports.view.

İstek
curl -X GET "https://{slug}.erp.blesyum.app/api/erp/v1/imports/<id>/verify" \
  -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