Getting Started
Invoice Management
Learn how to create, verify, and manage electronic invoices
Invoice Management Guide
This guide covers everything you need to know about creating, verifying, and managing electronic invoices with our E-Invoicing API. Our invoice management system follows Universal Business Language (UBL) standards and provides automatic IRN (Invoice Reference Number) generation.Verify IRN
Verify the integrity of the IRN (Invoice Reference Number) computation to ensure you have generated a valid IRNSample Request
Sample Request
Sample Response
Sample Response
Always verify IRN before submitting invoices to ensure data integrity and prevent submission errors.
Validate Invoice
Validate the full invoice content before submitting to ensure all data is properly formatted and compliant with UBL standards.Sample Request
Sample Request
Sample Response
Sample Response
Validation ensures your invoice data is properly formatted and compliant with UBL standards before submission. Always validate invoices before submitting to prevent processing errors.
Submit Invoice
Submit an invoice for processing and signing. The invoice will be processed according to e-invoicing standards.Sample Request
Sample Request
Sample Response
Sample Response
Important: You must generate and validate the IRN before submitting the invoice. The system does not automatically generate an IRN. Ensure you have completed the IRN verification and Invoice validation steps before submission.
Get Invoice Status
Check the status of a submitted invoice by IRN.Sample Request
Sample Request
Sample Response
Sample Response
PENDING: Payment is pendingPAID: Payment has been receivedREJECTED: Payment was rejected
Transmit Invoice
Transmit an invoice to the Invoice Receiver (Tax Payer) after it has been submitted and validated.Sample Request
Sample Request
Sample Response
Sample Response
Only invoices that have been successfully submitted and validated can be transmitted. Once transmitted, the invoice status will be updated to reflect the transmission status.
Search Invoices
Search and filter invoices by various criteria.Sample Request
Sample Request
Sample Response
Sample Response
Filtering and Search
Payment Status Filtering
- PENDING: Invoices awaiting payment
- PAID: Invoices that have been paid
- REJECTED: Invoices that have been rejected
Date Filtering
- issue_date: Filter by the date the invoice was issued
- due_date: Filter by the payment due date
Advanced Filtering
- irn: Search by specific Invoice Reference Number
- invoice_type_code: Filter by invoice type (e.g., 380 for commercial invoice)
- tax_currency_code: Filter by tax currency
- document_currency_code: Filter by document currency
Validation Rules
Format Validation
- Tax ID must follow Nigerian format
- Currency codes must be valid ISO 4217 codes
- Dates must be in ISO 8601 format
- Amounts must be positive numbers
Business Rules
- Invoice reference must be unique per business
- Due date must be after issue date
- Tax amounts must match calculated values
- Line totals must equal invoice total
Best Practices
1. Verify IRN Before Submit
Always verify IRN before submitting invoices to prevent errors and ensure data integrity.2. Validate Invoice details
Validate all data before submission to ensure compliance.3. Batch Operations
Use search endpoints for bulk operations and reporting.4. Monitor Processing
Implement status polling for long-running operations.Next Steps
Now that you understand invoice management operations, explore these related topics:- Resource - Access reference data
- Invoice Inbox - Manage received invoices
Always ensure proper validation and error handling in your implementation. The E-Invoicing API follows UBL standards and Nigerian tax regulations. Regular monitoring and compliance with regulatory requirements are essential for successful e-invoicing implementation.