AccueilRéférence de l'API API REST de notation 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.

Champ	Remarques
`devise` REQUIS	La chaîne de devise de base, représentée par un code ISO à trois lettres.
`montant_articles` REQUIS	Un décimal avec un montant d'article.
`colis` REQUIS	Une liste du nombre et des dimensions des colis expédiés. `hash`
`colis.id` REQUIS	L'identifiant unique du colis pour le commerçant ou l'exportateur.
`colis.dimensions` REQUIS	Les dimensions du colis. `hash`
`colis.dimensions.hauteur` REQUIS	Un décimal pour la hauteur de la boîte d'expédition.
`colis.dimensions.longueur` REQUIS	Un décimal pour la longueur de la boîte d'expédition.
`colis.dimensions.unité` REQUIS	L'unité de mesure des dimensions de la boîte d'expédition. Les valeurs possibles sont `pouce` `centimètre` `millimètre` `null`. Lorsque `null`, `pouce` sera utilisé.
`colis.dimensions.largeur` REQUIS	Un décimal contenant la largeur de la boîte d'expédition.
`colis.montant_assuré` FACULTATIF	Un décimal avec le montant de l'assurance.
`colis.type` FACULTATIF	Une chaîne pour spécifier un type de boîte de transporteur spécifique à utiliser pour le calcul d'expédition. Les valeurs possibles incluent `FEDEX_BOX`
`colis.poids` REQUIS	Un décimal contenant le poids du colis.
`colis.unité_poids` REQUIS	Une chaîne avec l'unité de mesure du poids. Les valeurs possibles sont `livre` `once` `kilogramme` `null`. Lorsque `null`, `livre` sera utilisé.
`date_enlèvement` REQUIS	La date d'enlèvement demandée pour le colis, au format ISO 8601 `AAAA-MM-JJTHH:mm:ss.sssZ`. L'UTC est supposé lorsque aucune information de fuseau horaire n'est transmise.
`niveau_service` FACULTATIF	Le niveau de service avec le transporteur, par exemple `standard`. `hash`Les 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`. Consultez la documentation du transporteur pour la liste complète des niveaux de service disponibles par transporteur.
`expéditeur` REQUIS	L'adresse d'origine. `hash`
`expéditeur.ville`	Une chaîne pour la ville, la commune, le quartier, la banlieue ou le village de l'adresse d'origine.
`expéditeur.pays` REQUIS	La chaîne de pays d'origine, représentée par un code ISO à deux lettres.
`expéditeur.code_postal` REQUIS	Une chaîne pour le code postal de l'adresse d'origine.
`expéditeur.code_état` REQUIS	Une chaîne pour l'adresse d'origine lorsque disponible. Uniquement requis au Canada et au Brésil.
`destinataire` REQUIS	L'adresse de destination. `hash`
`destinataire.ville` REQUIS	Une chaîne pour la ville, la commune, le quartier, la banlieue ou le village du client.
`destinataire.pays` REQUIS	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

{
  "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

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?

Des questions ?

Contactez-nous.

Voir Zonos

politiques et accords