Overview

1. FLUX (TAX FILING)

Automating your tax compliance lifecycle with Flux.

The Flux framework on TaxStreem is an intelligence layer used to classify, calculate, and remit every taxable transaction in your ecosystem. It enables real-time fractional calculations, automated filing generations, and direct integration with local revenue authorities.

🧾 What Are Tax Filings?

In Flux, workflows represent different regulatory requirements and are grouped under standard compliance types:

Filing Type	Description
VAT	Value Added Tax applied to goods and services. Must be remitted periodically.
WHT	Withholding Tax deducted from vendor payouts and contracts at source.
PAYE	Pay As You Earn. Personal income tax withheld from employee salaries.

⚙️ Default Payload Setup

TaxStreem automatically prepares internal ledgers when you submit transactions. For heavy enterprise processors, utilizing the Batch schemas allows you to submit up to 500 records simultaneously, so you're ready to hit daily quotas immediately.

🛠️ Using Flux via API

When making API requests for operations such as VAT and WHT, TaxStreem expects you to reference exact values rather than arbitrary text.

✅For identity arrays, pass the active taxId (e.g. "12345678-0001").

✅For status, strictly pass numerical constraints like vatStatus: 1 (Zero Rated).

📌 Use the Verification endpoints to resolve TIN numbers if unsure.

🏦 How Encrypted Credentials Work

Authority gateway credentials in TaxStreem are strictly partitioned:

Never pass raw passwords over standard HTTP JSON bodies.
You will specify an AES-256-GCM encoded string when transmitting.

For example, to execute a filing, pass the cipher as encryptedPayload: "eyJhbG...".

💡 Additional Notes

📘 Idempotency IDs like filingId are globally unique.

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