DOCS

Reverse inclusive pricing

Landed Cost•
BerandaEcommerce global Inclusive pricing Reverse inclusive pricing

Reverse inclusive pricing

Balikkan bea, pajak, dan biaya dari harga inklusif Anda melalui API.

SEGERA HADIR

Zonos' Reverse Inclusive Pricing memungkinkan Anda mengirimkan harga inklusif—yang sudah mencakup bea, pajak, dan/atau biaya—dan menerima harga dasar sebagai imbalannya untuk dokumentasi bea. Ini memungkinkan Anda menampilkan harga semua-in kepada pembeli sambil tetap menyatakan harga dasar yang bersih dan tidak inklusif untuk faktur komersial. Solusi ini ideal untuk pasar di mana inclusive pricing diharapkan atau diwajibkan, membantu Anda mendukung strategi harga global dan menjaga akurasi serta kepatuhan bea.

Bagaimana cara kerjanya? 

Untuk membalikkan bea, pajak, atau biaya dari harga inklusif, Anda akan menggunakan konfigurasi reverseAmountDetails dalam permintaan API Anda. Objek ini memberi tahu Zonos komponen mana yang termasuk dalam harga input Anda dan harus dihapus untuk menghitung harga dasar yang sebenarnya untuk bea.

Ketika Anda mengirimkan harga inklusif dengan konfigurasi reverseAmountDetails yang sesuai, Zonos akan:

  1. Menganalisis harga inklusif dan parameter yang ditentukan.
  2. Menentukan komponen mana (bea, pajak, biaya) yang akan dibalik.
  3. Menghitung harga dasar dengan menghapus komponen ini.
  4. Mengembalikan baik harga dasar yang disesuaikan maupun rincian jumlah yang dibalik.

Panduan API 

Untuk mengintegrasikan reverse inclusive pricing ke dalam alur kerja Anda, sertakan objek reverseAmountDetail dalam permintaan itemCreateWorkflow.

Mengonfigurasi permintaan

Menyampaikan reverseAmountDetail memberi tahu Zonos untuk membalikkan bea, pajak, dan/atau biaya. Jika konfigurasi ini tidak disampaikan, perhitungan landed cost standar akan dilakukan.

itemReverseAmountType

Menentukan komponen mana yang termasuk dalam harga. Anda dapat memilih dari:

  • TAX: Hanya pajak yang termasuk.
  • DUTY: Hanya bea yang termasuk.
  • DUTY_TAX: Bea dan pajak termasuk.
  • TAX_FEE: Pajak dan biaya termasuk.
  • DUTY_FEE: Bea dan biaya termasuk.
  • DUTY_TAX_FEE: Bea, pajak, dan biaya semuanya termasuk.
taxRateCountry

Menunjukkan negara yang pajak rate-nya termasuk dalam harga. Ini bersifat opsional.

  • Jika tidak ditentukan, sistem akan default ke pajak rate negara tujuan.
  • Nilai harus berupa kode negara ISO yang valid.
dutyRateCountry

Menunjukkan negara yang bea rate-nya termasuk dalam harga. Ini bersifat opsional.

  • Jika tidak ditentukan, sistem akan default ke pajak rate negara tujuan.
  • Nilai harus berupa kode negara ISO yang valid.
serviceLevelCodes

Ini hanya diperlukan jika itemReverseAmountType mencakup FEE.

  • Menentukan biaya tingkat layanan pengiriman mana yang termasuk dalam harga.
  • Nilai harus berupa array dari kode tingkat layanan.
status (hanya respons)

Menunjukkan hasil dari perhitungan balik. Bidang ini dikembalikan dalam respons:

  • APPLIED: Perhitungan balik berhasil diterapkan.
  • NOT_APPLIED_UNDER_DE_MINIMIS: Tidak ada perhitungan yang diterapkan karena nilai di bawah ambang de minimis.
  • NOT_APPLIED_NEGATIVE_VALUE: Perhitungan dilewati untuk menghindari nilai negatif.

Contoh API

Setelah Anda menyiapkan input yang diperlukan, kirimkan mutasi GraphQL ke API menggunakan klien atau alat pilihan Anda.

Mutasi

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

Respon

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"
      }
    ]
  }
}

Apakah halaman ini membantu?

Pesan demo
© 2025 Zonoszonos.com
Di halaman ini:
  • Reverse inclusive pricing
  • Bagaimana cara kerjanya?
  • Panduan API