e-SMM ve e-MM API: makbuz işlemlerini yazılımınıza bağlayın

MultiPortal REST API, e-Serbest Meslek Makbuzu ve e-Müstahsil Makbuzu için doğrulama, oluşturma, gönderim, listeleme ve içerik erişimi sunar. İki belge aynı hesaplama modeli değildir; vergi oranları ve beklenen tutar alanları belge türüne göre doğru eşlenmelidir.

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.

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ı

  1. Hizmeti ve anahtar modunu /hesap ile kontrol edin.
  2. Belge türüne uygun /dogrula ucunda hesaplanan tutarları inceleyin.
  3. Belgeyi benzersiz harici_id ile taslak oluşturun; yanıtın ETTN ve durumunu saklayın.
  4. Kullanıcıya alıcı/üretici, brüt, kesintiler ve tahsil/ödeme tutarı özetini gösterin.
  5. Açık onaydan sonra gönderin. Durumu GET /esmm/{ettn} veya GET /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.