EFRIX | URA Technical Brief

EFRIS Certified Integrator Accreditation Package

Prepared by: Xtellar Systems Co. Limited
Product: EFRIX – Electronic Fiscal Receipting Integration Exchange
Document Version: 1.0
Date: January 2026

---

Executive Summary

EFRIX is a certified middleware solution developed by Xtellar Systems Co. Limited that enables Ugandan businesses to achieve seamless compliance with URA's Electronic Fiscal Receipting and Invoicing Solution (EFRIS). EFRIX serves as a translation and security layer between client business systems (POS, ERP, custom applications) and URA's EFRIS infrastructure, handling all technical complexity of fiscalization while providing clients with a simple, RESTful API interface.

Key Capabilities:

• Real-time invoice fiscalization via system-to-system integration
• Support for all EFRIS document types (invoices, credit notes, debit notes)
• Per-TIN certificate management and cryptographic operations
• Automated retry logic with configurable failure handling
• Comprehensive audit logging with 10-year retention
• Sandbox environment for client integration testing

---

1. System Architecture

1.1 Architecture Overview

EFRIX operates as a middleware layer with three primary zones:

1.2 Data Flow

1.3 Component Description

---

2. Supported Transaction Types

EFRIX supports the following fiscal document types as defined by URA EFRIS:

Supported Payment Modes

• Cash
• Credit
• Cheque
• SWIFT Transfer
• Mobile Money (MTN, Airtel)

Supported Currencies

UGX, USD, EUR, GBP, CNY (as per EFRIS specification)

---

3. Data Validation & Error Handling

3.1 Pre-submission Validation

EFRIX validates all requests before transmission to EFRIS:

3.2 Failure Handling & Retry Logic

Retry Parameters:

3.3 Failure Categories

---

4. Security Architecture

4.1 Certificate Handling

EFRIX implements URA's required PKI infrastructure:

4.2 Per-TIN Isolation

Each registered business (TIN) maintains complete isolation:

4.3 Data Protection

---

5. Audit & Compliance Logs

5.1 Data Retention

5.2 Audit Log Schema

Each transaction log record follows this standardized schema:

{
  "transaction_id": "uuid",
  "timestamp": "ISO-8601",
  "tin": "1000000001",
  "document_type": "T109",
  "request_hash": "sha256",
  "response_hash": "sha256",
  "fdn": "EFRIS-123456789",
  "status": "SUCCESS|FAILED|PENDING",
  "error_code": null,
  "processing_time_ms": 234,
  "efris_response_time_ms": 189,
  "client_ip": "masked",
  "api_version": "v1"
}

5.3 URA Audit Support

EFRIX provides the following capabilities for URA audits:

---

6. EFRIX API Reference

6.1 Base URLs

6.2 Authentication

All requests require header authentication:

X-EFRIX-API-Key: efrix_live_xxxxx
X-EFRIX-API-Secret: sk_live_xxxxx

6.3 API Endpoints

6.4 Sample Request/Response

POST /invoices

// Request
{
  "invoice_number": "INV-2026-0001",
  "invoice_date": "2026-01-10",
  "buyer_tin": "1000000002",
  "buyer_name": "ABC Company Ltd",
  "currency": "UGX",
  "items": [
    {
      "description": "Professional Services",
      "quantity": 1,
      "unit_price": 1000000,
      "tax_rate": 18,
      "product_code": "99-001"
    }
  ],
  "payment_mode": "Credit",
  "idempotency_key": "unique-client-reference"
}

// Response
{
  "success": true,
  "data": {
    "fdn": "EFRIS-987654321",
    "verification_code": "ABCD1234",
    "qr_code": "base64-encoded-qr",
    "invoice_id": "URA-INV-123456",
    "fiscalized_at": "2026-01-10T14:30:00Z",
    "gross_amount": 1180000,
    "tax_amount": 180000,
    "net_amount": 1000000
  }
}

6.5 Response Codes

---

7. Demo & Sandbox Evidence

7.1 Sandbox Environment

EFRIX maintains a fully functional sandbox environment connected to URA's EFRIS test server:

7.2 Available Demo Evidence

7.3 Test Transaction Sample

{
  "request": {
    "buyer": {
      "tin": "1000000001",
      "legal_name": "Test Company Ltd"
    },
    "items": [
      {
        "description": "Test Product",
        "quantity": 1,
        "unit_price": 50000,
        "tax_rate": 18
      }
    ],
    "payment_mode": "CASH"
  },
  "response": {
    "success": true,
    "fiscal_document_number": "TEST-FDN-2026-001234",
    "qr_code": "https://efristest.ura.go.ug/verify/...",
    "antifake_code": "ABC123XYZ",
    "timestamp": "2026-01-10T12:00:00Z"
  }
}

7.4 Test Transaction Logs (Sandbox)

[2026-01-10 10:15:23] INFO  Request received: POST /invoices
[2026-01-10 10:15:23] INFO  TIN: 1000000001 | Invoice: TEST-001
[2026-01-10 10:15:23] INFO  Validation: PASSED
[2026-01-10 10:15:24] INFO  EFRIS submission initiated
[2026-01-10 10:15:24] INFO  EFRIS response: SUCCESS
[2026-01-10 10:15:24] INFO  FDN: EFRIS-TEST-123456789
[2026-01-10 10:15:24] INFO  Processing time: 856ms

---

8. Client Onboarding Checklist

For Commercial Deployment

Technical Prerequisites

• Client system can make HTTPS REST API calls
• Client can store and manage API tokens securely
• Client can handle webhook callbacks (recommended)
• Client has valid URA-issued EFRIS certificate
• Client TIN is registered for system-to-system integration with URA

---

9. Appendices

A. EFRIS Interface Codes Supported

B. Error Code Reference

C. Compliance Statement

EFRIX is developed and operated in accordance with:

• URA EFRIS Interface User Requirements Specifications v1.5
• Section 73A and 73B of the Tax Procedures Code Act 2014
• Uganda Data Protection and Privacy Act 2019

---

10. Contact Information

Xtellar Systems Co. Limited
Kampala, Uganda

---

Document Classification: URA Confidential
Prepared by: Xtellar Systems Co. Limited
Revision: 1.0
Last Updated: January 2026

This document is submitted in support of Xtellar Systems' application for EFRIS Certified Integrator accreditation renewal with the Uganda Revenue Authority.