Sorumluluklar
Platform Sorumlulukları
Platformun otomatik işlemleri, validasyon, PDF/önizleme ve GİB raporlama sorumlulukları.
Otomatik İşlemler
| # | İşlem | Açıklama |
|---|---|---|
| 1 | Düzenleyen taraf doldurma | AccountingSupplierParty firma profilinden otomatik doldurulur. |
| 2 | Belge numarası üretimi | DocumentNumber gönderilmezse 16 karakterli numara VBT tarafından üretilir. |
| 3 | UBL XML ve imza kuyruğu | Kayıt sonrası UBL CreditNote XML üretilir ve imza kuyruğuna eklenir. |
| 4 | İmzalama | Belge imzalama akışına alınır; tamamlandığında BillAndXmlCreated durumundan Signed durumuna geçer. |
| 5 | GİB raporlama | İmzalı belgeler dönemsel rapora alınır; raporun iletimi ve sonucu VBT tarafından yönetilir. |
Validasyon ve Hata Davranışı
| Kontrol grubu | Kod | Örnek hata |
|---|---|---|
| Model/profil | BLL0001, BLL0005, BLL0006 | İstek modeli boş, ProfileId/BillTypeCode hatalı |
| Dış referans | BLL0020, BLL0028 | ExternalId zorunlu / zaten kullanılmış |
| Kimlik | COM0017, BLL0035 | UUId geçersiz GUID / zaten mevcut |
| Belge no | BLL0009 | Belge no sıra/format kontrolü başarısız |
Önizleme, PDF ve Belge Paketi
PreviewOutgoingBill, kayıt oluşturmadan taslak bir UBL XML ve PDF üretir (dummy UUId/DocumentNumber ile); gerçek belge numarası veya kalıcı kayıt anlamına gelmez. Kayıt sonrası imzalı PDF, GetOutgoingBillPdf ile tekil/çoklu alınabilir; belge paketi GetOutgoingBillDocumentPackage ile döner.
Listeleme, Arama ve Durum İzleme
Portal grid'i (GetBillGridList) ve global arama (GetGlobalSearchBillList) ETTN, taraf VKN/TCKN/adı, belge no, dış referans, tarih, belge/rapor/mail/iptal/okundu durumlarına göre filtrelenebilir.
E-posta ve Yeniden Gönderim
Raporlanmış belgeler için e-posta bildirimi gönderilebilir (AddMailOutgoingBillPage/AddMailGlobalOutgoingBill); gönderim kuyruğu ResetOutgoingBillMailQueue ile sıfırlanabilir.
GİB Raporlama Sorumluluğu
Raporun oluşturulması, imzalanması, GİB'e gönderilmesi ve sonucunun takibi VBT sorumluluğundadır; entegratör yalnızca tekil belge endpointlerini kullanır.
İptal Davranışı
İptal yalnızca belge Signed durumdayken kabul edilir (BLL0024 aksi halde); zaten iptal edilmiş bir belge tekrar iptal edilemez (BLL0025). İptal işlemi bildirim e-postası göndermez — bu, e-Gider Pusulası/e-Müstahsil Makbuzu'ndan farklıdır.