Andersen E-Invoicing Platform
API Documentation
API Documentation
The Andersen Nigeria System Integrator E-Invoicing API is the external integration gateway that enables client Enterprise Resource Planning (ERP) systems — such as SAP, Oracle, Microsoft Dynamics, or bespoke enterprise platforms — to:
This APIs forms the backbone of the Merchant Buyer Solution (MBS) integration layer. All invoice data exchanged via these APIs is validated in real-time and transmitted to the NRS via a licensed Access Point Provider (APP), ensuring full regulatory compliance.
| Base URL | https://{domain}/erp/api |
| Authentication | OAuth 2.0 Bearer token (client_credentials grant) |
| Content-Type | application/json |
| Auth Header | Authorization: Bearer <access_token> |
The API uses the OAuth 2.0 Client Credentials flow, appropriate for ERP systems that
must authenticate autonomously and make API calls on behalf of a tenant organisation.
Your client_id and client_secret are provisioned within the
Andersen e-Invoicing portal by your organisation's administrator.
| Parameter | Type | Required | Description |
|---|---|---|---|
| grant_type | string | Required |
Specifies the OAuth 2.0 grant type. Must always be set to "client_credentials"
for ERP integrations. Any other value results in a 400 error.Default: "client_credentials" |
| client_id | string | Required |
The client identifier issued to your ERP integration by the Andersen administrator.
Each ERP integration receives a unique client_id bound to a specific tenant.
Treat this value as sensitive configuration data. |
| client_secret | string | Required |
The secret passphrase paired with the client_id. Together, these credentials
authenticate your ERP system to the platform. Contact Andersen admin to rotate this value
immediately if you suspect it has been compromised. |
| Parameter | Type | Description |
|---|---|---|
| access_token | string | The Bearer token for all subsequent requests: Authorization: Bearer <access_token> |
| token_type | string | Always returns "Bearer". |
| expires_in | integer | Token lifetime in seconds. Currently 3600 (1 hour). Refresh proactively to avoid 401 errors mid-operation. |
{
"grant_type": "client_credentials",
"client_id": "your-client-id",
"client_secret": "your-client-secret"
}{
"access_token": "eyJhbGciOiJIUzI1...",
"token_type": "Bearer",
"expires_in": 3600
}Generates the Invoice Reference Number (IRN) using the ERP invoice number, NRS Service ID, and a timestamp. Your NRS Service ID is a unique 8-character identifier available on your NRS MBS dashboard.
| Parameter | Type | Required | Description |
|---|---|---|---|
| invoiceNumber | string | Required | The unique invoice identifier generated by the ERP system. |
{
"invoiceNumber": "INV2340982938"
}{
"code": "FinancialDocument.IRNGenerated",
"message": "Invoice Reference Generated successfully.",
"data": {
"irn": "INV2340982938-1E5B443E-20250707"
}
}Returns a Base64-encoded QR Code image containing the IRN, Cryptographic Stamp Identifier (CSID), and your digital certificate. Your public key and digital certificate must be available on your NRS dashboard before calling this endpoint.
| Parameter | Type | Required | Description |
|---|---|---|---|
| irn | string | Required | The unique IRN of the invoice for which you want to retrieve the QR Code. |
{
"code": "FinancialDocument.Retrieved",
"message": "Financial document retrieved successfully.",
"data": {
"qr_code": "data:image/png;base64,iBOZQw0KGgoAAAANSUhVWgAAAQAAAAEA..."
}
}
Validates mapped invoice data against the NRS schema and returns true or false.
| Parameter | Type | Required | Description |
|---|---|---|---|
| documentDate | string (date) | Required | Invoice date in ISO 8601 format (YYYY-MM-DD). Used by NRS for period reporting. Default: "2026-02-18" |
| dueDate | string (date) | Required | The date by which the buyer must settle the invoice. Used for ageing analysis. Default: "2026-03-18" |
| currency | string | Required | ISO 4217 three-letter currency code. Use GET /reference-data/currencies for supported values.Default: "NGN" |
| buyerName | string | Required | Full legal registered name of the buyer as it appears on their CAC certificate. Embedded in the NRS-cleared invoice XML. |
| buyerTaxId | string | Required | Buyer's TIN as issued by the Nigeria Revenue Service. Primary key for upserting the buyer's Party record. Mandatory for all B2B and B2G invoices. |
| lineItems | array | Required | Array of line item objects. Each element must conform to the Line Item Object schema. |
| paymentMeansCode | string | Required | NRS-standardised payment method code. Use GET /reference-data/payment-means.Default: "30" |
| paymentDueDate | string (date) | Required | Payment due date as recorded on NRS systems. Default: "2026-03-18" |
| invoiceRefNumber | string | Required | IRN returned by POST /erp/api/generate-irn. |
| invoiceKind | string | Required | Invoice classification. Accepted values: B2B, B2G, B2C. |
| invoiceTypeCode | string | Required | NRS invoice type code. Use GET /reference-data/invoice-types.Default: "388" |
| invoiceTypeName | string | Required | Human-readable label for the invoice type. Default: "Standard Invoice" |
| reference | string | Optional | ERP internal reference or Purchase Order number. Searchable via GET /financial-documents. |
| notes | string | Optional | Free-text notes or special instructions printed on the invoice. |
| paymentTerms | string | Optional | Plain-language payment terms agreed with the buyer. Default: "Net 30 days" |
| buyerRegistrationNumber | string | Optional | Buyer's CAC company registration number. |
| buyerEmail | string | Optional | Buyer contact email address. |
| buyerPhone | string | Optional | Buyer contact phone number. |
| buyerAddressLine1 | string | Optional | First line of the buyer's registered street address. |
| buyerAddressLine2 | string | Optional | Second line of buyer's address (suite, floor, building name). |
| buyerCity | string | Optional | Buyer city. |
| buyerState | string | Optional | Buyer Nigerian state. Use GET /reference-data/states for NRS-recognised names. |
| buyerPostalCode | string | Optional | Buyer postal code. |
| buyerCountry | string | Optional | ISO 3166-1 alpha-2 country code. Default: "NG" |
| documentReferences | array | Optional | Related NRS document references. Each element must conform to the Document Reference Object schema. |
lineItems[]| Parameter | Type | Required | Description |
|---|---|---|---|
| description | string | Required | Clear description of the goods or services. Appears verbatim on the cleared invoice and in NRS records. |
| quantity | decimal | Required | Quantity supplied. Must be a positive decimal. |
| unitOfMeasure | string | Required | UN/ECE Recommendation 20 unit code. Common values: EA (each), KG (kilogram), HR (hour), MTR (metre).Default: "EA" |
| unitPrice | decimal | Required | Price per unit excluding tax. |
| taxRatePercent | decimal | Required | Applicable VAT or tax rate as a percentage. Standard Nigerian VAT is 7.5. Default: 7.5 |
| taxCode | string | Optional | NRS tax category code. Use GET /reference-data/tax-categories. Values: VAT, ZERO, EXMT.Default: "VAT" |
| productCategory | string | Optional | Product or service category. Auto-created if it does not exist. Default: "Goods" |
| discountFeeAmount | decimal | Optional | Discount amount for this line. Default: 0 |
| discountFeeType | string | Optional | "Percent" or "FixedAmount".Default: "Percent" |
| additionalFeeAmount | decimal | Optional | Additional charge for this line. Default: 0 |
| additionalFeeType | string | Optional | "Percent" or "FixedAmount".Default: "Percent" |
| itemCode | string | Optional | ERP item code. Used to upsert the item in the tenant catalogue. |
| itemName | string | Optional | Item name used when creating a new catalogue record. |
| itemCurrency | string | Optional | ISO 4217 currency for the item's unit price record. |
| categoryName | string | Optional | Category to assign to the item. Auto-created if missing. |
documentReferences[]| Parameter | Type | Required | Description |
|---|---|---|---|
| type | string | Required | Reference type. Examples: "PreviousInvoice", "Contract", "Billing". |
| irn | string | Required | IRN of the referenced document as issued by NRS. |
| issueDate | string (date) | Optional | Issue date of the referenced document in ISO 8601 format (YYYY-MM-DD). |
{
"documentDate": "2026-03-04",
"dueDate": "2026-08-18",
"currency": "NGN",
"buyerName": "Test Buyer",
"buyerTaxId": "12345678-0001",
"paymentMeansCode": "10",
"paymentDueDate": "2026-04-04",
"paymentTerms": "Net 30",
"invoiceTypeCode": "388",
"invoiceTypeName": "Standard Invoice",
"invoiceKind": "B2B",
"invoiceRefNumber": "INV2340982938-1E5B443E-20250707",
"lineItems": [
{
"classificationCode": "9609",
"description": "IT Consulting Services (Revised)",
"quantity": 25,
"unitOfMeasure": "HR",
"unitPrice": 15000.00,
"taxCode": "STANSARD_VAT",
"taxRatePercent": 7.5,
"productCategory": "Services",
"discountFeeAmount": 0,
"discountFeeType": "Percent",
"additionalFeeAmount": 0,
"additionalFeeType": "Percent",
"itemCode": "ITEM00001",
"itemName": "Test Item",
"itemCurrency": "NGN",
"categoryName": "Test Category"
}
],
"buyerEmail": "buyer@email.ng",
"buyerPhone": "+2347034567890",
"buyerAddressLine1": "20 Idimu road",
"buyerAddressLine2": "Abule-Egba",
"buyerCity": "Alimosho",
"buyerState": "NG-LG",
"buyerlga": "NG-SO-YAB",
"buyerPostalCode": "19029399",
"buyerCountry": "NG",
"documentReferences": [
{
"type": "Billing",
"irn": "INV2340982938-1E5B443E-20250707",
"issueDate": "2024-02-23"
}
]
}{
"code": "FinancialDocument.Validated",
"message": "Invoice data validated successfully."
}