API d’estimation du fret international

POST /v1/fulfillment/shipments/freight/estimate — calculateur léger ; les montants sont indicatifs.

Comparez avec prévisualisation d’expédition (tarification exacte après entrée en entrepôt).

Estimation vs prévisualisation

freight/estimatepreview
QuandAvant / sans colis entrantsAprès réception des colis en entrepôt
EntréePays/code postal + poids/dimensionsparcel_nos[] + destinataire complet + canal
SortiePrix de référence quotes[]Un seul freight / services / total

Corps de requête

{
  "destination": {
    "country_code": "US",
    "region": "California",
    "postal_code": "90001"
  },
  "weight_kg": 2.05,
  "length_cm": 30,
  "width_cm": 20,
  "height_cm": 10,
  "attributes": [
    "general"
  ]
}
  • weight_kg et/ou length_cm + width_cm + height_cm (au moins un)
  • attributes[] optionnel (par ex. general, battery)
  • Pas de parcel_nos, pas d’adresse complète

Réponse

quotes[] avec shipping_channel_code, shipping_channel_name, freight, total (fen). Référence des champs : modèles de réponse.

Attributs d’article {#item-attributes}

GET /v1/fulfillment/shipments/item-attributes — codes attributes[] valides pour l’estimation (par ex. general, battery).