Nasıl çalışır?
Dahil bir fiyatın gümrük vergilerini, vergilerini veya ücretlerini tersine çevirmek için, API isteğinizde reverseAmountDetails
yapılandırmasını kullanacaksınız. Bu nesne, Zonos'a giriş fiyatınızda hangi bileşenlerin dahil olduğunu ve gerçek temel fiyatı hesaplamak için kaldırılması gerektiğini bildirir.
İlgili reverseAmountDetails
yapılandırması ile birlikte bir dahil fiyat gönderdiğinizde, Zonos şunları yapacaktır:
- Dahil fiyatı ve belirtilen parametreleri analiz edin.
- Tersine çevrilecek bileşenleri (gümrük vergileri, vergiler, ücretler) belirleyin.
- Bu bileşenleri kaldırarak temel fiyatı hesaplayın.
- Hem ayarlanmış temel fiyatı hem de tersine çevrilen miktarların dökümünü geri döndürün.
API kılavuzu
Ters inclusive pricing'i iş akışınıza entegre etmek için, itemCreateWorkflow
isteğinde reverseAmountDetail
nesnesini ekleyin.
İsteği yapılandırma
reverseAmountDetail
geçişi, Zonos'a gümrük vergilerini, vergileri ve/veya ücretleri tersine çevirmesini söyler. Bu yapılandırma geçilmezse, standart landed cost hesaplaması yapılacaktır.
itemReverseAmountType
Fiyatta hangi bileşenlerin dahil olduğunu tanımlar. Seçenekler:
TAX
: Sadece vergi dahildir.DUTY
: Sadece gümrük vergisi dahildir.DUTY_TAX
: Gümrük vergisi ve vergi dahildir.TAX_FEE
: Vergi ve ücretler dahildir.DUTY_FEE
: Gümrük vergisi ve ücretler dahildir.DUTY_TAX_FEE
: Gümrük vergisi, vergi ve ücretler hepsi dahildir.
taxRateCountry
Fiyatta hangi ülkenin vergi rate'inin dahil olduğunu belirtir. Bu isteğe bağlıdır.
- Belirtilmezse, sistem varsayılan olarak varış ülkesinin vergi rate'ini kullanır.
- Değer, geçerli bir ISO ülke kodu olmalıdır.
dutyRateCountry
Fiyatta hangi ülkenin gümrük vergisi rate'inin dahil olduğunu belirtir. Bu isteğe bağlıdır.
- Belirtilmezse, sistem varsayılan olarak varış ülkesinin vergi rate'ini kullanır.
- Değer, geçerli bir ISO ülke kodu olmalıdır.
serviceLevelCodes
Bu, yalnızca itemReverseAmountType
'da FEE
dahilse gereklidir.
- Fiyatta hangi nakliye hizmet seviyesi ücretlerinin dahil olduğunu belirtir.
- Değer, hizmet seviyesi kodlarının bir dizisi olmalıdır.
status
(sadece yanıt)Ters hesaplamanın sonucunu belirtir. Bu alan yanıt içinde döndürülür:
APPLIED
: Ters hesaplama başarıyla uygulandı.NOT_APPLIED_UNDER_DE_MINIMIS
: De minimis eşiğinin altında olduğu için hesaplama uygulanmadı.NOT_APPLIED_NEGATIVE_VALUE
: Negatif bir değeri önlemek için hesaplama atlandı.
API örneği
Gerekli girişi hazırladıktan sonra, tercih ettiğiniz istemci veya araç kullanarak API'ye GraphQL mutasyonunu gönderin.
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
}
}
Yanıt
{
"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"
}
]
}
}
Ters inclusive pricing
Dahil fiyatınızdan gümrük vergilerini, vergileri ve ücretleri API aracılığıyla tersine çevirin.
YAKINDA
Zonos'un Ters Inclusive Pricing'i, dahil fiyatı—zaten gümrük vergilerini, vergileri ve/veya ücretleri içeren bir fiyat—gümrük belgeleri için geri almak üzere temel fiyatı almanızı sağlar. Bu, alışveriş yapanlara tüm dahil fiyatları gösterirken, ticari fatura için temiz, dahil olmayan bir temel fiyat beyan etmenizi sağlar. Bu çözüm, inclusive pricing'in beklendiği veya gerekli olduğu pazarlarda idealdir ve küresel fiyatlandırma stratejilerini desteklemenize ve gümrük doğruluğu ve uyumunu sağlamanıza yardımcı olur.