Reverse duties, taxes, and fees from your inclusive price via API.
BETA
Zonos' reverse inclusive pricing lets you send an inclusive price—one that already includes duties, taxes, and/or fees—and receive the base price in return for customs documentation. This allows you to display all-in pricing to shoppers while still declaring a clean, non-inclusive base price for the commercial invoice. This solution is ideal for markets where inclusive pricing is expected or required, helping you support global pricing strategies and maintain customs accuracy and compliance.
To reverse duties, taxes, or fees from an inclusive price, you’ll use the reverseAmountDetails configuration in your API request. This object tells Zonos which components are included in your input price and should be removed to calculate the true base price for customs.
When you send an inclusive price with the respective reverseAmountDetails configuration, Zonos will:
Analyze the inclusive price and specified parameters.
Determine which components (duties, taxes, fees) to reverse.
Calculate the base price by removing these components.
Return both the adjusted base price and a breakdown of the reversed amounts.
To integrate reverse inclusive pricing into your workflow, include the reverseAmountDetail object in the itemCreateWorkflow request.
Configuring the request
Passing reverseAmountDetail tells Zonos to reverse out duties, taxes, and/or fees. If this configuration is not passed, the standard landed cost calculation will be performed.
itemReverseAmountType
Defines which components are included in the price. You can choose from:
TAX: Only tax is included.
DUTY: Only duty is included.
DUTY_TAX: Duty and tax are included.
TAX_FEE: Tax and fees are included.
DUTY_FEE: Duty and fees are included.
DUTY_TAX_FEE: Duty, tax, and fees are all included.
taxRateCountry
Indicates the country whose tax rate is included in the price. This is optional.
If not specified, the system defaults to the destination country’s tax rate.
Reverse inclusive pricing
Reverse inclusive pricing
Reverse duties, taxes, and fees from your inclusive price via API.
BETA
Zonos' reverse inclusive pricing lets you send an inclusive price—one that already includes duties, taxes, and/or fees—and receive the base price in return for customs documentation. This allows you to display all-in pricing to shoppers while still declaring a clean, non-inclusive base price for the commercial invoice. This solution is ideal for markets where inclusive pricing is expected or required, helping you support global pricing strategies and maintain customs accuracy and compliance.
How does it work?
To reverse duties, taxes, or fees from an inclusive price, you’ll use the
reverseAmountDetailsconfiguration in your API request. This object tells Zonos which components are included in your input price and should be removed to calculate the true base price for customs.When you send an inclusive price with the respective
reverseAmountDetailsconfiguration, Zonos will:API guide
To integrate reverse inclusive pricing into your workflow, include the
reverseAmountDetailobject in theitemCreateWorkflowrequest.Configuring the request
Passing
reverseAmountDetailtells Zonos to reverse out duties, taxes, and/or fees. If this configuration is not passed, the standard landed cost calculation will be performed.itemReverseAmountTypeDefines which components are included in the price. You can choose from:
TAX: Only tax is included.DUTY: Only duty is included.DUTY_TAX: Duty and tax are included.TAX_FEE: Tax and fees are included.DUTY_FEE: Duty and fees are included.DUTY_TAX_FEE: Duty, tax, and fees are all included.taxRateCountryIndicates the country whose tax rate is included in the price. This is optional.
dutyRateCountryIndicates the country whose duty rate is included in the price. This is optional.
serviceLevelCodesThis is required only if
itemReverseAmountTypeincludesFEE.status(response only)Indicates the result of the reverse calculation. This field is returned in the response:
APPLIED: The reverse calculation was successfully applied.NOT_APPLIED_UNDER_DE_MINIMIS: No calculation applied because the value is below the de minimis threshold.NOT_APPLIED_NEGATIVE_VALUE: Calculation was skipped to avoid a negative value.API example
Once you’ve prepared the required input, send the GraphQL mutation to the API using your preferred client or tool.
mutation {partyCreateWorkflow(input: [{ type: ORIGIN, location: { countryCode: US } }{type: DESTINATIONlocation: { countryCode: CA, administrativeAreaCode: "AB" }}]) {id}itemCreateWorkflow(input: [{productId: "product-1"hsCode: "9503.00.9079"countryOfOrigin: USamount: 100quantity: 1currencyCode: USDreverseAmountDetail: { type: DUTY_TAX, taxRateCountry: CA }}]) {idamountcurrencyCodequantityhsCodecountryOfOriginreverseAmountDetail {originalAmountamountstatustypedutyRateCountrytaxRateCountrytaxRatedutyRatefeeAmount}}cartonsCreateWorkflow(input: {length: 8width: 4height: 2dimensionalUnit: INCHweight: 1weightUnit: POUND}) {id}shipmentRatingCreateWorkflow(input: {amount: "30.00"currencyCode: USDserviceLevelCode: "ups.worldwide_expedited"}) {id}landedCostCalculateWorkflow(input: { calculationMethod: DDP_PREFERRED }) {idamountSubtotals {itemsshippingdutiestaxesfees}duties {amountcurrencynote}fees {amountcurrencytypenote}taxes {amountcurrency}method}}Was this page helpful?