Nó hoạt động như thế nào?
Để loại bỏ thuế, phí hoặc lệ phí khỏi một giá toàn diện, bạn sẽ sử dụng cấu hình reverseAmountDetails
trong yêu cầu API của bạn. Đối tượng này cho Zonos biết các thành phần nào được bao gồm trong giá đầu vào của bạn và nên được loại bỏ để tính toán giá cơ bản thực sự cho hải quan.
Khi bạn gửi một giá toàn diện với cấu hình reverseAmountDetails
tương ứng, Zonos sẽ:
- Phân tích giá toàn diện và các tham số đã chỉ định.
- Xác định các thành phần nào (thuế, phí, lệ phí) cần loại bỏ.
- Tính toán giá cơ bản bằng cách loại bỏ các thành phần này.
- Trả về cả giá cơ bản đã điều chỉnh và một bảng phân tích các khoản đã loại bỏ.
Hướng dẫn API
Để tích hợp reverse inclusive pricing vào quy trình làm việc của bạn, hãy bao gồm đối tượng reverseAmountDetail
trong yêu cầu itemCreateWorkflow
.
Cấu hình yêu cầu
Việc truyền reverseAmountDetail
cho Zonos biết rằng cần loại bỏ thuế, phí và/hoặc lệ phí. Nếu cấu hình này không được truyền, tính toán landed cost tiêu chuẩn sẽ được thực hiện.
itemReverseAmountType
Xác định các thành phần nào được bao gồm trong giá. Bạn có thể chọn từ:
TAX
: Chỉ có thuế được bao gồm.DUTY
: Chỉ có lệ phí được bao gồm.DUTY_TAX
: Lệ phí và thuế được bao gồm.TAX_FEE
: Thuế và lệ phí được bao gồm.DUTY_FEE
: Lệ phí và lệ phí được bao gồm.DUTY_TAX_FEE
: Lệ phí, thuế và lệ phí đều được bao gồm.
taxRateCountry
Chỉ định quốc gia mà thuế rate được bao gồm trong giá. Đây là tùy chọn.
- Nếu không được chỉ định, hệ thống sẽ mặc định sử dụng thuế rate của quốc gia đích.
- Giá trị nên là một mã quốc gia ISO hợp lệ.
dutyRateCountry
Chỉ định quốc gia mà lệ phí rate được bao gồm trong giá. Đây là tùy chọn.
- Nếu không được chỉ định, hệ thống sẽ mặc định sử dụng thuế rate của quốc gia đích.
- Giá trị nên là một mã quốc gia ISO hợp lệ.
serviceLevelCodes
Điều này chỉ cần thiết nếu itemReverseAmountType
bao gồm FEE
.
- Chỉ định các phí dịch vụ vận chuyển nào được bao gồm trong giá.
- Giá trị nên là một mảng các mã cấp độ dịch vụ.
status
(chỉ phản hồi)Chỉ định kết quả của phép tính đảo ngược. Trường này được trả về trong phản hồi:
APPLIED
: Phép tính đảo ngược đã được áp dụng thành công.NOT_APPLIED_UNDER_DE_MINIMIS
: Không có phép tính nào được áp dụng vì giá trị dưới ngưỡng de minimis.NOT_APPLIED_NEGATIVE_VALUE
: Phép tính đã bị bỏ qua để tránh giá trị âm.
Ví dụ API
Khi bạn đã chuẩn bị đầu vào cần thiết, hãy gửi phép biến đổi GraphQL đến API bằng cách sử dụng công cụ hoặc khách hàng ưa thích của bạn.
Biến đổi
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
}
}
Phản hồi
{
"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
Loại bỏ thuế, phí và lệ phí khỏi giá toàn diện của bạn qua API.
SẮP CÓ
Zonos' Reverse Inclusive Pricing cho phép bạn gửi một giá toàn diện—một giá đã bao gồm thuế, phí và/hoặc lệ phí—và nhận lại giá cơ bản để làm tài liệu hải quan. Điều này cho phép bạn hiển thị giá cả toàn diện cho người mua trong khi vẫn khai báo một giá cơ bản sạch, không bao gồm cho hóa đơn thương mại. Giải pháp này lý tưởng cho các thị trường nơi inclusive pricing được mong đợi hoặc yêu cầu, giúp bạn hỗ trợ các chiến lược giá toàn cầu và duy trì độ chính xác và tuân thủ hải quan.