Yazılım firmaları · API
Canlıda çalışan e-Fatura entegrasyon altyapısı
ERP, ön muhasebe ve sektörel yazılımlarınız GİB uyumlu e-Fatura zincirine REST API ile bağlanır. İşlemler kendi arayüzünüzden yürütülür; NES Portal hesabı müşterilerinizin kullanımına açık kalır.
Mikroservis mimarisi, test ortamı, log ve durum takibi canlı kullanım için birlikte tasarlandı. İş modeli ve ortaklık koşulları yazılım iş ortaklığı sayfasında anlatılır.
İşlem zinciri
live · production
POST /v1/uploads/document — upload.document
← 201 · uuid
uuid: 30e4317c-…
Entegrasyon altyapısı ve işlem akışı
Yazılımınızda oluşturulan fatura verisi, GİB tarafından yetkilendirilmiş NES özel entegratör altyapısı üzerinden GİB'e iletilir; yanıt, red, iade ve durum bilgisi anlık olarak sisteminize döner. İşlemler kendi arayüzünüzden yürür; NES Portal hesabı müşterilerinizin kullanımına açık kalır.
- Fatura oluşturma ve gönderim kendi arayüzünüzden
- GİB yanıtları ve durum sorgusu API ile
- Mevzuata uyumlu işlem zinciri uçtan uca
Mikroservis mimarisi
İşlemler bağımsız servislerde yürür; tek modüldeki yük veya bakım diğer akışları kilitlemez.
Ölçeklenebilir altyapı
İşlem hacmi arttığında altyapı otomatik olarak ölçeklenir ve artan yükü karşılar.
Pik yük dayanımı
E-ticaret kampanyaları ve dönem sonu toplu gönderimlerinde de belge işlemleri normal şekilde devam eder.
yazılım firması bu altyapıyı kullanıyor
ERP, ön muhasebe, SaaS, e-ticaret ve sektörel yazılımlar bu entegrasyon altyapısına bağlı.
Hızlı başlangıç
UBL-TR yapısını canlı önizleme ile inceleyin
Test portalında örnek bir e-Fatura oluştururken sistem UBL-TR XML çıktısını test ortamında anlık olarak üretir. Fatura ekranında girdiğiniz bilgiler XML'e canlı yansır. Böylece kendi senaryonuzu — örneğin temel fatura, alıcı VKN/TCKN veya %20 KDV'li satış — oluşturarak XML yapısını inceleyebilirsiniz.
Test ortamı erişiminizi formdan alarak UBL-TR ve API akışlarını doğrudan deneyebilirsiniz.
- portaltest.nes.com.tr üzerindeki test portalında manuel e-Fatura oluşturma ekranını açın.
- Kendi senaryonuza ait alanları doldurun.
- XML alanında oluşan geçerli UBL-TR çıktısını alın ve aynı belgeyi API üzerinden gönderin.
Aşağıdaki POST /v1/uploads/document örneğine geçin.
Teknik spesifikasyon ve API gönderim adımları için Developer Portal dokümanlarını kullanmaya devam edin.
İlk test e-Faturanızı API ile gönderin
Aşağıdaki örnek, test portalında oluşan UBL-TR belgesinin NES API üzerinden nasıl gönderildiğini gösterir.
UBL-TR XML (multipart) — zorunlu alanlar: File, SenderAlias, IsDirectSend, PreviewType, SourceApp, AutoSaveCompany. ReceiverAlias ve PreviewType değerleri Swagger'da.
curl -X POST "https://apitest.nes.com.tr/einvoice/v1/uploads/document" \
-H "Authorization: Bearer {api_key}" \
-F "[email protected]" \
-F "SenderAlias=urn:mail:[email protected]" \
-F "ReceiverAlias=urn:mail:[email protected]" \
-F "IsDirectSend=true" \
-F "PreviewType=Html" \
-F "SourceApp=erp-uygulamam" \
-F "AutoSaveCompany=true"Platform yetenekleri
Canlı ortam API'si: güvenlik, izlenebilirlik, ölçek ve modüler e-Belge bağlantısı tek platformda.
Güvenlik
Kimlik, yetki ve güvenlik
- Bearer API key (JWT) ile token tabanlı erişim
- İstemci ve kullanıcı düzeyinde yetkilendirme
Durum takibi
Test, log ve durum takibi
- Başvuru sonrası test ortamında modül doğrulama
- Belge uuid ve işlem geçmişi (histories) ile izlenebilirlik
Ölçek
Ölçek ve toplu işlem
- Toplu durum işlemleri ve taslak gönderim uçları
- Tanımlı hata kodları ve örnek yanıt şablonları
Ürün yüzeyi
Ürün yüzeyi ve modüler bağlantı
- e-Fatura ile başlayıp diğer e-Belge türlerine kademeli genişleme
- Portal işlemleriyle eşlenen REST uçları — tam veya kısmi entegrasyon
Test ortamı
Developer docs ile senaryoları inceleyin
Swagger ve dokümantasyonu açın; test portalı girişini formdan otomatik alın. Takıldığınız yerde entegrasyon ekibiyle görüşebilirsiniz.
Bearer · REST · UBL
Başvuru süreci
Başvuru sonrası ne olur?
01
Formu gönderin
İhtiyacınız olan erişim türünü seçin.
02
Test erişiminizi alın
Test portalı giriş bilgileriniz e-posta adresinize otomatik olarak iletilir.
03
İlk e-Faturanızı test edin
Örnek UBL-TR XML'inizi test ortamında API'ye gönderin ve belge durumunu kontrol edin.
04
Gerektiğinde bize ulaşın
Teknik bir noktada desteğe ihtiyaç duyarsanız entegrasyon ekibiyle görüşün.
Sıkça sorulan sorular
Entegrasyon, test ortamı, dokümantasyon ve teknik destek hakkında.
NES, GİB tarafından yetkilendirilmiş özel entegratör mü?
Evet. NES, GİB tarafından yetkilendirilmiş özel entegratördür. e-Fatura ve diğer e-Belge işlemlerini REST API üzerinden kendi yazılımınızdan yürütebilirsiniz.
NES hangi ürünler için entegrasyon sunuyor?
NES; e-Fatura, e-Arşiv Fatura, e-İrsaliye, e-SMM, e-MM ve e-Defter dahil farklı ürünler için entegrasyon dokümantasyonu sunar. e-Arşiv REST API e-Arşiv entegrasyonu sayfasında; e-İrsaliye REST API e-İrsaliye entegrasyonu sayfasında anlatılır. e-Belge servisleri ile e-Defter gibi diğer ürünlerin teknik kapsamı Developer Portal’da ayrı ayrı yer alır.
Test ortamına nasıl erişebilirim?
Formda Test ortamı erişimini seçtiğinizde size özel güvenli erişim bağlantısı e-posta adresinize otomatik olarak gönderilir. NES’ten dönüş beklemeden test ortamına girip e-Belge akışlarını GİB test sistemi üzerinden deneyebilirsiniz.
İlk test e-Faturamı nasıl gönderebilirim?
Formdan test ortamı erişimini alın. portaltest.nes.com.tr üzerinde bir satış faturası oluşturun; alanları doldururken UBL-TR XML anlık oluşur. Bu XML'i alıp aynı belgeyi POST /v1/uploads/document ile gönderin. Yanıtta uuid döndüğünde ilk test e-Faturanız iletilmiş demektir.
Swagger ve OpenAPI dokümantasyonuna nasıl erişebilirim?
Test ortamı erişiminizi aldığınızda size özel erişim sayfasında e-Fatura, e-Arşiv Fatura, e-İrsaliye, e-SMM ve e-MM servislerinin Swagger ve OpenAPI bağlantıları yer alır. Aynı sayfadan Test Portalı erişim bilgilerinize, API KEY’inize ve ilk deneme senaryosuna da ulaşabilirsiniz. Daha kapsamlı teknik dokümantasyon Developer Portal’da bulunur.
Entegrasyon için teknik destek alabilir miyim?
Evet. Planlama, test ve canlıya geçiş sırasında entegrasyon ekibimiz teknik konularda destek verir. Test ortamına başlamak için teknik görüşme zorunlu değildir; ihtiyaç duyarsanız aynı formdan teknik görüşme talep edebilirsiniz.
Hangi teknolojilerle entegrasyon yapılabilir?
REST API üzerinden HTTP isteği gönderebilen .NET, Java, PHP, Python, Node.js ve benzeri teknolojilerle entegrasyon yapılabilir.
Entegrasyon süresi ne kadar sürer?
Süre, kullanacağınız ürünlere, entegrasyon kapsamına ve mevcut yazılım altyapınıza göre değişir. Yalnızca e-Fatura ile başlayan bir entegrasyon, birden fazla ürünü kapsayan projeye göre daha kısa planlanabilir.
NES Portalını kullanmak zorunda mıyız?
Müşterileriniz e-Belge işlemlerini kendi yazılımınızdan yürütebilir. Entegrasyon NES Portal hesabının yerini almaz; NES Portal da müşterilerinizin kullanımına açık kalır. Entegrasyon kapsamındaki e-Belge akışlarını API üzerinden kendi arayüzünüze taşıyabilirsiniz.
Bu sayfanın Yazılım İş Ortaklığı sayfasından farkı nedir?
Bu sayfa teknik entegrasyon, Developer Portal ve test ortamına odaklanır. Çalışma modelleri ve ortaklık koşulları ise Yazılım İş Ortaklığı sayfasında anlatılır.
e-Fatura'ya kayıtlı olmayan alıcılar, internet satışı ve pazaryeri senaryoları e-Arşiv entegrasyon sayfasında anlatılır.
e-Arşiv entegrasyonunu inceleyin →