# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.nilvera.com/hata-kodlari.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.