Overview
🔍 Numens
Transaction Intelligence & Tax Computation Engine
Numens is TaxStreem's AI-powered intelligence layer. Submit raw financial transactions and Numens determines the correct tax treatment — VAT, WHT, CIT, or PIT — by inspecting each transaction's context: the business profile, counterparty type, amount, narration, and jurisdiction.
| Module | Endpoint | What it does |
|---|---|---|
| Transaction Classification | POST /single | Classify a single transaction and return VAT, WHT, or CIT treatment. |
| Transaction Classification | POST /batch | Classify 1–500 transactions in one request. Results delivered async via webhook. |
| CIT Computation | POST /cit/compute | Run the full 13-step NTA computation for a company and tax year. |
| CIT Computation | POST /cit/compute-from-accounting | Pull financial figures from the accounting module, then compute CIT automatically. |
| PIT Computation | POST /pit/compute | Run the 14-step Personal Income Tax computation for freelancers, solopreneurs, and partnerships. |
Business Context in Every Payload
Every Numens request must include the customer's business identity so the engine can apply the correct Nigerian tax jurisdiction rules. The required fields are tenantId, clientId, taxId, state, and country. Without these, Numens cannot determine the correct filing authority (NRS vs State IRS) or WHT rate.