Platform Sorumlulukları

Portal UI Geliştiricisi — Uçtan Uca Belge Akışı

1. Alıcı ve varsa vekil PersonParty endpointleriyle aranır. Kayıt bulunursa response içindeki cari Id ile Update, bulunamazsa Add çağrılır.
2. Kullanıcının seçtiği tek TCKN veya PASAPORTNO belge request'ine yazılır. Alıcı cari Id'si AccountingCustomerParty.Party.Id, vekil cari Id'si DelegateReceiver.PartyId alanında taşınır.
3. Belge, AddOutgoingExpenseVoucher veya UpdateOutgoingExpenseVoucher ile kaydedilir. Portal yalnız SMS senaryosunda iki doğrulama modelini tamamen boş bırakabilir; İADEKODU seçildiyse VerificationProvider ve VerificationInfo aynı requestte eksiksiz gönderilir.
4. Boş SMS verisiyle kabul edilen unsigned belgede WaitingForVerification döner ve SMS ekranı açılır. Geçerli İADEKODU verisi bekleme state'ine girmeden belgeyi imza kuyruğuna taşır.
5. SMS için Send ve Complete çağrılır. İADEKODU için ayrı Submit endpointi yoktur. Başarılı yanıttan sonra belge detayı yeniden sorgulanır.
6. ExpenseVoucherAndXmlCreated veya Signed durumunda doğrulama ekranı kapatılır; hata kodu varsa kullanıcıya düzeltilebilir alan gösterilir.

Otomatik İşlemler

Request kabul edildiğinde platform; cari yönetimi, içerik kontrolü, doğrulama, belge üretimi, imza, saklama, GİB bildirimi ve kullanıcı çıktısını bu sırayla yönetir. Aşağıdaki bölümler bu tablonun sırasını izler.

Gerçek Kişi Cari Seçimi

Alıcı ve yalnız IADE senaryosunda kullanılabilen vekil, aynı gerçek kişi cari kaynağından aranır. Cari bulunursa arama response'undaki Id korunur; yalnız bulunamazsa yeni cari oluşturulur. Birden fazla kimliği varsa belgede kullanılacak TCKN veya PASAPORTNO açıkça seçilir.

Belgeye aktarılan kişi bilgileri oluşturma veya güncelleme anında kaydedilir. Cari kartında daha sonra yapılan değişiklikler mevcut belgeyi değiştirmez. Endpoint sözleşmeleri için API Endpoint Referansı kullanılmalıdır.

Validasyon Kuralları

Validasyon katmanı, belge üretimine geçmeden önce senaryo, doğrulama, kimlik ve kargo bilgilerinin tutarlı bir bütün oluşturmasını bekler.

Hata Yanıtı

Hata yanıtı, entegrasyon tarafının problemi kod üzerinden ayırt edebilmesi için aynı response iskeletini korur.

{
            "IsSuccess": false,
            "Message": "Açıklama",
            "MessageCode": "EGP0055",
            "Data": null
            }

Portal Doğrulama Akışı

Portal, SMS senaryosunda gönderim ve kod doğrulama adımlarını hazır sunar. İADEKODU seçildiğinde kod, telefon ve sağlayıcı alanları belge Add/Update isteğinin parçasıdır.

Portal Durumları

Doğrulama ve İmza Durum Makinesi

OutgoingExpenseVoucherStatusForUser, entegratörün izlediği ortak durum kümesidir. Add/Update isteğinde tam SMS doğrulama verisi gönderilirse belge bekleme durumlarına girmeden ExpenseVoucherAndXmlCreated durumuna ilerler. Doğrulama verisi boş başlayan Portal SMS akışında belge önce WaitingForVerification, kod gönderildikten sonra WaitingForSmsCode durumunda izlenir; kod başarıyla tamamlandığında aynı ExpenseVoucherAndXmlCreated durumunda birleşir. İADEKODU ise Add/Update isteğinde eksiksiz gönderilir; ayrı bir bekleme durumu veya Complete çağrısı yoktur.

Doğrulama Yöntemi Senaryo Matrisi

SMS ve İADEKODU validasyonları birbirinden ayrıdır. SMS'in boş başlayabilmesi yalnız unsigned Portal akışına aittir. İADEKODU feature flag'den bağımsız olarak tam model ister; signed UBL ise sonradan SMS tamamlayamayacağı için boş doğrulama verisiyle kabul edilmez.

Excel ve İptal Davranışı

Excel ile oluşturulan belgelerde doğrulama her belge için ayrı tamamlanır; tek kodla toplu doğrulama yapılmaz. WaitingForVerification ve WaitingForSmsCode durumundaki belgeler iptal edilebilir. Portal iptal işlemini başlattığında belge iptal edilir. SMS gönderilmişse kayıtlı telefona bildirim gönderilmeye çalışılır; bildirim hatası iptal işlemini geri almaz.

İptal Ön Koşulları

İptal edilebilirlik belgenin kullanıcı durumu ve platformda kayıtlı e-Arşiv durumu üzerinden değerlendirilir.

• WaitingForVerification durumundaki belge, Portal iptal işlemini başlattığında bildirim gönderilmeden iptal edilir.
• WaitingForSmsCode durumundaki belge iptal edilir; kayıtlı telefona iptal bildirimi gönderilmeye çalışılır.
• İmzalama aşamasında olup henüz imzalanmamış belge iptal edilemez.
• İmzalanmış ve raporlanmamış belge doğrudan; raporlanmış belge ise iptal raporuyla iptal edilir.
• Kayıtlı e-Arşiv durumu Valid olmayan belge için iptal işlemi başlatılmaz.