e-Fatura servisi, e-fatura mükellefinin fatura gönderimini ve gelen faturaları kendi sistemine çekmesini sağlayan web servis uygulamasıdır.
Servis adresi
| Servis | Endpoint |
|---|---|
| E-Fatura WS | https://efaturatest.izibiz.com.tr/EInvoiceWS?wsdl |
Kimlik doğrulama için ortak AuthenticationWS servisi kullanılır; REQUEST_HEADER alanları Kimlik Doğrulama bölümünde açıklanmıştır.
Genel kurallar
- Faturalar UBL-TR formatında hazırlanmalıdır. Her faturanın içinde, faturanın görüntülenmesini sağlayan XSLT dokümanı bulunmalıdır.
- Alıcının birden fazla posta kutusu (PK) varsa gönderim öncesi kullanıcıya seçtirilmelidir. Tek PK varsa seçim yapılmadan gönderilebilir.
- GetInvoice ile tek seferde en fazla 100 fatura çekilir.
- Ticari faturaya 8 gün içinde kabul/red yanıtı gönderilebilir; elektronik ortamda en fazla 1 yanıt gönderilir.
- Temel faturalar için yanıt gönderimi kısıtlanmalıdır.
Test hesabı
| Gönderici VKN | Gönderici Etiket | Alıcı VKN | Alıcı Etiket |
|---|---|---|---|
| 4840847211 | urn:mail:defaultgb@izibiz.com.tr |
4840847211 | urn:mail:defaultpk@izibiz.com.tr |
Portal
Belgelerin durumunu kontrol etmek ve içerik doğrulaması yapmak için: https://portaltest.izibiz.com.tr — erişim bilgileri: entegrasyon@izibiz.com.tr
Durum Kodları
Giden Fatura Durumları (STATUS)
| Durum Kodu | Durum Açıklaması | STATUS_SUBSTATUS | Alınacak Aksiyon |
|---|---|---|---|
| 100 | DURUM HENÜZ GÜNCELLENMEDİ | LOAD_SUCCEED | Durum sorgulaması yapmaya devam edilecek |
| 101 | KUYRUĞA EKLENDİ | LOAD_SUCCEED | Fatura yükleme başarılı |
| 102 | TASLAK İŞLENİYOR | LOAD_PROCESSING | Belge işleniyor |
| 103 | PAKETLENİYOR | PACKAGE_PROCESSING | Belge GİB'e göndermek için zarflanıyor |
| 104 | PAKETLENDİ | PACKAGE_SUCCEED | Belge zarflandı, GİB'e gönderilecek |
| 105 | PAKETLEME HATASI | PACKAGE_FAILED | Belge zarflanırken hata oluştu, tekrar denenecektir |
| 106 | İMZALANIYOR | SIGN_PROCESSING | Belge imzalanıyor |
| 107 | İMZALANDI | SIGN_SUCCEED | Belge imzalandı |
| 109 | GİB'DEN YANIT BEKLİYOR | SEND_WAIT_GIB_RESPONSE | Belge GİB'e gönderildi |
| 110 | ALICIDAN YANIT BEKLİYOR | SEND_WAIT_SYSTEM_RESPONSE | Belge alıcıya ulaştırıldı, sistem yanıtı bekleniyor |
| 111 | ALICIDAN ONAY BEKLİYOR | SEND_WAIT_APPLICATION_RESPONSE | Ticari belge alıcıdan onay bekliyor |
| 112 | KABUL EDİLDİ | ACCEPTED_SUCCEED | Belge kabul edildi |
| 117 | RET EDİLDİ | REJECTED_WAIT_SYSTEM_RESPONSE | Red alıcıdan yanıt bekliyor |
| 120 | RET EDİLDİ | REJECTED_SUCCEED | Belge ret edildi |
| 134 | ZAMAN AŞIMI OLUŞTU | SEND_TIMEOUT | Belge GİB'e gönderilirken zaman aşımına uğradı |
| 135 | GÖNDERİLİYOR | SEND_PROCESSING | Belge GİB'e gönderiliyor |
| 136 | GÖNDERME İŞLEMİ BAŞARISIZ | SEND_FAILED | Belge GİB'e gönderilirken hata oluştu |
| 137 | GÖNDERİLDİ | SEND_SUCCEED | Belge GİB'e gönderildi |
| 139 | OTOMATİK GÖNDERİM HATASI | AUTO_FAILED | Otomatik gönderim hatası |
| 140 | FATURA NUMARASI ATANDI | LOAD_ID_ASSIGNED | Belge numarası atandı |
| 141 | FATURA NUMARASI ATANMA BEKLENİYOR | LOAD_WAIT_ID_ASSIGNED | Belge numarası atanması bekleniyor |
Gelen Fatura Durumları (STATUS)
| Durum Kodu | Durum Açıklaması | STATUS_SUBSTATUS | Alınacak Aksiyon |
|---|---|---|---|
| 122 | KABUL EDİLDİ | ACCEPTED_SUCCEED | |
| 123 | KABUL İŞLENİYOR | ACCEPTED_PROCESSING | |
| 124 | KABUL GİB'DEN YANIT BEKLİYOR | ACCEPT_GIB_RESPONSE | |
| 125 | KABUL ALICIDAN YANIT BEKLİYOR | ACCEPT_WAIT_SYSTEM_RESPONSE | |
| 126 | KABUL İŞLEMİ BAŞARISIZ | ACCEPT_FAILED | |
| 127 | RED ALICIDAN YANIT BEKLİYOR | REJECT_WAIT_SYSTEM_RESPONSE | |
| 128 | RED GİB'DE YANIT BEKLİYOR | REJECT_WAIT_GIB_RESPONSE | |
| 129 | RED İŞLENİYOR | REJECT_PROCESSING | |
| 130 | REDDEDİLDİ | REJECT_SUCCEED | |
| 131 | RED İŞLEMİ BAŞARISIZ | FAILED | |
| 132 | ALINDI | RECEIVE_WAIT_APPLICATION_RESPONSE | Ticari fatura yanıt bekliyor |
| 133 | ALINDI | RECEIVE_SUCCEED | Temel fatura alındı |
| 134 | ZAMAN AŞIMI OLUŞTU | ACCEPT/REJECT_TIMEOUT | İşlem sistem tarafından otomatik tekrarlanacaktır |
GİB Durum Kodları (GIB_STATUS_CODE)
| Kod | Açıklama | Alınacak Aksiyon |
|---|---|---|
| 1000 | ZARF KUYRUĞA EKLENDİ | Durum kodunun güncellenmesi beklenmelidir. |
| 1100 | ZARF İŞLENİYOR | Durum kodunun güncellenmesi beklenmelidir. |
| 1110 | ZIP DOSYASI DEĞİL | Belge yeniden gönderilmeli |
| 1111 | ZARF ID UZUNLUĞU GEÇERSİZ | Belge yeniden gönderilmeli |
| 1120 | ZARF ARŞİVDEN KOPYALANAMADI | Belge yeniden gönderilmeli |
| 1130 | ZIP AÇILAMADI | Belge yeniden gönderilmeli |
| 1131 | ZIP BİR DOSYA İÇERMELİ | Belge yeniden gönderilmeli |
| 1132 | XML DOSYASI DEĞİL | Belge yeniden gönderilmeli |
| 1133 | ZARF ID VE XML DOSYASININ ADI AYNI OLMALI | Belge yeniden gönderilmeli |
| 1140 | DOKUMAN AYRIŞTIRILAMADI | Belge yeniden gönderilmeli |
| 1141 | ZARF ID YOK | Belge yeniden gönderilmeli |
| 1142 | ZARF ID VE ZIP DOSYASI ADI AYNI OLMALI | Belge yeniden gönderilmeli |
| 1143 | GEÇERSİZ VERSİYON | Belge yeniden gönderilmeli |
| 1150 | SCHEMATRON KONTROL SONUCU HATALI | Belge yeniden gönderilmeli |
| 1160 | XML ŞEMA KONTROLÜNDEN GEÇEMEDİ | Belge yeniden gönderilmeli |
| 1161 | İMZA SAHİBİ TCKN VKN ALINAMADI | Belge yeniden gönderilmeli |
| 1162 | İMZA KAYDEDİLEMEDİ | Belge yeniden gönderilmeli |
| 1163 | GÖNDERİLEN ZARF SİSTEMDE DAHA ÖNCE KAYITLI OLAN BİR BELGEYİ İÇERMEKTEDİR | Belge yeniden gönderilmeli |
| 1170 | YETKİ KONTROL EDİLEMEDİ | Belge yeniden gönderilmeli |
| 1171 | GÖNDERİCİ BİRİM YETKİSİ YOK | Belge yeniden gönderilmeli |
| 1172 | POSTA KUTUSU YETKİSİ YOK | Belge yeniden gönderilmeli |
| 1175 | İMZA YETKİSİ KONTROL EDİLEMEDİ | Belge yeniden gönderilmeli |
| 1176 | İMZA SAHİBİ YETKİSİZ | Belge yeniden gönderilmeli |
| 1177 | GEÇERSİZ İMZA | Belge yeniden gönderilmeli |
| 1180 | ADRES KONTROL EDİLEMEDİ | Belge yeniden gönderilmeli |
| 1181 | ADRES BULUNAMADI | Belge yeniden gönderilmeli |
| 1182 | KULLANICI EKLENEMEDİ | Belge yeniden gönderilmeli |
| 1183 | KULLANICI SİLİNEMEDİ | Belge yeniden gönderilmeli |
| 1190 | SİSTEM YANITI HAZIRLANAMADI | Belge yeniden gönderilmeli |
| 1195 | SİSTEM HATASI | Belge yeniden gönderilmeli |
| 1200 | ZARF BAŞARIYLA İŞLENDİ | Belgede sorun tespit edilmedi, sonraki aşamalara geçilecek. |
| 1210 | DOKUMAN BULUNAN ADRESE GÖNDERİLEMEDİ | GİB'in tekrar gönderme denemesi sonlandıktan sonra 1215 alınırsa belge yeniden gönderilmeli |
| 1215 | DOKÜMAN GÖNDERİMİ BAŞARISIZ. TEKRAR GÖNDERME SONLANDI | Belge yeniden gönderilmeli |
| 1220 | HEDEFTEN SİSTEM YANITI GELMEDİ | Ardından 1230 alınırsa belge yeniden gönderilmeli |
| 1230 | HEDEFTEN SİSTEM YANITI BAŞARISIZ GELDİ | Belge yeniden gönderilmeli |
| 1300 | BAŞARIYLA TAMAMLANDI | Başarılı olan belge aynı numara ile gönderilemez. |