Gelecek Değişiklikler

Portal Kullanıcıları İçin

VBT Portalda hazır sunulacak SMS gönderme, kod doğrulama ve belgeyi ilerletme davranışları.

Henüz aktif değildir. Portal ekranları VBT aktivasyon duyurusuna kadar mevcut davranışı korur. Ortak yürürlük bilgisi için SMS Doğrulamalı Gönderim sayfasını inceleyin.

VBT Portal, doğrulama zorunluluğu aktive edildiğinde SMS gönderme ve kod doğrulama adımlarını e-müstahsil makbuzu ekranında hazır olarak sunacaktır. Portal kullanan firmaların yeni endpoint veya request modeli geliştirmesi gerekmez.

Yöntem seçimi gerekmez: MM için planlanan yöntem SMS'tir. Portal bu değeri ve GİB'in beklediği UBL yöntem bilgilerini kullanıcıdan ek alan istemeden belgeye uygular.

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.

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

İş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. İptal davranışı belgenin doğrulama aşamasına göre Portal tarafından yönlendirilir; kullanıcıya izin verilen işlem ve gerekli bilgilendirme aynı ekran üzerinde gösterilir.

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 doğrulama kodu gönderir.

Çağrı koşulu	Belge `WaitingForVerification` durumundadır.
Request	`SendCreditNoteSmsCodeRequestModel` — belge kimliği alanlarından en az biri ve `PhoneNumber`
Response	`SendCreditNoteSmsCodeResponseModel` — `MaskedPhoneNumber`, `VerificationToken`, `ExpiresInSeconds`
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şulu	Belge `WaitingForSmsCode` durumundadır.
Request	`VerifyCreditNoteSmsCodeRequestModel` — aynı belge kimliği, `VerificationToken` ve `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.

İ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.