Başlangıç

e-Adisyon Nedir?

e-Adisyon'un kapsamı, tarafları, teslim şekli ve belge yaşam döngüsü.

Temel Kavram

e-Adisyon, restoran, kafe ve benzeri işletmelerin düzenlediği adisyon/hesap fişinin GİB e-Arşiv standardında elektronik formudur. Belge; sipariş kalemleri, KDV ve varsa tevkifat bilgileriyle birlikte oluşturulur, e-imza ile kesinleştirilir ve GİB'e günlük rapor olarak bildirilir.

GİB kategorisinde e-Arşiv Belgesi (EARSIVBELGE) olarak sınıflandırılır; UBL-TR standardında, teknik olarak UBL CreditNote belge tipiyle üretilir ve GİB'e raporlanır.

💡 Örnek: Bir restoran, müşterinin masasındaki siparişi kapatırken adisyonu e-Adisyon olarak düzenler; alıcı gerçek kişi (TCKN) veya tüzel kişi (VKN) olabilir.

Belge Tipi

Belge tipi, adisyonun GİB ve UBL tarafındaki kimliğini belirler.

Tip	İş Anlamı
`ADISYON`	Restoran/adisyon belgesi için kullanılan tek belge tipi

İki Ayrı XML

Belge XML'i ve rapor XML'i aynı sürecin farklı çıktılarıdır; biri belgeyi temsil eder, diğeri dönemsel bildirimi taşır.

XML	Amaç	Standart	Üretim
UBL XML	Her belge için — imzalanır, saklanır	UBL 2.1 CreditNote	Anlık
GİB Rapor XML	Dönemdeki tüm belgelerin toplu GİB bildirimi	e-Arşiv XSD	Periyodik

Teknik Kimlik

Aşağıdaki iki alan GİB standardı gereği sabit değerler taşır:

Alan	Sabit Değer
`ProfileId`	`EARSIVBELGE`
`BillTypeCode` (UBL karşılığı `CreditNoteTypeCode`)	`ADISYON`

Belge Yaşam Döngüsü

e-Adisyon, diğer e-Arşiv modülleriyle (e-Gider Pusulası, e-Müstahsil Makbuzu) aynı 4 fazlı akışı izler: oluşturma → imza kuyruğu → günlük GİB raporu → GİB sonucu.

💡 Not: Doğrudan entegrasyonlarda SMS veya iade kodu gibi bir doğrulama adımı yoktur; belge tek istekte imza kuyruğuna alınır.

İptal Akışı

İptal, yalnızca belge imzalanmış (Signed) durumdaysa kabul edilir.

İptal e-postası: İptal işlemi herhangi bir bildirim e-postası göndermez; yalnızca durum alanlarını günceller ve GİB iptal raporu döngüsüne dahil eder.

Oluşturma Yöntemi

Bir adisyon, tam alan listesini içeren bir JSON gövdesiyle AddOutgoingBill endpointine gönderilerek oluşturulur; entegratör kendi ürettiği UBL XML'i göndermek isterse AddOutgoingBillByUbl kullanılabilir. Bu rehberin geri kalanı JSON akışına odaklanır; diğer oluşturma yolları için Entegratör API Endpoint Referansı sayfasına bakabilirsiniz.