e-İrsaliye API: sevkiyattan alındı yanıtına

MultiPortal e-İrsaliye API, sevkiyat yazılımınızdan taslak oluşturma ve gönderimin yanında gelen irsaliyeleri okuma ve alındı yanıtı verme işlemlerini de kapsar. Bu işlemler firma için e-İrsaliye hizmetinin açık olmasına ve anahtarın yetkisine bağlıdır.

e-İrsaliye API entegrasyonu ne sağlar?

Depo, ERP veya lojistik uygulamasındaki sevkiyat bilgisini portalda yeniden girmeden e-belge akışına taşıyabilirsiniz. Giden belgeyi oluşturma, gelen belgeyi okuma ve alındı yanıtını kendi sisteminizde işleme farklı adımlardır. MultiPortal bunları ayrı REST uçlarıyla tanımlar; irsaliye gönderimi ile alıcının yanıtını aynı sonuç saymayın.

Giden e-İrsaliye için işlem sırası

  1. Yetki ve alıcıyı kontrol edin: GET /hesap hizmet kapsamını, GET /mukellef/{vkn} alıcının kayıt bilgisini verir. Anahtarı sunucu tarafında saklayın.
  2. Kaydetmeden doğrulayın: POST /irsaliyeler/dogrula alanları denetler; kayıt oluşturmaz. Araç veya taşıyıcı bilgisi, teslimat adresi ve tarih alanlarını güncel şemaya göre hazırlayın.
  3. Taslak oluşturun: POST /irsaliyeler isteğinde benzersiz harici_id taşıyın. Taslakla geliştirme yaparken gonder: false kullanın.
  4. Kontrollü gönderin: POST /irsaliyeler/{ettn}/gonder gönderim içindir. Tam yetkili anahtar ve belgeye özel kullanıcı onayı gerekir; entegrasyon rehberini okurken gerçek sevkiyat belgesi oluşturmanız gerekmez.
  5. Durumu ve içeriği alın: GET /irsaliyeler/{ettn} ile durumu, ilgili /pdf, /xml ve /html uçlarıyla belge içeriğini okuyun. ETTN ile belge numarasını ayrı alanlarda tutun.

Gelen e-İrsaliye: kabul, red ve kısmi kabul

GET /gelen-irsaliyeler gelen belgeleri listeler. Yanıt öncesi GET /gelen-irsaliyeler/{ettn}/satirlar ile kalemleri okuyun. POST /gelen-irsaliyeler/{ettn}/yanit üç yanıt türünü destekler:

Aynı irsaliyeye ikinci yanıt gönderilmez. Yanıt vermek ile belgeyi yalnız görüntülemek farklı yetkilerdir. Operatörün kontrol ettiği kalem ve miktar özetini onaydan önce gösterin.

Tekrar, durum ve iptal sınırları

harici_id sevkiyat kaydınızla belgeyi eşleştiren mükerrer korumasıdır. Aynı referansla farklı içerik gönderildiğinde oluşan çakışmayı yeni belge oluşturarak gizlemeyin. Ağ kesilmesini kesin başarısızlık saymadan mevcut kaydı sorgulayın.

MultiPortal API gönderilmiş e-İrsaliye için iptal ucu sunmaz. Taslak silme, gönderilmiş belgeyi geri alma değildir. Gönderim tamamlandı mesajıyla nihai belge durumunu da ayırın; durum değişiklikleri için webhook ve MCP rehberine bakın.

Sık sorulan sorular

e-İrsaliye API ile gelen belgeler de alınabilir mi?

Evet. Gelen irsaliye listesi, detay, satırlar ve PDF/UBL XML/HTML erişimi bulunur. Kabul, red ve kısmi kabul yanıtı ayrı bir işlemdir.

Kısmi kabulde ne gönderilmelidir?

KISMI_KABUL yanıtında satır bilgisi zorunludur. Kalemleri ve fiilen alınan miktarları teknik sözleşmeye göre eşleyin; yalnız durum etiketi göndermek yeterli değildir.

API demosu gerçek belge gönderir mi?

Bağlantı verdiğimiz portal demosu ekranları incelemek içindir. API geliştirmesinde kayıt oluşturmayan dogrula ucu ve gönderime kapalı taslak anahtar modu kullanılır; demo erişimi API yetkisi yerine geçmez.

Kaynaklar ve ilgili rehberler

Teknik açıklamalar 21 Kasım 2026 tarihinde erişilen MultiPortal kaynaklarına dayanır. Uygulamada güncel sözleşmeyi kontrol edin. Portal demosu ekranları incelemek içindir; API anahtarı veya gerçek işlem yetkisi vermez.