e-Serbest Meslek Makbuzu

e-Serbest Meslek Makbuzu Entegrasyon Rehberi

e-Serbest Meslek Makbuzu süreçleri için entegrasyon, API, belge teslimi ve GİB raporlama sorumluluklarını açıklayan uygulama rehberi.

Rehbere başlayınAPI 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-Serbest Meslek Makbuzu Nedir?e-SMM'nin kapsamı, tarafları, teslim şekilleri ve belge yaşam döngüsü. GİB ReferansıGİB paketi, kullanım yöntemi, teknik gereksinimler ve resmi e-SMM kaynakları.

Uygulama

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

Kullanım SenaryolarıGerçek ve tüzel alıcı, para birimi, vergi, gönderim ve iptal senaryoları. Entegratör SorumluluklarıEntegratörün veri hazırlama, kimlik, tutar, vergi ve sonuç yönetimi sorumlulukları. Platform SorumluluklarıVBT platformunun belge üretimi, imzalama, teslim 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-SMM endpointleri ve yanıt sözleşmeleri. Portal API Endpoint ReferansıPortal kullanıcı deneyimini sağlayan e-SMM işlemleri. Request ÖrnekleriGerçek ve tüzel alıcılarla TRY, döviz, stopaj ve tevkifat senaryolarına yönelik JSON örnekleri. Request → Belge → GİB Raporu MappingEntegratör request alanlarının makbuzdaki iş anlamı ve GİB raporundaki 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-SMM entegrasyon rehberinde yayımlanan içerik değişikliklerinin tarihçesi. Sıkça Sorulan SorularBelge kullanımı, vergi, teslim, iptal, API ve raporlama hakkında sık sorulan sorular.