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

Taxpayer return codes

Taxpayer Return Codes are returned when validating taxpayer information, taxpayer status, and taxpayer branch information.
These codes are commonly encountered when searching for taxpayers, retrieving registration details, validating invoice participants, or processing transactions against taxpayer records.

Taxpayer Codes#

CodeDescriptionExplanation
100Taxpayer does not existThe supplied taxpayer could not be found in EFRIS.
101Taxpayer status is abnormalThe taxpayer exists but is not in an active status.
102Taxpayer branch status abnormalThe taxpayer branch exists but is not active or available for transactions.

Code 100 - Taxpayer Does Not Exist#

Description#

Taxpayer does not exist

Explanation#

The TIN supplied in the request could not be found in EFRIS.

Common Causes#

Incorrect TIN provided.
Typographical errors in the TIN.
Taxpayer has not been registered.
Taxpayer record has been removed or deactivated.

Resolution#

Verify the TIN.
Use the Search Taxpayer endpoint to validate the taxpayer before processing transactions.
Confirm that the taxpayer is registered with URA.

Example#

{
  "returnCode": "100",
  "returnMessage": "Taxpayer does not exist"
}

Code 101 - Taxpayer Status Is Abnormal#

Description#

Taxpayer status is abnormal

Explanation#

The taxpayer exists but is not currently active within EFRIS.

Common Causes#

Taxpayer registration is suspended.
Taxpayer account has been deactivated.
Taxpayer registration is incomplete.
Taxpayer account is under administrative review.

Resolution#

Verify the taxpayer's registration status.
Contact URA if the taxpayer should be active.
Confirm that the taxpayer is authorized to issue e-Invoices.

Example#

{
  "returnCode": "101",
  "returnMessage": "Taxpayer status is abnormal"
}

Code 102 - Taxpayer Branch Status Abnormal#

Description#

Taxpayer branch status abnormal

Explanation#

The branch associated with the taxpayer is not active or cannot be used for transactions.

Common Causes#

Branch has been deactivated.
Branch registration is incomplete.
Branch information is incorrect.
Branch is no longer authorized for e-Invoicing.

Resolution#

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

Example#

{
  "returnCode": "102",
  "returnMessage": "Taxpayer branch status abnormal"
}

Best Practices#

1.
Validate taxpayer information before creating invoices.
2.
Cache taxpayer information where appropriate to reduce validation failures.
3.
Verify branch information before submitting transactions.
4.
Handle taxpayer validation failures gracefully and present clear messages to users.

Related Documentation#

Search Taxpayer
Registration Details
General System Return Codes
Invoicing
Credit Notes
Tip: Most taxpayer-related errors can be prevented by validating the taxpayer and branch information before submitting invoices or credit notes.
Previous
General system return codes
Next
Invoice return codes
Built with