Hvordan fungerer det?
For at omvende 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 specificerede parametre.
- Bestemme hvilke komponenter (afgifter, skatter, gebyrer) der skal omvendes.
- 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 omvendt inclusive pricing i dit workflow, skal du inkludere reverseAmountDetail
objektet i itemCreateWorkflow
anmodningen.
Konfigurering af anmodningen
At sende reverseAmountDetail
fortæller Zonos at omvende 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 imellem:
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 skat rate er inkluderet i prisen. Dette er valgfrit.
- Hvis ikke specificeret, defaultes systemet til destinationens lands skat 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 specificeret, defaultes systemet til destinationens lands skat 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
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"
}
]
}
}
Omvendt inclusive pricing
Omvend afgifter, skatter og gebyrer fra din inklusive pris via API.
BETA
Zonos's omvendte inclusive pricing giver dig mulighed for at sende en inklusive pris—en der allerede inkluderer afgifter, skatter og/eller gebyrer—og modtage basisprisen tilbage 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.