How it works
Two fields on the landed cost calculation input control this behavior:
taxIdNumber– Your own tax registration number for the destination scheme (for example, an IOSS, UK VAT, or GST number). When provided, it is surfaced on the responseremittancelines so you can reconcile what to remit.taxRemittanceCalculation– Controls whether Zonos calculates remittance. Accepts:REMITTANCE– Zonos calculates tax remittance (the default behavior when a remittance scheme applies).NO_REMITTANCE– Zonos does not calculate remittance. Tax on duties is still calculated, but tax on goods and shipping is skipped, leaving you to remit the tax under your own registration.
When taxRemittanceCalculation applies
The tax ID you pass determines whether taxRemittanceCalculation is honored:
taxIdNumber passed↕ | Result↕ |
|---|---|
| None | taxRemittanceCalculation is ignored. Remittance is calculated as it is today. |
| Your own (non-Zonos) tax ID | taxRemittanceCalculation is honored — REMITTANCE or NO_REMITTANCE applies. |
| A Zonos-issued tax ID | taxRemittanceCalculation is ignored. Zonos calculates and remits as it does today. |
Use NO_REMITTANCE with your own tax ID when you intend to remit the destination tax yourself. The quote remains guaranteed, but Zonos will not collect or remit the tax on your behalf.
Calculate with your tax ID
Pass taxIdNumber with the behavior you want. For the same shipment, taxRemittanceCalculation changes the result. The examples below use a dutiable shipment to make the difference clear.
REMITTANCE — Zonos calculates remittance
Zonos calculates the full tax (on goods, shipping, and duties) and populates the remittance lines, with your taxIdNumber surfaced for reconciliation.
mutation { landedCostCalculateWorkflow( input: { endUse: NOT_FOR_RESALE method: DDP tariffRate: ZONOS_PREFERRED taxIdNumber: "IM1234567890" taxRemittanceCalculation: REMITTANCE } ) { id taxIdNumber amountSubtotals { duties taxes fees landedCostTotal } duties { amount currency } taxes { amount description currency } remittance { amount description note taxId taxIdNumber } }}NO_REMITTANCE — you remit the tax yourself
Zonos returns tax on duties only and leaves remittance empty, so you remit the destination tax on goods and shipping yourself under your own registration.
mutation { landedCostCalculateWorkflow( input: { endUse: NOT_FOR_RESALE method: DDP tariffRate: ZONOS_PREFERRED taxIdNumber: "IM1234567890" taxRemittanceCalculation: NO_REMITTANCE } ) { id taxIdNumber amountSubtotals { duties taxes fees landedCostTotal } duties { amount currency } taxes { amount description currency } remittance { amount description note taxId taxIdNumber } }}
Remit with your own tax ID
Supply your own tax registration number and control whether Zonos calculates tax remittance.
GraphQL
If you are already registered in a destination's low-value tax scheme (for example, you hold your own IOSS number for the EU, or a UK VAT or Australia GST registration), you can supply that registration number on the landed cost calculation and tell Zonos not to calculate remittance. Zonos still returns a guaranteed landed cost, but the tax is set aside for you to remit directly under your own registration rather than through Zonos.