DOCS

Rating object

/

Oggetto di valutazione

Esplora le capacità e le funzioni dell'oggetto di valutazione.

L'oggetto di valutazione fornirà preventivi di spedizione per livello di servizio con una suddivisione dei supplementi, delle spese e degli sconti rate negoziati che compongono il preventivo.

Attributi 

CampoNote
id STRINGL'identificatore unico per l'oggetto. L'id per l'oggetto di valutazione sarà sempre preceduto da ship.
currency HASHHash che fornisce informazioni sulla valuta di base inviata nella richiesta e fornita per la risposta.
currency.id STRINGL'identificatore unico per l'oggetto valuta.
currency.base STRINGLa valuta di base come inviata nella richiesta di valutazione, rappresentata da un codice ISO a tre lettere. Tutti gli importi nell'oggetto di valutazione 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.
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 fornito dal corriere corrispondente.
errors.details HASHHash contenente dettagli sul livello di servizio che ha restituito un errore.
errors.details.id STRINGL'identificatore unico per il livello di servizio.
errors.details.service_level STRINGIl livello di servizio con il corriere, ad esempio standard.
errors.details.display_name STRINGIl nome visualizzato per il livello di servizio.
quotes LISTL'elenco delle quotazioni di spedizione per livello di servizio.
quotes.id STRINGL'identificatore unico per l'oggetto. L'id per l'oggetto delle quotazioni 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 la quotazione di spedizione.
quotes.weight.unit STRINGL'unità di misura per il peso. I valori possibili sono pound, ounce, kilogram, e null. Quando è null, verrà utilizzato pound.
quotes.mode HASHHash contenente informazioni dettagliate sul livello di servizio.
quotes.mode.service_level STRINGIl livello di servizio con il 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. Vedi la documentazione dei corrieri per l'elenco completo dei livelli di servizio disponibili per corriere.
quotes.mode.display_name STRINGIl nome visualizzato per il 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. Questo verrà restituito se disponibile dall'API del corriere.
quotes.mode.transit_business_days INTEGERIl numero stimato di giorni di transito per il livello di servizio contando solo i giorni lavorativi come giorni di transito. Questo verrà restituito se disponibile dall'API del corriere.
quotes.mode.transit_days INTEGERIl numero stimato di giorni di transito per il livello di servizio. Questo verrà restituito se disponibile dall'API del corriere.
quotes.mode.rates HASHHash contenente informazioni dettagliate sulla suddivisione dell'importo della spedizione rate.
quotes.mode.rates.amount DECIMALL'importo del specifico elemento rate.
quotes.mode.rates.note STRINGDettagli aggiuntivi su cosa rappresenta l'importo dell'elemento rate.
quotes.mode.rates.type STRINGIl tipo dell'elemento rate. I valori possibili includono retail_shipping fuel_surcharge carrier_fee negotiated_discount.
quotes.packages LISTUn elenco di dettagli sui pacchi in spedizione.
quotes.packages.id STRINGL'identificatore unico per l'oggetto pacchi.
quotes.packages.weight HASHHash contenente dettagli sul peso del pacco.
quotes.packages.weight.billable DECIMALIl 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 per il peso. I valori possibili sono pound ounce kilogram null. Quando null, verrà utilizzato pound.

Esempio di 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
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
{
  "id": "ship_5p67angIDnS91CyfpW55YZ",
  "currency": {
    "id": "curr_1Rp9lhXSRXvEWVs97k2PHE",
    "base": "USD",
    "date": "2020-02-04T18:47:04.629+0000",
    "rates": []
  },
  "errors": [
    {
      "details": {
        "id": "rtqt_7cz80Ny8dToSqoWlHTJJnP",
        "display_name": "FedEx Express Saver",
        "service_level": "FEDEX_EXPRESS_SAVER",
        "message": "[868] Service is not allowed.  ",
        "type": "fedex_api"
      }
    }
  ],
  "quotes": [
    {
      "id": "rtqt_4BUyxLEUeoU6zDdprCRoUV",
      "amount_subtotal": 943.18,
      "mode": {
        "delivery_date_estimate": null,
        "display_name": "UPS Expedited ",
        "rates": [
          {
            "amount": 848.31,
            "note": "UPS api: standard rate",
            "type": "retail_shipping"
          },
          {
            "amount": 64.4,
            "note": "UPS api: fuel surcharge",
            "type": "fuel_surcharge"
          },
          {
            "amount": 40.0,
            "note": "UPS api: extended area",
            "type": "carrier_fee"
          },
          {
            "amount": -9.53,
            "note": "UPS negotiated discount",
            "type": "negotiated_discount"
          }
        ],
        "service_level": "UPS_WORLDWIDE_EXPEDITED",
        "transit_business_days": null,
        "transit_days": null
      },
      "packages": [
        {
          "id": "1",
          "weight": {
            "billable": 32.0,
            "dimensional": 30.7554,
            "factor": 139,
            "weight_unit": "pound"
          }
        }
      ],
      "weight": {
        "billable": 32.0,
        "unit": "pound"
      }
    },
    {
      "id": "rtqt_1jyuPdiE5uIBcYzhO54DAb",
      "amount_subtotal": 1058.86,
      "mode": {
        "delivery_date_estimate": null,
        "display_name": "UPS Saver ",
        "rates": [
          {
            "amount": 957.26,
            "note": "UPS api: standard rate",
            "type": "retail_shipping"
          },
          {
            "amount": 72.3,
            "note": "UPS api: fuel surcharge",
            "type": "fuel_surcharge"
          },
          {
            "amount": 40.0,
            "note": "UPS api: extended area",
            "type": "carrier_fee"
          },
          {
            "amount": -10.7,
            "note": "UPS negotiated discount",
            "type": "negotiated_discount"
          }
        ],
        "service_level": "UPS_SAVER",
        "transit_business_days": null,
        "transit_days": null
      },
      "packages": [
        {
          "id": "1",
          "weight": {
            "billable": 32.0,
            "dimensional": 30.7554,
            "factor": 139,
            "weight_unit": "pound"
          }
        }
      ],
      "weight": {
        "billable": 32.0,
        "unit": "pound"
      }
    }
  ]
}

Questa pagina è stata utile?