DOCS

Reverse Inclusive Pricing

Reverse Inclusive Pricing

Scorpora dazi, imposte e commissioni dal prezzo all-inclusive tramite API.

BETA

Reverse Inclusive Pricing di Zonos consente di inviare un prezzo all-inclusive — che include già dazi, imposte e/o commissioni — e di ricevere in cambio il prezzo base per la documentazione doganale. Ciò consente di mostrare prezzi all-inclusive agli acquirenti pur dichiarando un prezzo base non inclusivo per la fattura commerciale. Questa soluzione è ideale per i mercati in cui Inclusive Pricing è previsto o richiesto, aiutandoti a supportare strategie di pricing globale e a mantenere accuratezza e conformità doganale.

Come funziona? 

Per scorporare dazi, imposte o commissioni da un prezzo all-inclusive, utilizzerai la configurazione reverseAmountDetails nella richiesta API. Questo oggetto indica a Zonos quali componenti sono inclusi nel prezzo di input e devono essere rimossi per calcolare il vero prezzo base per la dogana.

Quando invii un prezzo all-inclusive con la rispettiva configurazione reverseAmountDetails, Zonos:

  1. Analizza il prezzo all-inclusive e i parametri specificati.
  2. Determina quali componenti (dazi, imposte, commissioni) scorporare.
  3. Calcola il prezzo base rimuovendo tali componenti.
  4. Restituisce sia il prezzo base rettificato sia un dettaglio degli importi scorporati.

Guida API 

Per integrare Reverse Inclusive Pricing nel tuo flusso di lavoro, includi l'oggetto reverseAmountDetail nella richiesta itemCreateWorkflow.

Configurazione della richiesta

Passando reverseAmountDetail indichi a Zonos di scorporare dazi, imposte e/o commissioni. Se questa configurazione non viene passata, verrà eseguito il calcolo standard del landed cost.

itemReverseAmountType

Definisce quali componenti sono inclusi nel prezzo. Puoi scegliere tra:

  • TAX: è inclusa solo l'imposta.
  • DUTY: è incluso solo il dazio.
  • DUTY_TAX: sono inclusi dazio e imposta.
  • TAX_FEE: sono incluse imposta e commissioni.
  • DUTY_FEE: sono inclusi dazio e commissioni.
  • DUTY_TAX_FEE: sono inclusi dazio, imposta e commissioni.
taxRateCountry

Indica il paese la cui aliquota fiscale è inclusa nel prezzo. Questo campo è facoltativo.

  • Se non specificato, il sistema utilizza per impostazione predefinita l'aliquota fiscale del paese di destinazione.
  • Il valore deve essere un codice paese ISO valido.
dutyRateCountry

Indica il paese la cui aliquota doganale è inclusa nel prezzo. Questo campo è facoltativo.

  • Se non specificato, il sistema utilizza per impostazione predefinita l'aliquota fiscale del paese di destinazione.
  • Il valore deve essere un codice paese ISO valido.
serviceLevelCodes

Obbligatorio solo se itemReverseAmountType include FEE.

  • Specifica quali commissioni del livello di servizio di spedizione sono incluse nel prezzo.
  • Il valore deve essere un array di codici del livello di servizio.
status (solo risposta)

Indica l'esito del calcolo inverso. Questo campo viene restituito nella risposta:

  • APPLIED: il calcolo inverso è stato applicato correttamente.
  • NOT_APPLIED_UNDER_DE_MINIMIS: nessun calcolo applicato perché il valore è al di sotto della soglia de minimis.
  • NOT_APPLIED_NEGATIVE_VALUE: calcolo ignorato per evitare un valore negativo.

Esempio API

Una volta preparato l'input richiesto, invia la mutation GraphQL all'API utilizzando il client o lo strumento che preferisci.

1mutation {
2 partyCreateWorkflow(
3 input: [
4 { type: ORIGIN, location: { countryCode: US } }
5 {
6 type: DESTINATION
7 location: { countryCode: CA, administrativeAreaCode: "AB" }
8 }
9 ]
10 ) {
11 id
12 }
13 itemCreateWorkflow(
14 input: [
15 {
16 productId: "product-1"
17 hsCode: "9503.00.9079"
18 countryOfOrigin: US
19 amount: 100
20 quantity: 1
21 currencyCode: USD
22 reverseAmountDetail: { type: DUTY_TAX, taxRateCountry: CA }
23 }
24 ]
25 ) {
26 id
27 amount
28 currencyCode
29 quantity
30 hsCode
31 countryOfOrigin
32 reverseAmountDetail {
33 originalAmount
34 amount
35 status
36 type
37 dutyRateCountry
38 taxRateCountry
39 taxRate
40 dutyRate
41 feeAmount
42 }
43 }
44 cartonsCreateWorkflow(
45 input: {
46 length: 8
47 width: 4
48 height: 2
49 dimensionalUnit: INCH
50 weight: 1
51 weightUnit: POUND
52 }
53 ) {
54 id
55 }
56 shipmentRatingCreateWorkflow(
57 input: {
58 amount: "30.00"
59 currencyCode: USD
60 serviceLevelCode: "ups.worldwide_expedited"
61 }
62 ) {
63 id
64 }
65 landedCostCalculateWorkflow(input: { calculationMethod: DDP_PREFERRED }) {
66 id
67 amountSubtotals {
68 items
69 shipping
70 duties
71 taxes
72 fees
73 }
74 duties {
75 amount
76 currency
77 note
78 }
79 fees {
80 amount
81 currency
82 type
83 note
84 }
85 taxes {
86 amount
87 currency
88 }
89 method
90 }
91}

Questa pagina è stata utile?