e-SMM ile e-MM entegrasyonunu neden ayırmalısınız?
Her iki belgeyi tek bir genel “makbuz tutarı” alanına indirgemek, brüt ücretle ödenecek netin karışmasına yol açabilir. Entegrasyonda önce belge türünü belirleyin, sonra o türün şemasını kullanın. GET /hesap yanıtındaki hizmetler ve anahtar modu ilgili işleme izin vermelidir.
e-SMM API: brüt ücret, vergi ve tahsilat tutarı
POST /esmm/dogrula brüt, KDV, stopaj, tevkifat, net ve tahsil edilecek tutarı kayıt oluşturmadan hesaplar. POST /esmm ile taslak oluştururken harici_id zorunludur. Teknik sözleşmede birim_fiyat brüt ücrettir; beklenen_toplam ise tahsil edilecek tutardır.
kdv_oranivestopaj_oraniaçıkça verilmelidir; uygulama içinde gizli oran varsaymayın.- Oranı yazılım veya yapay zekâ tahmin etmemeli; işlem için yetkili kişinin doğruladığı değerler kullanılmalıdır.
- Teknik kılavuza göre müşteri e-Fatura mükellefi değilse gönderim için e-posta gerekir. E-posta alanını genel analiz veya olay loglarına taşımayın.
- Gönderimi
POST /esmm/{ettn}/gonderile, kontrol edilmiş taslak ve açık onay üzerinden yürütün.
e-MM API: müstahsile ödenecek neti kontrol edin
POST /emm/dogrula e-Müstahsil Makbuzu için kayıt oluşturmayan denetimdir. POST /emm ile oluşturma isteğinde stopaj_orani ve harici_id zorunludur. beklenen_toplam müstahsile ödenecek neti ifade eder. Borsa tescil, mera fonu ve SGK primi gibi desteklenen ek kesintileri yalnız işlemde gerçekten uygulanıyorsa doldurun.
Bu rehber vergi oranı belirlemez. Oran ve kesinti değerleri yetkili muhasebe değerlendirmesiyle doğrulanmalı, ardından teknik sözleşmedeki alanlara aktarılmalıdır. e-SMM için kullandığınız hesaplamayı değişiklik yapmadan e-MM’ye uygulamayın.
İki makbuz türü için güvenli işlem sırası
- Hizmeti ve anahtar modunu
/hesapile kontrol edin. - Belge türüne uygun
/dogrulaucunda hesaplanan tutarları inceleyin. - Belgeyi benzersiz
harici_idile taslak oluşturun; yanıtın ETTN ve durumunu saklayın. - Kullanıcıya alıcı/üretici, brüt, kesintiler ve tahsil/ödeme tutarı özetini gösterin.
- Açık onaydan sonra gönderin. Durumu
GET /esmm/{ettn}veyaGET /emm/{ettn}üzerinden, ya da olay akışıyla takip edin.
Taslak silme ile gönderilmiş makbuz iptali farklıdır
e-MM taslağı entegratörde oluşabilir ve numarası taslak aşamasında verilebilir. Bu taslağı silmek numarayı kullanılmış bırakabilir. Bu nedenle gerçek kaydı deneme verisi gibi oluşturup silmeyin. Gönderilmiş makbuzun iptali ayrı işlem ve yetki gerektirir; API, gerçek durum okunamadığında iptal yapmaz. Silme veya iptal, arşivin yok olduğu anlamına gelmez.
PDF, UBL XML ve HTML içerik uçlarını belge kopyasını almak için kullanın. Belge durumu bilinmiyorsa başarılı diye işaretlemeyin; içeriği indirebilmek ile gönderim sonucunun kesinleşmesi aynı şey değildir.
Sık sorulan sorular
e-SMM API’de birim fiyat net tutar mıdır?
Hayır. MultiPortal e-SMM sözleşmesinde birim_fiyat brüt ücrettir. beklenen_toplam tahsil edilecek tutarı ifade eder; KDV ve stopaj oranları açıkça verilmelidir.
e-MM’de beklenen_toplam hangi tutardır?
Müstahsile ödenecek net tutardır. Stopaj ve işlemde uygulanacak ek kesintiler doğrulandıktan sonra hesaplanan sonuçla karşılaştırılmalıdır.
Deneme için e-MM taslağı oluşturup silmeli miyim?
Kayıt oluşturmayan emm/dogrula ucuyla başlayın. Gerçek e-MM taslağı entegratörde numara alabilir; taslağı silmek bu numarayı kullanılmış bırakabilir.
Kaynaklar ve ilgili rehberler
Teknik açıklamalar 21 Kasım 2026 tarihinde erişilen MultiPortal kaynaklarına dayanır. Uygulamada güncel sözleşmeyi kontrol edin. Portal demosu ekranları incelemek içindir; API anahtarı veya gerçek işlem yetkisi vermez.