DOCS

Demandez une notation d'expédition

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.

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.

ChampRemarques
currency OBLIGATOIRELa chaîne de la devise de base, représentée par un code ISO à trois lettres.
items_amount OBLIGATOIREUn décimal avec un montant d'articles.
packages OBLIGATOIREUne liste du nombre et des dimensions des colis expédiés. hash
packages.id OBLIGATOIREL'identifiant unique du colis pour le commerçant ou l'exportateur.
packages.dimensions OBLIGATOIRELes dimensions du colis. hash
packages.dimensions.height OBLIGATOIREUn décimal pour la hauteur de la boîte d'expédition.
packages.dimensions.length OBLIGATOIREUn décimal pour la longueur de la boîte d'expédition.
packages.dimensions.unit OBLIGATOIREL'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 OBLIGATOIREUn décimal contenant la largeur de la boîte d'expédition.
packages.insured_amount OPTIONNELUn décimal avec le montant de l'assurance.
packages.type OPTIONNELUne 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 OBLIGATOIREUn décimal contenant le poids du colis.
packages.weight_unit OBLIGATOIREUne 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 OBLIGATOIRELa 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 OPTIONNELLe 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 OBLIGATOIREL'adresse d'origine. hash
ship_from.cityUne chaîne pour la ville, le bourg, le district, le faubourg ou le village de l'adresse d'origine.
ship_from.country OBLIGATOIRELa chaîne du pays d'origine, représentée par un code ISO à deux lettres.
ship_from.postal_code OBLIGATOIREUne chaîne pour le code postal de l'adresse d'origine.
ship_from.state_code OBLIGATOIREUne chaîne pour l'adresse d'origine lorsque disponible. Nécessaire uniquement au Canada et au Brésil.
ship_to OBLIGATOIREL'adresse de destination. hash
ship_to.city OBLIGATOIREUne chaîne pour la ville, le bourg, le district, le faubourg ou le village du client.
ship_to.country OBLIGATOIREUne chaîne pour le pays de destination, représentée par un code ISO à deux lettres.
ship_to.postal_code REQUISUne chaîne pour le code postal de destination. Optionnel en fonction du pays d'importation.
ship_to.state_code REQUISUne chaîne pour le code d'état de destination lorsque disponible. Obligatoire uniquement au Canada et au Brésil.
ship_to.type REQUISLe 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"
          }
        }
      ]
    }
  ]
}

Cette page était-elle utile?