General system return codes

General System Return Codes apply across all EFRIS operations and are not specific to a particular business process such as invoicing, credit notes, or stock management.

These codes typically indicate request validation failures, authentication issues, missing information, permission problems, or system-level errors.

Success Codes

Code	Description	Explanation
00	SUCCESS	The request was processed successfully.

General Error Codes

Code	Description	Explanation
99	Unknown error	An unexpected system error occurred.
01	Interface coding error	The specified interface code is invalid or unsupported.
02	White box encryption failed	Internal EFRIS encryption failed.
03	White box decryption failed	Internal EFRIS decryption failed.
04	Read white box error	EFRIS could not access its encryption components.
05	AppID error	Invalid application identifier.
06	The outer message is empty	No request payload was supplied.
07	GlobalInfo content cannot be empty	Required request metadata is missing.
08	Data content cannot be empty	Request data is missing.
09	ReturnStateInfo content cannot be empty	Required return state information is missing.
10	DataDescription content cannot be empty	Data description information is missing.
11	InterfaceCode cannot be empty	Interface code is required.
12	UserName cannot be empty	Username is required.
13	TaxpayerID cannot be empty	Taxpayer ID is required.
14	DeviceMAC cannot be empty	Device MAC address is required.
15	Unpacking data error	The request payload could not be processed.
16	AppID cannot be empty	Application identifier is required.
17	Version cannot be empty	Client version is required.
18	DataExchangeId cannot be empty	Data exchange identifier is required.
19	RequestCode cannot be empty	Request code is required.
20	RequestTime cannot be empty	Request timestamp is required.
21	ResponseCode cannot be empty	Response code is required.
22	Currency cannot be empty	Currency is required.
23	Tax rate acquisition error	EFRIS could not retrieve tax rate information.
24	The version cannot be longer than 15 characters	Version exceeds the allowed length.
25	DataExchangeId cannot be greater than 32 characters	Data exchange identifier exceeds the allowed length.
26	RequestCode error	Invalid request code supplied.
27	ResponseCode error	Invalid response code supplied.
28	The difference between RequestTime and the current time is greater than ten minutes	Request timestamp falls outside the allowed time window.
29	DeviceMAC cannot be greater than 25 characters	Device MAC address exceeds the allowed length.
30	AppID error	Invalid application identifier.
31	RequestTime time format error	Request timestamp format is invalid.
32	Version is too low, please upgrade version	Client version is no longer supported.
33	Version error	Invalid version supplied.
34	Longitude cannot be empty	Longitude is required.
35	Longitude cannot be greater than 60 characters	Longitude exceeds the allowed length.
36	Latitude cannot be empty	Latitude is required.
37	Latitude cannot be greater than 60 characters	Latitude exceeds the allowed length.
38	Signature value is invalid	Request signature validation failed.
39	Signature value cannot be empty	Request signature is missing.
40	Insufficient permissions	The authenticated user does not have permission to perform the requested operation.
41	Item does not exist	The specified item could not be found.
42	Please register for e-Invoicing first	The taxpayer is not enrolled for EFRIS e-Invoicing.
43	Outer packet json format is invalid	Request JSON structure is invalid.
44	Taxpayer branch has been removed	The referenced branch is no longer active.
45	Partial failure	Some operations completed successfully while others failed.
46	Database error	An internal database error occurred.

Commonly Encountered Codes

The following codes are frequently encountered during integrations:

Code	Typical Cause
22	Currency not supplied
28	Invalid or expired request timestamp
38	Invalid authentication signature
40	Insufficient permissions
42	Taxpayer not registered for e-Invoicing
43	Invalid JSON request payload
45	Partial processing failure
99	Unexpected EFRIS error

Troubleshooting

Code 22 - Currency Cannot Be Empty

Ensure a valid currency code is supplied in the request.

Code 28 - Request Time Difference Exceeds Ten Minutes

Verify that your server clock is synchronized correctly and that request timestamps are generated at the time of submission.

Code 38 - Signature Value Is Invalid

Verify that:

The API Key is correct.

The API Secret is correct.

The access token has not expired.

Code 40 - Insufficient Permissions

Ensure that the authenticated account has access to the requested operation.

Code 42 - Please Register For e-Invoicing First

The taxpayer must complete EFRIS registration before invoices can be submitted.

Code 43 - Outer Packet JSON Format Is Invalid

Verify that the request body contains valid JSON and conforms to the documented request schema.

Taxpayer Return Codes

Invoice Return Codes

Credit Note Return Codes

Stock Management Return Codes

Authentication

Registration Details

Success Codes#

General Error Codes#

Commonly Encountered Codes#

Troubleshooting#

Code 22 - Currency Cannot Be Empty#

Code 28 - Request Time Difference Exceeds Ten Minutes#

Code 38 - Signature Value Is Invalid#

Code 40 - Insufficient Permissions#

Code 42 - Please Register For e-Invoicing First#

Code 43 - Outer Packet JSON Format Is Invalid#

Related Documentation#