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

Overview

The Kumusoft EFRIS API returns the same return codes provided by the underlying EFRIS platform.
Return codes indicate the outcome of an operation and help developers identify validation failures, processing issues, configuration problems, and business rule violations.
This page provides a high-level summary of the available return code categories. Detailed descriptions for individual codes can be found in the corresponding sections of this documentation.

General System Codes#

These codes apply across all API operations and typically indicate request validation errors, authentication issues, permission problems, or system failures.
Code RangeDescription
00Successful operation
01 - 46Request validation, authentication, authorization, and system errors
99Unknown system error
Examples:
Invalid request format
Missing required fields
Invalid signature
Insufficient permissions
Database errors

Taxpayer Codes#

These codes relate to taxpayer validation and taxpayer status checks.
Code RangeDescription
100 - 102Taxpayer validation and status errors
Examples:
Taxpayer does not exist
Taxpayer status is abnormal
Taxpayer branch status is abnormal
For detailed descriptions, see Taxpayers → Return Codes.

Device Codes#

These codes relate to EFRIS device registration, device status, and device key validation.
Code RangeDescription
400 - 403Device validation and device status errors
Examples:
Device does not exist
Device key expired
Device status abnormal

Credit Note & Debit Note Codes#

These codes are returned when processing credit notes, debit notes, cancellations, and related approval workflows.
Code RangeDescription
300 - 319Credit note and debit note processing errors
Examples:
Original invoice not found
Credit note already exists
Debit note already exists
Application period expired
Approval failed
For detailed descriptions, see Credit Notes → Return Codes.

Product & Stock Management Codes#

These codes relate to product configuration, inventory management, stock movements, commodity classifications, units of measure, and inventory validation.
Code RangeDescription
600 - 684Product and inventory management errors
Examples:
Invalid product code
Missing commodity category
Invalid quantity
Invalid stock operation
Product not found
For detailed descriptions, see Stock Management → Return Codes.

Invoice Processing Codes#

These codes are returned during invoice creation, validation, submission, and approval.
Code RangeDescription
1040 - 1999Invoice processing and validation errors
Examples:
Invoice already exists
Invalid seller information
Invalid buyer information
Invalid invoice details
Invalid tax calculations
For detailed descriptions, see Invoicing → Return Codes.

Verification & Validation Codes#

These codes relate to invoice verification, QR code validation, lottery participation, and verification services.
Code RangeDescription
501 - 509Verification and validation errors
Examples:
Invalid verification code
Invoice does not exist
Verification limit exceeded

Interface-Specific Codes#

Some return codes are only applicable to specific EFRIS interfaces and business processes.
These codes are documented alongside the relevant API operation and business workflow to make troubleshooting easier.
Examples include:
Invoice submission validations
Credit note workflow validations
Product creation validations
Inventory operation validations
Taxpayer registration validations

Best Practices#

When handling API responses:
1.
Always check the return code before processing the response data.
2.
Log both the return code and return message for troubleshooting.
3.
Display user-friendly messages to end users where appropriate.
4.
Refer to the detailed return code documentation within the relevant module when investigating failures.
5.
Contact support if you receive a return code that is not documented.

Related Documentation#

Taxpayers → Return Codes
Invoicing → Return Codes
Credit Notes → Return Codes
Stock Management → Return Codes
Interface Codes
Status Codes
Note: The Kumusoft EFRIS API currently surfaces return codes directly from the underlying EFRIS platform. Future versions may introduce additional Kumusoft-specific return codes and enhanced error handling while maintaining compatibility with existing integrations.
Previous
Tax Rules
Next
General system return codes
Built with