Teknik Temel

GİB Referansı

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

📦 Kaynak: GİB tarafından ebelge.gib.gov.tr adresinde yayımlanan resmi e-Gider Pusulası Paketi ve Teknik Kılavuz V1.0 (Mayıs 2026, GİB Uygulama ve Veri Yönetimi Daire Başkanlığı III) baz alınmıştır.

GİB Paketi

GİB tarafından yayımlanan paket; XSD şema dosyaları, XSLT görüntüleme dosyaları ve örnek XML belgelerinden oluşmaktadır. Paket doğrudan şu adresten indirilebilir:

https://ebelge.gib.gov.tr/dosyalar/kilavuzlar/e-Gider_Pusulasi_Paketi.rar

Kullanım Yöntemi

e-Fatura uygulamasına dahil olan mükellefler, e-Gider Pusulası sistemini GİB tarafından yetkilendirilmiş Özel Entegratörler aracılığıyla kullanabilir. VBT Yazılım bu süreçte Özel Entegratör konumundadır.

Teknik Gereksinimler

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

UBL Belge Standardı

e-Gider Pusulası UBL 2.1 CreditNote doküman tipi üzerinden ifade edilir.

Operatör Bilgisi (Madde 3.1.15)

Operatör bilgisi, alıcı doğrulamasının hangi sağlayıcı üzerinden yürütüldüğünü UBL içinde izlenebilir kılar.

Operatör Kavramı

GİB'in "operatör" dediği: müşteri doğrulaması (SMS/iade kodu) hizmetini sağlayan üçüncü parti şirkettir.

SMS_PROVIDER — SMS kodu üreten/gönderen hizmet sağlayıcı
IADE_PROVIDER — İade kodu üreten/doğrulayan hizmet sağlayıcı

Alıcı Doğrulama (Madde 3.1.16)

Hem SATIS hem IADE'de zorunlu:

💡 Vekalet ve doğrulama ayrımı: DelegateReceiver, UBL'de BuyerCustomerParty olarak belge oluşturma anında kaydedilen kimlik ve adı taşır. GİB raporundaki bilgiDetay alanları belgede kaydedilen ayrı VerificationInfo bilgisinden üretilir.

İade Belgesi Referansı (Madde 3.1.12)

İade referansı, iade edilen işlemin hangi belgeye dayandığını UBL seviyesinde ilişkilendirir.

schemeID	Anlamı	ID İçeriği
`EARSIV_FATURA`	e-Arşiv faturasına karşı iade	Fatura no
`SATIS_FISI`	Satış fişine karşı iade	Fiş no
`BELGESIZ`	Karşılığında belge yok	Boş

⛔ BELGESIZ İade: Gerçek TCKN veya PASAPORTNO zorunlu. Sahte kimlik GİB tarafından reddedilir.

ChannelCode — VerificationInfo Uyumu

Doğrulama sağlayıcısı ve doğrulama tipi birlikte değerlendirilir; bu eşleşme hatalı kanal kombinasyonlarını önler.

API VerificationMethod	Backend'in ürettiği GİB değerleri	Belge Tipi
`SMS`	`SMS` + `SMS_PROVIDER`	SATIS veya yüz yüze IADE
`IADEKODU`	`IADEKODU` + `IADE_PROVIDER`	Yüz yüze veya kargolu IADE

Alıcı Kimlik Tipleri

Kimlik tipi, alıcı veya vekil bilgisinin hem UBL tarafında hem de GİB raporunda doğru sınıflandırılmasını sağlar.

SchemeId	Açıklama	Rapor
`TCKN`	TC Kimlik No (11 hane)	`gercekKisi/tckn`
`PASAPORTNO`	Yabancı uyruklu	`yabanci/pasaportNo`

⛔ VKN kullanılamaz — Gider pusulası alıcısı veya vekili tüzel kişi olamaz.

Telefon Format

GİB XSD: 0[1-9][0-9]{9} — 11 karakter, 0 ile başlar. ✅ 05551234567 ❌ 5551234567

GİB Rapor Alanları

GİB rapor alanları, imzalanmış belgenin dönemsel bildirime hangi bilgilerle dahil edileceğini belirler.

Alan		Açıklama
`giderPusulasiBelgeNo`	Z	Belge no
`UUID`	Z	ETTN
`belgeTip`	Z	SATIS/IADE
`gonderimSekli`	Z	Sabit: ELEKTRONIK
`ozetDeger`	Z	İmza hash
`duzenlenmeTarihi` + `Zamani`	Z	Tarih/saat
`paraBirimi`	Z	ISO 4217
`toplamTutar` / `odenecekTutar`	Z	Tutarlar
`vergiBilgisi`	Z	matrah + vergiKodu + vergiTutari + vergiOrani
`aliciBilgileri`	Z	kisi + bilgiDetay (kod, tip, telefon)
`operatorUygulamaBilgi`	Z	yontem + saglayiciAdi + vkn
`url` / `imzaZamani`	Z	—
`iadeDetay`	Ş	IADE'de zorunlu
`kargoBilgi`	Ş	Kargo iadede

İptal Raporu

İptal raporu, daha önce düzenlenmiş belgenin iptal bilgisinin GİB'e hangi alanlarla taşınacağını netleştirir.

Resmi Kaynaklar

Resmi kaynaklar, teknik yorumun dayandığı GİB paketini, kılavuzları ve mevzuat bağlantılarını birlikte takip etmeyi sağlar.

Kaynak	URL
GİB Duyurular Sayfası	ebelge.gib.gov.tr/duyurular.html
e-Gider Pusulası Paketi (.rar)	e-Gider_Pusulasi_Paketi.rar
Teknik Kılavuz V1.0 (PDF)	ebelge.gib.gov.tr → Kılavuzlar
UBL-TR 1.2.1 Paketi	UBL-TR1.2.1_Paketi.zip
VUK 509 Sıra No.lu Genel Tebliğ	Resmi Gazete