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.

12 Ocak 2026 Arhivix Ekibi 10 min
E-Irsaliye API Entegrasyonu: ERP/DMS'nizi Portala Bağlama

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

EndpointMetotAçıklama
/api/v1/delivery-notesPOSTYeni e-irsaliye oluştur
/api/v1/delivery-notes/{id}GETTek irsaliyeyi görüntüle
/api/v1/delivery-notesGETIrsaliyeleri listele (filtrelerle)
/api/v1/receipt-notesPOSTTeslim alma belgesi oluştur (teslim almayı onayla)
/api/v1/delivery-notes/{id}/statusGETIrsaliye durumu
/api/v1/delivery-notes/{id}/pdfGETYazdı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ı

  1. Sertifika doğru yapılandırılmamış: sunucuda olmalı, sadece is istasyonunda değil
  2. Yanlış tarih formatı: API ISO 8601 bekler (YYYY-MM-DDTHH:mm:ss)
  3. Eksik zorunlu alanlar: API alan listesiyle 400 dondurur
  4. Alici kayıtlı değil: alici sistemde mevcut olmalı
  5. 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.