Overview

NUMENS (TRANSACTION INTELLIGENCE)

Automating tax classification and treatment for every business transaction with Numens.

Numens is TaxStreem's transaction intelligence engine. Submit raw business financial transactions and Numens inspects context — counterparty type, transaction nature, TIN, and amount — to determine the correct tax treatment. It eliminates manual categorisation by returning structured tax treatment jobs that drive 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 single and bulk transaction tax treatment, multi-business batch processing, and income tax computation:

✅Single Transaction Tax Treatment — submit a single business transaction for tax treatment. Returns a 202 Accepted job tracking response.

✅Batch Business Transaction Tax Treatment — submit up to 500 transactions in a flat list or grouped across multiple businesses in a single request.

✅Batch Job Status Query — query the status of an asynchronous batch or single transaction tax treatment job using its jobId.

✅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 tax treatment requests are queued asynchronously with 202 Accepted status responses. Track job progress using the returned statusUrl or query endpoint.

✅Pass a unique transactionId per record alongside tenant, client, and tax details.

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

✅For multi-tenant or multi-entity applications, group transactions under the businesses array in batch requests.

💡 Additional Notes

📘 Batch requests deduct 1 credit per processed transaction from your active subscription plan balance.

📘 Test API keys starting with txsm_test bypass credit balance deduction for local/sandbox testing.

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