Attributs
Paires clé/valeur JSON dans le corps de la demande
POST | https://api.zonos.com/v1/shipment_rating
EN-TÊTE zonos-version: 2020-03-04
L'en-tête ci-dessus est une entrée requise pour que cette demande de notation soit complétée avec succès.
Champ | Remarques |
---|---|
currency OBLIGATOIRE | La chaîne de la devise de base, représentée par un code ISO à trois lettres. |
items_amount OBLIGATOIRE | Un décimal avec un montant d'articles. |
packages OBLIGATOIRE | Une liste du nombre et des dimensions des colis expédiés. hash |
packages.id OBLIGATOIRE | L'identifiant unique du colis pour le commerçant ou l'exportateur. |
packages.dimensions OBLIGATOIRE | Les dimensions du colis. hash |
packages.dimensions.height OBLIGATOIRE | Un décimal pour la hauteur de la boîte d'expédition. |
packages.dimensions.length OBLIGATOIRE | Un décimal pour la longueur de la boîte d'expédition. |
packages.dimensions.unit OBLIGATOIRE | L'unité de mesure pour les dimensions de la boîte d'expédition. Les valeurs possibles sont inch centimeter millimeter null . Lorsque null , inch sera utilisé. |
packages.dimensions.width OBLIGATOIRE | Un décimal contenant la largeur de la boîte d'expédition. |
packages.insured_amount OPTIONNEL | Un décimal avec le montant de l'assurance. |
packages.type OPTIONNEL | Une chaîne pour spécifier un type de boîte de transport spécifique à utiliser pour le calcul d'expédition. Les valeurs possibles incluent FEDEX_BOX |
packages.weight OBLIGATOIRE | Un décimal contenant le poids du colis. |
packages.weight_unit OBLIGATOIRE | Une chaîne avec l'unité de mesure pour le poids. Les valeurs possibles sont pound ounce kilogram null . Lorsque null , pound sera utilisé. |
pickup_date OBLIGATOIRE | La date de ramassage demandée pour le colis, au format ISO 8601 YYYY-MM-DDTHH:mm:ss.sss+0000 . UTC est supposé lorsque aucune information de fuseau horaire n'est fournie. |
service_level OPTIONNEL | Le niveau de service avec le transporteur, par exemple, standard . hash Exemples courants incluent : 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 , et fedex_international_ground . Voir la documentation des transporteurs pour la liste complète des niveaux de service disponibles par transporteur. |
ship_from OBLIGATOIRE | L'adresse d'origine. hash |
ship_from.city | Une chaîne pour la ville, le bourg, le district, le faubourg ou le village de l'adresse d'origine. |
ship_from.country OBLIGATOIRE | La chaîne du pays d'origine, représentée par un code ISO à deux lettres. |
ship_from.postal_code OBLIGATOIRE | Une chaîne pour le code postal de l'adresse d'origine. |
ship_from.state_code OBLIGATOIRE | Une chaîne pour l'adresse d'origine lorsque disponible. Nécessaire uniquement au Canada et au Brésil. |
ship_to OBLIGATOIRE | L'adresse de destination. hash |
ship_to.city OBLIGATOIRE | Une chaîne pour la ville, le bourg, le district, le faubourg ou le village du client. |
ship_to.country OBLIGATOIRE | Une chaîne pour le pays de destination, représentée par un code ISO à deux lettres. |
ship_to.postal_code REQUIS | Une chaîne pour le code postal de destination. Optionnel en fonction du pays d'importation. |
ship_to.state_code REQUIS | Une chaîne pour le code d'état de destination lorsque disponible. Obligatoire uniquement au Canada et au Brésil. |
ship_to.type REQUIS | Le type de l'adresse de destination. Les valeurs possibles incluent résidentiel et commercial . |
Exemple de demande
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"
}
}
Exemple de réponse
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"
}
}
]
}
]
}
Demandez une notation d'expédition
Explorez les paires clé/valeur dans une demande de notation d'expédition.
Demandez les tarifs d'expédition internationale pour différents prestataires de services d'expédition configurés dans les paramètres de votre magasin dans Zonos.