# Hata Kodları

<table data-card-size="large" data-column-title-hidden data-view="cards"><thead><tr><th>Http Status Kodlar</th><th> </th></tr></thead><tbody><tr><td><strong>200 - OK</strong></td><td>HTTP 200 durum kodu, yanıtın başarılı olduğunu gösterir.</td></tr><tr><td><strong>401 - Unauthorized</strong></td><td>Bu durumda, alınan bir yanıta erişim sağlamak için yetkilendirme gerekir.</td></tr><tr><td><strong>403 - Forbidden</strong></td><td>Kullanıcının söz konusu kaynak üzerinde herhangi bir yetkiye sahip olmadığı anlamına gelir.</td></tr><tr><td><strong>500, 502, 503, 504 - Server Errors</strong></td><td>Sunucunun belirli bir isteği tamamlamak için gereken gereksinimleri desteklemediğini veya sahip olmadığını gösterir. </td></tr></tbody></table>

## BadRequest - <mark style="color:red;">400</mark>

Servisten **400** Http kodu ile bir dönüş aldığınızda, gönderdiğiniz istekte geçersiz veriler bulunduğu anlamında gelmektedir. Bu hatayı aldığınız durumda istek parametrelerinizi gözden geçirmeniz gerekmektedir.

{% code title="Örnek Dönüş" %}

```json
{
  "Message": "GECERSIZ ISTEK",
  "Errors": [
    {
      "Code": 400,
      "Description": "Alias",
      "Detail": "Nesnesi Null Olamaz."
    }
  ]
}
```

{% endcode %}

## NotFound - <mark style="color:red;">404</mark>

Servisten **404** Http kodu ile bir dönüş aldığınızda, gönderdiğiniz isteğe karşılık bir kayıt olamadığı anlamına gelmektedir.&#x20;

{% code title="Örnek Dönüş" %}

```json
{
  "Message": "HATALI ISTEK",
  "Errors": [
    {
      "Code": 3006,
      "Description": "Belge Bulunamadı.",
      "Detail": "61bc499c-8e77-4ec9-a358-8f7a6d657d51 Nolu belge sistemde bulunamadı."
    }
  ]
}
```

{% endcode %}

### 404 Dönebilecek Diğer Kodlar

<table><thead><tr><th width="107">Kod</th><th>Açıklama</th></tr></thead><tbody><tr><td>3000</td><td>Alıcıya Ait Etiket Bulunamadı.</td></tr><tr><td>3001</td><td>Göndericiye Ait Etiket Bulunamadı.</td></tr><tr><td>3002</td><td>Etiket Sistemde Kayıtlı Değildir.</td></tr><tr><td>3003</td><td>Belge Sistemde Bulunamadı.</td></tr><tr><td>3004</td><td>Kayıt Sistemde Bulunamadı.</td></tr><tr><td>3005</td><td>Döküman İçeriği Boş.</td></tr><tr><td>3006</td><td>Rapor Sistemde Bulunamadı.</td></tr><tr><td>3007</td><td>Raporlanacak Fatura Bulunamadı.</td></tr><tr><td>3008</td><td>Raporlanacak Makbuz Bulunamadı.</td></tr><tr><td>3009</td><td>Seri Firmaya Tanımlı Değil.</td></tr><tr><td>3010</td><td>Şablon Bulunamadı.</td></tr><tr><td>3011</td><td>Şablon Aktif Değil.</td></tr><tr><td>3012</td><td>Firmaya Tanımlı Herhangi Bir Şablon Bulunmamaktadır.</td></tr><tr><td>3013</td><td>E-Mail Modülünüz Aktif Değildir.</td></tr><tr><td>3014</td><td>Whatsapp Modülünüz Aktif Değildir.</td></tr><tr><td>3015</td><td>Sms Modülünüz Aktif Değildir.</td></tr><tr><td>3016</td><td>Firma Bayiye Tanımlı Değildir.</td></tr><tr><td>3017</td><td>Koduna Sahip Paketiniz Bulunmamaktadır.</td></tr><tr><td>3018</td><td>Belirtilen Koda Sahip Alt Bayiniz Bulunmamaktadır.</td></tr><tr><td>3019</td><td>Raporlanacak Fatura Bulunamadı.</td></tr><tr><td>3020</td><td>E-Saklama Modülü Bulunamadı.</td></tr><tr><td>3021</td><td>E-Defter Ayarları Bulunamadı.</td></tr><tr><td>3022</td><td>Muhasebeci Bilgisi Bulunamadı.</td></tr><tr><td>3023</td><td>Sertifika Bilgisi Bulunamadı.</td></tr><tr><td>3024</td><td>Firma Erp Ayar Alanı Bulunamadı.</td></tr><tr><td>3025</td><td>E-Defter Sorgusu Bulunamadı</td></tr><tr><td>3026</td><td>E-Defter raporu bulunamadı.</td></tr><tr><td>3027</td><td>E-Defter İmza Değeri Bulunamadı.</td></tr><tr><td>3028</td><td>Mali Dönem Hatalı.</td></tr><tr><td>3029</td><td>Design Modülünüz Bulunamadı.</td></tr><tr><td>3030</td><td>API Bulunamadı.</td></tr></tbody></table>

## Conflict - <mark style="color:red;">409</mark>

Servisten **409** Http kodu ile bir dönüş aldığınızda, gönderdiğiniz istek sistemde daha önce bulunduğu anlamına gelmektedir.

{% code title="Örnek Dönüş" %}

```json
{
  "Message": "HATALI ISTEK",
  "Errors": [
    {
      "Code": 1000,
      "Description": "ETTN Numarası Sistemde Kayıtlıdır.",
      "Detail": "e1b40d5b-24b3-4f79-8735-a01ae5577de7 ETTN Numarası Sistemde Kayıtlıdır."
    }
  ]
}
```

{% endcode %}

### 409 Dönebilecek Diğer Kodlar

<table><thead><tr><th width="106">Kod</th><th>Açıklama</th></tr></thead><tbody><tr><td>1000</td><td>Gönderilen VKN/TCKN İle Firma Uyuşmamaktadır.</td></tr><tr><td>1001</td><td>ETTN Numarası Sistemde Kayıtlıdır.</td></tr><tr><td>1002</td><td>Uyumsuz OperationType Bilgisi.</td></tr><tr><td>1003</td><td>E-Fatura Otomatik Olarak Kabul Edildi Durumundadır.</td></tr><tr><td>1004</td><td>E-Fatura Daha Önce Eklenmiş.</td></tr><tr><td>1005</td><td>E-Fatura Serisi Daha Önce Kullanılmıştır.</td></tr><tr><td>1006 </td><td>Temel Faturalara Cevap Verilmemektedir.</td></tr><tr><td>1007</td><td>E-Fatura Daha Önce Cevaplanmış.</td></tr><tr><td>1008</td><td>E-İrsaliye Otomatik Olarak Kabul Edildi Durumundadır.</td></tr><tr><td>1009</td><td>E-İrsaliye Daha Önce Eklenmiş.</td></tr><tr><td>1010</td><td>E-İrsaiye Serisi Daha Önce Kullanılmıştır.</td></tr><tr><td>1011</td><td>E-İrsaliye Daha Önce Cevaplanmış.</td></tr><tr><td>1012</td><td>E-Arşiv Fatura Daha Önce Eklenmiş.</td></tr><tr><td>1013</td><td>E-SMM Daha Önce Eklenmiş.</td></tr><tr><td>1014</td><td>E-MM Daha Önce Eklenmiş.</td></tr><tr><td>1015</td><td>Kayıt Daha Önce Eklenmiş.</td></tr><tr><td>1016</td><td>Firmanın Belirtilen Yıl İçin Tanımlanmış Saklama Paketi Bulunmaktadır.</td></tr><tr><td>1017</td><td>E-SMM Serisi Daha Önce Kullanılmıştır.</td></tr><tr><td>1018</td><td>E-MM Serisi Daha Önce Kullanılmıştır.</td></tr><tr><td>1019</td><td>E-Adisyon Serisi Daha Önce Kullanılmıştır.</td></tr><tr><td>1020</td><td>E-Adisyon Daha Önce Eklenmiş.</td></tr></tbody></table>

## UnprocessableEntity - <mark style="color:red;">422</mark>

Servisten **422** Http kodu ile bir dönüş aldığınızda, gönderdiğiniz istek geçerli fakat iş kuralları gereği geçersiz değerler içermektedir.

{% code title="Örnek Dönüş" %}

```json
{
  "Message": "HATALI ISTEK",
  "Errors": [
    {
      "Code": 2000,
      "Description": "Yeterli Kontörünüz Bulunmamaktadır.",
      "Detail": "Yeterli Kontörünüz Bulunmamaktadır. Lütfen Kontör Alımı Yapınız."
    }
  ]
}
```

{% endcode %}

### 422 Dönebilecek Diğer Kodlar&#x20;

{% hint style="info" %}
Örneğin Oluşturmak istediğiniz e-Fatura KAMU daki bir vergi numarasına ait ise  size <mark style="background-color:blue;">**422**</mark> <mark style="color:orange;">Fatura Seneryosu KAMU Olmalıdır</mark> hatası döner. Servisten dönen <mark style="background-color:blue;">**422**</mark> kodundaki hataların detay kodları ve dönebilecek kodların listesi aşağıda listelenmiştir.
{% endhint %}

<table><thead><tr><th width="98">Kod</th><th>Açıklama</th></tr></thead><tbody><tr><td>2000</td><td>Yeterli Kontörünüz Bulunmamaktadır.</td></tr><tr><td>2001</td><td>Firma Bilgileri Eklenirken Hata Oluştu.</td></tr><tr><td>2002   </td><td>Saklama Alanınız Yetersiz Lütfen Üst Pakete Geçiniz.</td></tr><tr><td>2003 </td><td>Şubeler Getirilirken Hata Oluştu.</td></tr><tr><td>2004 </td><td>Kayıt Başarısız.</td></tr><tr><td>2005 </td><td>Dosya Yüklenemedi.</td></tr><tr><td>2006</td><td>Şablon Güncellenemedi.</td></tr><tr><td>2007</td><td>Döküman Açılamadı.(Unzip)</td></tr><tr><td>2008</td><td>Döküman Deserialize Edilemedi.</td></tr><tr><td>2009</td><td>Döküman İşleme Hatası.</td></tr><tr><td>2010</td><td>Belge Ekleri Getirilirken Hata.</td></tr><tr><td>2011</td><td>Yeni Zarf Oluşturulurken Hata Oluştu.</td></tr><tr><td>2012</td><td>Döküman Okunamadı.</td></tr><tr><td>2013</td><td>Kayıt Silinemedi.</td></tr><tr><td>2014</td><td>Pdf Dosyası Oluşturulamadı.</td></tr><tr><td>2015</td><td>Şema/Şematron Hatası.</td></tr><tr><td>2016</td><td>İstatistikler Getirilirken Hata Oluştu.</td></tr><tr><td>2017</td><td>Uyumsuz FileType Bilgisi.</td></tr><tr><td>2018</td><td>SEND_TYPE İçin Geçersiz Değer.</td></tr><tr><td>2019</td><td>İşlem Sayısı 100 Adedi Geçemez.</td></tr><tr><td>2020</td><td>Uyumsuz Dosya İçeriği.</td></tr><tr><td>2021</td><td>Döviz Kurları Getirilirken Hata.</td></tr><tr><td>2022</td><td>Güncelleme Yapılırken Hata.</td></tr><tr><td>2023</td><td>Önizleme Oluşturulamadı.</td></tr><tr><td>2024</td><td>Belge Senaryosu EARSIVBELGE Olmalıdır.</td></tr><tr><td>2025</td><td>Alıcı E-Fatura Mükellefidir. E-Arşiv Fatura Gönderilemez.</td></tr><tr><td>2026</td><td>E-Arşiv Fatura Daha Önce İptal Edilmiştir.</td></tr><tr><td>2027</td><td>Rapor Hatalı Olması Durumunda E-Arşiv Fatura İptal Edilemez.</td></tr><tr><td>2028</td><td>Dosya Kuyrukta Veya Durumu Bilinmiyorsa E-Arşiv Fatura İptal Edilemez.</td></tr><tr><td>2029</td><td>E-Arşiv Fatura İptal Kaydı Oluşturulamadı.Lütfen Daha Sonra Tekrar Deneyiniz.</td></tr><tr><td>2030</td><td>İptal Kaydı Geri Alınmak İstenen E-Arşiv Fatura Raporlanmıştır.</td></tr><tr><td>2031</td><td>E-Arşiv Fatura İptal Kaydı Geri Alınamadı. Lütfen Daha Sonra Tekrar Deneyiniz.</td></tr><tr><td>2032</td><td>E-Arşiv Fatura Serisi Aktif Değil.</td></tr><tr><td>2033</td><td>E-Arşiv Fatura Seri Alanı Boş Geçilemez.</td></tr><tr><td>2034</td><td>E-SMM Daha Önce İptal Edilmiştir.</td></tr><tr><td>2035</td><td>Rapor Hatalı Olması Durumunda E-SMM İptal Edilemez.</td></tr><tr><td>2036</td><td>Dosya Kuyrukta Veya Durumu Bilinmiyorsa E-SMM İptal Edilemez.</td></tr><tr><td>2037</td><td>E-SMM İptal Kaydı Oluşturulamadı.Lütfen Daha Sonra Tekrar Deneyiniz.</td></tr><tr><td>2038</td><td>İptal Kaydı Geri Alınmak İstenen E-SMM Raporlanmıştır.</td></tr><tr><td>2039</td><td>E-SMM İptal Kaydı Geri Alınamadı. Lütfen Daha Sonra Tekrar Deneyiniz.</td></tr><tr><td>2040</td><td>E-SMM Serisi Aktif Değil.</td></tr><tr><td>2041</td><td>E-SMM Seri Alanı Boş Geçilemez.</td></tr><tr><td>2042</td><td>E-MM Daha Önce İptal Edilmiştir.</td></tr><tr><td>2043</td><td>Dosya Kuyrukta Veya Durumu Bilinmiyorsa E-MM İptal Edilemez.</td></tr><tr><td>2044</td><td>E-MM İptal Kaydı Oluşturulamadı.Lütfen Daha Sonra Tekrar Deneyiniz.</td></tr><tr><td>2045</td><td>İptal Kaydı Geri Alınmak İstenen E-MM Raporlanmıştır.</td></tr><tr><td>2046</td><td>E-MM İptal Kaydı Geri Alınamadı. Lütfen Daha Sonra Tekrar Deneyiniz.</td></tr><tr><td>2047</td><td>E-MM Serisi Aktif Değil.</td></tr><tr><td>2048</td><td>E-MM Seri Alanı Boş Geçilemez.</td></tr><tr><td>2049</td><td>Rapor Sorgulanamaz.</td></tr><tr><td>2050</td><td>Rapor Oluşturulurken Hata.</td></tr><tr><td>2051</td><td>Gönderici E-Fatura Mükellefi Değildir.</td></tr><tr><td>2052</td><td>Alıcıya Ait Etiket Kullanımda Değildir.</td></tr><tr><td>2053</td><td>Alıcı Bu Tarihde E-Fatura Mükellefi Olmuştur.</td></tr><tr><td>2054</td><td>Alıcı E-Fatura Mükellefi Değildir.</td></tr><tr><td>2055</td><td>Alıcının Etiketi Girilmelidir.</td></tr><tr><td>2056</td><td>Alıcıya Ait Etiket Kullanımdadır.</td></tr><tr><td>2057</td><td>E-Fatura Etiketleri Getirilirken Hata Oluştu.</td></tr><tr><td>2058</td><td>E-Fatura Kâğıt yada E-Arşiv Fatura Olarak Düzenlenmelidir.</td></tr><tr><td>2059</td><td>E-Fatura Senaryosu Kamu Olmalıdır.</td></tr><tr><td>2060</td><td>Fatura Senaryosu E-Arşiv Fatura Olmalıdır.</td></tr><tr><td>2061</td><td>E-Fatura Senaryosu Kamu Olmamalıdır.</td></tr><tr><td>2062</td><td>E-Fatura Cevabı Güncellenemedi.</td></tr><tr><td>2063</td><td>Fatura Senaryosu E-Arşiv Fatura Olduğu İçin E-Fatura Ucuna Gönderilemez.</td></tr><tr><td>2064</td><td>E-Fatura Serisi Aktif Değil.</td></tr><tr><td>2065</td><td>E-Fatura Seri Alanı Boş Geçilemez.</td></tr><tr><td>2066</td><td>Gönderici E-İrsaliye Mükellefi Değildir.</td></tr><tr><td>2067</td><td>Alıcı Bu Tarihde E-İrsaliye Mükellefi Olmuştur.</td></tr><tr><td>2068</td><td>Belge Sanal Alıcıya Gönderilemez.</td></tr><tr><td>2069</td><td>Belge Sanal Alıcıya Gönderilmelidir. (urn:mail:defaultpk@gib.gov.tr)</td></tr><tr><td>2070</td><td>E-İrsaliye Etiketleri Getirilirken Hata Oluştu.</td></tr><tr><td>2071</td><td>İrsaliye Yanıtı Beklememektedir.</td></tr><tr><td>2072</td><td>İrsaliye Senaryosu 'TEMELIRSALIYE' veya 'HKSIRSALIYE' Olmalıdır.</td></tr><tr><td>2073</td><td>E-İrsaliye Serisi Aktif Değil.</td></tr><tr><td>2074</td><td>E-İrsaliye Seri Alanı Boş Geçilemez.</td></tr><tr><td>2075</td><td>Kontör Paketinizin Tarihi Bitmiştir.</td></tr><tr><td>2076</td><td>Saklama Paketinizin Tarihi Bitmiştir.</td></tr><tr><td>2077</td><td>Yeterli Sayıda Paketiniz Bulunmamaktadır.</td></tr><tr><td>2078</td><td>Kontör Paketinizin Yeterli Kontörü Bulunmamaktadır.</td></tr><tr><td>2079</td><td>Rapor Hatalı Olması Durumunda E-MM İptal Edilemez.</td></tr><tr><td>2080</td><td>E-Adisyon Daha Önce İptal Edilmiştir.</td></tr><tr><td>2081</td><td>Dosya Kuyrukta Veya Durumu Bilinmiyorsa E-Adisyon İptal Edilemez.</td></tr><tr><td>2082</td><td>E-Adisyon İptal Kaydı Oluşturulamadı.Lütfen Daha Sonra Tekrar Deneyiniz.</td></tr><tr><td>2083</td><td>İptal Kaydı Geri Alınmak İstenen E-Adisyon Raporlanmıştır.</td></tr><tr><td>2084</td><td>E-Adisyon İptal Kaydı Geri Alınamadı. Lütfen Daha Sonra Tekrar Deneyiniz.</td></tr><tr><td>2085</td><td>E-Adisyon Serisi Aktif Değil.</td></tr><tr><td>2086</td><td>E-Adisyon Seri Alanı Boş Geçilemez.</td></tr><tr><td>2087</td><td>PDF Dosyası Okunamadı.</td></tr><tr><td>2088</td><td>E-Defter Daha Önceden Oluşturuldu.</td></tr><tr><td>2089</td><td>E-Defter Oluşturulurken Hata.</td></tr><tr><td>2090</td><td>E-Defter Yapısında Hata.</td></tr><tr><td>2091</td><td>E-Defter Oluşturma İşlemi Devam Ediyor.</td></tr><tr><td>2092</td><td>Sertifikalar Eşleşmiyor.</td></tr><tr><td>2093</td><td>İmzalama Hatalı.</td></tr><tr><td>2094</td><td>Amount Değeri Bir Sayı Olmalıdır.</td></tr><tr><td>2095</td><td>EnteredDate alanı hatalı formatta.</td></tr><tr><td>2096</td><td>E-Defter Gönderme İşlemi Devam Etmektedir.</td></tr><tr><td>2097</td><td>GİB'ten Sorgulanamadı.</td></tr><tr><td>2098</td><td>Hesap Dönemi 12 Aydan Oluşmalıdır.</td></tr><tr><td>2099</td><td>Defter Statusu Güncellenirken Hata Oluştu.</td></tr><tr><td>2100</td><td>Seri ve Belge Yılı Uyuşmazlığı.</td></tr><tr><td>2101</td><td>Rapor Hatalı Olması Durumunda E-Adisyon İptal Edilemez.</td></tr></tbody></table>