API Entegrasyonu Neden Gerekli
Portal manuel giris icin web arayuzune sahiptir, ancak gunluk 5-10'dan fazla irsaliye gonderen sirketler icin manuel giris surdurulebilir degildir. API entegrasyonu, otomatik olusturma, teslim alindi onayi ve durum senkronizasyonu saglar.
Sistem Mimarisi
- Protokol: HTTPS (TLS 1.2+)
- Format: JSON
- Kimlik Dogrulama: Nitelikli elektronik sertifika (karsilikli TLS) + API anahtari
- Dokumantasyon: Kayit sonrasi portalda mevcut
Temel API Endpoint'leri
| Endpoint | Metot | Aciklama |
|---|---|---|
| /api/v1/delivery-notes | POST | Yeni e-irsaliye olustur |
| /api/v1/delivery-notes/{id} | GET | Tek irsaliyeyi goruntule |
| /api/v1/delivery-notes | GET | Irsaliyeleri listele (filtrelerle) |
| /api/v1/receipt-notes | POST | Teslim alma belgesi olustur (teslim almayi onayla) |
| /api/v1/delivery-notes/{id}/status | GET | Irsaliye durumu |
| /api/v1/delivery-notes/{id}/pdf | GET | Yazdirma icin PDF surumu |
Populer ERP Sistemleriyle Entegrasyon
SAP
SAP PI/PO veya SAP Integration Suite kullanin. SD modulunden (Gonderim/Teslimat belgesi) API formatina esleyin.
Microsoft Dynamics
Power Automate veya ozel baglantilar kullanin. Satis/Transfer Siparislerinden esleyin.
Yerel ERP Sistemleri
Cogu yerel ERP cozumu (Pantheon, Lidder, Bild, 4D) e-irsaliye modulleri gelistirmektedir veya sahiptir.
Yaygin Entegrasyon Sorunlari
- Sertifika dogru yapilandirilmamis -- sunucuda olmali, sadece is istasyonunda degil
- Yanlis tarih formati -- API ISO 8601 bekler (YYYY-MM-DDTHH:mm:ss)
- Eksik zorunlu alanlar -- API alan listesiyle 400 dondurur
- Alici kayitli degil -- alici sistemde mevcut olmali
- Buyuk sevkiyatlarda zaman asimi -- 100+ kalemi birden fazla irsaliyeye bölun
Webhook Bildirimleri
Portal, gercek zamanli durum guncellemeleri icin webhook destekler -- teslim alindi onayi, kabul/red, son tarih uyarilari.
Sonuc
API entegrasyonu yuksek hacimli operasyonlar icin tek surdurulebilir yaklasimdir.
Arhivix hazir portal entegrasyonuna sahiptir -- ERP'nizi Arhivix'e baglayin, sizin yerinize portalla iletisim kurar.
