DOCS

Oggetto Rating

Oggetto Rating

Esplori le funzionalità dell'oggetto Rating.

L'oggetto Rating fornisce preventivi di spedizione per livello di servizio con il dettaglio di supplementi, commissioni e sconti sulle tariffe negoziate che compongono il preventivo.

Attributi 

CampoNote
id STRINGL'identificatore univoco dell'oggetto. L'id dell'oggetto Rating sarà sempre preceduto da ship.
currency HASHHash che fornisce informazioni sulla valuta di base inviata nella richiesta e fornita nella risposta.
currency.id STRINGL'identificatore univoco dell'oggetto valuta.
currency.base STRINGLa valuta di base inviata nella richiesta di tariffazione, rappresentata da un codice ISO a tre lettere. Tutti gli importi dell'oggetto Rating sono indicati nella valuta di base.
currency.date TIMESTAMPLa data in cui è stato recuperato il tasso di cambio, 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.
errors HASHHash contenente i dettagli di eventuali errori nella richiesta.
errors.type STRINGL'origine dell'errore. I valori possibili includono fedex_api ups_api dhl_api usps_api internal_error zonos_configuration.
errors.message STRINGIl motivo descrittivo dell'errore dal corriere corrispondente.
errors.details HASHHash contenente i dettagli del livello di servizio che ha restituito un errore.
errors.details.id STRINGL'identificatore univoco del livello di servizio.
errors.details.service_level STRINGIl livello di servizio del corriere, ad esempio standard.
errors.details.display_name STRINGIl nome visualizzato del livello di servizio.
quotes LISTL'elenco dei preventivi di spedizione per livello di servizio.
quotes.id STRINGL'identificatore univoco dell'oggetto. L'id dell'oggetto quotes sarà sempre preceduto da rtqt.
quotes.amount_subtotal DECIMALIl costo totale di spedizione calcolato per il livello di servizio.
quotes.weight HASHHash che fornisce informazioni sul peso utilizzato per il costo di spedizione quotato.
quotes.weight.billable DECIMALIl peso fatturabile del pacco utilizzato per il preventivo di spedizione.
quotes.weight.unit STRINGL'unità di misura del peso. I valori possibili sono pound, ounce, kilogram e null. Quando è null, viene utilizzato pound.
quotes.mode HASHHash contenente informazioni dettagliate sul livello di servizio.
quotes.mode.service_level STRINGIl service_level del corriere, ad esempio standard. Esempi comuni includono: ups_express, ups_express_saver, ups_expedited, ups_economy, ups_standard, ups_mail_innovations_economy, ups_mail_innovations_priority, dhl_express, dhl_ecommerce_parcel_direct, fedex_priority, fedex_economy, usps_first_class_mail_international, usps_priority_mail_international, landmark_parcel, apc_parcel, point2point_standard, point2point_direct, point2point_packet e fedex_international_ground. Consultare la documentazione dei corrieri per l'elenco completo dei livelli di servizio disponibili per corriere.
quotes.mode.display_name STRINGIl nome visualizzato del livello di servizio.
quotes.mode.delivery_date_estimate TIMESTAMPLa data di consegna stimata per il livello di servizio, nel formato ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ. Viene restituita se disponibile dall'API del corriere.
quotes.mode.transit_business_days INTEGERIl numero stimato di giorni di transito per il livello di servizio, considerando come giorni di transito solo i giorni lavorativi. Viene restituito se disponibile dall'API del corriere.
quotes.mode.transit_days INTEGERIl numero stimato di giorni di transito per il livello di servizio. Viene restituito se disponibile dall'API del corriere.
quotes.mode.rates HASHHash contenente informazioni dettagliate sulla ripartizione dell'importo della tariffa di spedizione.
quotes.mode.rates.amount DECIMALL'importo della specifica voce tariffaria.
quotes.mode.rates.note STRINGDettagli aggiuntivi su ciò che rappresenta l'importo della voce tariffaria.
quotes.mode.rates.type STRINGIl tipo di voce tariffaria. I valori possibili includono retail_shipping fuel_surcharge carrier_fee negotiated_discount.
quotes.packages LISTUn elenco di dettagli sui pacchi spediti.
quotes.packages.id STRINGL'identificatore univoco dell'oggetto packages.
quotes.packages.weight HASHHash contenente dettagli sul peso del pacco.
quotes.packages.weight.billable DEMICALIl peso fatturabile del pacco.
quotes.packages.weight.dimensional DECIMALIl peso dimensionale del pacco.
quotes.packages.weight.factor INTEGERIl fattore di peso internazionale utilizzato per calcolare il peso dimensionale del pacco.
quotes.packages.weight.weight_unit STRINGUna stringa con l'unità di misura del peso. I valori possibili sono pound ounce kilogram null. Quando è null, viene utilizzato pound.
1{
2 "id": "ship_5p67angIDnS91CyfpW55YZ",
3 "currency": {
4 "id": "curr_1Rp9lhXSRXvEWVs97k2PHE",
5 "base": "USD",
6 "date": "2020-02-04T18:47:04.629+0000",
7 "rates": []
8 },
9 "errors": [
10 {
11 "details": {
12 "id": "rtqt_7cz80Ny8dToSqoWlHTJJnP",
13 "display_name": "FedEx Express Saver",
14 "service_level": "FEDEX_EXPRESS_SAVER",
15 "message": "[868] Service is not allowed. ",
16 "type": "fedex_api"
17 }
18 }
19 ],
20 "quotes": [
21 {
22 "id": "rtqt_4BUyxLEUeoU6zDdprCRoUV",
23 "amount_subtotal": 943.18,
24 "mode": {
25 "delivery_date_estimate": null,
26 "display_name": "UPS Expedited ",
27 "rates": [
28 {
29 "amount": 848.31,
30 "note": "UPS api: standard rate",
31 "type": "retail_shipping"
32 },
33 {
34 "amount": 64.4,
35 "note": "UPS api: fuel surcharge",
36 "type": "fuel_surcharge"
37 },
38 {
39 "amount": 40,
40 "note": "UPS api: extended area",
41 "type": "carrier_fee"
42 },
43 {
44 "amount": -9.53,
45 "note": "UPS negotiated discount",
46 "type": "negotiated_discount"
47 }
48 ],
49 "service_level": "UPS_WORLDWIDE_EXPEDITED",
50 "transit_business_days": null,
51 "transit_days": null
52 },
53 "packages": [
54 {
55 "id": "1",
56 "weight": {
57 "billable": 32,
58 "dimensional": 30.7554,
59 "factor": 139,
60 "weight_unit": "pound"
61 }
62 }
63 ],
64 "weight": {
65 "billable": 32,
66 "unit": "pound"
67 }
68 },
69 {
70 "id": "rtqt_1jyuPdiE5uIBcYzhO54DAb",
71 "amount_subtotal": 1058.86,
72 "mode": {
73 "delivery_date_estimate": null,
74 "display_name": "UPS Saver ",
75 "rates": [
76 {
77 "amount": 957.26,
78 "note": "UPS api: standard rate",
79 "type": "retail_shipping"
80 },
81 {
82 "amount": 72.3,
83 "note": "UPS api: fuel surcharge",
84 "type": "fuel_surcharge"
85 },
86 {
87 "amount": 40,
88 "note": "UPS api: extended area",
89 "type": "carrier_fee"
90 },
91 {
92 "amount": -10.7,
93 "note": "UPS negotiated discount",
94 "type": "negotiated_discount"
95 }
96 ],
97 "service_level": "UPS_SAVER",
98 "transit_business_days": null,
99 "transit_days": null
100 },
101 "packages": [
102 {
103 "id": "1",
104 "weight": {
105 "billable": 32,
106 "dimensional": 30.7554,
107 "factor": 139,
108 "weight_unit": "pound"
109 }
110 }
111 ],
112 "weight": {
113 "billable": 32,
114 "unit": "pound"
115 }
116 }
117 ]
118}

Questa pagina è stata utile?


In questa pagina: