APIPour les développeurs des marques e-commerce, marketplaces et 3PL

Une API d’expédition pour les vendeurs.

Tarifs, étiquettes avec documents douaniers, suivi et webhooks, validation des adresses : de simples endpoints REST. Intégrez l’expédition UPS, FedEx, USPS et DHL à votre boutique, à vos outils marketplace ou à votre système d’entrepôt.

couvre
Tarifs · Étiquettes · Suivi · Adresses
transporteurs
UPS · FedEx · USPS · DHL
style
REST + JSON, webhooks
POST/rates
// requête d’exemple : comparer les tarifs, puis acheter une étiquette
const rates = await ex.rates.create({
  from:   { country: 'ES', city: 'Barcelona' },
  to:     { country: 'US', city: 'Atlanta', state: 'GA' },
  parcel: { weight_oz: 8, length_in: 10, width_in: 8, height_in: 3 },
})

// acheter le moins cher, documents douaniers inclus
const label = await ex.labels.create({ rate: rates[0].id })
200tarifs de vos transporteurs, du moins cher au plus cherrequête d’exemple · champs exacts dans la référence de l’API

où elle se place

Votre système d’un côté, les transporteurs de l’autre.

Votre code parle à une seule API. ExperShip gère chaque transporteur, renvoie les tarifs et les étiquettes, et vous transmet les mises à jour de suivi au fil des envois.

OÙ SE PLACE L’APIschéma

ce que vous pouvez construire

Quatre briques pour expédier par le code.

Les mêmes fonctionnalités que l’application web ExperShip, disponibles par l’API. Utilisez-en une, ou branchez tout le parcours, de la commande à la porte.

tarifs

Tarifs multi-transporteurs

Envoyez une origine, une destination et un colis. Recevez les tarifs en direct des transporteurs de votre compte, du moins cher au plus cher, pour que votre code ou votre page de paiement choisisse le bon service.

  • Comparez UPS, FedEx, USPS et DHL en un seul appel
  • National aux États-Unis et international vers les États-Unis
  • Choisissez selon le prix, le délai ou vos propres règles
TARIFS Shopify #7323 → Philadelphiaréponse d’exemple
#TransporteurServiceNote
0FedExHome Deliveryle moins cher à temps
1USPSGround Advantagecomparé
2UPSGroundcomparé
3USPSPriority Mailcomparé
rates[0] est celui que vos règles ont choisi
étiquettes

Étiquettes, avec documents douaniers pour l’international

Transformez le tarif choisi en étiquette imprimable. Pour les colis qui entrent aux États-Unis, les documents douaniers reviennent à la même étape : rien n’est rempli à la main.

  • Une étiquette, ou plusieurs par lot
  • Les papiers de douane avec l’étiquette
  • Le même appel pour tous les transporteurs
Commande Amazon · Barcelona → Atlantarequête d’exemple
// les tarifs sont triés du moins cher ; acheter rates[0]
const label = await ex.labels.create({ rate: rates[0].id })

// colis international : étiquette + déclaration en douane
// UPS Worldwide Expedited · Barcelona, Espagne → Atlanta, GA
200étiquette prête à imprimer, documents douaniers inclus
suivi et webhooks

Suivi et webhooks

Chaque envoi que vous créez peut être suivi. Demandez son statut à tout moment, ou enregistrez un webhook et recevez les mises à jour de statut, dans l’ordre, au fil du trajet du colis.

  • Mises à jour de statut envoyées à votre système
  • Vos commandes restent à jour automatiquement
  • Prévenez vos acheteurs à votre façon
Fonctionnement des webhooks →
ENVOI Shopify #7323 · FedEx Home Deliveryexemple
statut
En transit
transporteur
FedEx
destination
Philadelphia, PA
acheteur
prévenu
validation des adresses

Validation des adresses

Vérifiez une adresse avant d’acheter l’étiquette. Repérer une faute de frappe au paiement ou à l’entrepôt coûte moins cher qu’un colis retourné ou une correction facturée par le transporteur.

  • Validez au paiement ou avant l’impression
  • Recevez une adresse corrigée quand c’est possible
  • Bloquez les mauvaises adresses avant l’envoi
VÉRIFICATION D’ADRESSEexemple
telle que saisie

1200 main st
philadelphia pa

validée

1200 Main St
Philadelphia, PA 19103

livrable · prête pour l’étiquette

référence de l’api

Les endpoints en un coup d’œil.

Une carte en langage clair de ce que couvre l’API. Les chemins, champs et réponses exacts figurent dans la référence complète de l’API.

ENDPOINTS par domaineindicatif · pas la spécification
DomaineVous envoyezVous recevezExemple
TarifsOrigine, destination, dimensions et poids du colisLes tarifs de vos transporteurs connectés, du moins cher au plus cherPOST /rates
ÉtiquettesLe tarif choisiUne étiquette imprimable, plus les documents douaniers pour les colis internationauxex.labels.create(...)
SuiviUn envoi que vous avez crééSon statut actuel et son historiquevoir la référence
WebhooksUne URL de votre côtéLes mises à jour de statut qui y sont envoyées au fil de chaque envoivoir la référence
Validation des adressesUne adresseSi elle est livrable, avec une version corrigée quand c’est possiblevoir la référence
Besoin de la référence complète ? Obtenez une clé API ou demandez-nous un accès.Obtenir une clé API →Nous parler →

webhooks

Les mises à jour de statut viennent à vous.

Au lieu d’interroger chaque transporteur, donnez une URL à ExperShip. À mesure qu’un envoi avance, ses mises à jour de statut y sont envoyées dans l’ordre : vos commandes, tableaux de bord et e-mails aux acheteurs restent à jour.

  1. Enregistrez un endpoint

    Une URL sur votre serveur qui accepte du JSON.

  2. Recevez les mises à jour dans l’ordre

    Les changements de statut de chaque envoi arrivent dans l’ordre où ils se sont produits.

  3. Mettez à jour votre système

    Écrivez le statut sur la commande, déclenchez un e-mail à l’acheteur ou signalez un problème à votre équipe.

MISES À JOUR DE STATUT Shopify #7323envoi d’exemple
  1. 01
    Étiquette crééeFedEx Home Delivery
  2. 02
    Pris en charge par le transporteurpremier scan du transporteur
  3. 03
    En transiten route dans le réseau
  4. 04
    En cours de livraisonPhiladelphia, PA
  5. 05
    Livréstatut final
libellés en langage clair · noms de statut exacts dans la référence de l’API
votre handler de webhookesquisse d’exemple
// votre serveur : recevoir une mise à jour de statut, l’enregistrer
app.post('/shipping-updates', async (req, res) => {
  const update = req.body
  await saveShipmentStatus(update)  // votre code
  res.sendStatus(200)
})

guides

Guides pour expédier par le code.

Des guides pratiques sur les API d’expédition, les transporteurs et la douane, écrits pour celles et ceux qui construisent des systèmes e-commerce.

Intégrez l’expédition à vos outils.

Obtenez une clé API et commencez par les tarifs et les étiquettes. Vous préparez une intégration plus large, ou vous expédiez à l’international vers les États-Unis ? Parlons-en d’abord.