e-Müstahsil Makbuzu

30 Haziran 2027 Geçişi

Portal Kullanıcıları İçin

30 Haziran 2027 geçişinde VBT Portalda sunulacak SMS gönderme ve kod doğrulama davranışları.

Canlı sürümde makbuz SMS’siz düzenlenir. Aşağıdaki SMS akışı TEST ortamındaki geçiş sürümünü anlatır.

VBT Portal, SMS gönderme ve kod doğrulama adımlarını e-Müstahsil Makbuzu ekranında hazır olarak sunar. Portal kullanan firmaların yeni endpoint veya request modeli geliştirmesi gerekmez. SMS akışı seçildiğinde kullanıcı gönderimi ekrandan başlatır; VBT Platform SMS'i gönderir ve kodu doğrular.

Portalda SMS seçildiğinde: MM için planlanan yöntem SMS'tir. TEST’te SMS seçilen makbuz kodu bekler. Geçişten önce SMS seçilmeyen makbuz imzaya ilerler.

Portalda hazır sunulacak akış

  1. Portal kullanıcısı e-müstahsil makbuzunu mevcut belge ekranından oluşturur.
  2. Belge ekranı üreticinin telefon numarasına SMS gönderme adımını sunar.
  3. Üreticinin ilettiği kod aynı ekran üzerinden doğrulanır.
  4. Başarılı doğrulama sonrasında belge normal imzalama ve gönderim sürecine otomatik olarak devam eder.
Ek entegrasyon gerektirmez: SMS gönderimi, kodun süresinin dolması, yeniden gönderim, yanlış kod ve tekrar sınırı gibi davranışlar VBT Portal tarafından yönetilir.

Platformun Otomatik İşlemleri

İşlemPortalın sağladığı davranışKullanıcıdan beklenen
Telefon girişiBelge ekranında doğrulama telefonu alanı sunulur.Üreticinin güncel telefon numarasını girmek.
SMS gönderimiKod gönderimi ve gönderim sonucu ekranda yönetilir.SMS gönderimini belge ekranından başlatmak.
Kod doğrulamaKod girişi, süre ve tekrar davranışı hazır sunulur.Üreticinin ilettiği kodu ekrana girmek.
Belgeyi ilerletmeBaşarılı doğrulamadan sonra belge normal imza sürecine aktarılır.Belge durumunu ekrandan takip etmek.
İptalDoğrulama aşamasına uygun iptal seçeneği ve bilgilendirme gösterilir.Ekranda izin verilen iptal adımını kullanmak.

Portal doğrulama durum akışı

Belge oluşturulduktan sonra SMS gönderme, kod doğrulama ve imzaya ilerleme adımları aynı Portal süreci içinde yönetilir.

Portal state akışı

Portalda SMS gönderme ve kod doğrulama durumları kullanıcı ekranında hazır yönetilir. Hata kartları yalnızca bağlı oldukları state'in altında gösterilir.

Portal SMS doğrulama state akışı Belge oluşturulmasından SMS gönderimine, kod doğrulamaya ve imzaya ilerleyen Portal akışı ile state bazlı hata grupları. Belge oluşturuldu Portal kayıt adımı WaitingForVerification SMS gönderimi bekleniyor WaitingForSmsCode Üretici kodu bekleniyor Doğrulandı İmzalama akışı devam eder EMM0037 · EMM0038 · EMM0039 EMM0040 · EMM0051 · EMM0053 · EMM0054 SMS gönderimi tamamlanmadı Bekleme veya yeniden deneme adımı Portal ekranında gösterilir. EMM0036 · EMM0038 · EMM0041 EMM0055 · EMM0056 Kod doğrulama tamamlanmadı Durum kontrolü, bekleme veya yeni kod adımı Portal ekranında yönlendirilir. EMM0052 Excel yüklemesi Portal dışından çağrılamaz Excel yüklemesi VBT Portal üzerinden gerçekleştirilir. Hata koşulu giderildiğinde akış, bağlı olduğu state üzerinden devam eder.

Portalda gösterilecek durumlar

DurumKullanıcıya gösterilen anlamPortal davranışı
WaitingForVerificationDoğrulama bekleniyor.SMS gönderme adımı belge ekranında sunulur.
WaitingForSmsCodeSMS onayı bekleniyor.Kod giriş ve doğrulama adımı aynı ekranda yürütülür.
CreditNoteAndXmlCreatedDoğrulama tamamlandı.Belge normal işleme akışına aktarılır.
SignedGİB'e gönderime hazır.Mevcut gönderim ve sorgulama akışı devam eder.

Excel ve iptal davranışı

Portal üzerinden Excel ile oluşturulan makbuzlarda doğrulama her belge için ayrı yürütülür. WaitingForVerification, WaitingForSmsCode ve CreditNoteAndXmlCreated durumları imzalanmamıştır; iptal edilemez. İptal işlemi yalnızca belge Signed durumuna geçtikten sonra kullanılabilir.

Portal Kullanıcısı SSS

Portal için ayrıca entegrasyon geliştirmek gerekir mi?

Hayır. Telefon girişi, SMS gönderimi, kod doğrulama, tekrar ve süre yönetimi VBT Portal içinde hazır sunulur.

SMS kodu otomatik mi gönderilir?

Belge SMS gönderimini bekleyen duruma geldiğinde Portal belge ekranında gönderim adımını sunar. Kullanıcı üreticinin telefonunu kontrol ederek gönderimi başlatır.

Excel ile yüklenen belgeler topluca doğrulanabilir mi?

Hayır. Her e-müstahsil makbuzu ayrı bir üretici doğrulaması taşıdığı için doğrulama belge bazında tamamlanır.

Kodun süresi dolarsa ne olur?

Portal yeni SMS gönderme adımını aynı belge ekranında sunar; kullanıcıların teknik token veya endpoint yönetmesi gerekmez.

Portal UI geliştiricileri için

Portal kullanıcısına hazır sunulan SMS gönderme ve kod doğrulama ekranları, aşağıdaki endpoint sözleşmeleri üzerinden ilerler. Bu endpointler VBT Portal uygulamasının kullanımı içindir; dış entegratörlerin belge oluşturma ve güncelleme sözleşmelerinin yerini almaz.

Aktivasyon ve görünürlük: UI, doğrulama zorunluluğunu ayrı bir istemci ayarıyla yönetmez. WaitingForVerification durumunda SMS gönderme, WaitingForSmsCode durumunda kod doğrulama adımı gösterilir.
Portal endpoint sözleşmeleri
POST/api/CreditNoteApi/SendCreditNoteSmsCode

e-Müstahsil Makbuzu için üreticinin telefonuna 6 haneli sayısal doğrulama kodu gönderir.

Çağrı koşuluBelge ilk gönderim için WaitingForVerification; telefon düzeltme veya yeniden gönderim için WaitingForSmsCode durumundadır.
RequestSendCreditNoteSmsCodeRequestModel — belge kimliği alanlarından en az biri ve PhoneNumber
ResponseSendCreditNoteSmsCodeResponseModel — MaskedPhoneNumber, VerificationToken, ExpiresInSeconds=180; kod response içinde dönmez
UI davranışıMaskeli telefon ve kalan süre gösterilir; token kullanıcıya gösterilmeden kod doğrulama çağrısına taşınır.
POST/api/CreditNoteApi/CompleteCreditNoteSmsVerification

SMS gönderiminden dönen token ile üreticinin ilettiği kodu doğrular.

Çağrı koşuluBelge WaitingForSmsCode durumundadır.
RequestVerifyCreditNoteSmsCodeRequestModel — aynı belge kimliği, VerificationToken ve SMS ile iletilen 4–6 karakterli Code
ResponseResponseModel<bool>
UI davranışıBaşarılı sonuçta belge yeniden okunur ve güncel state gösterilir; hata halinde doğrulanmış görünümü verilmez.
İstemci davranışı: Devam eden çağrı sırasında aynı aksiyon yeniden tetiklenmez. İş kuralı hatasında API'nin kullanıcıya dönük mesajı gösterilir ve belge başarılı yanıt alınmadan bir sonraki state'e geçirilmez. Güncel durum için işlem sonrasında belge yeniden sorgulanır.