Invoice Return Codes are returned during invoice creation, validation, submission, approval, and retrieval operations.

These codes indicate issues with seller information, buyer information, invoice details, tax calculations, product information, or invoice processing.

Kumusoft Validation Layer
The Kumusoft EFRIS API performs extensive validation before submitting requests to EFRIS. As a result, many invoice validation errors documented in this section may never be encountered during normal API usage.
This reference is provided primarily for troubleshooting, diagnostics, support investigations, and understanding responses returned directly by the underlying EFRIS platform.
Whenever possible, validation errors are detected and reported by the Kumusoft platform before the request is submitted to EFRIS.

Invoice Codes Summary

Code Range	Description
1040	Duplicate invoice errors
1100 - 1121	Seller validation errors
1122 - 1141	Invoice header validation errors
1142 - 1169	Buyer validation errors
1170 - 1299	Invoice item validation errors

Duplicate Invoice Errors

Code 1040

Code	Description	Explanation
1040	Invoice number already exists	The invoice number has already been submitted to EFRIS.

Resolution

Ensure invoice numbers are unique.

Avoid resubmitting previously successful invoices.

Implement duplicate submission checks in your application.

Example

{
  "returnCode": "1040",
  "returnMessage": "Invoice number already exists"
}

Seller Validation Errors

These errors occur when validating seller details.

Code	Description
1100	Seller TIN cannot be empty
1101	Invalid seller TIN length
1102	Seller TIN does not match outer packet TIN
1103	Seller NIN/BRN cannot be empty
1104	Seller NIN/BRN exceeds maximum length
1105	Seller legal name cannot be empty
1106	Seller legal name exceeds maximum length
1107	Seller business name cannot be empty
1108	Seller business name exceeds maximum length
1109	Seller address cannot be empty
1110	Seller address exceeds maximum length
1111	Seller mobile phone cannot be empty
1112	Seller mobile phone exceeds maximum length
1113	Seller telephone cannot be empty
1114	Seller telephone exceeds maximum length
1115	Seller email address cannot be empty
1116	Invalid seller email length
1117	Seller email address is invalid
1118	Place of business cannot be empty
1119	Place of business exceeds maximum length
1120	Seller reference number cannot be empty
1121	Seller reference number exceeds maximum length

Invoice Header Validation Errors

These errors relate to invoice-level information.

Code	Description
1122	Invoice number cannot be empty
1123	Invoice number exceeds maximum length
1124	Anti-fake code cannot be empty
1125	Invalid anti-fake code length
1126	Invalid anti-fake code value
1127	Device number mismatch
1129	Issue date cannot be empty
1130	Invalid issue date format
1131	Operator cannot be empty
1132	Operator exceeds maximum length
1133	Currency cannot be empty
1134	Currency exceeds maximum length
1135	Invalid invoice type
1136	Original invoice ID required
1137	Original invoice ID cannot be empty
1138	Original invoice ID exceeds maximum length
1139	Invalid invoice kind
1140	Invalid data source
1141	Invalid payment method

Buyer Validation Errors

These errors occur when validating buyer details.

Code	Description
1142	Buyer TIN cannot be empty
1143	Invalid buyer TIN length
1144	Buyer NIN/BRN cannot be empty
1145	Buyer NIN/BRN exceeds maximum length
1146	Buyer passport number cannot be empty
1147	Buyer passport number exceeds maximum length
1148	Buyer legal name cannot be empty
1149	Buyer legal name exceeds maximum length
1150	Buyer business name cannot be empty
1151	Buyer business name exceeds maximum length
1152	Buyer address cannot be empty
1153	Buyer address exceeds maximum length
1154	Buyer email cannot be empty
1155	Invalid buyer email length
1156	Invalid buyer email address
1157	Buyer mobile phone cannot be empty
1158	Buyer mobile phone exceeds maximum length
1159	Buyer telephone cannot be empty
1160	Buyer telephone exceeds maximum length
1161	Buyer place of business cannot be empty
1162	Buyer place of business exceeds maximum length
1163	Invalid buyer type
1164	Buyer citizenship cannot be empty
1165	Buyer citizenship exceeds maximum length
1166	Buyer sector cannot be empty
1167	Buyer sector exceeds maximum length
1168	Buyer reference number cannot be empty
1169	Buyer reference number exceeds maximum length

Invoice Item Validation Errors

These errors occur when validating invoice line items.

Code Range	Description
1170 - 1299	Product and invoice line validation errors

Common examples include:

Code	Description
1175	Item name cannot be empty
1179	Item code cannot be empty
1182	Quantity cannot be empty
1188	Unit price cannot be empty
1194	Total amount cannot be empty
1200	Tax amount cannot be empty

The full list of invoice item validation codes is defined by EFRIS and may evolve over time.

Best Practices

Generate unique invoice numbers.

Validate seller information before invoice creation.

Validate buyer information before invoice creation.

Use supported currency codes and payment methods.

Ensure all invoice line items contain valid quantities and prices.

Avoid resubmitting previously successful invoices.

Invoicing

Tax Rules

Currency Codes

Data Sources

Payment Methods

General System Return Codes

Taxpayer Return Codes

Note: This page documents return codes exposed by the underlying EFRIS platform. Although many of these codes are unlikely to occur when using the Kumusoft EFRIS API, they are included here as a reference for troubleshooting and support purposes.

Invoice return codes

Invoice Codes Summary#

Duplicate Invoice Errors#

Code 1040#

Resolution#

Example#

Seller Validation Errors#

Invoice Header Validation Errors#

Buyer Validation Errors#

Invoice Item Validation Errors#

Best Practices#

Related Documentation#