Teknik Temel

GİB Referansı

GİB paketi, kullanım yöntemi, teknik gereksinimler ve resmi kaynaklar.

GİB Paketi

e-Adisyon, GİB e-Arşiv kategorisinde (ProfileId = EARSIVBELGE) UBL CreditNote şemasına eşlenir; belge tipi kodu her zaman ADISYON'dur.

Kullanım Yöntemi

Konu	Değer
UBL versiyonu	`UBLVersionId = "2.1"`
Customization	`CustomizationId = "TR1.2.1"`
Belge no uzunluğu	16 karakter (VBT üretir)
Oluşturma yöntemleri	JSON model (`AddOutgoingBill`) veya hazır UBL XML (`AddOutgoingBillByUbl`)

Teknik Gereksinimler

Teknik gereksinimler, UBL üretimi ile GİB raporlamasının aynı veri setinden tutarlı şekilde beslenmesini sağlar.

Gereksinim	Açıklama
Düzenleyen taraf	`AccountingSupplierParty` VBT tarafından firma profilinden otomatik doldurulur; entegratör göndermez.
Alıcı kimliği	`AccountingCustomerParty.Party.PartyIdentifications` içinde `VKN` (10 hane) veya `TCKN` (11 hane).
Belge no sırası	`DocumentNumber` gönderilirse sıra/format kontrolünden geçer; boş bırakılırsa VBT üretir.

UBL Belge Standardı

e-Adisyon UBL 2.1 CreditNote doküman tipi üzerinden ifade edilir; üretilen XML'de aşağıdaki sabit sürüm ve belge kimliği bilgileri kullanılır:

Alan	Değer
`UBLVersionID`	`2.1`
`CustomizationID`	`TR1.2.1`
`ProfileID`	`EARSIVBELGE`
`CreditNoteTypeCode`	`ADISYON`

Kısa kural: e-Adisyon teknik olarak CreditNote tipidir; belgeyi Adisyon yapan ayırt edici alan CreditNoteTypeCode=ADISYON değeridir.

Taraf Kimlik Tipleri

UBL-TR'nin PartyIdentification şema kodları bu belgede şu şekilde kullanılır:

Taraf	SchemeId	Açıklama
Alıcı — tüzel kişi (`AccountingCustomerParty`)	`VKN`	Tüzel kişi vergi kimlik numarası (10 hane)
Alıcı — gerçek kişi (`AccountingCustomerParty`)	`TCKN`	Gerçek kişi kimlik numarası (11 hane)

Belge Toplamları

Belge toplamları, kalem tutarları ve vergi alt toplamlarının tek net ödenecek tutara bağlandığı noktadır.

GİB Rapor Alanları

Belge imzalandıktan sonra dönemsel GİB e-Arşiv raporuna dahil edilir. Raporun hazırlanması, iletilmesi ve sonucunun platforma yansıtılması VBT tarafından yönetilir. Rapor alanlarının kesin XML şeması GİB'in resmi e-Arşiv teknik kılavuzunda tanımlıdır (bkz. Resmi Kaynaklar).

İptal Raporu

İptal edilen bir belge, ayrı bir GİB iptal raporu döngüsüyle (EArchiveCancelReportStatus) bildirilir; bu döngü normal rapor döngüsünden bağımsız izlenir.

Resmi Kaynaklar

Manuel doğrulama gerekir: Aşağıdaki bağlantı GİB'in resmi e-Arşiv teknik kılavuzlarına işaret eder; bu rehberin hazırlanması sırasında internet erişimiyle doğrulanmamıştır. Yayın öncesi elle açılıp güncelliği teyit edilmelidir.

GİB e-Arşiv Uygulama Genel Tebliği ve teknik kılavuzları — ebelge.gib.gov.tr