Sıkça Sorulan Sorular

Serbest meslek erbabı, mesleki faaliyeti karşılığında yaptığı tahsilat için e-SMM düzenler. Temel taraflar ve belge kapsamı e-SMM Nedir? sayfasındadır.

Her iki teslim yöntemi de desteklenir. Portal’da veya request’te GonderimSekli seçilir. Elektronik teslimde e-posta adresi kullanılabilir; kâğıt teslimde imzalı PDF çıktısı alınır.

Evet. Portal taslak PDF önizlemesi üretir. Önizleme kalıcı kayıt veya belge numarası oluştuğu anlamına gelmez; Kaydet sonucunda numara ve UUID oluşur.

Evet. Belge listesi veya detay ekranından tekil/çoklu PDF alınabilir. Portal işlevleri görüntüleme ve PDF bölümünde açıklanır.

Hayır. E-posta teslim durumu, belgenin PDF/imza ve GİB raporlama durumundan ayrıdır. Portal’dan yeniden gönderim başlatılabilir.

Evet. MalHizmetler listesine birden fazla satır eklenebilir. Her satırın kimliği benzersiz, üst toplamların satır toplamlarıyla uyumlu olması gerekir. Çok kalemli örneğe bakın.

Evet. Para birimi ISO 4217 koduyla, işlem kuru CalculationRate ile belirtilir. Dövizli senaryoda kur sıfır olamaz ve TRY karşılıkları tutarlı olmalıdır.

Hayır. Stopaj brüt hizmet bedeli üzerinden gelir vergisi kesintisidir; KDV tevkifatı hesaplanan KDV üzerinden uygulanır. İkisi birlikte de bulunabilir. Hesap sırası Vergi ve Kesinti Yapısı bölümündedir.

Portal’dan uygun belge seçilerek iptal başlatılır. Entegrasyonda UUID ile CancelOutgoingSmm çağrılır. GİB iptal bildirimi VBT tarafından raporlama sürecinde yönetilir.

Evet; ancak iptal edilen belge güncellenmez. Aynı ekonomik işlem için yeni bir belge ve yeni SmmExternalId oluşturulur.

Hayır. Raporun oluşturulması, imzalanması, paketlenmesi, gönderilmesi ve sonucunun takibi VBT sorumluluğudur. Portal yalnız kullanıcıya anlamlı durumları gösterir.

POST /api/Account/Token ile oturum tokenı alınır. Ardından VbtAuthorization header’ıyla belge endpointleri çağrılır. Tam sıra ilk belge akışında gösterilir.

Tek başına hayır. Oluşturma ve güncellemede Data.HasError = false kontrol edilmeli, SmmNumber ve UUId saklanmalıdır.

Her standart yanıtta RefreshToken kontrol edilir. Boş değilse sonraki çağrıdan önce saklanan token atomik biçimde güncellenir.

ERP’deki işlemle VBT belgesini eşleştiren benzersiz dış referanstır. Zaman aşımı sonrası uzlaştırma ve mükerrer belgeyi önleme için kullanılır.

Önce GetOutgoingSmmList çağrısında SmmExternalId ile kayıt sorgulanmalıdır. Kayıt bulunmadan yeni dış referansla tekrar göndermek mükerrer belge riski oluşturur.

10 haneli VKN’de Unvan ve VergiDaire; 11 haneli TCKN’de Ad ve Soyad gönderilir. Her iki durumda adres gereklidir.

DocumentCurrencyCode geçerli ISO 4217 kodu ve CalculationRate sıfırdan büyük olmalıdır. TRY karşılıkları kullanılıyorsa Kur modeli aynı kurla hesaplanır.

Entegratör request’te satır ve belge tutarlarını hazır ve tutarlı gönderir. KDV, stopaj, tevkifat, net ücret ve ödenecek tutar ilişkileri gönderimden önce ERP tarafında doğrulanmalıdır.

Evet. Stopaj brüt üzerinden, tevkifat hesaplanan KDV üzerinden ayrı hesaplanır. Birlikte kullanım örneği Örnek 7 içindedir.

Hayır. Önce detay endpointinden güncel model okunmalı; Id ve UUId dahil tam güncel SmmRequestModel gönderilmelidir.

POST /api/Smm/GetOutgoingSmmPdf çağrısında Ettns[] gönderilir. Yanıttaki Data.SmmPdfFileBytes base64 çözülerek PDF olarak saklanır veya gösterilir.

GET /api/Smm/GetOutgoingSmm?id={uuid} çağrısındaki id, belgenin UUID/ETTN değeridir. Liste uzlaştırmasında ayrıca dış referans filtresi kullanılabilir.

Hayır. Tekil belge oluşturma, sorgulama, çıktı ve iptal uçları entegratör sözleşmesidir. Rapor oluşturma, imzalama, gönderme ve durum sorgulama VBT’nin platform sorumluluğudur.

Hayır. Data.Errors[] içindeki alan/koşul düzeltilmeden tekrar gönderilmemelidir. Ağ veya 5xx hatalarında ise önce dış referansla uzlaştırma yapılır.

Genellikle hayır. Grid, global arama, Excel, önizleme, okunma, e-posta ve mükellef yardımcıları Portal deneyimine aittir. ERP için ayrılmış uçlar entegratör referansında listelenir.