# Table of Contents - [Genel Bakış | Nilvera API v1](#genel-bak-nilvera-api-v1) - [API Anahtarı Üretimi | Nilvera API v1](#api-anahtar-retimi-nilvera-api-v1) - [GENEL API | Nilvera API v1](#genel-api-nilvera-api-v1) - [Firma İşlemleri | Nilvera API v1](#firma-i-lemleri-nilvera-api-v1) - [Firma Bilgileri Günceller | Nilvera API v1](#firma-bilgileri-g-nceller-nilvera-api-v1) - [Hata Kodları | Nilvera API v1](#hata-kodlar-nilvera-api-v1) - [Firmaya Sertifika Ekler | Nilvera API v1](#firmaya-sertifika-ekler-nilvera-api-v1) - [Firma Sertifikasını Günceller | Nilvera API v1](#firma-sertifikas-n-g-nceller-nilvera-api-v1) - [Kampanya | Nilvera API v1](#kampanya-nilvera-api-v1) - [Kampanyaları Getirir | Nilvera API v1](#kampanyalar-getirir-nilvera-api-v1) - [Firma Kimlik Bilgileri | Nilvera API v1](#firma-kimlik-bilgileri-nilvera-api-v1) - [Müşteriler | Nilvera API v1](#m-teriler-nilvera-api-v1) - [Kredi | Nilvera API v1](#kredi-nilvera-api-v1) - [Müşteri Ekler | Nilvera API v1](#m-teri-ekler-nilvera-api-v1) --- # Genel Bakış | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/genel-bakis.md) . [](https://developer.nilvera.com/#api-hakkinda) API Hakkında ----------------------------------------------------------------- **Nilvera API**'leri, REST olarak tasarlanmıştır. API istek ve dönüşleri HTTP standartlarına uygun olarak geliştirilmiştir. Dokumanın ilerleyen sayfalarında Ortak Nesneler hakkında detaylı bilgiler verilmiştir. API istek ve dönüş tiplerinde **OAS 3.x** standartları kullanılmıştır. İlgili API'lere ait tanımlayıcı dosyaları ile kendi uygulamalarınızı çok hızlı ve sorunsuz bir biçimde entegre edebilirsiniz. API dokumantasyonları içerisinde tüm uçların açıklamaları, istek ve dönüş tipleri detaylıca açıklanmıştır. API'leri kullanarak **e-Fatura**, **e-Arşiv Fatura**, **e-İrsaliye**, **e-Serbest Meslek Makbuzu**, **e-Müstahsil Makbuzu**, **e-Adisyon** özel entegratörlük hizmetlerimizi geliştirmiş olduğunuz ERP/Muhasebe sistemleri ve diğer uygulamalarınız ile entegre edebilirsiniz. [](https://developer.nilvera.com/#test-ve-canli-ortam-hakkinda) Test ve Canlı Ortam Hakkında ------------------------------------------------------------------------------------------------- API'ler Canlı ve Test ortamı olarak ayrılmaktadır. Test ortamında üretilen anahtlar ile Canlı ortam anahtarları ve Firma bilgileri birbirinden ayrı olacaktır. Test ortamı ile tüm entegrasyon tamamlandıktan sonra canlı hesap açılışları yapıldıktan sonra endpoint canlı ortama bakacak şekilde ayarlanması durumunda bir sorun yaşanmayacaktır. Canlı Ortam Test Ortamı Copy https://api.nilvera.com/{API_NAME} Copy https://apitest.nilvera.com/{API_NAME} [](https://developer.nilvera.com/#authentication-ve-authorization) Authentication ve Authorization ------------------------------------------------------------------------------------------------------- Tüm API'lerimizde yetkilendirme mekanizması olarak OAuth 2.0 kullanılmaktadır. Hizmetlere ait API'ler farklı uygulamalar olmasına karşın merkezi yetkilendirme otoritesi üzerinden API'leri kullanabilirsiniz. API'lerde kullanılacak Token tipi JWT değil Reference tipindedir. Daha önceden edindiğiniz kullanıcı adı ve şifrenizle Portal uygulaması üzerinden API'lerde kullanmak üzere API Anahtarı üretmelisiniz. Üretilen API Anahtarı sizin belirleyeceğiniz yetkilere (scope) sahip olacak ve sadece yetkisi olduğu işlemleri yapabilecek, belirttiğiniz süre dolduğunda da API Anahtarı geçersiz olacaktır. API anahtarları `Persisted Access Token` şeklindedir. Bir anahtar ürettikten sonra bu anahtarı sürekli kullanabilir, Portal üzerinden erişimini anında sonlandırabilirsiniz. Örnek : 9EE05B6564525810C86A32646DB46A26E20F4BCE32C0B13AB22AA78E70DC4F69 ![](https://developer.nilvera.com/~gitbook/image?url=https%3A%2F%2Fcontent.gitbook.com%2Fcontent%2Fd6zbpiT3oETRlZXAzPZr%2Fblobs%2FshKBzo8BPFQJRFb9jFG4%2Fapi.png&width=768&dpr=3&quality=100&sign=403dea09&sv=2) > **Not:** API anahtarını servis çağrılarınızın Header alanında `Authorization:Bearer {API_ANAHTARI}` şeklinde göndermeniz API nin sizi tanıması ve yetkilendirmesi için yeterli olacaktır. [NextAPI Anahtarı Üretimi](https://developer.nilvera.com/api-anahtari-uretimi) Last updated 5 months ago --- # API Anahtarı Üretimi | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api-anahtari-uretimi.md) . Kullanıcı Adı ve Şifre kullanılarak Portal üzerinde oturum açıldıktan sonra sırayla aşağıdaki işlemler takip edilir. Sol Menüden, **API Tanımları** > **Yeni Anahtar** 'a tıklanır. Gelen erkandaki bilgiler doldurulur. * **Açıklama** kısmına ilgili anahtar için hatırlatıcı bir değer girebilirsiniz. Örn : X Erp Entegrasyon vb. * **Son geçerlilik tarihi**, api anahtarının hangi süreye kadar geçerli olacağını belirtir. Boş bırakarak süresiz olarak ayarlayabilirsiniz ![](https://developer.nilvera.com/~gitbook/image?url=https%3A%2F%2Fcontent.gitbook.com%2Fcontent%2Fd6zbpiT3oETRlZXAzPZr%2Fblobs%2Fs5MQ2zAgqFFjE6rpU9RU%2Fapikey.png&width=768&dpr=3&quality=100&sign=2ad1b83&sv=2) Api Key **Not :** Üretilen anahtar yalnızca bir kez görüntülenir. Ürettiğiniz anahtarı mutlaka kopyalayarak, kendi uygulamalarınızdaki ilgili alanlara kaydetmelisiniz [PreviousGenel Bakış](https://developer.nilvera.com/) [NextHata Kodları](https://developer.nilvera.com/hata-kodlari) --- # GENEL API | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api.md) . Bu dökümanda genel bilgilendirme yapılmaktadır. [PreviousHata Kodları](https://developer.nilvera.com/hata-kodlari) [NextFirma İşlemleri](https://developer.nilvera.com/api/genel-api/firma-islemleri) Last updated 3 months ago --- # Firma İşlemleri | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/firma-islemleri.md) . Firmaya ait bilgileri (Adres,Telefon Numarası,WEB Sitesi vb.) sorgulama ve güncelleme işlemlerini buradan yapabilirsiniz. [PreviousGENEL API](https://developer.nilvera.com/api/genel-api) [NextFirma Bilgileri Getirir](https://developer.nilvera.com/api/genel-api/firma-islemleri/firma-bilgileri-getirir) --- # Firma Bilgileri Günceller | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/firma-islemleri/firma-bilgileri-gunceller.md) . Copy On this page ### [](https://developer.nilvera.com/api/genel-api/firma-islemleri/firma-bilgileri-gunceller#put-company) Firma bilgilerini günceller. put/general/Company Authorizations Bearer Bearer HTTPRequired API anahtar� giriniz Body application/json-patch+json application/json-patch+jsonapplication/jsontext/jsonapplication/\*+json TaxOfficestring · nullableOptional Addressstring · nullableOptional Districtstring · nullableOptional Citystring · nullableOptional Countrystring · nullableOptional PostalCodestring · nullableOptional PhoneNumberstring · nullableOptional Faxstring · nullableOptional Emailstring · nullableOptional WebSitestring · nullableOptional PayeeFinancialAccountIDstring · nullableOptional PaymentMeansChannelCodestring · nullableOptional PaymentMeansCodestring · enumOptionalPossible values: `ODEMETIPIMUHTELIF``NAKIT``CEK``BANKACEKI``HAVALE_EFT``KREDIKARTI_BANKAKARTI` Responses 200 Firma bilgilerini günceller. application/json Namestring · nullableOptional TaxNumberstring · nullableOptional TaxOfficestring · nullableOptional Addressstring · nullableOptional Districtstring · nullableOptional Citystring · nullableOptional Countrystring · nullableOptional PostalCodestring · nullableOptional PhoneNumberstring · nullableOptional Faxstring · nullableOptional Emailstring · nullableOptional WebSitestring · nullableOptional IsActiveboolean · nullableOptional IsDeletedboolean · nullableOptional PayeeFinancialAccountIDstring · nullableOptional PaymentMeansChannelCodestring · nullableOptional PaymentMeansCodestring · nullableOptional Aliasesobject · CompanyAliases\[\] · nullableRead-onlyOptional Show properties 400 Geçersiz İstek | Gönderdiğiniz istekte geçersiz veriler bulunduğu anlamında gelmektedir | Detaylar için tıklayınız 403 Yetkisiz Erişim | Bu uca erişmek için gerekli yetkiye sahip olmadığınız durumda dönülür 404 Parametrede belirtilen kayıt bulunamadığında dönülür | Detaylar için tıklayınız put/Company HTTP HTTPcURLJavaScriptPython Copy PUT /general/Company HTTP/1.1 Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json-patch+json Accept: */* Content-Length: 277 { "TaxOffice": "text", "Address": "text", "District": "text", "City": "text", "Country": "text", "PostalCode": "text", "PhoneNumber": "text", "Fax": "text", "Email": "text", "WebSite": "text", "PayeeFinancialAccountID": "text", "PaymentMeansChannelCode": "text", "PaymentMeansCode": "ODEMETIPIMUHTELIF" } application/json-patch+json application/json-patch+jsonapplication/jsontext/jsonapplication/\*+json 200 Firma bilgilerini günceller. Copy { "Name": "text", "TaxNumber": "text", "TaxOffice": "text", "Address": "text", "District": "text", "City": "text", "Country": "text", "PostalCode": "text", "PhoneNumber": "text", "Fax": "text", "Email": "text", "WebSite": "text", "IsActive": true, "IsDeleted": true, "PayeeFinancialAccountID": "text", "PaymentMeansChannelCode": "text", "PaymentMeansCode": "text", "Aliases": [\ {\ "Alias": "text",\ "AliasType": 1,\ "Type": 1\ }\ ] } C# PHP - cURL NodeJs - Axios Copy var client = new RestClient("https://apitest.nilvera.com/general/Company"); client.Timeout = -1; var request = new RestRequest(Method.PUT); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); var body = @"{"TaxOffice": "string", "Address": "string", "District": "string", "City": "string", "Country": "string", "PostalCode": "string", "PhoneNumber": "string", "Fax": "string", "Email": "string", "WebSite": "string", "PayeeFinancialAccountID": "string", "PaymentMeansChannelCode": "string", "PaymentMeansCode": "ODEMETIPIMUHTELIF"}"; request.AddParameter("application/json", body, ParameterType.RequestBody); IRestResponse response = client.Execute(request); Console.WriteLine(response.Content); Copy 'https://apitest.nilvera.com/general/Company', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'PUT', CURLOPT_POSTFIELDS =>'{ "TaxOffice": "string", "Address": "string", "District": "string", "City": "string", "Country": "string", "PostalCode": "string", "PhoneNumber": "string", "Fax": "string", "Email": "string", "WebSite": "string", "PayeeFinancialAccountID": "string", "PaymentMeansChannelCode": "string", "PaymentMeansCode": "ODEMETIPIMUHTELIF" }', CURLOPT_HTTPHEADER => array( 'Authorization: Bearer ', 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; Copy var axios = require('axios'); var data = JSON.stringify({ "TaxOffice": "string", "Address": "string", "District": "string", "City": "string", "Country": "string", "PostalCode": "string", "PhoneNumber": "string", "Fax": "string", "Email": "string", "WebSite": "string", "PayeeFinancialAccountID": "string", "PaymentMeansChannelCode": "string", "PaymentMeansCode": "ODEMETIPIMUHTELIF" }); var config = { method: 'put', url: 'https://apitest.nilvera.com/general/Company', headers: { 'Authorization': 'Bearer ', 'Content-Type': 'application/json' }, data : data }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); }); [PreviousFirma Bilgileri Getirir](https://developer.nilvera.com/api/genel-api/firma-islemleri/firma-bilgileri-getirir) [NextFirmanın Modüllerini Getirir](https://developer.nilvera.com/api/genel-api/firma-islemleri/firmanin-modullerini-getirir) Last updated 1 year ago --- # Hata Kodları | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/hata-kodlari.md) . **200 - OK** HTTP 200 durum kodu, yanıtın başarılı olduğunu gösterir. **401 - Unauthorized** Bu durumda, alınan bir yanıta erişim sağlamak için yetkilendirme gerekir. **403 - Forbidden** Kullanıcının söz konusu kaynak üzerinde herhangi bir yetkiye sahip olmadığı anlamına gelir. **500, 502, 503, 504 - Server Errors** Sunucunun belirli bir isteği tamamlamak için gereken gereksinimleri desteklemediğini veya sahip olmadığını gösterir. [](https://developer.nilvera.com/hata-kodlari#badrequest-400) BadRequest - 400 ----------------------------------------------------------------------------------- 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. Örnek Dönüş Copy { "Message": "GECERSIZ ISTEK", "Errors": [\ {\ "Code": 400,\ "Description": "Alias",\ "Detail": "Nesnesi Null Olamaz."\ }\ ] } [](https://developer.nilvera.com/hata-kodlari#notfound-404) NotFound - 404 ------------------------------------------------------------------------------- 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. Örnek Dönüş Copy { "Message": "HATALI ISTEK", "Errors": [\ {\ "Code": 3006,\ "Description": "Belge Bulunamadı.",\ "Detail": "61bc499c-8e77-4ec9-a358-8f7a6d657d51 Nolu belge sistemde bulunamadı."\ }\ ] } ### [](https://developer.nilvera.com/hata-kodlari#id-404-donebilecek-diger-kodlar) 404 Dönebilecek Diğer Kodlar Kod Açıklama 3000 Alıcıya Ait Etiket Bulunamadı. 3001 Göndericiye Ait Etiket Bulunamadı. 3002 Etiket Sistemde Kayıtlı Değildir. 3003 Belge Sistemde Bulunamadı. 3004 Kayıt Sistemde Bulunamadı. 3005 Döküman İçeriği Boş. 3006 Rapor Sistemde Bulunamadı. 3007 Raporlanacak Fatura Bulunamadı. 3008 Raporlanacak Makbuz Bulunamadı. 3009 Seri Firmaya Tanımlı Değil. 3010 Şablon Bulunamadı. 3011 Şablon Aktif Değil. 3012 Firmaya Tanımlı Herhangi Bir Şablon Bulunmamaktadır. 3013 E-Mail Modülünüz Aktif Değildir. 3014 Whatsapp Modülünüz Aktif Değildir. 3015 Sms Modülünüz Aktif Değildir. 3016 Firma Bayiye Tanımlı Değildir. 3017 Koduna Sahip Paketiniz Bulunmamaktadır. 3018 Belirtilen Koda Sahip Alt Bayiniz Bulunmamaktadır. 3019 Raporlanacak Fatura Bulunamadı. 3020 E-Saklama Modülü Bulunamadı. 3021 E-Defter Ayarları Bulunamadı. 3022 Muhasebeci Bilgisi Bulunamadı. 3023 Sertifika Bilgisi Bulunamadı. 3024 Firma Erp Ayar Alanı Bulunamadı. 3025 E-Defter Sorgusu Bulunamadı 3026 E-Defter raporu bulunamadı. 3027 E-Defter İmza Değeri Bulunamadı. 3028 Mali Dönem Hatalı. 3029 Design Modülünüz Bulunamadı. 3030 API Bulunamadı. [](https://developer.nilvera.com/hata-kodlari#conflict-409) Conflict - 409 ------------------------------------------------------------------------------- Servisten **409** Http kodu ile bir dönüş aldığınızda, gönderdiğiniz istek sistemde daha önce bulunduğu anlamına gelmektedir. Örnek Dönüş Copy { "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."\ }\ ] } ### [](https://developer.nilvera.com/hata-kodlari#id-409-donebilecek-diger-kodlar) 409 Dönebilecek Diğer Kodlar Kod Açıklama 1000 Gönderilen VKN/TCKN İle Firma Uyuşmamaktadır. 1001 ETTN Numarası Sistemde Kayıtlıdır. 1002 Uyumsuz OperationType Bilgisi. 1003 E-Fatura Otomatik Olarak Kabul Edildi Durumundadır. 1004 E-Fatura Daha Önce Eklenmiş. 1005 E-Fatura Serisi Daha Önce Kullanılmıştır. 1006 Temel Faturalara Cevap Verilmemektedir. 1007 E-Fatura Daha Önce Cevaplanmış. 1008 E-İrsaliye Otomatik Olarak Kabul Edildi Durumundadır. 1009 E-İrsaliye Daha Önce Eklenmiş. 1010 E-İrsaiye Serisi Daha Önce Kullanılmıştır. 1011 E-İrsaliye Daha Önce Cevaplanmış. 1012 E-Arşiv Fatura Daha Önce Eklenmiş. 1013 E-SMM Daha Önce Eklenmiş. 1014 E-MM Daha Önce Eklenmiş. 1015 Kayıt Daha Önce Eklenmiş. 1016 Firmanın Belirtilen Yıl İçin Tanımlanmış Saklama Paketi Bulunmaktadır. 1017 E-SMM Serisi Daha Önce Kullanılmıştır. 1018 E-MM Serisi Daha Önce Kullanılmıştır. 1019 E-Adisyon Serisi Daha Önce Kullanılmıştır. 1020 E-Adisyon Daha Önce Eklenmiş. [](https://developer.nilvera.com/hata-kodlari#unprocessableentity-422) UnprocessableEntity - 422 ----------------------------------------------------------------------------------------------------- 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. Örnek Dönüş Copy { "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."\ }\ ] } ### [](https://developer.nilvera.com/hata-kodlari#id-422-donebilecek-diger-kodlar) 422 Dönebilecek Diğer Kodlar Örneğin Oluşturmak istediğiniz e-Fatura KAMU daki bir vergi numarasına ait ise size **422** Fatura Seneryosu KAMU Olmalıdır hatası döner. Servisten dönen **422** kodundaki hataların detay kodları ve dönebilecek kodların listesi aşağıda listelenmiştir. Kod Açıklama 2000 Yeterli Kontörünüz Bulunmamaktadır. 2001 Firma Bilgileri Eklenirken Hata Oluştu. 2002 Saklama Alanınız Yetersiz Lütfen Üst Pakete Geçiniz. 2003 Şubeler Getirilirken Hata Oluştu. 2004 Kayıt Başarısız. 2005 Dosya Yüklenemedi. 2006 Şablon Güncellenemedi. 2007 Döküman Açılamadı.(Unzip) 2008 Döküman Deserialize Edilemedi. 2009 Döküman İşleme Hatası. 2010 Belge Ekleri Getirilirken Hata. 2011 Yeni Zarf Oluşturulurken Hata Oluştu. 2012 Döküman Okunamadı. 2013 Kayıt Silinemedi. 2014 Pdf Dosyası Oluşturulamadı. 2015 Şema/Şematron Hatası. 2016 İstatistikler Getirilirken Hata Oluştu. 2017 Uyumsuz FileType Bilgisi. 2018 SEND\_TYPE İçin Geçersiz Değer. 2019 İşlem Sayısı 100 Adedi Geçemez. 2020 Uyumsuz Dosya İçeriği. 2021 Döviz Kurları Getirilirken Hata. 2022 Güncelleme Yapılırken Hata. 2023 Önizleme Oluşturulamadı. 2024 Belge Senaryosu EARSIVBELGE Olmalıdır. 2025 Alıcı E-Fatura Mükellefidir. E-Arşiv Fatura Gönderilemez. 2026 E-Arşiv Fatura Daha Önce İptal Edilmiştir. 2027 Rapor Hatalı Olması Durumunda E-Arşiv Fatura İptal Edilemez. 2028 Dosya Kuyrukta Veya Durumu Bilinmiyorsa E-Arşiv Fatura İptal Edilemez. 2029 E-Arşiv Fatura İptal Kaydı Oluşturulamadı.Lütfen Daha Sonra Tekrar Deneyiniz. 2030 İptal Kaydı Geri Alınmak İstenen E-Arşiv Fatura Raporlanmıştır. 2031 E-Arşiv Fatura İptal Kaydı Geri Alınamadı. Lütfen Daha Sonra Tekrar Deneyiniz. 2032 E-Arşiv Fatura Serisi Aktif Değil. 2033 E-Arşiv Fatura Seri Alanı Boş Geçilemez. 2034 E-SMM Daha Önce İptal Edilmiştir. 2035 Rapor Hatalı Olması Durumunda E-SMM İptal Edilemez. 2036 Dosya Kuyrukta Veya Durumu Bilinmiyorsa E-SMM İptal Edilemez. 2037 E-SMM İptal Kaydı Oluşturulamadı.Lütfen Daha Sonra Tekrar Deneyiniz. 2038 İptal Kaydı Geri Alınmak İstenen E-SMM Raporlanmıştır. 2039 E-SMM İptal Kaydı Geri Alınamadı. Lütfen Daha Sonra Tekrar Deneyiniz. 2040 E-SMM Serisi Aktif Değil. 2041 E-SMM Seri Alanı Boş Geçilemez. 2042 E-MM Daha Önce İptal Edilmiştir. 2043 Dosya Kuyrukta Veya Durumu Bilinmiyorsa E-MM İptal Edilemez. 2044 E-MM İptal Kaydı Oluşturulamadı.Lütfen Daha Sonra Tekrar Deneyiniz. 2045 İptal Kaydı Geri Alınmak İstenen E-MM Raporlanmıştır. 2046 E-MM İptal Kaydı Geri Alınamadı. Lütfen Daha Sonra Tekrar Deneyiniz. 2047 E-MM Serisi Aktif Değil. 2048 E-MM Seri Alanı Boş Geçilemez. 2049 Rapor Sorgulanamaz. 2050 Rapor Oluşturulurken Hata. 2051 Gönderici E-Fatura Mükellefi Değildir. 2052 Alıcıya Ait Etiket Kullanımda Değildir. 2053 Alıcı Bu Tarihde E-Fatura Mükellefi Olmuştur. 2054 Alıcı E-Fatura Mükellefi Değildir. 2055 Alıcının Etiketi Girilmelidir. 2056 Alıcıya Ait Etiket Kullanımdadır. 2057 E-Fatura Etiketleri Getirilirken Hata Oluştu. 2058 E-Fatura Kâğıt yada E-Arşiv Fatura Olarak Düzenlenmelidir. 2059 E-Fatura Senaryosu Kamu Olmalıdır. 2060 Fatura Senaryosu E-Arşiv Fatura Olmalıdır. 2061 E-Fatura Senaryosu Kamu Olmamalıdır. 2062 E-Fatura Cevabı Güncellenemedi. 2063 Fatura Senaryosu E-Arşiv Fatura Olduğu İçin E-Fatura Ucuna Gönderilemez. 2064 E-Fatura Serisi Aktif Değil. 2065 E-Fatura Seri Alanı Boş Geçilemez. 2066 Gönderici E-İrsaliye Mükellefi Değildir. 2067 Alıcı Bu Tarihde E-İrsaliye Mükellefi Olmuştur. 2068 Belge Sanal Alıcıya Gönderilemez. 2069 Belge Sanal Alıcıya Gönderilmelidir. (urn:mail:defaultpk@gib.gov.tr) 2070 E-İrsaliye Etiketleri Getirilirken Hata Oluştu. 2071 İrsaliye Yanıtı Beklememektedir. 2072 İrsaliye Senaryosu 'TEMELIRSALIYE' veya 'HKSIRSALIYE' Olmalıdır. 2073 E-İrsaliye Serisi Aktif Değil. 2074 E-İrsaliye Seri Alanı Boş Geçilemez. 2075 Kontör Paketinizin Tarihi Bitmiştir. 2076 Saklama Paketinizin Tarihi Bitmiştir. 2077 Yeterli Sayıda Paketiniz Bulunmamaktadır. 2078 Kontör Paketinizin Yeterli Kontörü Bulunmamaktadır. 2079 Rapor Hatalı Olması Durumunda E-MM İptal Edilemez. 2080 E-Adisyon Daha Önce İptal Edilmiştir. 2081 Dosya Kuyrukta Veya Durumu Bilinmiyorsa E-Adisyon İptal Edilemez. 2082 E-Adisyon İptal Kaydı Oluşturulamadı.Lütfen Daha Sonra Tekrar Deneyiniz. 2083 İptal Kaydı Geri Alınmak İstenen E-Adisyon Raporlanmıştır. 2084 E-Adisyon İptal Kaydı Geri Alınamadı. Lütfen Daha Sonra Tekrar Deneyiniz. 2085 E-Adisyon Serisi Aktif Değil. 2086 E-Adisyon Seri Alanı Boş Geçilemez. 2087 PDF Dosyası Okunamadı. 2088 E-Defter Daha Önceden Oluşturuldu. 2089 E-Defter Oluşturulurken Hata. 2090 E-Defter Yapısında Hata. 2091 E-Defter Oluşturma İşlemi Devam Ediyor. 2092 Sertifikalar Eşleşmiyor. 2093 İmzalama Hatalı. 2094 Amount Değeri Bir Sayı Olmalıdır. 2095 EnteredDate alanı hatalı formatta. 2096 E-Defter Gönderme İşlemi Devam Etmektedir. 2097 GİB'ten Sorgulanamadı. 2098 Hesap Dönemi 12 Aydan Oluşmalıdır. 2099 Defter Statusu Güncellenirken Hata Oluştu. 2100 Seri ve Belge Yılı Uyuşmazlığı. 2101 Rapor Hatalı Olması Durumunda E-Adisyon İptal Edilemez. [PreviousAPI Anahtarı Üretimi](https://developer.nilvera.com/api-anahtari-uretimi) [NextGENEL API](https://developer.nilvera.com/api/genel-api) Last updated 2 years ago --- # Firmaya Sertifika Ekler | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/firma-islemleri/firmaya-sertifika-ekler.md) . Copy On this page ### [](https://developer.nilvera.com/api/genel-api/firma-islemleri/firmaya-sertifika-ekler#post-company-certificate) Firmaya sertifika ekler. post/general/Company/Certificate Authorizations Bearer Bearer HTTPRequired API anahtar� giriniz Body application/json-patch+json application/json-patch+jsonapplication/jsontext/jsonapplication/\*+json SerialNostring · nullableOptional StartDatestring · date-time · nullableOptional EndDatestring · date-time · nullableOptional Typestring · enumOptionalPossible values: `MALIMUHUR``EIMZA``HSM` Passwordstring · nullableOptional Descriptionstring · nullableOptional Responses 200 Firmaya sertifika ekler. application/json booleanOptional 400 Geçersiz İstek | Gönderdiğiniz istekte geçersiz veriler bulunduğu anlamında gelmektedir | Detaylar için tıklayınız 403 Yetkisiz Erişim | Bu uca erişmek için gerekli yetkiye sahip olmadığınız durumda dönülür 404 Parametrede belirtilen kayıt bulunamadığında dönülür | Detaylar için tıklayınız post/Company/Certificate HTTP HTTPcURLJavaScriptPython Copy POST /general/Company/Certificate HTTP/1.1 Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json-patch+json Accept: */* Content-Length: 153 { "SerialNo": "text", "StartDate": "2026-07-22T10:39:17.201Z", "EndDate": "2026-07-22T10:39:17.201Z", "Type": "MALIMUHUR", "Password": "text", "Description": "text" } application/json-patch+json application/json-patch+jsonapplication/jsontext/jsonapplication/\*+json 200 Firmaya sertifika ekler. Copy true C# PHP - cURL NodeJs - Axios Copy var options = new RestClientOptions("https://apitest.nilvera.com") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("/general/Company/Certificate", Method.Post); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Authorization", "APIKEY"); var body = new { SerialNo = "string", StartDate = DateTime.Parse("2024-07-04T08:15:04.102Z"), EndDate = DateTime.Parse("2024-07-04T08:15:04.102Z"), Type = "MALIMUHUR", Password = "string", Description = "string" }; request.AddJsonBody(body); RestResponse response = await client.ExecuteAsync(request); Console.WriteLine(response.Content); Copy 'https://apitest.nilvera.com/general/Company/Certificate', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS =>'{ "SerialNo": "string", "StartDate": "2024-07-04T08:15:04.102Z", "EndDate": "2024-07-04T08:15:04.102Z", "Type": "MALIMUHUR", "Password": "string", "Description": "string" }', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json', 'Authorization: APIKEY' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; Copy const axios = require('axios'); let data = JSON.stringify({ "SerialNo": "string", "StartDate": "2024-07-04T08:15:04.102Z", "EndDate": "2024-07-04T08:15:04.102Z", "Type": "MALIMUHUR", "Password": "string", "Description": "string" }); let config = { method: 'post', maxBodyLength: Infinity, url: 'https://apitest.nilvera.com/general/Company/Certificate', headers: { 'Content-Type': 'application/json', 'Authorization': 'APIKEY' }, data : data }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); [PreviousFirma Sertifikalarını Getirir](https://developer.nilvera.com/api/genel-api/firma-islemleri/firma-sertifikalarini-getirir) [NextFirma Sertifikasını Günceller](https://developer.nilvera.com/api/genel-api/firma-islemleri/firma-sertifikasini-gunceller) Last updated 1 year ago --- # Firma Sertifikasını Günceller | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/firma-islemleri/firma-sertifikasini-gunceller.md) . Copy On this page ### [](https://developer.nilvera.com/api/genel-api/firma-islemleri/firma-sertifikasini-gunceller#put-company-certificate) Firma sertifikasını günceller. put/general/Company/Certificate Authorizations Bearer Bearer HTTPRequired API anahtar� giriniz Body application/json-patch+json application/json-patch+jsonapplication/jsontext/jsonapplication/\*+json IDinteger · int32Optional SerialNostring · nullableOptional StartDatestring · date-time · nullableOptional EndDatestring · date-time · nullableOptional Typestring · enumOptionalPossible values: `MALIMUHUR``EIMZA``HSM` Passwordstring · nullableOptional Descriptionstring · nullableOptional Responses 200 Firma sertifikasını günceller. application/json booleanOptional 400 Geçersiz İstek | Gönderdiğiniz istekte geçersiz veriler bulunduğu anlamında gelmektedir | Detaylar için tıklayınız 403 Yetkisiz Erişim | Bu uca erişmek için gerekli yetkiye sahip olmadığınız durumda dönülür 404 Parametrede belirtilen kayıt bulunamadığında dönülür | Detaylar için tıklayınız put/Company/Certificate HTTP HTTPcURLJavaScriptPython Copy PUT /general/Company/Certificate HTTP/1.1 Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json-patch+json Accept: */* Content-Length: 160 { "ID": 1, "SerialNo": "text", "StartDate": "2026-07-22T10:25:41.483Z", "EndDate": "2026-07-22T10:25:41.483Z", "Type": "MALIMUHUR", "Password": "text", "Description": "text" } application/json-patch+json application/json-patch+jsonapplication/jsontext/jsonapplication/\*+json 200 Firma sertifikasını günceller. Copy true C# PHP - cURL NodeJs - Axios Copy var options = new RestClientOptions("https://apitest.nilvera.com") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("/general/Company/Certificate", Method.Put); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Authorization", "APIKEY"); var body = new { ID = 0, SerialNo = "string", StartDate = DateTime.Parse("2024-07-04T08:17:14.738Z"), EndDate = DateTime.Parse("2024-07-04T08:17:14.738Z"), Type = "MALIMUHUR", Password = "string", Description = "string" }; request.AddJsonBody(body); RestResponse response = await client.ExecuteAsync(request); Console.WriteLine(response.Content); Copy 'https://apitest.nilvera.com/general/Company/Certificate', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'PUT', CURLOPT_POSTFIELDS =>'{ "ID": 0, "SerialNo": "string", "StartDate": "2024-07-04T08:17:14.738Z", "EndDate": "2024-07-04T08:17:14.738Z", "Type": "MALIMUHUR", "Password": "string", "Description": "string" }', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json', 'Authorization: APIKEY' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; Copy const axios = require('axios'); let data = JSON.stringify({ "ID": 0, "SerialNo": "string", "StartDate": "2024-07-04T08:17:14.738Z", "EndDate": "2024-07-04T08:17:14.738Z", "Type": "MALIMUHUR", "Password": "string", "Description": "string" }); let config = { method: 'put', maxBodyLength: Infinity, url: 'https://apitest.nilvera.com/general/Company/Certificate', headers: { 'Content-Type': 'application/json', 'Authorization': 'APIKEY' }, data : data }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); [PreviousFirmaya Sertifika Ekler](https://developer.nilvera.com/api/genel-api/firma-islemleri/firmaya-sertifika-ekler) [NextSeri Numarasına Göre Sertifika Getirir](https://developer.nilvera.com/api/genel-api/firma-islemleri/seri-numarasina-gore-sertifika-getirir) Last updated 1 year ago --- # Kampanya | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/kampanya.md) . [Kampanyaları Getirir](https://developer.nilvera.com/api/genel-api/kampanya/kampanyalari-getirir) [PreviousKullanıcıya Tanımlı Firmaları Getirir](https://developer.nilvera.com/api/genel-api/firma-islemleri/kullaniciya-tanimli-firmalari-getirir) [NextKampanyaları Getirir](https://developer.nilvera.com/api/genel-api/kampanya/kampanyalari-getirir) --- # Kampanyaları Getirir | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/kampanya/kampanyalari-getirir.md) . Copy On this page ### [](https://developer.nilvera.com/api/genel-api/kampanya/kampanyalari-getirir#get-campaigns) Kampanyaları getirir. get/general/Campaigns Authorizations Bearer Bearer HTTPRequired API anahtar� giriniz Responses 200 OK application/json Namestring · nullableOptional CreatedDatestring · date-timeOptional EndDatestring · date-timeOptional Contentstring · nullableOptional Subjectstring · nullableOptional IsActivebooleanOptional Urlstring · nullableOptional get/Campaigns HTTP HTTPcURLJavaScriptPython Copy GET /general/Campaigns HTTP/1.1 Authorization: Bearer YOUR_SECRET_TOKEN Accept: */* 200 OK Copy [\ {\ "Name": "text",\ "CreatedDate": "2026-07-22T10:28:09.290Z",\ "EndDate": "2026-07-22T10:28:09.290Z",\ "Content": "text",\ "Subject": "text",\ "IsActive": true,\ "Url": "text"\ }\ ] C# PHP - cURL NodeJs - Axios Copy var options = new RestClientOptions("https://apitest.nilvera.com") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("/general/Campaigns", Method.Get); request.AddHeader("Authorization", "APIKEY"); RestResponse response = await client.ExecuteAsync(request); Console.WriteLine(response.Content); Copy 'https://apitest.nilvera.com/general/Campaigns', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => array( 'Authorization: APIKEY' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; Copy const axios = require('axios'); let config = { method: 'get', maxBodyLength: Infinity, url: 'https://apitest.nilvera.com/general/Campaigns', headers: { 'Authorization': 'APIKEY' } }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); [PreviousKampanya](https://developer.nilvera.com/api/genel-api/kampanya) [NextFirma Kimlik Bilgileri](https://developer.nilvera.com/api/genel-api/firma-kimlik-bilgileri) Last updated 1 year ago --- # Firma Kimlik Bilgileri | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/firma-kimlik-bilgileri.md) . Firmaya ait kimlik bilgilerini (MersisNo,SicilNo vb.) sorgulama ve güncelleme işlemlerini buradan yapabilirsiniz. [PreviousKampanyaları Getirir](https://developer.nilvera.com/api/genel-api/kampanya/kampanyalari-getirir) [NextFirma Kimlik Bilgilerini Listeler](https://developer.nilvera.com/api/genel-api/firma-kimlik-bilgileri/firma-kimlik-bilgilerini-listeler) --- # Müşteriler | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/musteriler.md) . Firmanın müşterileri ile ilgili sorgulama, ekleme, silme veya güncelleme işlemlerini bu kısımda yapabilirsiniz. [PreviousKredi Bilgileri Getirir](https://developer.nilvera.com/api/genel-api/kredi/kredi-bilgileri-getirir) [NextMüşteri Listeler](https://developer.nilvera.com/api/genel-api/musteriler/musteri-listeler) --- # Kredi | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/kredi.md) . Firmanın kontör bilgilerinin sorgulandığı kısımdır. [PreviousFirmadan Kimlik Bilgisi Siler](https://developer.nilvera.com/api/genel-api/firma-kimlik-bilgileri/firmadan-kimlik-bilgisi-siler) [NextKredi Bilgileri Getirir](https://developer.nilvera.com/api/genel-api/kredi/kredi-bilgileri-getirir) --- # Müşteri Ekler | Nilvera API v1 For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt) . This page is also available as [Markdown](https://developer.nilvera.com/api/genel-api/musteriler/musteri-ekler.md) . Copy On this page ### [](https://developer.nilvera.com/api/genel-api/musteriler/musteri-ekler#post-customers) Müşteri ekler. post/general/Customers Authorizations Bearer Bearer HTTPRequired API anahtar� giriniz Bodyobject · CustomerDto\[\] application/json-patch+json application/json-patch+jsonapplication/jsontext/jsonapplication/\*+json TaxNumberstring · nullableOptional Namestring · nullableOptional TaxDepartmentstring · nullableOptional Addressstring · nullableOptional Countrystring · nullableOptional Citystring · nullableOptional Districtstring · nullableOptional PostalCodestring · nullableOptional Phonestring · nullableOptional Faxstring · nullableOptional Emailstring · nullableOptional WebSitestring · nullableOptional IsExportbooleanOptional Responses 200 Müşteri ekler. application/json stringOptional 400 Geçersiz İstek | Gönderdiğiniz istekte geçersiz veriler bulunduğu anlamında gelmektedir | Detaylar için tıklayınız 403 Yetkisiz Erişim | Bu uca erişmek için gerekli yetkiye sahip olmadığınız durumda dönülür 404 Parametrede belirtilen kayıt bulunamadığında dönülür | Detaylar için tıklayınız post/Customers HTTP HTTPcURLJavaScriptPython Copy POST /general/Customers HTTP/1.1 Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json-patch+json Accept: */* Content-Length: 221 [\ {\ "TaxNumber": "text",\ "Name": "text",\ "TaxDepartment": "text",\ "Address": "text",\ "Country": "text",\ "City": "text",\ "District": "text",\ "PostalCode": "text",\ "Phone": "text",\ "Fax": "text",\ "Email": "text",\ "WebSite": "text",\ "IsExport": true\ }\ ] application/json-patch+json application/json-patch+jsonapplication/jsontext/jsonapplication/\*+json 200 Müşteri ekler. Copy text C# PHP - cURL NodeJs - Axios Copy var client = new RestClient("https://apitest.nilvera.com/general/Customers"); client.Timeout = -1; var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); var body = @"["TaxNumber": "string",\ "Name": "string",\ "TaxDepartment": "string",\ "Address": "string",\ "Country": "string",\ "City": "string",\ "District": "string",\ "PostalCode": "string",\ "Phone": "string",\ "Fax": "string",\ "Email": "string",\ "WebSite": "string",\ "IsExport"": true]"; request.AddParameter("application/json", body, ParameterType.RequestBody); IRestResponse response = client.Execute(request); Console.WriteLine(response.Content); Copy 'https://apitest.nilvera.com/general/Customers', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS =>'[\ {\ "TaxNumber": "string",\ "Name": "string",\ "TaxDepartment": "string",\ "Address": "string",\ "Country": "string",\ "City": "string",\ "District": "string",\ "PostalCode": "string",\ "Phone": "string",\ "Fax": "string",\ "Email": "string",\ "WebSite": "string",\ "IsExport": true\ }\ ]', CURLOPT_HTTPHEADER => array( 'Authorization: Bearer ', 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; Copy var axios = require('axios'); var data = JSON.stringify([\ {\ "TaxNumber": "string",\ "Name": "string",\ "TaxDepartment": "string",\ "Address": "string",\ "Country": "string",\ "City": "string",\ "District": "string",\ "PostalCode": "string",\ "Phone": "string",\ "Fax": "string",\ "Email": "string",\ "WebSite": "string",\ "IsExport": true\ }\ ]); var config = { method: 'post', url: 'https://apitest.nilvera.com/general/Customers', headers: { 'Authorization': 'Bearer ', 'Content-Type': 'application/json' }, data : data }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); }); [PreviousMüşteri Listeler](https://developer.nilvera.com/api/genel-api/musteriler/musteri-listeler) [NextMüşteri Günceller](https://developer.nilvera.com/api/genel-api/musteriler/musteri-gunceller) Last updated 1 year ago ---