DOCS

Reverse inclusive pricing

Landed Cost•
HomeEcommerce globale Inclusive pricing Reverse inclusive pricing

Reverse inclusive pricing

Inverti dazi, tasse e commissioni dal tuo prezzo tutto incluso tramite API.

BETA

Il reverse Zonos di inclusive pricing ti consente di inviare un prezzo tutto incluso—uno che già include dazi, tasse e/o commissioni—e ricevere in cambio il prezzo base per la documentazione doganale. Questo ti permette di mostrare prezzi tutto incluso ai clienti, mantenendo comunque un prezzo base pulito e non incluso per la fattura commerciale. Questa soluzione è ideale per i mercati in cui ci si aspetta o è richiesto il inclusive pricing, aiutandoti a supportare strategie di prezzo globali e mantenere l'accuratezza e la conformità doganale.

Come funziona? 

Per invertire dazi, tasse o commissioni da un prezzo tutto incluso, utilizzerai la configurazione reverseAmountDetails nella tua richiesta API. Questo oggetto indica a Zonos quali componenti sono inclusi nel tuo prezzo di input e devono essere rimossi per calcolare il vero prezzo base per le dogane.

Quando invii un prezzo tutto incluso con la rispettiva configurazione reverseAmountDetails, Zonos:

  1. Analizza il prezzo tutto incluso e i parametri specificati.
  2. Determina quali componenti (dazi, tasse, commissioni) invertire.
  3. Calcola il prezzo base rimuovendo questi componenti.
  4. Restituisce sia il prezzo base corretto che un riepilogo degli importi invertiti.

Guida API 

Per integrare il reverse inclusive pricing nel tuo flusso di lavoro, includi l'oggetto reverseAmountDetail nella richiesta itemCreateWorkflow.

Configurazione della richiesta

Passare reverseAmountDetail indica a Zonos di invertire dazi, tasse e/o commissioni. Se questa configurazione non viene passata, verrà eseguita la normale calcolo del landed cost.

itemReverseAmountType

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

  • TAX: Solo la tassa è inclusa.
  • DUTY: Solo il dazio è incluso.
  • DUTY_TAX: Dazio e tassa sono inclusi.
  • TAX_FEE: Tassa e commissioni sono incluse.
  • DUTY_FEE: Dazio e commissioni sono incluse.
  • DUTY_TAX_FEE: Dazio, tassa e commissioni sono tutti inclusi.
taxRateCountry

Indica il paese il cui rate fiscale è incluso nel prezzo. Questo è facoltativo.

  • Se non specificato, il sistema utilizza il rate fiscale del paese di destinazione.
  • Il valore deve essere un valido codice paese ISO.
dutyRateCountry

Indica il paese il cui rate doganale è incluso nel prezzo. Questo è facoltativo.

  • Se non specificato, il sistema utilizza il rate fiscale del paese di destinazione.
  • Il valore deve essere un valido codice paese ISO.
serviceLevelCodes

Questo è richiesto solo se itemReverseAmountType include FEE.

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

Indica il risultato del calcolo inverso. Questo campo viene restituito nella risposta:

  • APPLIED: Il calcolo inverso è stato applicato con successo.
  • NOT_APPLIED_UNDER_DE_MINIMIS: Nessun calcolo applicato perché il valore è al di sotto della soglia de minimis.
  • NOT_APPLIED_NEGATIVE_VALUE: Il calcolo è stato saltato per evitare un valore negativo.

Esempio API

Una volta preparato l'input richiesto, invia la mutazione GraphQL all'API utilizzando il tuo client o strumento preferito.

Mutazione

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

Risposta

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

Questa pagina è stata utile?

Prenota una demo
© 2025 Zonoszonos.com
In questa pagina:
  • Reverse inclusive pricing
  • Come funziona?
  • Guida API