Error Codes

200 - OK

HTTP 200 status code indicates that the request was successful.

401 - Unauthorized

In this case, authorization is required to access the received response.

403 - Forbidden

It means the user doesn't have any authorization over the resource in question.

500, 502, 503, 504 - Server Errors

It indicates that the server does not support or lacks the requirements needed to fulfill the specific request.

BadRequest - 400

"When you receive a return from the service with a 400 HTTP code, it means that there are invalid data in the request you sent. In this case, you need to review your request parameters."

Örnek Dönüş

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

NotFound - 404

When you receive a return from the service with a 404 HTTP code, it means that there is no record corresponding to the request you sent.

Örnek Dönüş

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

404 Dönebilecek Diğer Kodlar

Kod	Açıklama
3000	Tag for the Recipient Not Found.
3001	Tag for the Sender Not Found.
3002	The label is not registered in the system.
3003	The document could not be found in the system.
3004	The record could not be found in the system.
3005	Document content is empty.
3006	The report could not be found in the system.
3007	No invoice found to report.
3008	No receipt found to report.
3009	The series is not defined for the company.
3010	Template not found.
3011	Template is not active.
3012	There are no templates defined for the company.
3013	Your email module is not active.
3014	Your WhatsApp module is not active.
3015	Your SMS module is not active.
3016	The company is not defined for the dealer.
3017	You do not have a package with this code.
3018	There is no sub-dealer with the specified code.

Conflict - 409

When you receive a 409 HTTP code from the service, it means that the request you sent already exists in the system.

Örnek Dönüş

{
  "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."
    }
  ]
}

409 Dönebilecek Diğer Kodlar

Kod	Açıklama
1000	The sent Tax Identification Number (TIN) does not match the company.
1001	The ETTN number is registered in the system.
1002	Mismatched OperationType information.
1003	The e-invoice has been automatically accepted.
1004	E-invoice has been previously added.
1005	The e-invoice series has been used before.
1006	Responses to basic invoices are not provided.
1007	The e-invoice has been responded to before.
1008	The e-waybill has been automatically accepted.
1009	The e-waybill has been added before.
1010	The e-waybill series has been used before.
1011	The e-waybill has been responded to before.
1012	The e-archive invoice has been added before.
1013	The e-Voucher has been added before.
1014	E-Producer Daha Önce Eklenmiş.
1015	The record has been added before.
1016	The company has a storage package defined for the specified year.
1017	The e-Voucherseries has been used before.
1018	The e-Producerseries has been used before.

UnprocessableEntity - 422

When you receive a 422 HTTP code from the service, it means that the request you sent is valid, but it contains invalid values according to business rules.

Örnek Dönüş

{
  "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."
    }
  ]
}

422 Dönebilecek Diğer Kodlar

For example, if you try to create an e-invoice for a tax number belonging to the public sector, you will receive a 422 error stating "Invoice Scenario Must Be PUBLIC". Below is a list of detail codes and the list of codes that may be returned for the errors returned from the service with a 422 code.

Kod	Açıklama
2000	You do not have sufficient credits.
2001	An error occurred while adding company information.
2002	Your storage space is insufficient. Please upgrade to a higher package.
2003	An error occurred while fetching branches.
2004	Registration unsuccessful.
2005	File upload failed.
2006	Template update failed.
2007	The document could not be opened. (Unzip)
2008	The document could not be deserialized.
2009	Document processing error.
2010	Error occurred while fetching document attachments.
2011	An error occurred while creating a new envelope.
2012	The document could not be read.
2013	Deletion unsuccessful.
2014	PDF file could not be generated.
2015	Schema/Schematron error.
2016	An error occurred while fetching statistics.
2017	Incompatible FileType information.
2018	Invalid value for SEND_TYPE.
2019	Transaction count cannot exceed 100.
2020	Incompatible file content.
2021	Error occurred while fetching exchange rates.
2022	Error occurred while updating.
2023	Preview could not be generated.
2024	The document scenario must be EARSIVBELGE.
2025	The recipient is an e-invoice taxpayer. E-archive invoice cannot be sent.
2026	The e-archive invoice has been previously cancelled.
2027	The e-archive invoice cannot be cancelled if the report is faulty.
2028	The e-archive invoice cannot be cancelled if the file is in the queue or its status is unknown.
2029	Cancellation record for the e-archive invoice could not be created. Please try again later.
2030	The cancellation record is requested for an e-archive invoice that has been reported.
2031	The cancellation record for the e-archive invoice could not be reversed. Please try again later.
2032	The e-archive invoice series is not active.
2033	The e-archive invoice series field cannot be left empty.
2034	E-Voucher Has Been Canceled Before.
2035	E-Voucher Cannot Be Cancelled If the Report Is Erroneous.
2036	E-Voucher cannot be canceled if the file is in the queue or its status is unknown.
2037	E-Voucher Cancellation Record Could Not Be Created. Please Try Again Later.
2038	The E-Voucher whose cancellation record is requested to be withdrawn has been reported.
2039	E-Voucher Cancellation Record Could Not Be Retrieved. Please try again later.
2040	E-Voucher Series Not Active.
2041	E-Voucher Serial Field Cannot Be Empty.
2042	E-Producer Has Been Canceled Before.
2043	If the file is in the queue or its status is unknown, E-Producer cannot be cancelled.
2044	E-Producer Cancellation Record Could Not Be Created. Please Try Again Later.
2045	The E-Producer whose cancellation record is requested to be withdrawn has been reported.
2046	E-Producer Cancellation Record Could Not Be Retrieved. Please try again later.
2047	E-Producer Series Inactive.
2048	E-Producer Serial Field Cannot Be Empty.
2049	The Report Cannot Be Questioned.
2050	Error Creating Report.
2051	The Sender is not an E-Invoice Payer.
2052	Buyer's Label is Not in Use.
2053	The Buyer Became an E-Invoice Taxpayer on This Date.
2054	The Buyer is Not an E-Invoice Payer.
2055	Recipient's Label Must Be Entered.
2056	Buyer's Label is in Use.
2057	An Error Occurred While Fetching E-Invoice Labels.
2058	E-Invoice must be prepared as a paper or e-archive invoice.
2059	E-Invoice Scenario Must Be Public.
2060	Invoice Scenario Must Be E-Archive Invoice.
2061	E-Invoice Scenario Should Not Be Public.
2062	E-Invoice Response Could Not Be Updated.
2063	Since the Invoice Scenario is an E-Archive Invoice, it cannot be sent to the E-Invoice Ender.
2064	E-Invoice Series is Not Active.
2065	E-Invoice Serial Field Cannot Be Blank.
2066	The Sender is not an E-Delivery Note Taxpayer.
2067	The Buyer Became an E-Delivery Note Taxpayer on This Date.
2068	The Document Cannot Be Sent to the Virtual Recipient.
2069	The Document Must Be Sent to the Virtual Recipient. (urn:mail:defaultpk@gib.gov.tr)
2070	An Error Occurred While Fetching E-Delivery Note Labels.
2071	Delivery Note Not Waiting for Response.
2072	Delivery Note Scenario Must Be 'TEMELIRSALIYE' or 'HKSIRSALIYE'.
2073	E-Delivery Note Series is Inactive.
2074	E-Delivery Note Serial Field Cannot Be Blank.
2075	Your Top Up Package Has Expired.
2076	Your Storage Package is Expired.
2077	You do not have enough packages.
2078	Your Credit Package Does Not Have Enough Credit.
2079	E-Producer Cannot Be Cancelled If the Report Is Erroneous.

PreviousAPI Key Generation NextGENERAL API

Last updated 20 days ago