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

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 (Gonderim/Teslimat belgesi) API formatına eşleyin.

Microsoft Dynamics

Power Automate veya özel bağlantılar kullanın. Satis/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.

Docavelo hazır portal entegrasyonuna sahiptir: ERP'nizi Docavelo'e bağlayın, sizin yerinize portalla iletişim kurar.