透過 API 從您的包含性價格中反向處理關稅、稅項和費用。
BETA
Zonos 的反向包容定價功能讓您可以提交包含性價格(已包括關稅、稅項和/或費用)並獲得基礎價格的回報,以用於清關文件。這讓您可以向購物者展示全包價格,同時仍為商業發票申報清晰、非包含性的基礎價格。此解決方案適用於要求或規定包含性定價的市場,幫助您支持全球定價策略並維持清關準確性和合規性。
要從包含性價格中反向處理關稅、稅項或費用,您需要在 API 請求中使用 reverseAmountDetails 配置。此物件告訴 Zonos 您的輸入價格中包含哪些元素,應移除這些元素以計算用於清關的真實基礎價格。
reverseAmountDetails
當您發送包含 reverseAmountDetails 配置的包含性價格時,Zonos 將:
若要將反向包容定價整合到您的工作流程中,請在 itemCreateWorkflow 要求中包含 reverseAmountDetail 物件。
itemCreateWorkflow
reverseAmountDetail
傳遞 reverseAmountDetail 告訴 Zonos 要反向處理關稅、稅項和/或費用。如果未傳遞此配置,將執行標準 Landed Cost 計算。
itemReverseAmountType
定義價格中包含哪些元素。您可以選擇以下任一選項:
TAX
DUTY
DUTY_TAX
TAX_FEE
DUTY_FEE
DUTY_TAX_FEE
taxRateCountry
表示價格中包含其稅率的國家/地區。此為選項。
dutyRateCountry
表示價格中包含其關稅率的國家/地區。此為選項。
serviceLevelCodes
僅當 itemReverseAmountType 包含 FEE 時才需要此項。
FEE
status
表示反向計算的結果。此欄位在回應中返回:
APPLIED
NOT_APPLIED_UNDER_DE_MINIMIS
NOT_APPLIED_NEGATIVE_VALUE
準備好必要的輸入後,使用您偏好的用戶端或工具將 GraphQL mutation 傳送至 API。
mutation {
partyCreateWorkflow(
input: [
{ type: ORIGIN, location: { countryCode: US } }
{
type: DESTINATION
location: { countryCode: CA, administrativeAreaCode: "AB" }
}
]
) {
id
itemCreateWorkflow(
productId: "product-1"
hsCode: "9503.00.9079"
countryOfOrigin: US
amount: 100
quantity: 1
currencyCode: USD
reverseAmountDetail: { type: DUTY_TAX, taxRateCountry: CA }
amount
currencyCode
quantity
hsCode
countryOfOrigin
reverseAmountDetail {
originalAmount
type
taxRate
dutyRate
feeAmount
cartonsCreateWorkflow(
input: {
length: 8
width: 4
height: 2
dimensionalUnit: INCH
weight: 1
weightUnit: POUND
shipmentRatingCreateWorkflow(
amount: "30.00"
serviceLevelCode: "ups.worldwide_expedited"
landedCostCalculateWorkflow(input: { calculationMethod: DDP_PREFERRED }) {
amountSubtotals {
items
shipping
duties
taxes
fees
duties {
currency
note
fees {
taxes {
method
反向包容定價
反向包容定價
透過 API 從您的包含性價格中反向處理關稅、稅項和費用。
BETA
Zonos 的反向包容定價功能讓您可以提交包含性價格(已包括關稅、稅項和/或費用)並獲得基礎價格的回報,以用於清關文件。這讓您可以向購物者展示全包價格,同時仍為商業發票申報清晰、非包含性的基礎價格。此解決方案適用於要求或規定包含性定價的市場,幫助您支持全球定價策略並維持清關準確性和合規性。
運作原理
要從包含性價格中反向處理關稅、稅項或費用,您需要在 API 請求中使用
reverseAmountDetails配置。此物件告訴 Zonos 您的輸入價格中包含哪些元素,應移除這些元素以計算用於清關的真實基礎價格。當您發送包含
reverseAmountDetails配置的包含性價格時,Zonos 將:API 指南
若要將反向包容定價整合到您的工作流程中,請在
itemCreateWorkflow要求中包含reverseAmountDetail物件。配置請求
傳遞
reverseAmountDetail告訴 Zonos 要反向處理關稅、稅項和/或費用。如果未傳遞此配置,將執行標準 Landed Cost 計算。itemReverseAmountType定義價格中包含哪些元素。您可以選擇以下任一選項:
TAX:僅包含稅項。DUTY:僅包含關稅。DUTY_TAX:包含關稅和稅項。TAX_FEE:包含稅項和費用。DUTY_FEE:包含關稅和費用。DUTY_TAX_FEE:包含關稅、稅項和費用。taxRateCountry表示價格中包含其稅率的國家/地區。此為選項。
dutyRateCountry表示價格中包含其關稅率的國家/地區。此為選項。
serviceLevelCodes僅當
itemReverseAmountType包含FEE時才需要此項。status(僅限回應)表示反向計算的結果。此欄位在回應中返回:
APPLIED:反向計算已成功套用。NOT_APPLIED_UNDER_DE_MINIMIS:未套用計算,因為價值低於極小值門檻。NOT_APPLIED_NEGATIVE_VALUE:跳過計算以避免負值。API 範例
準備好必要的輸入後,使用您偏好的用戶端或工具將 GraphQL mutation 傳送至 API。
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}}這個頁面有幫助嗎?