Overview

NUMENS (TRANSACTION INTELLIGENCE)

Automating tax classification for every transaction with Numens.

Numens is TaxStreem's transaction intelligence engine. Submit a raw financial transaction and Numens inspects its context — counterparty type, transaction nature, and amount — to determine the correct tax treatment. It eliminates manual categorisation by returning a structured classification that drives downstream VAT, WHT, and income tax obligations automatically.

🔍 What Does Numens Classify?

Every transaction submitted to Numens is assessed against the applicable tax types. Results indicate which obligations apply and at what rate:

Tax Type	Description
VAT	Value Added Tax. Numens determines whether VAT applies, the applicable rate, and whether the transaction is exempt or zero-rated.
WHT	Withholding Tax. Numens identifies whether a deduction must be made at source and the applicable percentage based on counterparty type.
CIT	Companies Income Tax. Numens flags transactions contributing to CIT computation and returns the income tax exposure per record.
PIT	Personal Income Tax. Applicable to transactions involving individual counterparties or employee-related payments.

⚙️ Available Operations

Numens supports both real-time and bulk classification, as well as income tax computation:

✅Single Classification — submit one transaction and receive an immediate tax classification response.

✅Batch Classification — submit up to 500 transactions in a single request for high-volume workflows.

✅CIT Compute — calculate Companies Income Tax liability based on submitted transaction data.

✅CIT from Accounting — derive CIT exposure directly from your accounting ledger records.

✅PIT Compute — calculate Personal Income Tax for individual counterparties or employee payments.

🛠️ Using Numens via API

Numens classification is synchronous — results are returned in the response body immediately. Use the classification output to drive downstream filing with Flux or accounting entries with Atlas.

✅Pass a unique transactionId per record — it serves as the idempotency key and is returned in all downstream events.

✅Include a descriptive description field — Numens uses it alongside counterparty data to improve classification accuracy.

📌 Classification results can be passed directly to Flux filing endpoints without additional mapping.

💡 Additional Notes

📘 Batch submissions return a per-transaction result array; individual failures do not abort the entire batch.

📘 CIT and PIT compute endpoints are currently in early access — contact support to enable them for your account.

📘 Rate limiting will enforce 429 status codes if queues overfill.