Sıkça Sorulan Sorular

e-Gider Pusulası, esnaf/serbest meslek erbabından yapılan mal veya hizmet alımlarında GİB UBL-TR standardına uygun olarak elektronik ortamda düzenlenen bir belgedir. Satış (SATIS) veya iade (IADE) işlemi için ayrı belge tipleri kullanılır.

İade, orijinal işlemin belge tipine göre değişir: e-Arşiv fatura, satış fişi veya belgesiz iade olabilir. Kargo ile veya yüz yüze iadelerde ek olarak kargo firması ve/veya vekalet bilgisi istenebilir. Detaylı akış için Kullanım Senaryoları sayfasına bakın.

Kimlik doğrulama alanında SchemeId değeri TCKN yerine PASAPORTNO olarak gönderilir; diğer alanlar aynı kalır.

GİB standardı, işlemin muhatap tarafından doğrulandığını göstermek için SMS veya iade kodu bilgisi ister. Portalda SMS kodu VBT tarafından gönderilir; uygun IADE işleminde iade kodu ilgili sağlayıcıdan alınarak Portalda kaydedilir. Doğrudan entegrasyonlarda ise doğrulama entegratörün kendi sürecinde tamamlanır ve sonuç belge requestiyle gönderilir.

Hayır. Belge kaydedilir, kullanıcı doğrulama ekranında telefonu kontrol eder ve SMS gönderimini başlatır. Kod 6 hanelidir ve ekranda gösterilen süre içinde girilmelidir. Kargolu IADE işleminde SMS yerine iade kodu kullanılır.

Evet. Kod henüz gönderilmediyse belge doğrudan iptal edilir. Kod gönderilmişse telefona iptal bildirimi gönderilmeye çalışılır; bildirimin başarısız olması belge iptalini geri almaz.

Hayır. SMS gönderme, kod doğrulama, iade kodu kaydetme ve gerçek kişi cari seçme ekranları VBT Portal içinde hazır sunulur.

Hayır. Her e-Gider Pusulası ayrı bir doğrulama kaydı taşıdığı için SMS veya iade kodu adımı belge bazında tamamlanır.

Geçersiz veya süresi dolmuş kod kabul edilmez. Deneme ve bekleme kuralları uygunsa yeni kod istenir.

Hayır. Bu endpointler hazır Portal akışına aittir. Doğrudan entegrasyon, kendi sürecinde tamamladığı doğrulamanın altı alanını mevcut oluşturma veya güncelleme requestiyle göndermelidir.

Yüz yüze IADE senaryosunda VerificationMethod için SMS veya IADEKODU kullanılabilir. Kargo aracılığıyla yapılan IADE işleminde değer yalnızca IADEKODU olabilir. GİB'in beklediği IADE_PROVIDER ve IADEKODU alanlarını platform üretir.

Doğrudan ERP/API önizlemesi aynı model validasyonundan geçtiği için doğrulama alanları eksiksiz gönderilmelidir. Portal önizlemesi boş doğrulama verisiyle üretilebilir; ancak önizleme başarısı belgenin doğrulandığı veya gerçek kaydın kabul edileceği anlamına gelmez.

POST /api/Account/Token ile oturum token'ı alınır; sonraki tüm istekler bu token'ı VbtAuthorization header'ında taşır. Detay için Entegratör API Endpoint Referansı sayfasına bakın.

Evet. Swagger üzerinden endpoint'leri deneyebilirsiniz: Entegratör API Endpoint Referansı sayfasındaki test ortamı linkine bakın.

Evet. SATIS ve IADE senaryoları için uyarlanabilir JSON şablonları Request Örnekleri sayfasında yer alır. Kimlik, telefon, sağlayıcı, kargo ve belge referansı değerleri gerçek işleme göre değiştirilmelidir.

Hayır. IsSigned=true, entegratörün UBL'nin gerçekten imzalı olduğuna ilişkin beyanıdır. Platform bu beyana güvenir ve gönderilen UBL baytlarını tamamlamaz veya yeniden üretmez. Doğrulama, kargo, iade edilen belge ve vekalet alanlarının tamamı imzadan önce UBL içinde hazırlanmalıdır.

Belge oluşturma/güncelleme yanıtlarında HasError alanı true döner ve Errors[] dizisinde hata detayları listelenir. Alan bazlı zorunluluklar için Entegratör Sorumlulukları sayfasına bakın.

Kargo ile iadede kargo firma kodu (CargoCompanies/GetAll endpointinden alınır), vekalet ile iadede ise vekil bilgilerinin eksiksiz doldurulması gerekir. Ayrıntılı alan listesi için Kullanım Senaryoları ve Request Örnekleri sayfalarına bakın.