İş Akışı
Entegratör Sorumlulukları
Kaynak veri, açılış/kapanış tarihi, tekilleştirme, hata yönetimi ve arşivleme sorumlulukları.
Entegratör; doğru açılış/kapanış tarihini ve kaynak envanter içeriğini seçmekten, aktarımı tekilleştirmekten, onay öncesi mutabakattan, durum takibinden ve teknik dosyaları kurum arşivine almaktan sorumludur.
Uçtan Uca Sorumluluk Matrisi
| Aşama | Entegratör | VBT platformu | Başarı kanıtı |
|---|---|---|---|
| Hazırlık | Doğru firma, şube, yıl ve 1 Ocak/31 Aralık türünü 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ı açılış/kapanış özetiyle ilişkilendirir. | Parça/kayıt/satır sayıları tutarlı; teşhis yok. |
| Üretim | İki hazırlık bilgisi olumlu olmadan üretim çağırmaz. | Envanter ve berat XML'lerini teknik kurallara göre üretir. | Durum WaitingForApprove. |
| Onay | Önizleme, hesap, tutar ve ölçü alanlarını mutabık kılar. | 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ı beratı erişime açar. | SentToGib ve indirilebilir onaylı berat. |
| Arşiv | İmzalı envanter ve onaylı beratı kurum politikasıyla korur. | Yetkili çıktı endpointlerini sağlar. | Firma-şube-tarih-Uuid ilişkisi kurulmuş arşiv. |
Kaynak Envanter Verisi
- Envanter başlık ve satır sıralarını koruyun.
- Hesap kodu, açıklama, tutar ve para birimini kaynak sistemle eşleştirin.
- Ölçülebilir kıymetlerde tanımlayıcı, açıklama, miktar ve ölçü birimini birlikte gönderin.
- Açılış için 1 Ocak, kapanış için 31 Aralık dışında dönem üretmeyin.
Üretim ve Onay Mutabakatı
| Kontrol | Beklenen sonuç |
|---|---|
| Firma/şube | Kaynak envanter sahibiyle aynı. |
| Dönem türü | Açılış veya kapanış; ara ay yok. |
| Parça bütünlüğü | Parça sayısı ve ilk/son kayıt numaraları tutarlı. |
| Ölçülebilir kıymet | IsMeasurable=true ise kimlik, açıklama, miktar ve birim eksiksiz. |
| Önizleme | Envanter ve berat firma/dönem bilgileri aynı. |
Tekilleştirme ve Güvenli Tekrar
Firma, şube, yıl ve açılış/kapanış tarihini yerel sistemde tekilleştirin. Dönen Uuid'yi saklayın. Timeout sonrasında güncel özet sorgulanmadan yeniden aktarım veya üretim başlatmayın.
| Yerel kayıt | Saklanacak değer | Neden? |
|---|---|---|
| Dönem anahtarı | VKN/TCKN, şube, 1 Ocak veya 31 Aralık | Mükerrer açılış/kapanış üretimini ö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 kayıt ve satır | Eksik veya çift aktarımı ayırt eder. |
| GİB | Paket adı, durum kodu/açıklaması | Gönderim ve onaylı dosya sonucunu eşleştirir. |
| Arşiv | İmzalı envanter ve GİB onaylı berat dosya adları | İbraz sırasında teknik bütünlüğü kanıtlar. |
Arşivleme
İmzalı envanter XML'i, mükellef beratı ve GİB onaylı berat aynı kayıt altında saklanmalıdır. PDF ve HTML yalnız görüntüleme çıktılarıdır.
Operasyon ve Destek Kaydı
Her çağrıda endpoint, zaman, süre, firma, şube, açılış/kapanış tarihi, Uuid, HTTP durumu, StatusCode ve hata mesajı izlenebilir olmalıdır. Parola, token, imza anahtarı ve tam envanter içeriği kaydedilmemelidir.