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 tam endpoint ve body sözleşmesiyle sunulan JSON request örnekleri. Request → UBL XML MappingEntegratör request alanlarının UBL CreditNote XML karşılıkları.

30 Haziran 2027 Geçişi

Geçiş dönemindeki SMS kullanımı ve sorumluluklar

30 Haziran 2027 SMS Doğrulama GeçişiSMS doğrulamasının geçiş kuralları ile entegratör ve Portal sorumlulukları.

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 30 Haziran 2027 SMS doğrulama geçişi hakkında sık sorulan sorular.