DOCS

Reverse inclusive pricing

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.

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ẽ:

  1. Phân tích giá toàn diện và các tham số đã chỉ định.
  2. Xác định các thành phần nào (thuế, phí, lệ phí) cần loại bỏ.
  3. Tính toán giá cơ bản bằng cách loại bỏ các thành phần này.
  4. 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

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

Phản hồi

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

Trang này có hữu ích không?