Sıkça Sorulan Sorular

Alıcı e-Fatura uygulamasına kayıtlı değilse (vergi mükellefi veya nihai tüketici) düzenlenir. GİB e-Arşiv kategorisinde, e-Fatura ile aynı UBL Invoice tipiyle oluşturulur; ayrım ProfileID=EARSIVFATURA alanındadır.

VUK Genel Tebliği (Sıra No: 589, 31/12/2025) uyarınca, ticari kazançları basit usulde tespit edilen mükellefler ile işletme hesabı esasına göre defter tutan mükellefler için 1/1/2025–31/12/2026 tarihleri arasında vergiler dahil toplam tutarı 3.000 TL'yi aşmayan faturalar kağıt ortamında düzenlenebilir. Bu tutarı aşan veya bu kapsam dışındaki faturalar e-Arşiv Fatura olarak düzenlenmek zorundadır. Bu platform üzerinden yalnızca elektronik e-Arşiv Fatura düzenlenir; kağıt fatura seçeneği bu platformda uygulanmaz.

6102 sayılı Türk Ticaret Kanunu madde 18/3 uyarınca itirazınızı noter, taahhütlü mektup, telgraf veya KEP (Kayıtlı Elektronik Posta) yollarından biriyle faturayı düzenleyen tarafa iletmeniz gerekir. Türk Ticaret Kanunu madde 21 gereği, faturayı aldığınız tarihten itibaren 8 gün içinde itiraz etmezseniz fatura içeriği kabul edilmiş sayılır.

Belge oluşturulduktan sonra çıktı işlemleri belge kimliğiyle çağrılır. Kullanılabilir işlemler için API sorgulama bölümüne bakın.

Portal işlemi API durumuna gecikmeli yansıyabilir. Nihai karar için belge kimliğiyle durum sorgusu tekrarlanmalıdır.

Kontrolü kendiniz yapmanız gerekmez; AddOutgoingInvoice çağrısında platform bu kontrolü otomatik yapar. Alıcı GİB e-Fatura mükellefiyken ProfileId=EARSIVFATURA gönderirseniz istek INV0221 ile reddedilir; alıcı mükellef değilken TICARIFATURA/TEMELFATURA gönderirseniz INV0220 ile reddedilir. Alıcı mükellefiyken ama fatura tarihinde henüz mükellef olmadığı bir tarih için TICARIFATURA gönderdiyseniz INV0229 alırsınız. Detay için Kullanım Senaryoları ve Teknik Referans sayfalarına bakın.

API tarafında sabit bir gün sayısı ile kısıtlanmış bir kontrol yoktur; iptal, belge durumuna (EArchiveDocumentGIBStatusType) göre değerlendirilir. Ancak faturaya yasal itiraz/yanıt süresi (Türk Ticaret Kanunu madde 21 kapsamında) 8 gündür — bu, e-Arşiv Fatura'nın iptal/itiraz akışında API tarafından kod seviyesinde doğrulanan bir süre değildir, tamamen genel bir hukuki kuraldır; bu süreyi entegratörün kendi tarafında takip etmesi gerekir. Detay için İptal ve İtiraz Durum Takibi sayfasına bakın.

ObjectOutgoingEArchiveInvoice endpointi, alıcının TTK md. 18/3 kapsamında zaten yaptığı hukuki itirazı (KEP/noter/taahhütlü mektup/telgraf yöntemiyle) GİB'e raporlanmak üzere kayda geçirir; itirazın kendisini başlatmaz.

ÖKC fiş bilgisini BillingReference.AdditionalDocumentReference altında, DocumentTypeCode alanını literal olarak OKCBF, DocumentType alanını literal olarak OKCBilgiFisi değeriyle gönderin; ayrıca Id, IssueDate, DocumentDescription, Attachment.ExternalReference, IssuerParty.EndpointId ve IssueDate ile aynı güne ait ValidityPeriod.StartDate alanlarının hepsi dolu olmalıdır. Eksik veya uyumsuz herhangi biri validasyon hatasıyla reddedilir (bkz. Request Örnekleri — Örnek 3).

Tüm istekler VbtAuthorization header'ı gerektirir. Önce POST /api/Account/Token endpointine Email/Password ile istek atıp bir token alınır; bu token diğer tüm endpointlerde VbtAuthorization header'ında gönderilir. Detay için Entegratör API Endpoint Referansı sayfasına bakın.

YTB (Yatırım Teşvik) ve İhracat faturaları bu rehberin kapsamı dışındadır — e-Fatura ile paylaşılan ayrı senaryolardır ve ayrı rehberlerde ele alınacaktır. Bkz. Kullanım Senaryoları.

Önce InvoiceExternalId ve bilinen ETTN ile belgeyi sorgulayın. Kayıt oluşmadığı doğrulanmadan yeni kimlikle tekrar göndermek mükerrer faturaya yol açabilir.

En az dış referans, ETTN/UUID, yasal fatura numarası ve son gözlenen durum birlikte saklanmalıdır.

ERP modeline en yakın tek yöntemi kanonik yol olarak belirleyin. İnternet satışı alanları gerekiyorsa mapping sayfasını kontrol edin.

Platformun UBL giriş işlemi InternetPayment alanını request modeline aktarmaz. Bu senaryoda JSON veya platformun düz XML modeli kullanılmalıdır.

Önce güncel durumu sorgulayın. Durum zaten istek alınmış ya da başarılı sonucu gösteriyorsa aynı işlemi yeniden başlatmayın.

Entegrasyon kararını yalnızca mesaj metnine değil response içindeki hata kodu ve alan ayrıntısına bağlayın; güncel katalog için Teknik Referans sayfasını kullanın.

Normal satış, internet satışı, çıktı alma, durum sorgusu, timeout sonrası mutabakat, iptal ve itiraz akışları test ortamında ayrı ayrı doğrulanmalıdır.