DOCS

Ters inclusive pricing

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.

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:

  1. Dahil fiyatı ve belirtilen parametreleri analiz edin.
  2. Tersine çevrilecek bileşenleri (gümrük vergileri, vergiler, ücretler) belirleyin.
  3. Bu bileşenleri kaldırarak temel fiyatı hesaplayın.
  4. 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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
{
  "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"
      }
    ]
  }
}

Bu sayfa yardımcı oldu mu?