e-Müstahsil Makbuzu

e-Müstahsil Makbuzu Entegrasyon Rehberi

Tarımsal ürün alımlarında KDV mükellefi olmayan çiftçilerden yapılan alışlar için GİB standardında e-Müstahsil Makbuzu düzenlemeye yönelik entegrasyon, API ve uygulama referansı.

İç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-Müstahsil Makbuzu Nedir?e-Müstahsil Makbuzu'nun kapsamı, belge tipi, XML yapısı 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, kesintili, çok kalemli oluşturma ve iptal akışları için karar ağacı. 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ıKimlik doğrulama, belge işlemleri, sorgulama, alt modeller ve response alanları. Request ÖrnekleriNormal, kesintili, çok kalemli ve iptal senaryoları için kullanılabilir JSON örnekleri. Request → UBL XML MappingEntegratör request alanlarının UBL CreditNote XML karşılıkları.

Gelecek Değişiklikler

Henüz aktif olmayan doğrulama akışı ve geçiş kapsamı

SMS Doğrulamalı GönderimHenüz aktif olmayan SMS doğrulama değişikliğinin yürürlük koşulu ile entegratör ve Portal rehberleri.

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-Müstahsil Makbuzu rehberindeki business ve teknik içerik değişikliklerinin tarihçesi. Sıkça Sorulan SorularBelge kullanımı, kesintiler, çıktı, API ve planlanan SMS doğrulaması hakkında sık sorulan sorular.