TaxStreem Logo

About this guide

Welcome to the TaxStreem VAT filing integration guide. This guide is designed for technology partners and API developers building integrations that handle Value Added Tax (VAT) compliance for Nigerian businesses.

This guide describes the steps to follow to integrate TaxStreem's Flux module for VAT into your product. Upon completion, your integration will be able to submit VAT filings to the Nigeria Revenue Service (NRS), retrieve filing confirmations, and handle asynchronous webhook callbacks.

We've broken these steps down into individual milestones in the order you should complete them.

Note:The information in this guide is based on standard TaxStreem API practices. All code examples are provided on an as-is basis. Ensure your integration uses HTTPS and handles credentials securely.

What is VAT in Nigeria?

Value Added Tax (VAT) is a consumption tax charged at 7.5% on goods and services in Nigeria. Businesses registered for VAT collect Output VAT on sales and deduct Input VAT paid on purchases. The net difference is remitted to NRS monthly via Rev360.

  • Standard rate: 7.5% on taxable supplies
  • Zero-rated supplies: 0% VAT — e.g. pharmaceutical products, agricultural goods, exports
  • Exempt supplies: No VAT at all — e.g. baby products, sanitary items
  • Filing deadline: 21st of the following month
  • Filing authority: NRS via Rev360 portal

What this guide covers

  • Authenticating your API calls with TaxStreem
  • Understanding VAT status codes (VATtable, zero-rated, exempt)
  • Submitting single VAT filings via POST /v1/flux/vat/single-filing
  • Submitting batch VAT filings via POST /v1/flux/vat/batch-filing
  • Receiving filing confirmations via webhooks