Jak to działa?
Aby odwrócić cła, podatki lub opłaty z ceny z wszystkimi opłatami, użyjesz konfiguracji reverseAmountDetails
w swoim żądaniu API. Ten obiekt informuje Zonos, które składniki są zawarte w Twojej cenie wejściowej i powinny zostać usunięte, aby obliczyć prawdziwą cenę podstawową do celów celnych.
Kiedy przesyłasz cenę z wszystkimi opłatami z odpowiednią konfiguracją reverseAmountDetails
, Zonos:
- Analizuje cenę z wszystkimi opłatami i określone parametry.
- Określa, które składniki (cła, podatki, opłaty) należy odwrócić.
- Oblicza cenę podstawową, usuwając te składniki.
- Zwraca zarówno dostosowaną cenę podstawową, jak i szczegółowe zestawienie odwróconych kwot.
Przewodnik po API
Aby zintegrować reverse inclusive pricing w swoim przepływie pracy, dołącz obiekt reverseAmountDetail
w żądaniu itemCreateWorkflow
.
Konfigurowanie żądania
Przekazanie reverseAmountDetail
informuje Zonos, aby odwrócił cła, podatki i/lub opłaty. Jeśli ta konfiguracja nie zostanie przekazana, zostanie przeprowadzone standardowe obliczenie landed cost.
itemReverseAmountType
Definiuje, które składniki są zawarte w cenie. Możesz wybrać z:
TAX
: Tylko podatek jest zawarty.DUTY
: Tylko cło jest zawarte.DUTY_TAX
: Cło i podatek są zawarte.TAX_FEE
: Podatek i opłaty są zawarte.DUTY_FEE
: Cło i opłaty są zawarte.DUTY_TAX_FEE
: Cło, podatek i opłaty są wszystkie zawarte.
taxRateCountry
Wskazuje kraj, którego podatek rate jest zawarty w cenie. To jest opcjonalne.
- Jeśli nie jest określone, system domyślnie przyjmuje podatek rate kraju docelowego.
- Wartość powinna być ważnym kodem kraju ISO.
dutyRateCountry
Wskazuje kraj, którego cło rate jest zawarte w cenie. To jest opcjonalne.
- Jeśli nie jest określone, system domyślnie przyjmuje podatek rate kraju docelowego.
- Wartość powinna być ważnym kodem kraju ISO.
serviceLevelCodes
To jest wymagane tylko wtedy, gdy itemReverseAmountType
zawiera FEE
.
- Określa, które opłaty za poziom usługi wysyłkowej są zawarte w cenie.
- Wartość powinna być tablicą kodów poziomu usługi.
status
(tylko odpowiedź)Wskazuje wynik obliczenia odwrotnego. To pole jest zwracane w odpowiedzi:
APPLIED
: Obliczenie odwrotne zostało pomyślnie zastosowane.NOT_APPLIED_UNDER_DE_MINIMIS
: Żadne obliczenie nie zostało zastosowane, ponieważ wartość jest poniżej progu de minimis.NOT_APPLIED_NEGATIVE_VALUE
: Obliczenie zostało pominięte, aby uniknąć wartości ujemnej.
Przykład API
Gdy przygotujesz wymagane dane wejściowe, wyślij mutację GraphQL do API za pomocą preferowanego klienta lub narzędzia.
Mutacja
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
}
}
Odpowiedź
{
"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
Odwróć cła, podatki i opłaty z Twojej ceny z wszystkimi opłatami za pomocą API.
WKRÓTCE
Zonos' Reverse Inclusive Pricing pozwala na przesłanie ceny z wszystkimi opłatami—takiej, która już zawiera cła, podatki i/lub opłaty—i otrzymanie ceny podstawowej w zamian do dokumentacji celnej. Umożliwia to wyświetlanie cen z wszystkimi opłatami dla kupujących, jednocześnie deklarując czystą, nieinkluzywną cenę podstawową na fakturze handlowej. To rozwiązanie jest idealne dla rynków, gdzie inclusive pricing jest oczekiwane lub wymagane, pomagając wspierać globalne strategie cenowe oraz utrzymywać dokładność i zgodność z przepisami celnymi.