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ı.
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.
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ış
- Portal kullanıcısı e-müstahsil makbuzunu mevcut belge ekranından oluşturur.
- Belge ekranı üreticinin telefon numarasına SMS gönderme adımını sunar.
- Üreticinin ilettiği kod aynı ekran üzerinden doğrulanır.
- Başarılı doğrulama sonrasında belge normal imzalama ve gönderim sürecine otomatik olarak devam eder.
Platformun Otomatik İşlemleri
| İşlem | Portalın sağladığı davranış | Kullanıcıdan beklenen |
|---|---|---|
| Telefon girişi | Belge ekranında doğrulama telefonu alanı sunulur. | Üreticinin güncel telefon numarasını girmek. |
| SMS gönderimi | Kod gönderimi ve gönderim sonucu ekranda yönetilir. | SMS gönderimini belge ekranından başlatmak. |
| Kod doğrulama | Kod girişi, süre ve tekrar davranışı hazır sunulur. | Üreticinin ilettiği kodu ekrana girmek. |
| Belgeyi ilerletme | Başarılı doğrulamadan sonra belge normal imza sürecine aktarılır. | Belge durumunu ekrandan takip etmek. |
| İptal | Doğ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.
Portalda gösterilecek durumlar
| Durum | Kullanıcıya gösterilen anlam | Portal davranışı |
|---|---|---|
WaitingForVerification | Doğrulama bekleniyor. | SMS gönderme adımı belge ekranında sunulur. |
WaitingForSmsCode | SMS onayı bekleniyor. | Kod giriş ve doğrulama adımı aynı ekranda yürütülür. |
CreditNoteAndXmlCreated | Doğrulama tamamlandı. | Belge normal işleme akışına aktarılır. |
Signed | Gİ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.
WaitingForVerification durumunda SMS gönderme, WaitingForSmsCode durumunda kod doğrulama adımı gösterilir.Portal endpoint sözleşmeleri
e-Müstahsil Makbuzu için üreticinin telefonuna 6 haneli sayısal doğrulama kodu gönderir.
| Çağrı koşulu | Belge ilk gönderim için WaitingForVerification; telefon düzeltme veya yeniden gönderim için WaitingForSmsCode durumundadır. |
| Request | SendCreditNoteSmsCodeRequestModel — belge kimliği alanlarından en az biri ve PhoneNumber |
| Response | SendCreditNoteSmsCodeResponseModel — 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. |
SMS gönderiminden dönen token ile üreticinin ilettiği kodu doğrular.
| Çağrı koşulu | Belge WaitingForSmsCode durumundadır. |
| Request | VerifyCreditNoteSmsCodeRequestModel — aynı belge kimliği, VerificationToken ve SMS ile iletilen 4–6 karakterli Code |
| Response | ResponseModel<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. |