e-Arşiv Fatura Entegrasyon Rehberi

e-Arşiv Fatura süreçlerinin VUK Genel Tebliği (Sıra No: 509) ve GİB e-Arşiv Teknik Kılavuzu'na uygun biçimde yürütülmesine yönelik entegrasyon, API ve uygulama referansı.

Rehbere başlayın API sözleşmeleri

İçerik haritası

İhtiyacınız olan akıştan başlayın

Ürün kapsamından API sözleşmelerine, iş akışlarından teknik referanslara kadar tüm entegrasyon yüzeyleri ayrı bölümlerde düzenlenir.

Başlangıç

Ürün kapsamı, teknik kimlik ve GİB gereksinimleri

e-Arşiv Fatura Nedir?e-Arşiv Fatura'nın kapsamı, ProfileID ayrımı, teknik kimliği ve belge yaşam döngüsü. GİB ReferansıGİB paketi, kullanım yöntemi, teknik gereksinimler ve resmi kaynaklar.

Uygulama

Senaryolar, yaşam döngüsü ve sorumluluk sınırları

Kullanım SenaryolarıNormal satış, internet satışı, ÖKC, tevkifat ve mükerrer/iade akışları için karar ağacı. İptal ve İtiraz Durum TakibiGİB Portal ile senkronize iptal/itiraz durum modeli, yasal süreler ve entegratör sorumlulukları. Entegratör SorumluluklarıEntegratörün veri hazırlama, doğrulama ve belge oluşturma sürecindeki sorumlulukları. Platform SorumluluklarıPlatformun otomatik işlemleri, validasyon kuralları, hata yanıtları ve iptal ön koşulları.

API

Entegratör ve Portal endpoint sözleşmeleri ile örnekler

Entegratör API Endpoint ReferansıEntegratör belge endpointleri, alan sözleşmeleri ve yanıt örnekleri. Portal API Endpoint ReferansıPortal grid, e-posta ve iptal/itiraz tamamlama endpoint sözleşmeleri. Request ÖrnekleriNormal satış, internet satışı, ÖKC, tevkifat ve iptal/itiraz senaryoları için kullanılabilir JSON örnekleri. Request → UBL XML MappingEntegratör request alanlarının UBL Invoice XML karşılıkları.

Referans

Teknik sözlük, değişiklik geçmişi ve operasyon soruları

Teknik ReferansEnum değerleri, hata/mesaj kodları, validasyon referansları ve kaynak bölüm bağlantıları. Changeloge-Arşiv Fatura rehberindeki business ve teknik içerik değişikliklerinin tarihçesi. Sıkça Sorulan SorularSenaryo seçimi, iptal, itiraz, çıktı, API ve UBL hakkında sık sorulan sorular.