Senaryolar

İptal ve İtiraz Durum Takibi

GİB Portal ile senkronize iptal/itiraz durum modeli, yasal süreler ve entegratör sorumlulukları.

Durum Modeli

İptal ve itiraz aynı EArchiveDocumentGIBStatusType durum sözleşmesi üzerinden takip edilir. Tanımlı olmayan sayısal değerler gönderilmemeli; yalnızca tabloda yayımlanan değerler kullanılmalıdır.

Değer	Durum	Anlamı
`1`	`CancellingObjectingRequested`	İptal / İtiraz Talebinde Bulunuldu
`3`	`WaitingResponseFromReceiver`	Alıcıdan Yanıt Bekleniyor
`5`	`Successful`	İptal / İtiraz Başarılı

İki Başlangıç Kanalı

İptal veya itiraz talebi iki farklı kanaldan başlayabilir; ikisi de aynı durum modelinde buluşur.

Yasal Süreler

Süreç	Süre	Dayanak
Faturaya yasal itiraz/yanıt süresi	8 gün	6102 sayılı Türk Ticaret Kanunu madde 21 kapsamındaki fatura kabul karinesine dayanan genel bir hukuki süredir; tüm faturalar için geçerlidir.
İtiraz yöntemi	—	TTK madde 18/3: `KEP`, `NOTER`, `TELGRAF` veya `TAAHHUTLU_MEKTUP` kanallarından biriyle yapılmalıdır (`DocumentObjectionType` enum).
İptal	Süre sınırı yok — durum bazlı	Belge durumu `EArchiveDocumentGIBStatusType` üzerinden değerlendirilir; sabit bir gün sayısı ile kısıtlanmaz.

Yasal süre API kontrolünün yerine geçmez: e-Arşiv iptal ve itiraz işlemlerinin kabul edilmesi, yasal sürenin platform tarafından doğrulandığı anlamına gelmez. Entegratör yasal süreyi kendi iş akışında izlemeli ve API sonucunu yalnızca teknik işlem sonucu olarak değerlendirmelidir.

İtirazın niteliği: İtiraz, platformun interaktif olarak yürüttüğü bir işlem değildir — TTK'ya göre noter/taahhütlü mektup/telgraf/KEP yoluyla alıcı tarafından yapılan bir hukuki bildirimdir. Platformun (ve ObjectOutgoingEArchiveInvoice endpointinin) rolü, bu bildirimin ne zaman ve hangi yöntemle yapıldığını GİB'e raporlamak üzere kayıt altına almaktır.

İptal Akışı

Entegratör CancelOutgoingEArchiveInvoice veya ByXml varyantını çağırır; durum CancellingObjectingRequested'a geçer. GİB Portal üzerinde yapılan işlem platform durumuna yansıtıldıktan sonra Portal'daki CompleteOutgoingEArchiveInvoiceCancellationProcess işlemiyle süreç Successful durumuna taşınır.

İtiraz Akışı

Alıcı, hukuki itirazını TTK madde 18/3'teki kanallardan biriyle (KEP, noter, taahhütlü mektup, telgraf) yaptıktan sonra, bu bildirim ObjectOutgoingEArchiveInvoice ile (DocumentObjectionRequestModel — itiraz yöntemi, belge no/tarih, açıklama alanlarıyla) kayda geçirilir. Portal tarafında aynı akış CompleteOutgoingEArchiveInvoiceObjectionProcess ile tamamlanır.

Portal İşlemlerinin Duruma Yansıması

GİB Portal üzerinde doğrudan yapılan iptal ve itiraz işlemleri platformun durum modeline otomatik olarak yansıtılır. Portal işlemi ile API'den okunan durum arasında kısa süreli gecikme olabileceği için entegratör nihai sonucu durum sorgusuyla doğrulamalıdır.

Entegratör Sorumlulukları

Sorumluluk	Neden
Yasal yanıt süresini kendi iş akışında izlemek	API çağrısı yasal süre takibinin yerine geçmez.
İtiraz bildirimini yalnızca gerçekten yapıldıktan sonra kayda geçirmek	`ObjectOutgoingEArchiveInvoice` işlemi itirazı başlatmaz; daha önce yapılan itirazın bilgisini platforma kaydeder.
Durumu `EArchiveDocumentGIBStatusType` üzerinden sorgulamak	GİB Portal'da yapılan işlem API'den okunan duruma gecikmeli yansıyabilir.

Edge-Case Tablosu

Durum	Sonuç	Entegratör davranışı
GİB Portal'da iptal edilmiş ama entegratör hâlâ eski durumu okuyor	Portal işlemi henüz API durumuna yansımamış olabilir.	Belge kimliğiyle durum sorgusu kontrollü aralıklarla tekrarlanmalıdır.
İtiraz yöntemi alanı boş gönderilmiş	Reddedilir.	`DocumentObjectionType` değerlerinden biri (KEP/NOTER/TELGRAF/TAAHHUTLU_MEKTUP) gönderilmelidir.
Aynı belge için mükerrer iptal/itiraz denemesi	Durum zaten `CancellingObjectingRequested` veya `Successful` ise reddedilir.	Güncel durum sorgulanmadan tekrar deneme yapılmamalıdır.