e-Adisyon Entegrasyon Rehberi

e-Adisyon süreçlerinin mevzuata ve GİB teknik standartları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-Adisyon Nedir?e-Adisyon'un kapsamı, tarafları, teslim şekli 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ıOluşturma, güncelleme ve iptal akışı için karar ağacı ve senaryolar. Entegratör SorumluluklarıEntegratörün veri hazırlama, hesaplama ve belge oluşturma sürecindeki sorumlulukları. Platform SorumluluklarıPlatformun otomatik işlemleri, validasyon, PDF/önizleme ve GİB raporlama sorumlulukları.

API

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

Entegratör API Endpoint ReferansıEntegratörün kullandığı e-Adisyon endpointleri ve yanıt sözleşmeleri. Portal API Endpoint ReferansıPortal kullanıcı deneyimini sağlayan e-Adisyon işlemleri. Request ÖrnekleriGerçek ve tüzel taraf, çok kalemli ve iptal senaryolarına yönelik JSON örnekleri. Request → UBL XML MappingEntegratör request alanlarının UBL CreditNote 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ı ve validasyon referansları. Changeloge-Adisyon entegrasyon rehberinde yayımlanan içerik değişikliklerinin tarihçesi. Sıkça Sorulan SorularBelge kullanımı, iptal, çıktı, API ve hata yönetimi hakkında sık sorulan sorular.