Hvordan fungerer det?
For å reversere avgifter, skatter eller gebyrer fra en inkludert pris, må du bruke reverseAmountDetails
-konfigurasjonen i API-forespørselen din. Dette objektet forteller Zonos hvilke komponenter som er inkludert i din inngangspris og som skal fjernes for å beregne den sanne basisprisen for toll.
Når du sender en inkludert pris med den respektive reverseAmountDetails
-konfigurasjonen, vil Zonos:
- Analysere den inkluderte prisen og spesifiserte parametere.
- Bestemme hvilke komponenter (avgifter, skatter, gebyrer) som skal reverseres.
- Beregne basisprisen ved å fjerne disse komponentene.
- Returnere både den justerte basisprisen og en oversikt over de reverserte beløpene.
API-guide
For å integrere reverse inclusive pricing i arbeidsflyten din, inkluder reverseAmountDetail
-objektet i itemCreateWorkflow
-forespørselen.
Konfigurere forespørselen
Å sende reverseAmountDetail
forteller Zonos å reversere avgifter, skatter og/eller gebyrer. Hvis denne konfigurasjonen ikke sendes, vil den standard landed cost-beregningen bli utført.
itemReverseAmountType
Definerer hvilke komponenter som er inkludert i prisen. Du kan velge mellom:
TAX
: Bare skatt er inkludert.DUTY
: Bare avgift er inkludert.DUTY_TAX
: Avgift og skatt er inkludert.TAX_FEE
: Skatt og gebyrer er inkludert.DUTY_FEE
: Avgift og gebyrer er inkludert.DUTY_TAX_FEE
: Avgift, skatt og gebyrer er alle inkludert.
taxRateCountry
Indikerer landet hvis skatt rate er inkludert i prisen. Dette er valgfritt.
- Hvis ikke spesifisert, vil systemet bruke destinasjonslandets skatte rate som standard.
- Verdien bør være en gyldig ISO landkode.
dutyRateCountry
Indikerer landet hvis avgift rate er inkludert i prisen. Dette er valgfritt.
- Hvis ikke spesifisert, vil systemet bruke destinasjonslandets skatte rate som standard.
- Verdien bør være en gyldig ISO landkode.
serviceLevelCodes
Dette er kun nødvendig hvis itemReverseAmountType
inkluderer FEE
.
- Spesifiserer hvilke fraktservice nivå gebyrer som er inkludert i prisen.
- Verdien bør være et array av service nivå koder.
status
(bare respons)Indikerer resultatet av den reverserte beregningen. Dette feltet returneres i responsen:
APPLIED
: Den reverserte beregningen ble vellykket anvendt.NOT_APPLIED_UNDER_DE_MINIMIS
: Ingen beregning ble anvendt fordi verdien er under de minimis terskelen.NOT_APPLIED_NEGATIVE_VALUE
: Beregningen ble hoppet over for å unngå en negativ verdi.
API-eksempel
Når du har forberedt den nødvendige inngangen, send GraphQL-mutasjonen til API-en ved hjelp av din foretrukne klient eller verktøy.
Mutation
mutation {
partyCreateWorkflow(
input: [
{ type: ORIGIN, location: { countryCode: US } }
{
type: DESTINATION
location: { countryCode: CA, administrativeAreaCode: "AB" }
}
]
) {
id
}
itemCreateWorkflow(
input: [
{
productId: "product-1"
hsCode: "9503.00.9079"
countryOfOrigin: US
amount: 100
quantity: 1
currencyCode: USD
reverseAmountDetail: { type: DUTY_TAX, taxRateCountry: CA }
}
]
) {
id
amount
currencyCode
quantity
hsCode
countryOfOrigin
reverseAmountDetail {
originalAmount
amount
status
type
dutyRateCountry
taxRateCountry
taxRate
dutyRate
feeAmount
}
}
cartonsCreateWorkflow(
input: {
length: 8
width: 4
height: 2
dimensionalUnit: INCH
weight: 1
weightUnit: POUND
}
) {
id
}
shipmentRatingCreateWorkflow(
input: {
amount: "30.00"
currencyCode: USD
serviceLevelCode: "ups.worldwide_expedited"
}
) {
id
}
landedCostCalculateWorkflow(input: { calculationMethod: DDP_PREFERRED }) {
id
amountSubtotals {
items
shipping
duties
taxes
fees
}
duties {
amount
currency
note
}
fees {
amount
currency
feeType
type
note
}
taxes {
amount
currency
}
method
}
}
Svar
{
"data": {
"partyCreateWorkflow": [
{ "id": "party_cc85f44d-567a-4cb0-984f-17a0e2d97f78" },
{ "id": "party_0kcf5m0x404q6" }
],
"itemCreateWorkflow": [
{
"id": "item_0kcf5rsa420zy",
"amount": 95.0,
"currencyCode": "USD",
"quantity": 1,
"hsCode": "9503.00.9079",
"countryOfOrigin": "US",
"reverseAmountDetail": [
{
"originalAmount": 100,
"amount": 95.0,
"status": "APPLIED",
"type": "DUTY_TAX",
"dutyRateCountry": "CA",
"taxRateCountry": "CA",
"taxRate": 0.05,
"dutyRate": null,
"feeAmount": null
}
]
}
],
"cartonsCreateWorkflow": [{ "id": "carton_0kcf5rth4057g" }],
"shipmentRatingCreateWorkflow": {
"id": "shipment_rating_0kcf5rtpc057t"
},
"landedCostCalculateWorkflow": [
{
"id": "lc-6bfd94d67d2e43e5b5cf1143d56ca01e",
"amountSubtotals": {
"items": 95.0,
"shipping": 30.0,
"duties": 0.0,
"taxes": 5.2,
"fees": 9.5
},
"duties": [],
"fees": [
{
"amount": 7.16,
"currency": "USD",
"feeType": "ADVANCEMENT",
"type": "ADVANCEMENT",
"note": null
},
{
"amount": 1.77,
"currency": "USD",
"feeType": "BROKERAGE_FEE",
"type": "BROKERAGE_FEE",
"note": null
},
{
"amount": 0.57,
"currency": "USD",
"feeType": "CURRENCY_CONVERSION_FEE",
"type": "CURRENCY_CONVERSION_FEE",
"note": null
}
],
"taxes": [
{ "amount": 4.75, "currency": "USD" },
{ "amount": 0.36, "currency": "USD" },
{ "amount": 0.09, "currency": "USD" }
],
"method": "DDP"
}
]
}
}
Reverse inclusive pricing
Fjern avgifter, skatter og gebyrer fra din inkluderte pris via API.
KOMMER SNART
Zonos' Reverse Inclusive Pricing lar deg sende en inkludert pris—en som allerede inkluderer avgifter, skatter og/eller gebyrer—og motta basisprisen tilbake for tolldokumentasjon. Dette lar deg vise alt-inkludert priser til kunder samtidig som du erklærer en ren, ikke-inkludert basispris for den kommersielle fakturaen. Denne løsningen er ideell for markeder der inclusive pricing forventes eller kreves, og hjelper deg med å støtte globale prisstrategier og opprettholde nøyaktighet og samsvar med toll.