Kumusoft Solutions
EFRIS API
EFRIS API
  1. EFRIS API
  • 🚀 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
      POST
  • ⚙️ Masterdata
    • Registration details
      GET
    • Get Masterdata
      GET
  • 📋 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. EFRIS API

🚀 Getting started

efris.jpg
The Kumusoft EFRIS API simplifies integration with the Uganda Revenue Authority (URA) Electronic Fiscal Receipting and Invoicing System (EFRIS) by providing a modern REST-based interface for invoice submission, fiscalization, credit notes, and related tax compliance workflows.
Instead of integrating directly with the complex native EFRIS protocols and payload structures, developers can integrate once with Kumusoft and focus on their business logic while we handle the EFRIS communication layer.

What We Solve#

Direct EFRIS integrations often involve:
Complex payload structures
Cryptic master-data codes
Encryption and signature requirements
Strict validation rules
Frequent rejection handling
Difficult debugging processes
The Kumusoft API abstracts this complexity into a clean and developer-friendly interface.
Our platform handles:
EFRIS request formatting
Validation workflows
Secure communication with URA
Response interpretation
Retry handling
Status synchronization
Fiscal document tracking

Typical Integration Flow#

A standard EFRIS integration using Kumusoft follows this process:
1.
Your application creates an invoice
2.
Your application sends the invoice to the Kumusoft API
3.
Kumusoft validates and transforms the payload
4.
Kumusoft securely submits the transaction to EFRIS
5.
EFRIS returns a fiscal response
6.
Kumusoft returns the processed response to your application
7.
Your application stores or prints the fiscal invoice details

Supported integrations#

The API can be integrated into:
ERP systems
POS systems
Accounting platforms
E-commerce platforms
Mobile applications
School management systems
SACCO systems
Custom business applications

Integration environments#

We provide two environments:
EnvironmentPurpose
SandboxTesting and certification
ProductionLive fiscal invoice submission

Before you begin#

Before requesting access, ensure you have:
An active URA TIN
Technical contact person

Integration journey#

Step 1 — Request Access#

Contact the Kumusoft integrations team to request:
Sandbox credentials
API keys
Integration guidance

Step 2 — Configure authentication#

Once approved, you will receive:
API credentials
Environment URLs
Access instructions
All API requests must include a valid authorization token.
Example:

Step 3 — Test in sandbox#

Use the sandbox environment to:
Submit sample invoices
Validate invoice structures
Test error handling
Simulate fiscal workflows

Step 4 — Complete certification#

Before production activation:
Invoice formats must be validated
Required fiscal fields must be tested
Successful submission scenarios must be confirmed

Step 5 — Production activation#

Once certification is complete:
Production credentials are issued
Live invoice submission is enabled
Fiscal invoice generation begins

Authentication#

All requests to the Kumusoft API require authentication using Bearer Tokens.
Example request:

Support#

For integration assistance:
Technical onboarding
Certification support
Production activation
Troubleshooting assistance
Contact:
Email: info@kumusoft.com
Tel: +256-704-764-602
Website: https://www.kumusoft.com
Next
Getting started
Built with