Use the original supply context
For a refund or correction, start from the relevant supply date and business facts rather than recalculating with a current default.
Historical rate handling
Historical VAT rates API
A current rate is not always the right rate. VAT Engine stores recorded/imported lookup windows so callers can request a covered historical row. Current live apply history is not yet guaranteed legal applicability; source-supported dates, exact upstream provenance, and replay are planned.
What this helps you do
Handle refunds, audits, migrations, and delayed imports using date-aware tax inputs rather than silently substituting today’s rate.
- Date-indexed requests for supported VAT rates.
- Recorded lookup windows are retained for imported source coverage.
- Current live apply windows can reflect observation/apply time rather than a verified legal start.
- Source-supported applicability, immutable source-version evidence, and exact replay are planned and are not inferred for older records.
How to use it well
Keep corrections identifiable
Link a correction to a stable external event or order reference so review and reporting can distinguish revisions from duplicates.
Escalate gaps in source coverage
If the requested date or classification is not covered, stop for review instead of falling back to an unrelated rate.