İş Akışı
Entegratör Sorumlulukları
Kaynak veri, dönem, tekilleştirme, durum takibi, hata yönetimi ve arşivleme sorumlulukları.
Entegratörün görevi yalnız API'ye veri göndermek değildir. Kaynak muhasebe doğruluğu, dönem tekilleştirmesi, onay öncesi mutabakat, durum takibi ve yasal dosyaların kurum arşivine alınması entegrasyonun ayrılmaz parçalarıdır.
Uçtan Uca Sorumluluk Matrisi
| Aşama | Entegratör | VBT platformu | Başarı kanıtı |
|---|---|---|---|
| Hazırlık | Doğru firma, şube, ay ve kaynak muhasebe verisini seçer. | Oturum ve firma bağlamını doğrular. | Login bağlamı ile işlem kimliği aynı firmayı gösterir. |
| Aktarım | VBT Client çıktısındaki tüm parçaları eksiksiz aktarır. | Parçaları aynı dönem özetiyle ilişkilendirir ve raporlar. | Parça/fiş/satır sayıları ve toplamlar tutarlı. |
| Üretim | Süreç raporu hazır olmadan üretim çağırmaz. | Yevmiye, kebir ve beratları teknik kurallara göre üretir. | Durum WaitingForApprove. |
| Onay | Önizleme ve mali mutabakatı yapar; güncel özeti onaylar. | Onayı kabul eder ve imza aşamasını başlatır. | Durum WaitingForSign. |
| GİB | Gönderimi uygun durumda bir kez başlatır; sonucu izler. | Paket sonucu ve GİB onaylı dosyayı erişime açar. | Olumlu sonuç ve indirilebilir GİB beratları. |
| Arşiv | İmzalı defterleri ve onaylı beratları kendi saklama politikasıyla korur. | Yetkili çıktı endpointlerini sağlar. | Firma-şube-dönem-Uuid ilişkisi kurulmuş arşiv. |
Kaynak Veri ve Dönem
- Fiş ve satır sıralarını, hesap kodlarını, belge tarih/numaralarını ve para birimlerini eksiksiz üretin.
- Borç ve alacak toplamlarını kaynak muhasebe sistemiyle mutabık tutun.
PeriodStartvePeriodEnddeğerlerini aynı takvim ayına göre gönderin.- Firma ve şube kimliğini her çağrıda aynı sözleşmeyle koruyun.
Tekilleştirme ve Durum Takibi
Firma, şube ve dönem anahtarını yerel sistemde tekilleştirin. Dönen Uuid'yi aynı kayda bağlayın. Ağ hatasında yeni bir dönem kaydı açmadan önce GetCurrentLedgerSumary veya GetEntity ile sonucu doğrulayın.
| Yerel kayıt | Saklanacak değer | Neden? |
|---|---|---|
| Dönem anahtarı | VKN/TCKN, şube, başlangıç/bitiş tarihi | Mükerrer ay oluşturmayı önler. |
| Platform kaydı | Uuid ve CurrentStatus | Tek kayıt üzerinden güvenli sorgu ve tekrar sağlar. |
| Aktarım | Parça adları, sayısı, ilk/son fiş ve satır | Eksik veya çift parça aktarımını ayırt eder. |
| GİB | Paket adı, durum kodu/açıklaması | Gönderim ve onaylı dosya sonucunu eşleştirir. |
| Arşiv | İmzalı dosya adları ve GİB onaylı berat adları | İbraz sırasında teknik bütünlüğü kanıtlar. |
Onay Öncesi Kontrol
| Kontrol | Beklenen kanıt |
|---|---|
| Aktarım bütünlüğü | Parça sayısı, ilk/son fiş ve satır numaraları tutarlı. |
| Mali denge | Toplam borç ve alacak eşit; kaynak sistemle mutabık. |
| Dönem | Tüm kayıt tarihleri seçilen ay içinde. |
| Önizleme | Yevmiye, kebir ve berat kimlikleri doğru. |
Arşivleme
İmzalı yevmiye/kebir dosyalarını, mükellef beratlarını ve GİB onaylı beratları aynı Uuid, firma ve dönemle ilişkilendirerek saklayın. PDF yalnızca görüntüleme çıktısıdır; XML/XBRL ve imza kanıtlarının yerini almaz.
Operasyon ve Destek Kaydı
Her çağrıda endpoint, zaman, süre, firma, şube, dönem, Uuid, HTTP durumu, StatusCode ve hata mesajı izlenebilir olmalıdır. Parola, token, imza anahtarı ve tam muhasebe içeriği kaydedilmemelidir. Destek talebinde aynı işlemi yeniden üretmek yerine mevcut kimlikler ve maskelenmiş hata cevabı paylaşılmalıdır.