Welcome to E-Invoice Portal
Streamline your business operations with digital invoicing
The Federal Inland Revenue Service (FIRS) E-Invoice system enables businesses to generate, transmit, and manage invoices electronically. This digital transformation ensures compliance with tax regulations while improving efficiency and reducing errors.
E-Invoice Integration Use Cases
Understand how different types of businesses can integrate with the FIRS E-Invoice system through our two distinct integration models.
Prerequisites
Tax Payer must have selected Elara as their Access Point Provider (APP) before proceeding with any integration. This is a mandatory requirement for accessing the FIRS E-Invoice system through our API.
Direct Tax Payer Integration
For businesses with their own Invoice Management application
Tax Payer have their own Invoice Management (ERP) application
The business already possess an Invoice Management (ERP) application they want to integrate with FIRS e-invoicing system.
Tax Payer registers on Elara portal
The business registers their application on the Elara E-Invoice portal, providing necessary business and technical information.
API credentials are generated for Tax Payer application upon authentication
Tax Payer authenticates by supplying FIRS tax payer email and password to verify ownership and eligibility. API Credentials are generated
Tax Payer does necessary development on their Invoice management application
The business integrates Elara e-invoice API into their Invoice Management application using the provided credentials.
Tax Payer application uses the generated credentials to call our e-invoice API
The application uses the generated credentials to securely access Elara e-invoicing API.
Authentication Mechanism
Client Credentials OAuth 2.0: The application uses the generated credentials (client ID and secret) to obtain access tokens for API calls. This is a server-to-server authentication method suitable for trusted applications.
Important Note
Tax Payer application can only manage Invoices linked to the authenticated Tax Payer. This ensures that businesses can only access and manage their own invoices, maintaining data security and compliance.
On Behalf Tax Payer Integration
For third-party applications managing invoices on behalf of taxpayers
Tax Payer does not have Invoice Management (ERP) application and selects a Third Party application
Individual taxpayers or SMEs who don't have their own invoice management systems choose to use a third-party application.
Third Party application registers on Elara portal
The third-party application provider (fintech, software vendor, etc.) registers their application on the Elara E-Invoice portal.
API credentials are generated for Third Party application
Upon successful registration, FIRS generates credentials for the third-party application.
Third Party does necessary development on their Invoice management application
The third-party provider integrates Elara e-invoice API with their Invoice Management application using the provided credentials.
Third Party application uses the generated credentials to call our e-invoice API
The application uses the authorization code OAuth 2 Authentication mechanism to securely access FIRS e-invoicing services.
Tax Payer is asked to authenticate when trying to manage invoice
When a taxpayer wants to manage their invoices through the third-party application, they are prompted to authenticate with their FIRS credentials.
If authentication is successful Third Party application can manage invoices for the Tax Payer
Upon successful taxpayer authentication, the third-party application can access and manage invoices on behalf of that specific taxpayer.
Authentication Mechanism
Authorization Code OAuth 2.0: The application uses the authorization code flow, which requires user (taxpayer) consent and authentication for each session. This ensures that taxpayers maintain control over their data access.
Important Note
Third Party application can only receive Invoices linked to the Tax Payer authenticated. This ensures that third-party applications can only access invoices for taxpayers who have explicitly authenticated and authorized access.
Integration Models Comparison
| Aspect | Direct Tax Payer Integration | On Behalf Tax Payer Integration |
|---|---|---|
| Application Ownership | Tax Payer owns the Invoice Management (ERP) application | Third-party owns the Invoice Management (ERP) application |
| Target Users | Large companies, banks, enterprises with their own ERP application | Individuals, SMEs and any other businesses without their own ERP application |
| Authentication Frequency | One-time during onboarding | Each time taxpayer wants to manage invoice |
| Authentication Flow | OAuth 2.0 Client Credentials | OAuth 2.0 Authorization Code |
| Data Access | Only taxpayer's own invoices | Only authenticated taxpayer's invoices |
| Use Case | Trusted Applications | Delegated Applications |
Get Started with E-Invoicing
Choose the integration option that best fits your business needs
Direct Tax Payer Integration
Trusted ApplicationsFor businesses accessing/managing invoices via their own Invoice management application. Ideal for large companies, banks, and organizations with their own enterprise systems.
- Manage invoicing via your own Invoice Management application
- Ideal for big companies, banks
- One-time FIRS Tax Payer authentication (FIRS Tax Payer email/password) during onboarding process
- Manage your invoices via our robust API
On Behalf Tax Payer Integration
Delegated ApplicationsFor businesses accessing/managing invoices via third-party Invoice management applications. Perfect for individuals, SMEs, and fintech solutions.
- Access via third-party Invoice Management applications
- Ideal for aggregators (Fintech) who has built applications to manage invoices on behalf of Individuals or SMEs
- Tax Payer authentication (FIRS Tax Payer email/password) required each time you want to manage Invoice
- Manage your invoices via our robust API
Get Started with E-Invoicing
Choose the integration option that best fits your business needs
Direct Tax Payer Integration
Trusted ApplicationsFor businesses accessing/managing invoices via their own Invoice management application. Ideal for large companies, banks, and organizations with their own enterprise systems.
- Manage invoicing via your own Invoice Management application
- Ideal for big companies, banks
- One-time FIRS Tax Payer authentication (FIRS Tax Payer email/password) during onboarding process
- Manage your invoices via our robust API
On Behalf Tax Payer Integration
Delegated ApplicationsFor businesses accessing/managing invoices via third-party Invoice management applications. Perfect for individuals, SMEs, and fintech solutions.
- Access via third-party Invoice Management applications
- Ideal for aggregators (Fintech) who has built applications to manage invoices on behalf of Individuals or SMEs
- Tax Payer authentication (FIRS Tax Payer email/password) required each time you want to manage Invoice
- Manage your invoices via our robust API