Hvordan fungerer det?
For at fjerne afgifter, skatter eller gebyrer fra en inklusive pris, skal du bruge reverseAmountDetails
konfigurationen i din API-anmodning. Dette objekt fortæller Zonos hvilke komponenter der er inkluderet i din inputpris og som skal fjernes for at beregne den sande basispris til told.
Når du sender en inklusive pris med den respektive reverseAmountDetails
konfiguration, vil Zonos:
- Analysere den inklusive pris og de angivne parametre.
- Bestemme hvilke komponenter (afgifter, skatter, gebyrer) der skal fjernes.
- Beregne basisprisen ved at fjerne disse komponenter.
- Returnere både den justerede basispris og en opdeling af de omvendte beløb.
API guide
For at integrere reverse inclusive pricing i dit workflow, skal du inkludere reverseAmountDetail
objektet i itemCreateWorkflow
anmodningen.
Konfigurering af anmodningen
At sende reverseAmountDetail
fortæller Zonos at fjerne afgifter, skatter og/eller gebyrer. Hvis denne konfiguration ikke sendes, vil den standard landed cost beregning blive udført.
itemReverseAmountType
Definerer hvilke komponenter der er inkluderet i prisen. Du kan vælge mellem:
TAX
: Kun skat er inkluderet.DUTY
: Kun afgift er inkluderet.DUTY_TAX
: Afgift og skat er inkluderet.TAX_FEE
: Skat og gebyrer er inkluderet.DUTY_FEE
: Afgift og gebyrer er inkluderet.DUTY_TAX_FEE
: Afgift, skat og gebyrer er alle inkluderet.
taxRateCountry
Angiver landet hvis skatte rate er inkluderet i prisen. Dette er valgfrit.
- Hvis ikke angivet, vil systemet som standard bruge destinationens lands skatte rate.
- Værdien skal være en gyldig ISO landekode.
dutyRateCountry
Angiver landet hvis afgift rate er inkluderet i prisen. Dette er valgfrit.
- Hvis ikke angivet, vil systemet som standard bruge destinationens lands skatte rate.
- Værdien skal være en gyldig ISO landekode.
serviceLevelCodes
Dette er kun påkrævet hvis itemReverseAmountType
inkluderer FEE
.
- Angiver hvilke forsendelsestjeneste niveau gebyrer der er inkluderet i prisen.
- Værdien skal være et array af service niveau koder.
status
(kun svar)Angiver resultatet af den omvendte beregning. Dette felt returneres i svaret:
APPLIED
: Den omvendte beregning blev anvendt med succes.NOT_APPLIED_UNDER_DE_MINIMIS
: Ingen beregning anvendt fordi værdien er under de minimis tærsklen.NOT_APPLIED_NEGATIVE_VALUE
: Beregningen blev sprunget over for at undgå en negativ værdi.
API eksempel
Når du har forberedt den nødvendige input, send GraphQL mutation til API'en ved hjælp af dit foretrukne klient eller værktøj.
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 afgifter, skatter og gebyrer fra din inklusive pris via API.
KOMMER SNART
Zonos's Reverse Inclusive Pricing giver dig mulighed for at sende en inklusive pris—en pris der allerede inkluderer afgifter, skatter og/eller gebyrer—og modtage basisprisen til tolddokumentation. Dette gør det muligt for dig at vise alt-inklusive priser til kunderne, mens du stadig erklærer en ren, ikke-inklusive basispris for den kommercielle faktura. Denne løsning er ideel til markeder, hvor inclusive pricing forventes eller kræves, hvilket hjælper dig med at understøtte globale prisstrategier og opretholde toldnøjagtighed og overholdelse.