Yazılım firmaları · e-Arşiv API
e-Arşiv Fatura REST API entegrasyonu
e-Arşiv faturalarını ERP, e-ticaret veya kendi yazılımınızdan oluşturup gönderirsiniz. Alıcı e-Fatura'ya kayıtlı değilse e-Arşiv servisini kullanırsınız; kayıt kontrolü NES tarafında VKN veya TCKN ile yapılır.
e-Arşiv, e-Fatura ile aynı NES API altyapısında ayrı bir servis olarak çalışır. Test ortamı ve Swagger linkleri başvuru sonrası size özel erişim sayfanızda yer alır.
e-Arşiv işlem zinciri
earchive · api
POST apitest.nes.com.tr/earchive/v1/uploads/document/preview — document.preview
← 200 · preview
e-Arşiv entegrasyonu hangi durumda devreye girer?
Faturanın e-Fatura mı e-Arşiv mi olacağı, alıcının e-Fatura'ya kayıtlı olup olmamasına bağlıdır. Alıcının VKN veya TCKN'sini NES'e ilettiğinizde kayıt durumu otomatik döner: kayıtlı alıcıya e-Fatura, kayıtlı olmayana e-Arşiv.
Alıcı e-Fatura'ya kayıtlıysa
Belge e-Fatura akışıyla GİB sistemi üzerinden iletilir. e-Arşiv servisi bu senaryoda devreye girmez.
e-Fatura entegrasyonu →Alıcı e-Fatura'ya kayıtlı değilse
Belge e-Arşiv Fatura olarak kesilir. Alıcıya elektronik ortamda veya kağıt çıktı ile iletirsiniz; e-Arşiv raporlamasını NES yürütür.
Faturayı kesmeden önce alıcının VKN veya TCKN'sini NES'e gönderirsiniz; dönen cevaba göre e-Fatura veya e-Arşiv servisine yönlendirirsiniz.
e-Arşiv Fatura akışı kendi yazılımınızda nasıl işler?
e-Arşiv, e-Fatura 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
Alıcının kaydını kontrol edin
Alıcının e-Fatura kaydını VKN veya TCKN ile NES'ten alın; kayıtlı değilse e-Arşiv servisine devam edin.
Adım 02
UBL-TR belgeyi hazırlayın
ERP, e-ticaret veya kendi uygulamanızdaki sipariş verisinden UBL-TR faturayı oluşturun.
Adım 03
NES e-Arşiv API'ye gönderin
Belgeyi göndermeden önce önizleyebilir veya API'ye yükleyebilirsiniz. Yükleme yanıtındaki UUID ile belgeyi takip edebilirsiniz.
Adım 04
İletim ve durumu takip edin
Faturayı alıcıya elektronik kanallardan veya kağıt çıktı ile iletirsiniz. Alıcının e-postası kayıtlıysa mail gider; iletim ve okundu bilgisini NES üzerinden izlersiniz. XML, PDF ve HTML çıktılarına API'den erişirsiniz.
Alıcı faturayı nasıl alır?
e-Arşiv faturayı alıcıya elektronik ortamda veya kağıt çıktı ile iletebilirsiniz. Genelde alıcının tercihine göre kağıt veya elektronik seçilir; internet satışında elektronik iletim zorunludur.
Elektronik iletim seçtiğinizde fatura e-posta veya diğer elektronik kanallardan gider. Alıcının e-posta adresi NES'te kayıtlıysa fatura otomatik mail ile iletilir.
Mail gitti mi, okundu mu — NES üzerinden operasyonel olarak takip edebilirsiniz. Bu kayıtlar tek başına hukuki teslim ispatı değildir.
İnternet satışında elektronik iletimin yanı sıra faturada web adresi, ödeme bilgisi ve "Bu satış internet üzerinden yapılmıştır" ifadesi gibi zorunlu alanlar da bulunur.
e-Arşiv API ile neler yapabilirsiniz?
Aşağıdaki işlemlerin hepsinin Swagger'da karşılığı var. İstek ve yanıt detayları, test erişiminizle birlikte gelen OpenAPI dokümantasyonunda.
- UBL-TR belge önizleme
- e-Arşiv belgesi yükleme
- XML, PDF ve HTML çıktısına erişim
- Taslak faturaları listeleme ve yönetme
- Taslak faturayı gönderme
Örnek uç
document.preview
POST apitest.nes.com.tr/earchive/v1/uploads/document/preview
← 200 · preview
Örnek uç — belge göndermeden önce UBL-TR çıktısını doğrulamak için:
e-Ticaret ve pazaryeri entegrasyon senaryoları
e-Ticaret ve pazaryerinde belge türü alıcının e-Fatura kaydına göre seçilir: kayıtlıysa e-Fatura, değilse e-Arşiv. Aşağıdaki senaryolar bu satış kanallarından NES API'ye bağlanan yazılım tiplerini anlatır.
Pazaryeri sipariş yazılımı
Pazaryeri siparişlerini NES API üzerinden faturalama
Trendyol, Hepsiburada veya başka kanallardan gelen siparişleri kendi yazılımınızda topluyorsunuz. Sipariş faturalanmaya hazır olduğunda belgeyi e-Fatura veya e-Arşiv olarak NES API'ye iletirsiniz.
e-Ticaret sitesi yazılımı
e-Ticaret satışlarını faturalama veya taslak gönderme
Kendi e-ticaret sitenizdeki satışları doğrudan faturalayabilir veya NES'e taslak olarak gönderebilirsiniz. Müşteriniz isterse taslakları NES Portal'dan kontrol edip onaylar; siz API üzerinden belge üretimini ve takibini yaparsınız.
Muhasebe / ERP
Muhasebe programından NES'e entegrasyon
Satış pazaryerinden, web sitesinden veya mağazadan muhasebe programına düşüyorsa muhasebe yazılımınız kendi API entegrasyonuyla NES'e gönderebilir. Müşteri ERP Konnektör (Web e-Con) kurarak da aynı veriyi NES'e aktarabilir.
NES Konnektör →
Sıkça sorulan sorular
e-Arşiv entegrasyonu, test ortamı ve API dokümantasyonu hakkında.
NES, GİB tarafından yetkilendirilmiş özel entegratör mü?
Evet. NES, GİB tarafından yetkilendirilmiş özel entegratördür. e-Arşiv Fatura işlemlerini REST API üzerinden kendi yazılımınızdan yürütebilirsiniz.
Doğrudan GİB entegrasyonu ile NES e-Arşiv 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-Arşiv 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-Arşiv Fatura ile e-Fatura arasındaki entegrasyon farkı nedir?
Alıcı e-Fatura'ya kayıtlıysa belge e-Fatura, değilse e-Arşiv kesilir. İkisi aynı NES API altyapısında ayrı servislerdir.
Alıcının e-Fatura'ya kayıtlı olup olmadığını nasıl belirlerim?
VKN veya TCKN'yi NES e-Fatura API mükellef listesi uçlarına ilettiğinizde kayıt durumu gelir. Manuel kontrol için e-Fatura mükellef sorgulama rehberimiz de var.
e-Arşiv Faturayı kendi ERP veya yazılımımdan oluşturabilir miyim?
Evet. REST API ile ERP, e-ticaret veya kendi uygulamanızdan e-Arşiv fatura oluşturup gönderebilir, durumu kendi sisteminize çekebilirsiniz. NES Portal ayrı bir kullanım yoludur; entegrasyon Portal'ın yerini almaz.
e-Arşiv API ile hangi işlemleri yapabilirim?
UBL-TR önizleme, belge yükleme, XML/PDF/HTML çıktısı, taslak yönetimi ve taslak gönderimi gibi işlemler e-Arşiv Swagger'da listelenir. Tam liste test erişiminizle gelen OpenAPI dokümantasyonunda.
e-Ticaret ve pazaryeri siparişlerini e-Arşiv akışına bağlayabilir miyim?
Evet. Sipariş verisini NES'e API ile iletirsiniz; belge türü yine alıcının e-Fatura kaydına göre seçilir. Taslak + Portal onayı veya ERP Konnektör de seçenek olabilir.
e-Arşiv Fatura alıcıya nasıl iletilir?
Kağıt veya elektronik; internet satışında elektronik zorunludur. E-posta kayıtlıysa mail gider. İletim/okundu takibi operasyoneldir; hukuki teslim ispatı değildir.
e-Arşiv raporlamasını kim yapar?
NES özel entegratör modelinde raporları mevzuatta belirtilen sürelerde hazırlar ve GİB'e iletir. Genel kural günlük dönemdir; bazı belge tiplerinde süre farklı olabilir.
e-Arşiv Fatura iptali entegrasyonda nasıl yürür?
NES e-Arşiv API üzerinden fatura iptal işlemi yapılabilir. Özel entegratör yönteminde iptal bilgisi ilgili GİB bildirim/raporlama süreciyle aktarılır. İptalin ticari ve vergisel sonucu belgenin ve işlemin durumuna göre ayrıca değerlendirilir.
e-Arşiv Swagger ve OpenAPI dokümantasyonuna nasıl erişebilirim?
Formdan test erişimi aldığınızda size özel sayfanızda e-Arşiv Swagger ve OpenAPI linkleri listelenir. Genel test adresi apitest.nes.com.tr/earchive; canlı çağrılar için size iletilen erişim bilgilerini kullanın.
Test ortamına nasıl erişebilirim?
Formda Test ortamı erişimini seçtiğinizde güvenli erişim linki e-posta adresinize otomatik gider. Erişim sayfanızda test portalı bilgileri, API anahtarı ve e-Arşiv dahil Swagger linkleri yer alır.
NES Portalını kullanmak zorunda mıyım?
Hayır. Müşterileriniz e-Arşiv işlemlerini kendi yazılımınızdan yürütebilir. Entegrasyon Portal'ın yerini almaz; Portal müşterilerinizin kullanımına açık kalır.
e-Fatura'ya kayıtlı alıcılar, UBL-TR akışı ve ilk test gönderimi adımları e-Fatura entegrasyon sayfasında anlatılır.
e-Fatura entegrasyonunu inceleyin →Sevk öncesi e-İrsaliye, sevkiyat verileri ve irsaliye yanıtı e-İrsaliye entegrasyon sayfasında.
e-İrsaliye entegrasyonunu inceleyin →