Hur fungerar det?
För att omvända avgifter, skatter eller avgifter från ett all-inclusive pris, kommer du att använda reverseAmountDetails-konfigurationen i din API-förfrågan. Detta objekt talar om för Zonos vilka komponenter som ingår i ditt ingångspris och som bör tas bort för att beräkna det verkliga baspriset för tull.
När du skickar ett all-inclusive pris med den respektive reverseAmountDetails-konfigurationen, kommer Zonos att:
- Analysera det all-inclusive priset och angivna parametrar.
- Bestämma vilka komponenter (avgifter, skatter, avgifter) som ska omvändas.
- Beräkna baspriset genom att ta bort dessa komponenter.
- Återvända både det justerade baspriset och en uppdelning av de omvända beloppen.
API-guide
För att integrera omvänd inclusive pricing i ditt arbetsflöde, inkludera reverseAmountDetail-objektet i itemCreateWorkflow-förfrågan.
Konfigurera förfrågan
Att skicka reverseAmountDetail talar om för Zonos att omvända avgifter, skatter och/eller avgifter. Om denna konfiguration inte skickas, kommer den standardmässiga landed cost-beräkningen att utföras.
itemReverseAmountTypeDefinierar vilka komponenter som ingår i priset. Du kan välja mellan:
TAX: Endast skatt ingår.DUTY: Endast avgift ingår.DUTY_TAX: Avgift och skatt ingår.TAX_FEE: Skatt och avgifter ingår.DUTY_FEE: Avgift och avgifter ingår.DUTY_TAX_FEE: Avgift, skatt och avgifter ingår alla.
taxRateCountryAnger landet vars skatt rate ingår i priset. Detta är valfritt.
- Om det inte anges, standardiserar systemet till destinationens lands skatt rate.
- Värdet bör vara en giltig ISO landskod.
dutyRateCountryAnger landet vars avgift rate ingår i priset. Detta är valfritt.
- Om det inte anges, standardiserar systemet till destinationens lands skatt rate.
- Värdet bör vara en giltig ISO landskod.
serviceLevelCodesDetta krävs endast om itemReverseAmountType inkluderar FEE.
- Specificerar vilka fraktservicenivåavgifter som ingår i priset.
- Värdet bör vara en array av servicenivåkoder.
status (endast svar)Anger resultatet av den omvända beräkningen. Detta fält returneras i svaret:
APPLIED: Den omvända beräkningen tillämpades framgångsrikt.NOT_APPLIED_UNDER_DE_MINIMIS: Ingen beräkning tillämpades eftersom värdet är under de minimis-tröskeln.NOT_APPLIED_NEGATIVE_VALUE: Beräkningen hoppades över för att undvika ett negativt värde.
API-exempel
När du har förberett den nödvändiga ingången, skicka GraphQL-mutation till API:et med hjälp av din föredragna klient eller verktyg.
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"
}
]
}
}
Omvänd inclusive pricing
Omvänd avgifter, skatter och avgifter från ditt all-inclusive pris via API.
BETA
Zonos's omvända inclusive pricing låter dig skicka ett all-inclusive pris—ett som redan inkluderar avgifter, skatter och/eller avgifter—och få tillbaka baspriset för tulldokumentation. Detta gör att du kan visa priser som är heltäckande för kunderna samtidigt som du deklarerar ett rent, icke-inkluderande baspris för den kommersiella fakturan. Denna lösning är idealisk för marknader där inclusive pricing förväntas eller krävs, vilket hjälper dig att stödja globala prissättningsstrategier och upprätthålla tullnoggrannhet och efterlevnad.