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

KodAçı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.

3019

No Invoice Found to Report.

3020

E-Storage Module Not Found.

3021

E-Ledger Settings Not Found.

3022

Accountant Information Not Found.

3023

Certificate Information Not Found.

3024

Company Erp Setting Area Not Found.

3025

E-Ledger Query Not Found.

3026

E-Ledger report could not be found.

3027

E-Ledger Signature Value Not Found.

3028

Fiscal Period Incorrect.

3029

Design Module Was Not Found.

3030

API Not Found.

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

KodAçı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.

1019

E-Bill Series Has Been Used Before.

1020

E-Bill Was Added 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.

KodAçı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.

2080

E-Bill Has Been Canceled Before.

2081

If The File İs İn The Queue Or İts Status İs Unknown, E-Bill Cannot Be Cancelled.

2082

E-Bill Cancellation Record Could Not Be Created. Please Try Again Later.

2083

E-Bill Whose Cancellation Record Is Requested To Be Withdrawn Has Been Reported.

2084

E-Bill Cancellation Record Could Not Be Reversed. Please try again later.

2085

E-Bill Series is Not Active.

2086

E-Bill Serial Field Cannot Be Blank.

2087

PDF File Could Not Be Read.

2088

E-Ledger Has Been Created Before.

2089

Error While Creating E-Ledger.

2090

Error in E-Ledger Structure.

2091

E-Ledger Creation Process Continues.

2092

Certificates Do Not Match.

2093

Signing Incorrect.

2094

Amount Value Must Be a Number.

2095

EnteredDate Field is in Incorrect Format.

2096

E-Ledger Sending Process Continues.

2097

GIB not be Questioned.

2098

Accounting Period Must Consist of 12 Months.

2099

An Error Occurred While Updating Ledger Status.

2100

Series and Document Year Mismatch.

2101

E-Bill Cannot Be Cancelled If the Report Is Erroneous.

Last updated