Yazılım firmaları · e-İrsaliye API
e-İrsaliye REST API entegrasyonu
Sevk başlamadan önce e-İrsaliyeyi NES'e iletin; giden ve gelen irsaliye süreçlerini API üzerinden yönetin. Belgeyi ERP, depo veya lojistik yazılımınızdan UBL-TR formatında üretirsiniz.
e-İrsaliye, e-Fatura ve e-Arşiv ile aynı NES API altyapısında ayrı bir servis olarak çalışır. e-İrsaliye test Swagger'ını doğrudan inceleyebilirsiniz. Test erişim bağlantınız form başvurusundan sonra e-postanıza gönderilir; API anahtarınız erişim sayfanızda yer alır.
e-İrsaliye işlem zinciri
edespatch · api
POST apitest.nes.com.tr/edespatch/v1/uploads/document/preview — document.preview
← 200 · preview
Sevkiyat başlamadan önce e-İrsaliye
e-İrsaliye, istisnai haller dışında malın fiili sevki başlamadan önce düzenlenir ve sisteme iletilir. Buradaki kritik zaman belge tarihi değil; belgede yazan fiili sevk tarih ve saatidir.
Özel entegratör yönteminde sevke başlamak
Belgenin Başkanlık sistemlerine iletilmek üzere NES'e ulaşması, fiili sevkiyatı başlatmak için yeterlidir. Sevkiyata başlamak için ayrıca sistem yanıtını beklemek gerekmez.
NES'ten GİB'e iletim
NES, kendisine iletilen e-İrsaliyeyi imzalayıp GİB sistemlerine azami 15 dakika içinde iletir. Bu süre GİB uygulama kılavuzundaki özel entegratör yükümlülüğüdür.
Akış nettir: e-İrsaliye sevkiyat başlamadan önce NES'e iletilir; sevkiyat bundan sonra başlar.
Sevkiyat için hangi bilgiler aktarılır?
Bu alanlar ayrı API uçları değildir. Yazılımınızın ürettiği UBL-TR DespatchAdvice belgesinde yer alır; NES API belgeyi yükler ve durumunu yönetir.
Sevk
Fiili sevk tarih ve saati
Mal ve teslimat
Ürün / miktar ve teslimat bilgileri (işyeri adresi; farklıysa teslimat adresi)
Taşıma
Araç plakası ve şoför bilgileri veya taşımayı yapan kargo/lojistik firmasının bilgileri
Giden ve gelen e-İrsaliyeler
e-İrsaliye entegrasyonu yalnızca belge üretmek değildir. Aynı API'de giden irsaliyeleri gönderir, gelenleri alır ve gerektiğinde yanıt işlersiniz.
Giden e-İrsaliyeleri gönderin
UBL-TR sevk belgesini göndermeden önce önizleyebilir veya API'ye yükleyebilirsiniz. Yüklediğiniz belgenin UUID'si üzerinden durumunu ve HTML, XML, PDF çıktılarını takip edebilirsiniz. Taslak bıraktıysanız daha sonra resmileştirebilirsiniz.
Gelen e-İrsaliyeleri alın ve yanıtlayın
Gelen e-İrsaliyeleri listeleyin, satırlarını ve geçmişini görüntüleyin; gerekiyorsa irsaliye yanıtını kendi iş akışınızdan gönderin.
Fatura tarafındaki e-Fatura / e-Arşiv ayrımı burada yoktur; e-İrsaliye kendi servisidir.
Gelen e-İrsaliyeye nasıl yanıt verilir?
İrsaliye yanıtı zorunlu değildir. Yanıt verilecekse fiili sevk tarihinden itibaren 7 günlük süre ve red koşulları dikkate alınır.
- Tam veya kısmi kabul: 7 gün içinde
- Yanıt verilmezse: Tam teslim kabul edilir
- Red: Yalnız sevkten önce ve mal/alıcı hatası varsa
Teknik olarak yanıt, POST /v1/incoming/despatches/{uuid}/receiptadvice ucuna UBL-TR yanıt dosyası gönderilerek yürür. OpenAPI'deki AnswerType değerleri (AllAccepted, PartialAnswered, AllRejected) API'nin teknik değerleridir; hukuki anlam GİB'deki kabul, kısmi kabul ve red kurallarıyla okunur.
e-İrsaliye akışı kendi yazılımınızda nasıl işler?
e-İrsaliye, e-Fatura ve e-Arşiv ile aynı NES API altyapısında ayrı bir servis olarak çalışır; test ortamı ve erişim süreci ortaktır.
Adım 01
Sevkiyat verisini yazılımınızda toplayın
ERP, depo veya lojistik yazılımınız fiili sevk zamanı, mal ve miktar, teslimat ile taşıma bilgilerini hazırlar.
Adım 02
UBL-TR e-İrsaliye belgesini oluşturun
Bu veriler DespatchAdvice XML içinde yer alır. İsterseniz göndermeden önce API ile önizleme alırsınız.
Adım 03
Belgeyi NES'e iletin, sonra sevkiyatı başlatın
Özel entegratör yönteminde sevke başlamak için belgenin NES'e ulaşması yeterlidir. NES belgesi GİB'e iletir; uuid ile durumu ve çıktıları kendi sisteminizden izlersiniz.
Adım 04
Gelen irsaliye ve yanıtı iş sürecine bağlayın
Alıcı tarafındaysanız gelen belgeleri API ile okur; gerektiğinde irsaliye yanıtını mevzuat çerçevesinde gönderirsiniz.
e-İrsaliye API ile neler yapabilirsiniz?
Aşağıdaki işlemler Swagger dokümantasyonunda yer alır. İstek alanları ve yanıt modelleri OpenAPI'dedir.
- UBL-TR belge önizleme ve yükleme
- Giden irsaliye listeleme, detay, HTML / XML / PDF
- Gelen irsaliye listeleme, satır ve geçmiş
- İrsaliye yanıtı (ReceiptAdvice) gönderme ve çıktı alma
- VKN veya TCKN ile mükellef sorgusu
Örnek uç
document.preview
POST apitest.nes.com.tr/edespatch/v1/uploads/document/preview
← 200 · preview
Örnek uç — belge göndermeden önce UBL-TR çıktısını doğrulamak için:
ERP, depo ve lojistikte nasıl kullanılır?
Bu sayfa Portal kullanımını değil, yazılımınızın NES e-İrsaliye API'ye bağlanmasını anlatır.
ERP
ERP'den sevk
Sevk emri ERP'de oluşuyorsa UBL-TR üretip sevkiyat başlamadan önce NES'e iletirsiniz. Alternatif: NES Konnektör.
NES Konnektör →Depo / WMS
Depo çıkışından e-İrsaliye
Fiili sevk zamanı ve mal miktarı depodan gelir; belge NES'e iletildikten sonra sevkiyat başlar.
Lojistik
Taşıma akışında belge ve yanıt
Araç plakası ve şoför bilgileri veya taşıyıcı firma bilgileri belgede yer alır; giden irsaliye veya gerektiğinde irsaliye yanıtı kendi iş akışınızdan gönderilir.
Sıkça sorulan sorular
Sevk zamanı, sevkiyat verileri, irsaliye yanıtı, API ve test erişimi hakkında.
e-İrsaliye sevkten önce mi düzenlenir?
Evet. İstisnai haller dışında fiili sevkiyat başlamadan önce düzenlenir ve iletilir. Özel entegratör yönteminde belgenin NES'e ulaşması sevki başlatmak için yeterlidir; ayrıca sistem yanıtı beklenmez. NES belgesini GİB'e azami 15 dakika içinde iletir.
İrsaliye yanıtı zorunlu mu?
Hayır. İrsaliye yanıtı zorunlu değildir; alıcı isterse oluşturur.
Gelen e-İrsaliyeye ne kadar sürede yanıt verilebilir?
Fiili sevk tarihinden itibaren 7 gün içinde tam veya kısmi kabul verilebilir. Yanıt dönülmezse malların tam teslim alındığı kabul edilir.
e-İrsaliye tamamen reddedilebilir mi?
Yalnız fiili sevkten önce ve mal muhteviyatı veya alıcı hatalıysa. Bu koşullar dışındaki retler hükümsüzdür; e-İrsaliye iptal edilmez.
e-İrsaliyede hangi sevkiyat bilgileri bulunur?
UBL-TR DespatchAdvice içinde: fiili sevk zamanı; mal ve teslimat; plaka/şoför veya taşımayı yapan lojistik/kargo firması. Bunlar ayrı REST uçları değildir.
ERP veya WMS'den e-İrsaliye gönderebilir miyim?
Evet. Yazılımınız UBL-TR üretip sevkiyat başlamadan önce NES e-İrsaliye API'ye iletir. ERP tarafında Konnektör de bir alternatiftir.
Test ortamına nasıl erişebilirim?
Formda Test ortamı erişimini seçtiğinizde erişim linki e-postanıza gider; API anahtarı erişim sayfanızdadır. Swagger herkese açıktır: apitest.nes.com.tr/edespatch.
NES, GİB tarafından yetkilendirilmiş özel entegratör mü?
Evet. NES, GİB tarafından yetkilendirilmiş özel entegratördür. e-İrsaliye işlemlerini REST API üzerinden kendi yazılımınızdan yürütebilirsiniz.
e-İrsaliye API e-Fatura veya e-Arşiv API ile aynı mı?
Hayır. Aynı NES API altyapısında ayrı servislerdir (edespatch / einvoice / earchive). Fatura tarafı için e-Fatura veya e-Arşiv entegrasyon sayfalarına bakın.
Doğrudan GİB entegrasyonu ile NES e-İrsaliye API aynı şey mi?
Hayır. GİB'in Entegrasyon Yönteminde mükellefin kendi bilgi işlem sistemi GİB sistemlerine doğrudan bağlanır. NES e-İrsaliye API ise Özel Entegrasyon Yöntemi kapsamında NES'in özel entegratör altyapısı üzerinden sunulur; yazılımınızı GİB'e değil NES'e bağlarsınız.
e-Fatura'ya kayıtlı alıcılar, UBL-TR fatura akışı ve ilk test gönderimi e-Fatura entegrasyon sayfasında.
e-Fatura entegrasyonunu inceleyin →e-Fatura'ya kayıtlı olmayan alıcılar ve e-ticaret faturalaması e-Arşiv entegrasyon sayfasında.
e-Arşiv entegrasyonunu inceleyin →