e-Arşiv Fatura REST API entegrasyonu

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.

Hayır. GİB dilinde özel entegrasyon, mükellefin kendi sistemini doğrudan GİB'e bağlamasıdır. NES e-Arşiv API ise özel entegratör altyapısı üzerinden sunulan REST servisidir; GİB bağlantısını NES yürütür, siz yazılımınızı NES'e bağlarsınız.

Her iki taraf da e-Fatura'ya kayıtlıysa belge e-Fatura olarak GİB sistemi üzerinden gider. Alıcı kayıtlı değilse e-Arşiv Fatura kesilir; alıcıya iletirsiniz ve günlük GİB raporunu NES hazırlayıp iletir. Teknik tarafta ikisi de aynı NES API altyapısında, ayrı servisler olarak çalışır.

Alıcının VKN veya TCKN'sini NES e-Fatura API mükellef listesi uçlarına ilettiğinizde kayıt durumu otomatik gelir. Kayıtlıysa e-Fatura, değilse e-Arşiv servisine geçersiniz. GİB listelerinden manuel kontrol için e-Fatura mükellef sorgulama rehberimizde adım adım anlatım da var.

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.

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.

Evet. Pazaryeri sipariş yazılımı, e-ticaret sitesi veya muhasebe programı fark etmez — sipariş verinizi NES'e API ile iletirsiniz. e-Ticarette alıcı genelde e-Fatura mükellefi olmadığı için e-Arşiv devreye girer; teknik yol e-Fatura entegrasyonuyla aynıdır. İsterseniz faturayı taslak gönderip müşteriniz Portal'dan onaylar; muhasebe tarafında ERP Konnektör de bir seçenektir.

Genelde alıcının tercihine göre kağıt veya elektronik iletilir; internet satışında elektronik zorunludur. Alıcının e-postası NES'te kayıtlıysa fatura mail ile gider. İletim ve okundu durumu NES üzerinden operasyonel olarak takip edilebilir; bu kayıtlar tek başına hukuki teslim ispatı değildir. İnternet satışında faturada web adresi, ödeme bilgisi ve "Bu satış internet üzerinden yapılmıştır" ifadesi gibi zorunlu alanlar da bulunur.

Portal yöntemi dışında kesilen e-Arşiv faturalar günlük dönemler halinde ve en geç izleyen günün sonuna kadar GİB'e raporlanır. NES özel entegratör modelinde bu raporu NES hazırlayıp iletir; rapor durumunu Portal veya API'den takip edebilirsiniz.

GİB, özel entegratör tarafında e-Arşiv fatura iptaline teknik bir süre kilidi koymaz. NES, dilediğiniz tarihteki e-Arşiv faturanın iptaline izin verir; iptal API ve Portal üzerinden yürütülebilir. Ticari ve yasal sonuç mükellefin sorumluluğundadır.

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.

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.

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.