E-Irsaliye API Entegrasyonu: ERP/DMS'nizi Portala Bağlama
ERP veya DMS'nizi API aracılığıyla e-irsaliye portaliyla entegre etmek için teknik rehber. Kimlik doğrulama, endpoint'ler, formatlar ve yaygın sorunlar.
Bu yazı Sırbistan'daki şirketler için yazılmıştır ve Sırbistan mevzuatını anlatır. Diğer ülkelerde farklı kurallar geçerlidir.

API Entegrasyonu Neden Gerekli
Portal manuel giriş için web arayüzüne sahiptir, ancak günlük 5-10'dan fazla irsaliye gönderen şirketler için manuel giriş sürdürülebilir değildir. API entegrasyonu, otomatik oluşturma, teslim alindi onayı ve durum senkronizasyonu sağlar.
Sistem Mimarisi
- Protokol: HTTPS (TLS 1.2+)
- Format: JSON
- Kimlik Doğrulama: Nitelikli elektronik sertifika (karşılıklı TLS) + API anahtarı
- Dokümantasyon: Kayıt sonrası portalda mevcut
Temel API Endpoint'leri
| Endpoint | Metot | Açıklama |
|---|---|---|
| /api/v1/delivery-notes | POST | Yeni e-irsaliye oluştur |
| /api/v1/delivery-notes/{id} | GET | Tek irsaliyeyi görüntüle |
| /api/v1/delivery-notes | GET | Irsaliyeleri listele (filtrelerle) |
| /api/v1/receipt-notes | POST | Teslim alma belgesi oluştur (teslim almayı onayla) |
| /api/v1/delivery-notes/{id}/status | GET | Irsaliye durumu |
| /api/v1/delivery-notes/{id}/pdf | GET | Yazdırma için PDF surumu |
Popüler ERP Sistemleriyle Entegrasyon
SAP
SAP PI/PO veya SAP Integration Süite kullanın. SD modülünden (Gönderim/Teslimat belgesi) API formatına eşleyin.
Microsoft Dynamics
Power Automate veya özel bağlantılar kullanın. Satış/Transfer Siparişlerinden eşleyin.
Yerel ERP Sistemleri
Çoğu yerel ERP çözümü (Pantheon, Lidder, Bild, 4D) e-irsaliye modülleri geliştirmektedir veya sahiptir.
Yaygın Entegrasyon Sorunları
- Sertifika doğru yapılandırılmamış: sunucuda olmalı, sadece is istasyonunda değil
- Yanlış tarih formatı: API ISO 8601 bekler (YYYY-MM-DDTHH:mm:ss)
- Eksik zorunlu alanlar: API alan listesiyle 400 dondurur
- Alici kayıtlı değil: alici sistemde mevcut olmalı
- Büyük sevkiyatlarda zaman asimi: 100+ kalemi birden fazla irsaliyeye bölun
Webhook Bildirimleri
Portal, gerçek zamanlı durum güncellemeleri için webhook destekler: teslim alindi onayı, kabul/red, son tarih uyarıları.
Sonuç
API entegrasyonu yüksek hacimli operasyonlar için tek sürdürülebilir yaklaşımdır.
Arhivix hazır portal entegrasyonuna sahiptir: ERP'nizi Arhivix'e bağlayın, sizin yerinize portalla iletişim kurar.


