Batch VAT filing
Use the batch endpoint to submit multiple VAT transactions in a single HTTP request. This is recommended for end-of-period aggregations and high-volume processors.
Endpoint
POST https://api.taxstreem.com/v1/flux/vat/batch-filing
The payload structure is the same as single filing, but the data array can contain up to 500 transaction records. A batchId is required to track the job.
Example request
{
"encryptedPayload": "enc_...",
"batchId": "batch_vat_march_2025",
"filingId": "fil_batch_001",
"month": 3,
"year": 2025,
"data": [
{ "vatStatus": 0, "amount": 107500, "item": "Consultancy", "taxId": "1234567890" },
{ "vatStatus": 1, "amount": 50000, "item": "Export services", "taxId": "1234567890" },
{ "vatStatus": 0, "amount": 215000, "item": "Software license", "taxId": "1234567890" }
]
}Batch results are delivered asynchronously. Each transaction in the batch gets its own webhook event. Use the
batchId to correlate results.