DOCS

Landed cost object

/

Landed Cost oggetto

Esplora le capacità e le funzioni dell'oggetto Landed Cost.

L'oggetto Landed Cost fornisce una suddivisione e un totale dei diritti di importazione, tasse e commissioni.

Attributi 

CampoNote
id STRINGL'identificatore unico per l'oggetto. L'id per l' Landed Cost sarà sempre preceduto da ldct.
amount_subtotal HASHTotale dell' Landed cost. Se utilizzato per un checkout ecommerce, si consiglia di utilizzare questi totali per visualizzarli all'utente finale. Questi totali consentono un'integrazione più semplice senza la necessità di sommare dazi, tasse o commissioni per articolo e livello di spedizione. Ulteriori dettagli sono disponibili nell'oggetto landed cost. Vedi gli attributi figli di seguito.
amount_subtotal.duties DECIMALSomma di tutti i dazi nell'array dei dazi. Include i dazi applicati agli articoli, alla spedizione o eventuali dazi aggiuntivi applicati all'importazione. Per comprendere come vengono calcolati i dazi, vedere il documento sui dazi all'importazione.
amount_subtotal.fees DECIMALSomma delle varie commissioni nell'array delle commissioni. Include le commissioni di sdoganamento, le commissioni di importazione del paese o altre commissioni applicate all'importazione. Per comprendere meglio le commissioni di importazione, vedere il documento sulle commissioni di importazione.
amount_subtotal.taxes DECIMALSomma di tutte le tasse nell'array delle tasse. Include le tasse applicate agli articoli, ai dazi, alla spedizione o alle commissioni. Per comprendere meglio le tasse all'importazione, vedere il documento sulle tasse all'importazione.
currency HASHHash che fornisce informazioni sulla valuta di base inviata nella richiesta e su altre valute con il rate di cambio utilizzato al momento della risposta. Questo è utile se si desidera convertire nella valuta del paese di importazione o in altre valute utilizzate nel calcolo dell' landed cost. Vedi gli attributi figli di seguito.
currency.id STRINGL'identificatore unico per loggetto valuta.
currency.base STRINGLa valuta di base inviata nella richiesta dell' landed cost, rappresentata da un codice ISO di tre lettere. Tutti gli importi nell'oggetto landed cost sono elencati nella valuta di base.
currency.date TIMESTAMPLa data in cui il rate della valuta è stato estratto, nel formato ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ
currency.rates HASHHash contenente le valute e i tassi di cambio necessari per la conversione dalla valuta di base.
currency.rates.currency STRINGUna valuta di cambio rate utilizzata nel calcolo dell' landed cost.
currency.rates.rate DECIMALIl rate di cambio al momento della richiesta dell' landed cost per la valuta specificata.
customs HASHHash contenente informazioni utilizzate per determinare l' landed cost così come informazioni necessarie per la documentazione doganale e lo sdoganamento. Vedi gli attributi figli di seguito.
customs.delivery_duty_paid STRINGLa possibilità di addebitare dazi e tasse a qualcuno diverso dal destinatario (DDP - dazi pagati alla consegna) varia a seconda del corriere, del servizio di spedizione o del paese di destinazione. I valori possibili sono available, unavailable e unknown. Se il landed cost è utilizzato per un checkout ecommerce, dovresti consentire al cliente di pagare dazi e tasse solo se il risultato è available. Se il risultato è unknown, puoi presentare al cliente un importo stimato di dazi e tasse che dovrà pagare al momento della consegna oppure potresti non voler visualizzare affatto i dazi e le tasse per quel livello di servizio del corriere. Se il risultato è unavailable, il tuo account è stato configurato nel Zonos Dashboard per non consentire DDP, anche se è un servizio consentito dal corriere selezionato.
customs.items LISTL'elenco degli articoli inviati nella richiesta. Vedi gli attributi figli di seguito.
customs.items.id STRINGL'identificatore unico inviato nella richiesta.
customs.items.amount DECIMALL'importo dell'articolo nella valuta di base. Questo è l'importo inviato nella richiesta per questo articolo.
customs.items.country_of_origin STRINGIl paese di fabbricazione in cui l'articolo è stato prodotto. Rappresentato da un codice ISO a due lettere. Vedi il documento sui dazi all'importazione per capire come il paese di origine influisce sul calcolo del landed cost.
customs.items.country_of_origin_source STRINGLa fonte del paese di origine. I valori possibili sono zonos_catalog, api_request e account_default platform.
customs.items.description_customs STRINGLa descrizione suggerita delle merci per la fattura commerciale. Questa descrizione di solito differisce da una descrizione al dettaglio e include tipicamente una descrizione generale di cosa sia, di cosa sia fatto e a cosa serva.
customs.items.description_retail STRINGLa descrizione al dettaglio dell'articolo.
customs.items.detail STRINGCaratteristiche, attributi o descrizioni aggiuntive dell'articolo.
customs.items.dimensions LISTLa dimensione della spedizione. hash
customs.items.dimensions.height DECIMALL'altezza dell'articolo.
customs.items.dimensions.length DECIMALLa lunghezza dell'articolo.
customs.items.dimensions.unit STRINGL'unità di misura per le dimensioni dell'articolo. I valori possibili sono inch, centimeter, millimeter e null. Quando è null, verrà utilizzato inch.
customs.items.dimensions.width DECIMALLa larghezza dell'articolo.
customs.items.hs_code STRINGIl codice tariffario armonizzato utilizzato per determinare il rate nel calcolo del landed cost.
customs.items.hs_code_source STRINGLa fonte del codice tariffario armonizzato utilizzato, che può essere impostata da Zonos. I valori possibili sono zonos_catalog, api_request, zonos_classified, account_default e hs_correction.
customs.items.image_url STRINGL'URL dell'immagine.
customs.items.note STRINGDettagli aggiuntivi sulla sdoganamento dell'articolo o sul codice HS, se applicabile. Un esempio per l'India è Secondo le linee guida all'importazione dell'India per le spedizioni personali, il tuo codice HS è stato corretto in 9804.90.00.
customs.items.quantity INTEGERLa quantità dell'articolo come inviata nella richiesta.
customs.items.upc_code STRINGIl codice UPC dell'articolo.
customs.items.weight DECIMALIl peso dell'articolo.
customs.items.weight_unit STRINGL'unità di misura per il peso. I valori possibili sono pound, ounce, kilogram e null. Quando è null, verrà utilizzato pound.
customs.ship_to_country STRINGIl paese di importazione dove si applicano dazi e tasse.
customs.shipping_amount DECIMALL'importo della spedizione che dovrebbe essere elencato nella documentazione doganale.
de_minimis HASHInformazioni sulla soglia specifica per paese che determina quando si applicano dazi e tasse. L'array dei tassi di cambio conterrà il rate di conversione utilizzato per determinare se l'importazione era sopra o sotto le soglie di dazi e tasse. Vedi gli attributi figli di seguito.
de_minimis.formula STRINGLa formula utilizzata per calcolare l'idoneità alla soglia de minimis.
de_minimis.method STRINGQuesto è il metodo di calcolo, come cif, cifd, cifdt, fob o fobd.
de_minimis.note STRINGDettagli aggiuntivi sulla soglia de minimis, come fornire informazioni se un articolo non era idoneo per la considerazione de minimis, come il vino.
de_minimis.threshold STRINGSe la tassa è sotto o sopra la soglia fiscale. I valori possibili includono above o below.
de_minimis.type STRINGLa soglia de minimis applicata al type. I valori possibili includono tax e duty.
duties HASHUn array di dazi applicati all'importazione. La somma degli importi dei dazi è uguale a amount_subtotal.duties. Vedi gli attributi figli di seguito.
duties.amount DECIMALL'importo del dazio sull'item, shipping o fee.
duties.description STRINGDescrizioni variabili del dazio come duty, anti_dumping_duty e altro.
duties.formula STRINGLa formula utilizzata per calcolare l'importo del dazio. Per il dazio, questo è tipicamente il dazio per il paese di importazione e potrebbe essere ad valorem o un dazio specifico rate.
duties.item_id STRINGL'identificatore unico inviato nella richiesta. L'id è fornito solo quando il tipo è item.
duties.note STRINGDettagli aggiuntivi sul dazio, inclusi accordi di libero scambio, tassi di dazio ridotti, dazi anti-dumping e altro.
duties.type STRINGIl dazio è applicato al type. I valori possibili includono item, shipping e fee.
fees HASHUn array di commissioni applicate all'importazione. La somma degli importi delle commissioni è uguale a amount_subtotal.fees. Vedi gli attributi figli di seguito.
fees.amount DECIMALL'importo della commissione applicata all'item, spedizione, dazio, livello di servizio, vettore o paese. Questo importo è nella valuta base e potrebbe essere stato convertito dalla valuta rispettiva del paese di importazione alla valuta base inviata nella richiesta.
fees.description STRINGDescrizioni variabili della commissione come UPS Disbursement Fee, FedEx Advancement Fee e An Post Clearance Fee.
fees.formula STRINGLa formula utilizzata per calcolare la commissione. Per le commissioni, questo è tipicamente un importo fisso, una percentuale dei dazi e delle tasse, o un'altra formula.
fees.item_id STRINGIl tuo identificatore unico inviato nella richiesta landed cost. L'id è fornito solo quando il tipo è item.
fees.note STRINGDettagli aggiuntivi sulla commissione, se necessario.
fees.type STRINGLa commissione è applicata al type. I valori possibili includono advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country e other.
messages HASHUn elenco di messaggi non critici, ad esempio "L'importo della spedizione nella richiesta era nullo, questo potrebbe influenzare il calcolo."
messages.message STRINGUn messaggio utile relativo alla tua richiesta Landed Cost e quali informazioni non critiche mancavano.
messages.type STRINGIl tipo di messaggio. I valori possibili includono price_adjustment, default_value_used, shipping_missing e item_weight_missing.
remittance HASHUn array contenente l'importo e i dettagli di ciò che deve essere versato a un paese specifico (ad es. Australia, Nuova Zelanda, Norvegia o Regno Unito).
remittance.amount DECIMALL'importo di denaro che deve essere versato a un paese specifico.
remittance.description STRINGUna descrizione di cosa è il versamento (ad es. IVA del Regno Unito).
remittance.note STRINGUna nota su come la tassa dovrebbe essere versata (ad es. remit a HMRC trimestralmente).
removed_items LISTL'elenco degli articoli rimossi dalla richiesta per il calcolo del landed cost. Vedi gli attributi figli di seguito.
removed_items.id STRINGL'identificatore unico inviato nella richiesta.
removed_items.amount DECIMALL'importo dell'articolo nella valuta di base. Questo è l'importo inviato nella richiesta per questo articolo.
removed_items.country_of_origin STRINGIl paese di fabbricazione in cui l'articolo è stato prodotto. Rappresentato da un codice ISO a due lettere. Vedi il documento sui dazi all'importazione per capire come il paese di origine influisce sul calcolo del landed cost.
removed_items.country_or_origin_source STRINGLa fonte del paese di origine. I valori possibili sono zonos_catalog, api_request e account_default platform.
removed_items.description_customs STRINGLa descrizione suggerita delle merci per la fattura commerciale. Questa descrizione di solito differisce da una descrizione al dettaglio e include tipicamente una descrizione generale di cosa sia, di cosa sia fatto e a cosa serva.
removed_items.description_retail STRINGLa descrizione al dettaglio dell'articolo.
removed_items.hs_code STRINGIl codice tariffario armonizzato utilizzato per determinare il tasso di rate nel calcolo del landed cost.
removed_items.hs_code_source STRINGLa fonte del codice tariffario armonizzato utilizzato, che può essere impostata da Zonos. I valori possibili sono zonos_catalog, api_request, platform, zonos_classified, account_default e hs_correction.
removed_items.note STRINGDettagli aggiuntivi sulla sdoganamento dell'articolo o sul codice HS, se applicabile. Un esempio per l'India è Secondo le linee guida per l'importazione dell'India per le spedizioni personali, il tuo codice HS è stato corretto in 9804.90.00.
removed_items.quantity INTEGERLa quantità dell'articolo come inviata nella richiesta.
taxes HASHUn array di tasse applicate all'importazione. La somma degli importi delle tasse è uguale a amount_subtotal.taxes. Vedi gli attributi figli di seguito.
taxes.amount DECIMALL'importo della tassa sull'articolo, spedizione, dazio o tassa.
taxes.description STRINGDescrizioni variabili della tassa applicata come tax, VAT, GST, PST, HST e altro.
taxes.formula STRINGLa formula utilizzata per calcolare l'importo della tassa include tipicamente la tassa del paese di importazione; tuttavia, questa può anche essere una tassa statale (o provinciale) o una tassa ridotta (o aggiunta).
taxes.item_id STRINGL'identificatore unico inviato nella richiesta del landed cost. L'id è fornito solo quando il tipo è item.
taxes.note STRINGDettagli aggiuntivi sulla tassa, inclusi tassi di tassa ridotti o altre informazioni applicabili sulla tassa applicata.
taxes.type STRINGLa tassa è applicata al type. I valori possibili includono item, duty e shipping così come i tipi di tasse di advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country e other.

Esempio di richiesta

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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
{
  "id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
  "amount_subtotal": {
    "duties": 0,
    "fees": 15,
    "taxes": 12.25
  },
  "currency": {
    "id": "b5f06418-3",
    "base": "USD",
    "date": "2021-01-07T00:34:03.471+0000",
    "rates": [
      {
        "currency": "GBP",
        "rate": 0.8117
      }
    ]
  },
  "customs": {
    "delivery_duty_paid": "available",
    "items": [
      {
        "id": "294395",
        "amount": 39.17,
        "country_of_origin": "FR",
        "country_of_origin_source": null,
        "description_customs": "Hoka One Running Shoe - Women's",
        "description_retail": "Hoka One Running Shoe - Women's",
        "hs_code": "6116.10",
        "hs_code_source": "api_request",
        "note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
        "quantity": 1
      },
      {
        "id": "294396",
        "amount": 7.83,
        "country_of_origin": "CN",
        "country_of_origin_source": "account_default",
        "description_customs": "Galaxy Quest Men's Tee Blue",
        "description_retail": "Galaxy Quest Men's Tee Blue",
        "hs_code": "6217.10",
        "hs_code_source": "api_request",
        "note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
        "quantity": 1
      }
    ],
    "shipping_amount": 14.23,
    "ship_to_country": "GB"
  },
  "de_minimis": [
    {
      "formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
      "method": "FOB",
      "note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
      "threshold": "below",
      "type": "duty"
    },
    {
      "formula": "(cost {'<='} 0 gbp)",
      "method": "FOB",
      "note": "Tax applies to all shipments",
      "threshold": "above",
      "type": "tax"
    }
  ],
  "duties": [],
  "fees": [
    {
      "amount": 15,
      "description": "UPS United States Duty and Tax Forwarding Charge",
      "item_id": null,
      "formula": "15 USD",
      "note": null,
      "type": "ddp_service_fee"
    }
  ],
  "remittance": [
    {
      "amount": 12.25,
      "description": "UK VAT",
      "note": "remit to HMRC quarterly"
    }
  ],
  "removed_items": [],
  "taxes": [
    {
      "amount": 7.83,
      "description": "VAT (Value-added tax)",
      "item_id": "294395",
      "formula": "20%",
      "note": null,
      "type": "item"
    },
    {
      "amount": 2.3719,
      "description": "VAT (Value-added tax)",
      "item_id": "294395",
      "formula": "20%",
      "note": null,
      "type": "shipping"
    },
    {
      "amount": 1.57,
      "description": "VAT (Value-added tax)",
      "item_id": "294396",
      "formula": "20%",
      "note": null,
      "type": "item"
    },
    {
      "amount": 0.4741,
      "description": "VAT (Value-added tax)",
      "item_id": "294396",
      "formula": "20%",
      "note": null,
      "type": "shipping"
    }
  ]
}

Questa pagina è stata utile?