Atributos
Pares clave/valor JSON en el cuerpo de la solicitud
POST | https://api.zonos.com/v1/shipment_rating
ENCABEZADO zonos-version: 2020-03-04
El encabezado anterior es una entrada requerida para que esta solicitud de calificación se complete con éxito.
| Campo | Notas |
|---|---|
moneda REQUERIDO | La cadena de moneda base, representada por un código ISO de tres letras. |
cantidad_articulos REQUERIDO | Un decimal con la cantidad de artículos. |
paquetes REQUERIDO | Una lista del número y dimensiones de los paquetes que se van a enviar. hash |
paquetes.id REQUERIDO | El identificador único del paquete para el comerciante o exportador. |
paquetes.dimensiones REQUERIDO | Las dimensiones del paquete. hash |
paquetes.dimensiones.altura REQUERIDO | Un decimal para la altura de la caja de envío. |
paquetes.dimensiones.longitud REQUERIDO | Un decimal para la longitud de la caja de envío. |
paquetes.dimensiones.unidad REQUERIDO | La unidad de medida para las dimensiones de la caja de envío. Los valores posibles son pulgada centímetro milímetro nulo. Cuando es nulo, se usará pulgada. |
paquetes.dimensiones.ancho REQUERIDO | Un decimal que contiene el ancho de la caja de envío. |
paquetes.monto_asegurado OPCIONAL | Un decimal con el monto del seguro. |
paquetes.tipo OPCIONAL | Una cadena para especificar un tipo de caja de transportista específico que se utilizará para el cálculo de envío. Los valores posibles incluyen FEDEX_BOX |
paquetes.peso REQUERIDO | Un decimal que contiene el peso del paquete. |
paquetes.unidad_peso REQUERIDO | Una cadena con la unidad de medida para el peso. Los valores posibles son libra onza kilogramo nulo. Cuando es nulo, se usará libra. |
fecha_recogida REQUERIDO | La fecha de recogida solicitada para el paquete, en el formato ISO 8601 AAAA-MM-DDTHH:mm:ss.sssZ. Se asume UTC cuando no se pasa información de zona horaria. |
nivel_servicio OPCIONAL | El nivel de servicio con el transportista, por ejemplo, estándar. hash 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 ver la lista completa de niveles de servicio disponibles por transportista. |
envio_desde REQUERIDO | La dirección de origen. hash |
envio_desde.ciudad | Una cadena para la ciudad, pueblo, distrito, suburbio o aldea de la dirección de origen. |
envio_desde.pais REQUERIDO | La cadena de país de origen, representada por un código ISO de dos letras. |
envio_desde.codigo_postal REQUERIDO | Una cadena para el código postal de la dirección de origen. |
envio_desde.codigo_estado REQUERIDO | Una cadena para la dirección de origen cuando esté disponible. Solo es requerido en Canadá y Brasil. |
envio_a REQUERIDO | La dirección de destino. hash |
envio_a.ciudad REQUERIDO | Una cadena para la ciudad, pueblo, distrito, suburbio o aldea del cliente. |
envio_a.pais REQUERIDO | Una cadena para el país de destino, representada por un código ISO de dos letras. |
ship_to.postal_code REQUERIDO | Una cadena para el código postal de destino. Opcional dependiendo del país de importación. |
ship_to.state_code REQUERIDO | Una cadena para el código de estado de destino cuando esté disponible. Solo requerido en Canadá y Brasil. |
ship_to.type REQUERIDO | El tipo de dirección de destino. Los valores posibles incluyen residencial y comercial. |
Solicitud 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
{
"currency": "USD",
"items_amount": 168.99,
"packages": [
{
"id": "1",
"dimensions": {
"height": 19.0,
"length": 15.0,
"unit": "inch",
"width": 15.0
},
"insured_amount": 33.22,
"type": null,
"weight": 32.0,
"weight_unit": "pound"
}
],
"pickup_date": "2020-07-06T18:47:04.629+0000",
"service_level": null,
"ship_from": {
"city": "St George",
"country": "US",
"postal_code": "84770",
"state_code": "UT"
},
"ship_to": {
"city": "Campinas",
"country": "BR",
"postal_code": "75828-000",
"state_code": "SP",
"type": "residential"
}
}
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",
"service_level": "FEDEX_EXPRESS_SAVER",
"display_name": "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,
"weight": {
"billable": 32.0,
"unit": "pound"
},
"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"
}
}
]
}
]
}
Solicitar una calificación de envío
Explore los pares clave/valor en una solicitud de calificación de envío.
Solicite tarifas de envío internacionales para varios proveedores de envío que estén configurados en la configuración de su tienda dentro de Zonos.