Overview

PRISM (INVOICING)

Automating your invoice compliance lifecycle with Prism.

Prism is TaxStreem's invoice intelligence layer. It validates, extracts, and classifies invoice data for tax compliance — returning VAT treatment recommendations, WHT deduction amounts, and anomaly flags in a single synchronous response. Prism also handles vendor onboarding by storing and associating vendor tax profiles for future invoice analysis.

🧾 What Does Prism Do?

Prism exposes three core operations, each targeting a distinct stage of the invoice lifecycle:

Endpoint	Description
Analyze Invoice	Submit a single structured invoice and receive a compliance assessment with VAT treatment and WHT recommendations.
Batch Analyze	Submit up to 500 invoices in a single request for high-volume compliance processing.
Vendor Upload	Register a vendor's tax profile so Prism can apply the correct WHT rate and VAT status on future invoices automatically.

⚙️ How Invoice Analysis Works

When you submit an invoice, Prism inspects the line items, counterparty tax profile, and transaction context to determine the applicable tax treatment. The response includes:

✅VAT Treatment — whether VAT is applicable, exempt, or zero-rated per line item.

✅WHT Deduction — the recommended withholding amount to deduct from the vendor payout.

✅Anomaly Flags — detected inconsistencies such as missing Tax IDs, duplicate invoice numbers, or mismatched amounts.

📌 Compliant invoices can be routed directly to Flux for VAT or WHT filing without any additional transformation.

🏢 Vendor Tax Profiles

Registering a vendor via the Vendor Upload endpoint stores their Tax ID, VAT status, and applicable WHT rate against your account. Once uploaded:

Prism automatically applies the correct WHT rate to any future invoice submitted for that vendor.
You do not need to pass VAT status or WHT rate per-invoice — Prism resolves them from the stored profile.
Updates to a vendor profile take effect on all subsequent invoice submissions.

🛠️ Using Prism via API

Prism expects exact, validated values in every request. Avoid free-text fields where enumerated values are defined.

✅Pass vendor Tax IDs exactly as issued — 13 digits, no formatting (e.g. "taxId": "1234567890123").

✅Use the invoiceNumber field as your idempotency key — duplicate submissions with the same number are rejected.

💡 Additional Notes

📘 Invoice analysis is synchronous — results are returned immediately in the response body.

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

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