Kumusoft Solutions
EFRIS API
EFRIS API
  1. Return Codes
  • 🚀 Getting started
  • 🔐 Authentication
    • Getting started
    • Calling Kumusoft APIs
    • API Keys
    • Generate auth Token
      POST
  • 🧾 Invoicing
    • How to generate a Fiscal invoice
    • Generate fiscal invoice
      POST
    • Preview fiscal invoice
      POST
    • Search invoices
      POST
    • Invoice detils
      GET
  • 📦 Stock Management
    • All stock items
      GET
    • Search stock items
      POST
    • Reduce stock
      POST
    • Increase stock
      POST
    • Register stock item
      POST
  • 📃 Credit Notes
    • Issue credit note
  • ⚙️ Masterdata
    • Registration details
    • Get Masterdata
  • 📋 Reference
    • Overview
    • Data Sources
    • Invoice Types
    • Tax Rules
    • Return Codes
      • Overview
      • General system return codes
      • Taxpayer return codes
      • Invoice return codes
      • Credit note return codes
      • Stock management return codes
      • Device return codes
      • Invoice industry codes
  1. Return Codes

Device return codes

Device Return Codes are returned when validating EFRIS device information, device credentials, and device registration status.
These codes are typically encountered when EFRIS validates the taxpayer's device configuration before processing a request.
Kumusoft Abstraction
The Kumusoft EFRIS API abstracts device management, encryption, signature generation, and device authentication from API consumers.
As a result, most applications integrating through the Kumusoft EFRIS API will never encounter these errors directly.
These codes are documented primarily for troubleshooting, diagnostics, and support investigations involving the underlying EFRIS platform.

Device Codes Summary#

Code RangeDescription
400 - 403Device Registration and Device Authentication Errors

Device Return Codes#

CodeDescriptionExplanation
400Device does not existThe specified EFRIS device could not be found.
401Device branch does not existThe device is associated with a branch that does not exist.
402Device key expiredThe device authentication key has expired.
403Device key does not existNo valid device key could be found for the device.

Code 400 - Device Does Not Exist#

Description#

Device does not exist

Explanation#

EFRIS could not locate the device associated with the request.

Common Causes#

Device has not been registered.
Invalid device configuration.
Device registration information has been removed.

Resolution#

Verify that the taxpayer has completed EFRIS registration.
Refresh registration details.
Contact support if the issue persists.

Code 401 - Device Branch Does Not Exist#

Description#

Device branch does not exist

Explanation#

The branch associated with the device could not be found.

Common Causes#

Branch has been removed.
Branch registration is incomplete.
Device is linked to an invalid branch.

Resolution#

Verify branch registration details.
Confirm that the branch is active within EFRIS.

Code 402 - Device Key Expired#

Description#

Device key expired

Explanation#

The device authentication credentials maintained by EFRIS have expired.

Common Causes#

Device credentials are no longer valid.
EFRIS device registration requires renewal.

Resolution#

Refresh device registration information.
Re-register the taxpayer device if required.
Contact support for assistance.

Code 403 - Device Key Does Not Exist#

Description#

Device key does not exist

Explanation#

EFRIS could not find a valid device key for the configured device.

Common Causes#

Device registration is incomplete.
Device credentials have been removed.
Device provisioning failed.

Resolution#

Verify EFRIS registration details.
Refresh taxpayer registration information.
Contact support if the issue persists.

Best Practices#

Ensure taxpayer registration is completed successfully before submitting invoices.
Keep taxpayer registration information up to date.
Refresh registration details whenever device-related errors occur.
Contact support if device credentials appear to be missing or invalid.

Related Documentation#

Registration Details
Taxpayer Return Codes
General System Return Codes
Authentication
Return Codes Overview
Note: Device management is handled automatically by the Kumusoft EFRIS API. Most integrations will never need to interact directly with device credentials, device keys, or device registration information.
Previous
Stock management return codes
Next
Invoice industry codes
Built with