DOCS

Reverse inclusive pricing

Landed Cost•
DomGlobalny e-commerce Inclusive pricing Reverse inclusive pricing

Reverse inclusive pricing

Odwróć cła, podatki i opłaty z Twojej ceny całkowitej za pomocą API.

BETA

Reverse Zonos' inclusive pricing pozwala na przesłanie ceny całkowitej—takiej, która już zawiera cła, podatki i/lub opłaty—i otrzymanie ceny podstawowej w zamian dla dokumentacji celnej. Umożliwia to wyświetlanie cen całkowitych dla kupujących, jednocześnie deklarując czystą, niecałkowitą cenę podstawową na fakturze handlowej. To rozwiązanie jest idealne dla rynków, gdzie inclusive pricing jest oczekiwane lub wymagane, pomagając wspierać globalne strategie cenowe oraz utrzymywać dokładność i zgodność z przepisami celnymi.

Jak to działa? 

Aby odwrócić cła, podatki lub opłaty z ceny całkowitej, użyjesz konfiguracji reverseAmountDetails w swoim żądaniu API. Ten obiekt informuje Zonos, które składniki są zawarte w Twojej cenie wejściowej i powinny zostać usunięte, aby obliczyć prawdziwą cenę podstawową dla celów celnych.

Kiedy przesyłasz cenę całkowitą z odpowiednią konfiguracją reverseAmountDetails, Zonos:

  1. Analizuje cenę całkowitą i określone parametry.
  2. Określa, które składniki (cła, podatki, opłaty) należy odwrócić.
  3. Oblicza cenę podstawową, usuwając te składniki.
  4. Zwraca zarówno dostosowaną cenę podstawową, jak i szczegółowe zestawienie odwróconych kwot.

Przewodnik po API 

Aby zintegrować reverse inclusive pricing w swoim workflow, dołącz obiekt reverseAmountDetail w żądaniu itemCreateWorkflow.

Konfigurowanie żądania

Przekazanie reverseAmountDetail informuje Zonos, aby odwrócił cła, podatki i/lub opłaty. Jeśli ta konfiguracja nie zostanie przekazana, zostanie przeprowadzone standardowe obliczenie landed cost.

itemReverseAmountType

Definiuje, które składniki są zawarte w cenie. Możesz wybrać z:

  • TAX: Tylko podatek jest zawarty.
  • DUTY: Tylko cło jest zawarte.
  • DUTY_TAX: Cło i podatek są zawarte.
  • TAX_FEE: Podatek i opłaty są zawarte.
  • DUTY_FEE: Cło i opłaty są zawarte.
  • DUTY_TAX_FEE: Cło, podatek i opłaty są wszystkie zawarte.
taxRateCountry

Wskazuje kraj, którego podatek rate jest zawarty w cenie. To jest opcjonalne.

  • Jeśli nie jest określone, system domyślnie przyjmuje podatek rate kraju docelowego.
  • Wartość powinna być ważnym kodem kraju ISO.
dutyRateCountry

Wskazuje kraj, którego cło rate jest zawarte w cenie. To jest opcjonalne.

  • Jeśli nie jest określone, system domyślnie przyjmuje podatek rate kraju docelowego.
  • Wartość powinna być ważnym kodem kraju ISO.
serviceLevelCodes

To jest wymagane tylko wtedy, gdy itemReverseAmountType zawiera FEE.

  • Określa, które opłaty za poziom usługi wysyłkowej są zawarte w cenie.
  • Wartość powinna być tablicą kodów poziomu usługi.
status (tylko odpowiedź)

Wskazuje wynik obliczenia odwrotnego. To pole jest zwracane w odpowiedzi:

  • APPLIED: Obliczenie odwrotne zostało pomyślnie zastosowane.
  • NOT_APPLIED_UNDER_DE_MINIMIS: Żadne obliczenie nie zostało zastosowane, ponieważ wartość jest poniżej progu de minimis.
  • NOT_APPLIED_NEGATIVE_VALUE: Obliczenie zostało pominięte, aby uniknąć wartości ujemnej.

Przykład API

Gdy przygotujesz wymagane dane wejściowe, wyślij mutację GraphQL do API za pomocą preferowanego klienta lub narzędzia.

Mutacja

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

Odpowiedź

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

Czy ta strona była pomocna?

Zarezerwuj demonstrację

Zobacz Zonos

polityki i umowy
© 2025 Zonoszonos.com
Na tej stronie:
  • Reverse inclusive pricing
  • Jak to działa?
  • Przewodnik po API