EC VAT MOSS sales tax rates
Look up MOSS sales tax rate bands for an EU place-of-supply country and transaction date. See also Sales tax and VAT for field behaviour on invoices, estimates, and bank transaction explanations.
| SDK service | client.EcMoss (EcMossService) |
| FreeAgent docs | dev.freeagent.com/docs/sales_tax (EC VAT MOSS section) |
| Sample app | /ec-moss/sales-tax-rates |
Methods
ListSalesTaxRatesAsync
Task<IReadOnlyList<EcMossSalesTaxRate>> ListSalesTaxRatesAsync(
EcMossPlaceOfSupply country,
DateOnly date,
CancellationToken cancellationToken = default)
HTTP: GET /v2/ec_moss/sales_tax_rates?country={name}&date={YYYY-MM-DD}
country— EU member country name (useEcMossPlaceOfSupply; same values asplace_of_supplyon MOSS documents).date— Transaction date.
Models
| Property | Type | Wire field |
|---|---|---|
Percentage |
decimal? |
percentage |
Band |
string? |
band |
MOSS writes on other resources
When ec_status is EC VAT MOSS:
- Invoices, estimates, credit notes —
place_of_supply(EcMossPlaceOfSupply) is required on create and update (validated by the SDK before HTTP). - Bank transaction explanations —
place_of_supplyandsales_tax_rateare required on create and update when MOSS applies.
Use ListSalesTaxRatesAsync with the same country and transaction date to choose a sales_tax_rate for bank explanations (and to inform invoice line rates).