Sorumluluklar
Platform Sorumlulukları
Platformun otomatik işlemleri, validasyon kuralları, hata yanıtları ve iptal ön koşulları.
Otomatik İşlemler
Platform, entegratörün gönderdiği request'i doğruladıktan sonra UBL XML üretimi, imza kuyruğu, günlük eArşiv raporu ve GİB Portal senkronizasyonu adımlarını yönetir. Entegratör belge içeriğini sağlar; platform teknik yaşam döngüsünü işletir.
| # | İşlem | Açıklama |
|---|---|---|
| 1 | Validasyon | Alıcı uygunluk kontrolü, alan zorunluluğu, senaryo kombinasyon kontrolleri |
| 2 | UBL XML Üretimi | UBL 2.1 Invoice standardında XML, ProfileID=EARSIVFATURA |
| 3 | İmzalama | Belge imzalama akışına alınır ve tamamlandığında yeni durumuyla sorgulanabilir. |
| 4 | e-Arşiv Rapor Üretimi | Geçerli, iptal ve itiraz faturaları dönemsel raporda toplanır. |
| 5 | GİB'e İletim | Hazırlanan rapor GİB e-Arşiv servisine iletilir ve sonucu platform durumuna yansıtılır. |
| 6 | Rapor Gönderim/Yanıt | Rapor GİB'e iletilir; teknik sonuç platformun rapor durumuna yansıtılır. |
| 7 | GİB Portal Senkronizasyonu | GİB Portal'da yapılan iptal ve itiraz işlemleri platform durumuna otomatik olarak yansıtılır. |
| 8 | E-posta | EArchiveMailTo alanına göre bildirim (yapılandırıldıysa) |
Validasyon Kuralları
Validasyonlar, e-Arşiv Fatura request'inin teknik olarak üretilebilir ve GİB raporuna taşınabilir olmasını kontrol eder; ana odak alıcı uygunluğu, senaryo alanları ve tutar bütünlüğüdür.
| Kontrol | Kod | Açıklama |
|---|---|---|
| Alıcı GİB e-Fatura mükellefi olmamalı (EARSIVFATURA için) | INV0221 | Alıcı kayıtlı ve kayıt tarihi fatura tarihinden önceyse e-Arşiv Fatura kesilemez |
| Alıcı GİB e-Fatura mükellefi olmalı (TICARIFATURA için) | INV0220 | Alıcı kayıtlı değilse e-Fatura kesilemez |
| Alıcının mükellefiyet tarihi fatura tarihinden sonra olmamalı (TICARIFATURA için) | INV0229 | Fatura tarihinde alıcı henüz e-Fatura mükellefi değildi |
| İnternet satışı zorunlu alanları | INV0036–INV0043, INV0168, INV0263 | VUK 509 md. IV.2.4.5 kapsamındaki 6 alan ve ibare kontrolü |
ÖKC referansı DocumentTypeCode/DocumentType değeri | "SCHEME" | OKCBF/OKCBilgiFisi literal değerleri dışında bir değer reddedilir; bkz. Teknik Referans — Katman A |
| Tevkifat/toplam uyumu | — | WithholdingTaxTotal ve PayableAmount aynı ekonomik hesabı yansıtmalı |
Hata Yanıtları
Oluşturma ve güncelleme endpointleri işlem sonucunu ResponseModel.Data.HasError altında taşır; entegrasyon başarı kararını HasError=false üzerinden vermelidir, HTTP çağrısının tamamlanmış olması yeterli değildir.
İptal Ön Koşulları
İptal, süre bazlı bir kısıt taşımaz; belge durumu (EArchiveDocumentGIBStatusType) üzerinden değerlendirilir. Platform, faturanın resmileşme tarihinden itibaren geçen gün sayısına göre iptali otomatik olarak engellemez — bu, entegratörün Entegratör Sorumlulukları sayfasındaki 8 günlük yasal yanıt süresi takibiyle kendi tarafında yönetmesi gereken bir sorumluluktur.