Overview
3. NUMENS (INTELLIGENCE)
Automating your continuous distribution loops with Numens.
The Numens engine on TaxStreem is a planet-scale framework that isolates the complexity of multi-national compliance rules, income taxes, and ultimate banking disbursement into a single POST request.
🧾 What Is A Compensation Run?
In Numens, a single JSON array submitted to the run endpoint calculates comprehensive metrics for every entry:
| Ledger Type | Description |
|---|---|
| Gross Salary | The total compensatable base metric provided at the top level of the payload. |
| Deductions | Automated income tax, pension, and health liabilities stripped immediately based on region. |
| Net Payout | The finalized amount passed directly to our interconnected banking gateways for deposit. |
⚙️ Default Employee Setup
Employees and contractors must be registered dynamically within your Numens Directory before they can be assigned IDs and included in compensation runs.
🛠️ Using Numens via API
Running operations requires tying together arrays with strict scheduling formats.
✅Provide the array of workers under the
employees property.✅The
paymentDate defines the day the deposit network triggers transfer logic.📌 Valid currency constants must match exactly; e.g., passing NGN for Nigerian local routing.
💡 Additional Notes
📘 Numens utilizes the
payrollId to prevent devastating dual-disbursement bugs.📘 You will receive exactly one
payroll.completed webhook when the regional gateway settles.