DOCS

Ters inclusive pricing

Landed Cost•
AnasayfaKüresel e-ticaret Inclusive pricing Ters inclusive pricing

Ters inclusive pricing

Dahil fiyatınızdan gümrük vergilerini, vergileri ve ücretleri API aracılığıyla tersine çevirin.

BETA

Zonos'un ters inclusive pricing özelliği, gümrük belgeleri için temel fiyatı almak üzere gümrük vergilerini, vergileri ve/veya ücretleri zaten içeren bir dahil fiyatı göndermenizi 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 zorunlu olduğu pazarlarda idealdir ve küresel fiyatlandırma stratejilerini desteklemenize ve gümrük doğruluğu ile 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 bir dahil fiyat gönderdiğinizde, Zonos:

  1. Dahil fiyatı ve belirtilen parametreleri analiz eder.
  2. Tersine çevrilecek bileşenleri (gümrük vergileri, vergiler, ücretler) belirler.
  3. Bu bileşenleri kaldırarak temel fiyatı hesaplar.
  4. Hem ayarlanmış temel fiyatı hem de tersine çevrilen miktarların dökümünü geri döner.

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 ücretlerin hepsi dahildir.
taxRateCountry

Fiyatta hangi ülkenin vergi rate'sinin dahil olduğunu belirtir. Bu isteğe bağlıdır.

  • Belirtilmezse, sistem varsayılan olarak varış ülkesinin vergi rate'sini kullanır.
  • Değer, geçerli bir ISO ülke kodu olmalıdır.
dutyRateCountry

Fiyatta hangi ülkenin gümrük vergisi rate'sinin dahil olduğunu belirtir. Bu isteğe bağlıdır.

  • Belirtilmezse, sistem varsayılan olarak varış ülkesinin vergi rate'sini kullanır.
  • Değer, geçerli bir ISO ülke kodu olmalıdır.
serviceLevelCodes

Bu, yalnızca itemReverseAmountType 'ın FEE'yi içermesi durumunda gereklidir.

  • Fiyatta hangi nakliye hizmet seviyesi ücretlerinin dahil olduğunu belirtir.
  • Değer, hizmet seviyesi kodlarının bir dizisi olmalıdır.
status (yalnızca yanıt)

Ters hesaplamanın sonucunu belirtir. Bu alan yanıt içinde döner:

  • 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
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
  }
}

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?

Bir demo rezervasyonu yap

Sorular?

Destek al
© 2025 Zonoszonos.com
Bu sayfada:
  • Ters inclusive pricing
  • Nasıl çalışır?
  • API kılavuzu