HayeFintax EIMS API

The Ethiopian Invoicing Middleware Suite (EIMS) connects your software to the Ministry of Revenue's Electronic Invoice Registration System. Every invoice is signed and registered in real time — IRN and QR code returned in under 2 seconds.

Base URL

https://einvoice.hayefintax.com/api

Environment

Production • Stable

Spec Version

OpenAPI 3.1.0

Total Endpoints

18 endpoints across 9 groups

Key Concepts

🏢

Tenant Architecture

Every business operates in an isolated tenant vault with its own cryptographic keys and IRN sequences.

⚡

Real-Time Signing

POST /register submits to MoR and returns an IRN in under 2 seconds. The receipt is sealed before it is issued.

📶

Offline Mode

Mandatory for 10+ B2C sectors under Directive 1142/2026. Invoices buffer locally and sync on reconnect — zero data loss.

🔑

Two Auth Flows

Tenant operators use username/password → JWT. ERP systems use OAuth2 Client Credentials (client_id + client_secret → 30-day token).

📦

Bulk & Async

POST /bulk-register processes large batches asynchronously and delivers results to your webhook callback URL.

🛡️

Directive Compliance

All endpoints implement Directive No. 1142/2026 (MoR). IRN, RRN, and QR code included on every registered document.

Integration Partner?