Overview

The B2B VAT Invoicing Service enables businesses to securely access and manage their VAT statements via API. This solution supports VAT generation and retrieval, ensuring compliance and operational efficiency.

 

Key Features

  • API-Based Access: Submit requests and retrieve VAT invoices programmatically.
  • Historical Archive: Access VAT records for up to 1 years.
  • PDF Downloads: Instantly download VAT invoices in PDF format.
  • Real-Time Notifications:
    • Alerts on request submission.
    • Notifications when invoices are generated. 

 

Pre-Requisites

To use VAT invoice service, ensure the following steps are completed:

  • Register/Login to the anb Developer Portal.
  • Create an app.
  • You should now have a client id and secret associated with your app.
  • Get an access token from our auth service using your client id and secret.

 

Request Parameters
Field Description Required Format
poiType CIF , Iqama, National ID and CR. Determines the type of identifier used for the VAT invoice request. Yes string
poiNum Proof of identification number
Must be a valid identifier. Invalid or mismatched values will result in errors such as 'Invalid Document Details'. 		Yes string
duration Duration in months for which the VAT invoices are requested.
Allowed values: 3, 6, 9, 12. Cannot be used together with fromDate and toDate.		 Yes number
fromDate Start date of the invoice period in YYYY-MM-DD format, Must be earlier than toDate. Yes string
toDate End date of the invoice period in YYYY-MM-DD format. Yes string
invoiceDate date of the invoice to be issued. Must be in YYYY-MM-DD format, Must be later than fromDate. Yes string
invoiceType Type of the invoice to be issued (e.g., SUMMARY_INVOICE, ADHOC_INVOICE, DEBIT_NOTE, CREDIT_NOTE). Yes string

 

B2B VAT Invoice Issuance Status codes
Status Description
200 File downloaded successfully
404 File not found on SFTP server
500 Unexpected error during file download
202 The downloaded file is empty

 

 

B2B VAT Invoice Inquiry Status codes
Status Code Description
200 Returns invoice details list
400 Validation Failed
500 Internal Finacle Error

 

API Documentation