DOCS

Rating object

/

Objeto de calificación

Explora las capacidades y funciones del objeto de calificación.

El objeto de calificación proporcionará cotizaciones de envío por nivel de servicio con un desglose de recargos, tarifas y descuentos negociados de rate que conforman la cotización.

Atributos 

CampoNotas
id STRINGEl identificador único para el objeto. El id para el objeto de calificación siempre estará precedido por ship.
currency HASHHash que proporciona información sobre la moneda base enviada en la solicitud y proporcionada para la respuesta.
currency.id STRINGEl identificador único para el objeto de moneda.
currency.base STRINGLa moneda base como se envió en la solicitud de calificación, representada por un código ISO de tres letras. Todos los montos en el objeto de calificación están listados en la moneda base.
currency.date TIMESTAMPLa fecha en la que se extrajo la rate de la moneda, en el formato ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ.
currency.rates HASHHash que contiene las monedas y tasas de cambio necesarias para la conversión desde la moneda base.
errors HASHHash que contiene los detalles de cualquier error en la solicitud.
errors.type STRINGEl origen del error. Los valores posibles incluyen fedex_api ups_api dhl_api usps_api internal_error zonos_configuration.
errors.message STRINGLa razón descriptiva del error del transportista correspondiente.
errors.details HASHHash que contiene detalles sobre el nivel de servicio que devolvió un error.
errors.details.id STRINGEl identificador único para el nivel de servicio.
errors.details.service_level STRINGEl nivel de servicio con el transportista, por ejemplo, standard.
errors.details.display_name STRINGEl nombre para mostrar del nivel de servicio.
quotes LISTLa lista de cotizaciones de envío por nivel de servicio.
quotes.id STRINGEl identificador único para el objeto. El id para el objeto de cotizaciones siempre estará precedido por rtqt.
quotes.amount_subtotal DECIMALEl costo total de envío calculado para el nivel de servicio.
quotes.weight HASHHash que proporciona información sobre el peso utilizado para el costo de envío cotizado.
quotes.weight.billable DECIMALEl peso facturable del paquete utilizado para la cotización de envío.
quotes.weight.unit STRINGLa unidad de medida para el peso. Los valores posibles son pound, ounce, kilogram, y null. Cuando es null, se utilizará pound.
quotes.mode HASHHash que contiene información detallada sobre el nivel de servicio.
quotes.mode.service_level STRINGEl nivel de servicio con el transportista, por ejemplo, standard. Ejemplos comunes incluyen: 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, y fedex_international_ground. Consulte la documentación del transportista para la lista completa de niveles de servicio disponibles por transportista.
quotes.mode.display_name STRINGEl nombre para mostrar del nivel de servicio.
quotes.mode.delivery_date_estimate TIMESTAMPLa fecha estimada de entrega para el nivel de servicio, en el formato ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ. Esto se devolverá si está disponible desde la API del transportista.
quotes.mode.transit_business_days INTEGEREl número estimado de días de tránsito para el nivel de servicio contando solo los días hábiles como días de tránsito. Esto se devolverá si está disponible desde la API del transportista.
quotes.mode.transit_days INTEGEREl número estimado de días de tránsito para el nivel de servicio. Esto se devolverá si está disponible desde la API del transportista.
quotes.mode.rates HASHHash que contiene información detallada sobre la desglose del monto de la rate de envío.
quotes.mode.rates.amount DECIMALEl monto del artículo de rate específico.
quotes.mode.rates.note STRINGDetalles adicionales sobre lo que representa el monto del artículo de rate.
quotes.mode.rates.type STRINGEl tipo del artículo de rate. Los valores posibles incluyen retail_shipping, fuel_surcharge, carrier_fee, negotiated_discount.
quotes.packages LISTUna lista de detalles sobre los paquetes que se están enviando.
quotes.packages.id STRINGEl identificador único para el objeto de paquetes.
quotes.packages.weight HASHHash que contiene detalles del peso del paquete.
quotes.packages.weight.billable DECIMALEl peso facturable del paquete.
quotes.packages.weight.dimensional DECIMALEl peso dimensional del paquete.
quotes.packages.weight.factor INTEGEREl factor de peso internacional utilizado para calcular el peso dimensional del paquete.
quotes.packages.weight.weight_unit STRINGUna cadena con la unidad de medida para el peso. Los valores posibles son libra, onza, kilogramo, nulo. Cuando es nulo, se utilizará libra.

Respuesta de ejemplo

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

¿Fue útil esta página?