Nilvera API v1
Swagger APIGo To App
English
English
  • Overview
  • API Key Generation
  • Error Codes
  • API
    • GENERAL API
      • Company Procedures
        • Retrieve Company Information
        • Update Company Information
        • Retrieve Company Modules
      • Company Identity Information
        • Lists Company Identity Information
        • Adds New Identity Information to the Company
        • Deletes Identity Information from the Company
      • Credit
        • Returns Credit Information
      • Customers
        • Customer Lists
        • Customer Adds
        • Customer Updates
        • Customer Deletes
        • Searches the Customer List
        • Brings Customer Information
      • Currency Information
        • Brings Foreign Exchange Information
      • GIB User Information
        • Gets GIB Username and Password
        • GİB Updates Username and Password
      • Taxpayer Transactions
        • Lists E-Invoice Taxpayers
        • Searches the Taxpayer List
        • Brings Taxpayer Information
        • Brings Taxpayer Information in List
        • Queries with TIN
        • Queries by Title
        • Taxpayer List is Returned as a Zip File
      • Mail Transactions
        • Brings up Mail Settings
        • Changes Whatsapp Feature
        • Changes Mail Feature
        • Changes SMS Feature
      • Stocks
        • Lists Stocks
        • Stock Inserts
        • Stock Updates
        • Brings Stock
        • Searches the Stock List
        • Deletes Stock
    • E-INVOICE API
      • Sending E-Invoice
        • Send the Invoice as a Model
        • Preview the Invoice to be Sent as a Model
        • Send the Invoice as XML
        • Preview the Invoice to be Sent as XML
        • Send the Invoice as Base64 String
        • Preview the Invoice to be Sent as Base64 String
        • Retrieve the XML of the Previewed Invoice
        • Download the PDF of the Previewed Invoice
      • Draft Invoices
        • List Draft Invoices
        • Delete Draft Invoices
        • Retrieve the HTML of the Draft
        • Retrieve the PDF of the Draft
        • Retrieve the XML of the Draft
        • Retrieve the Model of the Draft
        • Assign Tags to Draft Invoice
        • Retrieve Tag Information of the Draft Invoice
        • Export Drafts in Bulk
        • Assign New Status to Drafts
        • Approve and Send the Draft
        • Edit and Send the Draft
        • Create Draft
        • Create Bulk Draft Invoices
        • Retrieve WhatsApp Transaction History
        • Send Draft Invoice via WhatsApp
        • Assign Custom Code to Draft Invoice
      • Notification Settings
        • List Sales Invoice Notification Settings
        • Create Sales Invoice Notification Rule
        • Update Sales Invoice Notification
        • Delete Sales Invoice Notification Setting
        • Retrieve Sales Invoice Notification Rule
        • List Purchase Invoice Notification Settings
        • Create Purchase Invoice Notification Rule
        • Update Purchase Invoice Notification
        • Delete Purchase Invoice Notification Setting
        • Retrieve Purchase Invoice Notification Rule
      • Old Invoices
        • List Old Invoices
        • Upload Old Invoices
        • Retrieve the HTML of the Old Invoice
        • Retrieve the PDF of the Old Invoice
        • Retrieve the XML of the Old Invoice
        • Export Old Invoices in Bulk
        • Assign New Status to Old Invoices
      • Incoming Invoices
        • List Incoming Invoices
        • Retrieve the HTML of the Invoice
        • Retrieve the PDF of the Invoice
        • Retrieve the XML of the Invoice
        • Assign Tags to Invoice
        • Retrieve Tag Information of the Invoice
        • Retrieve Transaction History
        • Retrieve Details
        • List Invoice Attachments
        • Retrieve Despatch Note Information
        • Retrieve Email Transaction History
        • Retrieve WhatsApp Transaction History
        • Retrieve SMS Transaction History
        • Retrieve Email Activities
        • Export Invoices in Bulk
        • Assign New Status to Invoices
        • Send the Invoice via Email
        • Send the Invoice via WhatsApp
        • Send the Invoice via SMS
        • Verify the Invoice with GİB
        • Retrieve Envelope Information with ETTN Number for the Invoice
        • Save as Draft
        • Respond to the Invoice
        • Retrieve Rejection Response of the Invoice
        • Save the Incoming Invoice as a Return Invoice
        • Retrieve Status Information of the Incoming Invoice
        • Assign Custom Code to Invoice
      • Outgoing Invoices
        • Lists Outgoing Invoices
        • Get the HTML of the Invoice
        • Get the PDF of the Invoice
        • Get the XML of the Invoice
        • Assigns Tags To The Invoice
        • It Fetches The Invoice Label Information
        • Retrieve Transaction History
        • Brings Details
        • Lists the Attachments of the Invoice
        • Retrieves the Despatch Note Information
        • Retrieves Email Transaction History
        • Retrieves WhatsApp Transaction History
        • Retrieves SMS Transaction History
        • Retrieves Email Activities
        • Exports Invoices in Bulk
        • Sets New Status to Invoices
        • Sends the Invoice via Email
        • Sends the Invoice via WhatsApp
        • Sends the Invoice via SMS
        • Checks the Invoice from GTB
        • Checks the Invoice from GİB
        • Retrieves Envelope Information with the ETTN Number of the Invoice
        • Save as Draft
        • Creates Drafts for Invoices in Bulk
        • Retrieves the Rejection Response of the Invoice
        • Retrieves the Status Information of the Outgoing Invoice
        • Assigns a Custom Code to the Invoice
      • Series
        • Lists Series
        • Creates New Series
        • Updates Series
        • Brings Details of the Series
      • Statistics
        • Returns Outgoing Invoice Statistics
        • Returns Incoming Invoice Statistics
        • Returns the Last 10 Records of Outgoing Invoices
        • Returns the Last 10 Records of Incoming Invoices
      • Tags
        • Get Tag List
        • Create Tag
        • Update Tag
        • Delete Tag
      • Templates
        • Lists Templates
        • Creates Template
        • Updates Template
        • Gets the Details of the Template
        • Delete Template
        • Get Template
      • File Upload
        • Load as XML
        • Uploads SGK Invoice as PDF
    • E-ARCHIVE INVOICE API
      • Sending an Invoice
        • Sends Invoice as Model
        • Previews the Invoice to be Sent as a Model
        • Sends Invoice as Xml
        • Previews the Invoice to be Sent as XML
        • Sends Invoice as Base64String
        • Previews the Invoice to be Sent as Base64
        • Gets the Xml of the Previewed Invoice
        • Downloads Previewed Invoice as PDF
        • Sends Report of Invoices.
      • Draft Invoices
        • Lists Draft Invoices
        • Deletes Draft Invoices
        • Bring HTML of the Draft
        • Bring PDF of the Draft
        • Bring XML of the Draft
        • Bring Model of the Draft
        • Tag Assignment to Draft Invoice
        • Gets the Tag Information of the Draft Invoice
        • Bulk Exports Drafts
        • Assigns New Status to Drafts
        • Approves and Sends the Draft
        • Edit and Send the Draft
        • Creates Draft
        • Creates Bulk Draft Invoice
        • Brings Whatsapp Transaction History
        • Sends Draft Invoice via Whatsapp
        • A Special Code is Assigned to the Draft Invoice
      • Incoming E-Archive Invoices
      • Notification Settings
        • Lists Notification Rules
        • Creates Notification Rule
        • Updates Notification Rule
        • Deletes Notification Rule
        • Bring the Notification Rule
      • E-Archive Invoices
        • Lists Invoices
        • Get the HTML of the Invoice
        • Get the PDF of the Invoice
        • Get the XML of the Invoice
        • Tag Assignment to the Invoice
        • Gets Tag Information of the Invoice
        • Gets Transaction History
        • Brings Details
        • Lists Document Attachments
        • Returns Delivery Note Information
        • Brings Mail Transaction History
        • Brings Whatsapp Transaction History
        • Gets SMS Transaction History
        • Gets Email Activities
        • Exports Invoices in Bulk
        • Assigns New Status to Invoices
        • Sends the Invoice via Email
        • Sends the Invoice via Whatsapp
        • Sends Invoice via SMS
        • Saves as Draft
        • Bulk Drafts Outgoing Invoices
        • Cancels the Invoice
        • Undoes Invoice Cancellation
        • Returns the Status Information of the Invoice
        • A Special Code is Assigned to the Invoice
      • Old Invoices
        • Lists Old Invoices
        • Upload Old Invoices
        • Get the HTML of the Old Invoice
        • Get the PDF of the Old Invoice
        • Get the XML of the Old Invoice
        • Bulk Exports Old Invoices
        • Assigns New Status to Old Invoices
      • Reports
        • Brings Reports
        • Returns the List to Create a Report
        • Gets Report Xml
        • Lists the Documents in the Sent Report
        • Report Returns Transaction History
        • Queries Report Status from GİB
      • Series
        • Lists Series
        • Creates New Series
        • Updates Series
        • Brings Details of the Series
      • Templates
        • Lists Templates
        • Creates Template
        • Updates Template
        • Gets the Details of the Template
        • Deletes Template
        • Downloads Template
      • Statistics
        • Gets Statistics of Invoices
        • Gets the last 10 invoices
      • Tags
        • Gets Tag List
        • Creates Tag
        • Tag Updated
        • Tag Deleted
      • File Upload
        • Upload as XML File
    • E-DESPATCH API
      • Sending Despatch
        • Sends the Despatch as a Model
        • It Sends the Despatch as XML.
        • Sends the Despatch as Base64String
        • Previews the Despatch to be Sent
        • Returns the XML of the Previewed Despatch
      • Draft Despatch
        • Lists Draft Despatch
        • Deletes Draft Despatch
        • HTML of the draft is fetched
        • PDF of the draft is brought
        • XML of the draft is fetched
        • The Model of the Draft is Fetched
        • Bulk Exports Drafts
        • Assigns New Status to Drafts
        • Approves and Sends the Draft
        • Edit and Send the Draft
        • Creates Draft
        • Brings Whatsapp Transaction History
        • Sends Draft Despatch via Whatsapp
      • Outgoing Despatch
        • Lists Outgoing Despatch
        • Get Despatch HTML
        • Get HTML of Despatch Response
        • Get Despatch PDF
        • Get PDF of Despatch Response
        • Get XML of Despatch
        • Get XML of Despatch Response
        • Gets Transaction History
        • Brings Details
        • Lists Document Attachments
        • Returns the Status Information of the Outgoing Despatch
        • Brings Mail Transaction History
        • Brings Whatsapp Transaction History
        • Gets Email Activities
        • Exports Despatch in Bulk
        • Bulk Exports Despatch Responses
        • Assigns a New Status to Despatch
        • Sends the Despatch via e-mail
        • Sends the Despatch via Whatsapp
        • Controls the Despath from the GIB
        • Saves as Draft
      • Incoming Despatch
        • Lists Incoming Despatch
        • Get the HTML of the Despatch
        • Get HTML of Despatch Response
        • Get PDF of Despatch
        • Get PDF of Despatch Response
        • Get XML of Despatch
        • Get XML of Despatch Response
        • Gets Transaction History
        • Brings Details
        • Lists Document Attachments
        • Returns the Status Information of the Incoming Despatch
        • Brings Mail Transaction History
        • Brings Whatsapp Transaction History
        • Gets Email Activities
        • Exports Despatch in Bulk
        • Bulk Exports Despatch Responses
        • Assigns a New Status to Despatch
        • Sends the Despatch via e-mail
        • Sends the Despatch via Whatsapp
        • Controls the Despatch from the GİB
        • Saves as Draft
        • Creates a Response to the Despatch
        • Brings Despatch Items
      • Series
        • Lists Series
        • Creates New Series
        • Updates Series
        • Brings Details of the Series
      • Templates
        • Lists Templates
        • Creates Template
        • Updates Template
        • Gets the Details of the Template
        • Deletes Template
        • Gets Template
      • Statistics
        • Returns Outgoing Despatch Statistics
        • Returns Incoming Despatch Statistics
      • File Upload
        • Loads as XML
    • E-PRODUCER API
      • Sending E-Producer Receipt
        • Sends Receipt as Model
        • Sends the receipt as XML
        • Previews the Receipt to Send
        • Gets XML of Previewed Receipt
        • Sends Report
      • Draft Producer
        • Lists Draft Producer
        • Deletes Draft Producer
        • Get HTML of Draft
        • Get PDF of Draft
        • Get XML of Draft
        • Get Model of Draft
        • Bulk Exports Drafts
        • Assigns New Status to Drafts
        • Approves and Sends the Draft
        • Edit and Send the Draft
        • Creates Draft
        • Brings Whatsapp Transaction History
        • Sends Draft Producer Via Whatsapp
      • Producer
        • Lists Producers
        • Get Producer HTML
        • Get Producer PDF
        • Get Producer XML
        • Gets Transaction History
        • Brings Details
        • Brings Mail Transaction History
        • Brings Whatsapp Transaction History
        • Gets Email Activities
        • Bulk Exports Producers
        • Assigns New Status to Producers
        • Sends Producer via Email
        • Sends Producer Via Whatsapp
        • Saves as Draft
        • Cancel Producer
        • Undoes Producer Cancellation
      • Reports
        • Brings Reports
        • Returns the List to Create a Report
        • Gets Report XML
        • Lists the Documents in the Sent Report
        • Report Returns Transaction History
        • Queries Report Status from GİB
      • Series
        • Lists Series
        • Creates New Series
        • Updates Series
        • Brings Details of the Series
      • Templates
        • Lists Templates
        • Creates Template
        • Updates Template
        • Gets the Details of the Template
        • Deletes Template
        • Gets Template
      • Statistics
        • Brings Statistics
      • File Upload
        • Uploads as XML
    • E-INSURANCE API
      • Sending E-Insurance Document
        • Sends the document as Model
        • Previews the document to Send
        • Sends the document as XML
        • Previews the document to Send
        • Sends Document as Base64
        • Previews the document to Send
        • Gets XML of Previewed Document
        • Sends Report
      • Notification Settings
        • Lists Document Notification Rules
        • Creates Document Notification Rule
        • Updates Document Notification Rule
        • Deletes Document Notification Rule
        • Gets Document Notification Rule
      • Draft Insurances
        • Lists Draft Insurance
        • Deletes Draft Insurance
        • Get HTML of Draft
        • Get PDF of Draft
        • Get XML of Draft
        • Get Model of Draft
        • Assigns Tag to Draft
        • Gets Tag Information of Draft
        • Bulk Exports Drafts
        • Assigns New Status to Drafts
        • Approves and Sends the Draft
        • Edit and Send the Draft
        • Creates Draft
        • Creates Bulk Draft
        • Brings Whatsapp Transaction History
        • Sends Draft Insurance Via Whatsapp
        • Assigns Custom Code to Draft Document
      • Insurance
        • Lists Insurances
        • Get Insurance HTML
        • Get Insurance PDF
        • Get Insurance XML
        • Assigns Tag to Insurance
        • Gets Tag Information of Insurance
        • Gets Transaction History
        • Brings Details
        • Brings Mail Transaction History
        • Brings Whatsapp Transaction History
        • Gets SMS Transaction History
        • Gets Email Activities
        • Bulk Exports Insurances
        • Assigns New Status to Insurances
        • Sends Insurance via Email
        • Sends Insurance Via Whatsapp
        • Sends Document via SMS
        • Saves as Draft
        • Cancel Insurance
        • Undoes Insurance Cancellation
        • Gets Status Information of Insurance
        • Assigns Special Code to Insurance
      • Reports
        • Brings Reports
        • Returns the List to Create a Report
        • Gets Report XML
        • Lists the Documents in the Sent Report
        • Report Returns Transaction History
        • Queries Report Status from GİB
      • Series
        • Lists Series
        • Creates New Series
        • Updates Series
        • Brings Details of the Series
      • Statistics
        • Brings Statistics
        • Brings Last 10 Insurances
      • Tags
        • Gets Tag List
        • Creates Tag
        • Updates Tag
        • Deletes Tag
      • Templates
        • Lists Templates
        • Creates Template
        • Updates Template
        • Gets the Details of the Template
        • Deletes Template
        • Gets Template
      • File Upload
        • Uploads as XML
    • E-VOUCHER API
      • Sending E-Voucher
        • Sends Voucher as Model
        • Sends Voucher as XML
        • Previews the Voucher to Send
        • Gets XML of Previewed Voucher
        • Sends Report
      • Draft Vouchers
        • Lists Draft Voucher
        • Deletes Draft Voucher
        • Get HTML of Draft
        • Get PDF of Draft
        • Get PDF of Draft
        • Get Model of Draft
        • Bulk Exports Drafts
        • Assigns New Status to Drafts
        • Approves and Sends the Draft
        • Edit and Send the Draft
        • Creates Draft
        • Creates Bulk Draft
        • Brings Whatsapp Transaction History
        • Sends Draft Voucher Via Whatsapp
      • Vouchers
        • Lists Vouchers
        • Get Voucher HTML
        • Get Voucher PDF
        • Get Voucher XML
        • Gets Transaction History
        • Brings Details
        • Brings Mail Transaction History
        • Brings Whatsapp Transaction History
        • Gets Email Activities
        • Bulk Exports Vouchers
        • Assigns New Status to Vouchers
        • Sends Voucher via Email
        • Sends Voucher Via Whatsapp
        • Sends Voucher Via SMS
        • Saves as Draft
        • Cancels Voucher
        • Undoes Voucher Cancellation
        • Returns Status Information of the Voucher
      • Reports
        • Brings Reports
        • Returns the List to Create a Report
        • Gets Report XML
        • Lists the Vouchers in the Sent Report
        • Report Returns Transaction History
        • Queries Report Status from GİB
      • Series
        • Lists Series
        • Creates New Series
        • Updates Series
        • Brings Details of the Series
      • Templates
        • Lists Templates
        • Creates Template
        • Updates Template
        • Gets the Details of the Template
        • Deletes Template
        • Gets Template
      • Statistics
        • Lists the Last 10 Issued Voucher
        • Brings Statistics
      • File Upload
        • Loads as XML
    • E-BILL API
      • Sending E-Bill
        • Sends Bill as Model
        • Previews the bill to Send
        • Sends Bill as XML
        • Previews the bill to Send
        • Sends Bill as Base64
        • Previews the bill to Send
        • Gets XML of Previewed Bill
        • Sends Report
      • Draft Bills
        • Lists Draft Bill
        • Deletes Draft Bill
        • Get HTML of Draft
        • Get PDF of Draft
        • Get XML of Draft
        • Get Model of Draft
        • Assigns Tag to Draft
        • Gets Tag Information of the Draft
        • Bulk Exports Drafts
        • Assigns New Status to Drafts
        • Approves and Sends the Draft
        • Edit and Send the Draft
        • Creates Draft
        • Creates Bulk Drafts
        • Gets WhatsApp Transaction History
        • Sends Draft via WhatsApp
        • Assigns Special Code to Draft
      • Notification Settings
        • Lists Document Notification Rules
        • Creates Document Notification Rule
        • Updates Document Notification Rule
        • Deletes Document Notification Rule
        • Gets Document Notification Rule
      • Bills
        • Lists Bills
        • Get HTML of Bill
        • Get PDF of Bill
        • Get XML of Bill
        • Gets Transaction History
        • Brings Details
        • Brings Mail Transaction History
        • Brings Whatsapp Transaction History
        • Gets Email Activities
        • Bulk Exports Bills
        • Assigns New Status to Bills
        • Sends Bill via Email
        • Sends Bill Via Whatsapp
        • Saves as Draft
        • Cancel Bill
        • Undoes Bill Cancellation
      • Reports
        • Brings Reports
        • Returns the List to Create a Report
        • Gets Report XML
        • Lists the Documents in the Sent Report
        • Report Returns Transaction History
        • Queries Report Status from GİB
      • Series
        • Lists Series
        • Creates New Series
        • Updates Series
        • Brings Details of the Series
      • Templates
        • Lists Templates
        • Creates Template
        • Updates Template
        • Gets the Details of the Template
        • Deletes Template
        • Gets Template
      • Tags
        • Gets Tag List
        • Creates Tag
        • Updates Tag
        • Deletes Tag
      • Statistics
        • Brings Last 10 Bills
        • Brings Statistics
      • File Upload
        • Uploads as XML
    • E-STORAGE API
      • Ledgers
        • Ledger List
        • Downloads the Ledgers
        • Previews the Ledger
        • Upload Ledger
        • Get Statistics of Ledgers
    • E-LEDGER API
      • Accountant Information
        • Accountant Creates
        • Brings Accountants
        • Accountant Deletes
        • Updates Accountant
      • Ledger Settings
        • Creates or Updates Settings
        • Get Settings
      • Company ERP Information
        • Returns Company Ledger Queries
        • Brings Defined ERP Parameters to the Company
        • Brings the Defined ERP List to the Company
      • Ledgers
        • Deletes the Ledgers
        • Brings the Ledgers
        • Downloads the Ledgers
        • Downloads the Ledgers for the Relevant Year and Month
        • Downloads Ledgers in Bulk
        • Sets Ledger Status to Success
        • Uploads Old Ledgers
        • Gets Ledger Numbers for the Relevant Year
        • Deletes Uploaded Old Ledgers
        • Downloads all Ledgers in the Relevant Year
        • Downloads CSV File in Related Year and Month
        • Downloads the Ledgers of Companies and Branches for the Relevant Year and Month
        • Displays the Ledger
        • Gets Ledger Details
        • Schema/Schematron Control is Performed on the Ledger
        • Gets Ledger History
        • Gets Total Debit and Credit Information of Ledgers by Year
        • Checks the Accuracy of the Ledger
      • ERP
        • Gets ERP List
      • GİB
        • Journal and G/L Certificates are Sent to GIB
        • Brings GIB Approved Certificates
        • Sends the Ledger Report to the GİB
        • Queries the Status of the Ledger Report
        • Sends the Ledgers that are Faulty or Need to be Sent Again
        • Returns the Status of the Ledgers in the Relevant Month
      • Settings
        • Ledger Settings are Created/Updated
        • Gets Ledger Settings
      • Signing
        • Signs All Ledgers in the Relevant Period with Company Signature (HSM)
        • Returns the UUIDs of All Ledgers in the Relevant Period
      • Statistics
        • Gets Statistics
        • Gets Last 10 Ledger Records
      • File Upload
        • A Ledger is Created by Taking the Zip .csv File
        • Brings Uploaded Ledgers
        • Creates a Ledger by Taking the Base64 String Value of a Zip .csv File
        • GIB Approved Certificates of Manually Uploaded Ledgers Are Uploaded
        • Ledger Errors Are Introduced
        • Returns the Year and Period Information of the Last Ledger
    • E-REPORT API
      • Accounting Report
        • Lists Reports
        • Creates a Report
        • Downloads Report
        • Report Template Lists
        • Creates Accounting Report Template
        • Updates Report Template
        • Deletes Report Template
        • Report Template Columns Lists
        • Gets Report Template Columns
  • NİLVERA MODEL
    • EInvoice
      • InvoiceInfo
      • CompanyInfo
      • CustomerInfo
      • BuyerCustomerInfo
      • ExportCustomerInfo
      • TaxFreeInfo
      • InvoiceLines
      • Notes
      • CustomerAlias
    • ArchiveInvoice
      • InvoiceInfo
      • CompanyInfo
      • CustomerInfo
      • InvoiceLines
      • Notes
    • EDespatch
      • DespatchInfo
      • DespatchSupplierInfo
      • DeliveryCustomerInfo
      • BuyerCustomerInfo
      • SellerSupplierInfo
      • OriginatorCustomerInfo
      • Notes
      • DespatchLines
      • ShipmentDetail
      • AdditionalDocumentReference
      • OrderReference
      • CustomerAlias
    • EDespatchAnswer
      • DespatchInfo
      • DespatchSupplierInfo
      • DeliveryCustomerInfo
      • BuyerCustomerInfo
      • SellerSupplierInfo
      • ShipmentDetail
      • ReceiptLines
      • DespatchDocumentReference
      • Notes
      • DocumentReference
      • AdditionalDocumentReference
    • Producer
      • ProducerInfo
      • CompanyInfo
      • CustomerInfo
      • ProducerLines
      • Notes
    • Voucher
      • VoucherInfo
      • CompanyInfo
      • CustomerInfo
      • VoucherLines
      • Notes
    • Bill
      • BillInfo
      • CompanyInfo
      • CustomerInfo
      • SellerInfo
      • BillLines
      • Notes
    • ELedger
      • Eledger Properties
      • Accounting
      • DownloadLedger
  • GİB CODE LISTS
Powered by GitBook
On this page
  • BadRequest - 400
  • NotFound - 404
  • 404 Dönebilecek Diğer Kodlar
  • Conflict - 409
  • 409 Dönebilecek Diğer Kodlar
  • UnprocessableEntity - 422
  • 422 Dönebilecek Diğer Kodlar

Error Codes

PreviousAPI Key GenerationNextGENERAL API

Last updated 10 months ago

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.

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

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.

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.

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.

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.

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.