API ShippyPro

Globe Pickup Points s’intègre à ShippyPro, une plateforme d’expédition multi-transporteurs qui vous permet d’expédier avec les contrats transporteurs déjà connectés dans votre propre compte ShippyPro. Avec cette intégration, vous pouvez :

Exporter vos commandes vers ShippyPro directement depuis Shopify
Imprimer des étiquettes d’expédition dans Shopify
Expédier vers des points de retrait ou à l’adresse du client, selon le service transporteur choisi
Prendre en charge le paiement à la livraison (PDL) et les déclarations douanières (CN22) pour les envois transfrontaliers

Les commandes peuvent être exportées vers 33 pays de destination — l’UE, le Royaume-Uni, la Suisse, la Norvège, les États-Unis, le Canada et l’Australie.

Activer l’intégration API ShippyPro

Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Ajoutez un nouveau transporteur et sélectionnez ShippyPro.
Saisissez votre Clé API — vous la trouverez dans votre compte ShippyPro. C’est le seul identifiant obligatoire.
Cliquez sur Fetch carriers. Globe vérifie la clé et télécharge tous les transporteurs et services connectés à votre compte ShippyPro, afin que vous puissiez les associer à vos méthodes d’expédition Shopify.
Renseignez les coordonnées de l’expéditeur imprimées sur l’étiquette : Nom de l’expéditeur, Nom de la société expéditeur, Rue de l’expéditeur, Ville de l’expéditeur, Code postal de l’expéditeur, Pays de l’expéditeur (un code à deux lettres tel que CZ, SK, HU), Téléphone de l’expéditeur et Email de l’expéditeur.
Configurez les options de traitement et de tag selon vos besoins — Expédier les commandes automatiquement, Tagger les commandes avec le numéro de suivi et Tag personnalisé après l’export.
Associez vos méthodes d’expédition Shopify aux services transporteurs récupérés.

Il n’existe pas de bac à sable ShippyPro distinct dans Globe — la clé API que vous saisissez crée de véritables expéditions sur votre compte.

Export des commandes et impression des étiquettes

Vous pouvez exporter vos commandes vers ShippyPro et imprimer les étiquettes d’expédition directement depuis Shopify, par lots ou une par une. Consultez Créer des étiquettes d’expédition pour le fonctionnement complet.

Chaque export crée l’expédition et renvoie un numéro de suivi ainsi qu’une étiquette en un seul appel : les étiquettes sont donc prêtes à imprimer immédiatement. Le nom de votre commande Shopify est envoyé comme référence et note de l’expédition. Une fois l’export effectué, le numéro de suivi est utilisé pour le suivi du traitement de la commande — le transporteur indiqué par ShippyPro est inscrit dans Shopify comme société de suivi.

Transporteurs et services

ShippyPro n’a pas de réseau propre. Les transporteurs, les services et les grilles tarifaires proviennent de votre compte ShippyPro : la liste que vous voyez lors de l’export correspond donc exactement à ce que vous y avez connecté. Si vous ajoutez un nouveau transporteur dans ShippyPro, cliquez de nouveau sur Fetch carriers dans les paramètres du transporteur Globe pour le récupérer.

Si votre compte ne renvoie aucune liste de transporteurs (par exemple lorsque l’API ShippyPro est temporairement indisponible), Globe bascule sur la saisie manuelle et vous permet de coller la définition du transporteur au format JSON. Utilisez Copy sample pour obtenir le format attendu.

Points de retrait ou livraison à domicile

Si la commande comporte un point de retrait sélectionné au paiement et que vous l’exportez avec un service de type point de retrait, Globe transmet l’identifiant du point à ShippyPro comme option transporteur, afin que le colis soit acheminé vers ce point.
Les services dont le nom indique une livraison à domicile expédient toujours à l’adresse de livraison du client, même lorsqu’un point est associé à la commande.

Les points de retrait eux-mêmes peuvent provenir de n’importe quel fournisseur utilisé au paiement, ou du fournisseur ShippyPro PUDO, qui interroge en direct les points de retrait des transporteurs de votre compte ShippyPro. Voir Ajouter des transporteurs de points de retrait.

Lors de l’export, Globe vous avertit avec une bannière Type selection mismatch si le transporteur ShippyPro sélectionné ne semble pas être celui auquel appartient le point de retrait de la commande — par exemple un point Packeta exporté avec un service GLS. L’export n’est pas bloqué : examinez donc la bannière avant de continuer.

Poids et dimensions du colis

ShippyPro exige un poids réel. Globe n’en invente jamais : si la commande n’a pas de poids défini dans Shopify, l’export est rejeté. Ajoutez les poids des produits dans Shopify et exportez de nouveau.

Les dimensions du colis sont facultatives. La Longueur du colis (cm), la Largeur du colis (cm) et la Hauteur du colis (cm) sont des options avancées et non des paramètres du transporteur ; lorsqu’aucune valeur n’est définie, 1 cm est envoyé pour chaque dimension. Si le service transporteur sélectionné propose une option d’assurance, l’expédition est assurée à hauteur du total de la commande.

Douanes

Pour les envois transfrontaliers, Globe construit une déclaration CN22 à partir des lignes de la commande — description, quantité, valeur unitaire, poids, code SH et pays d’origine repris de l’article d’inventaire du produit. Lorsque les données produit sont incomplètes, ces paramètres du transporteur comblent les manques :

Paramètre	Utilisé pour
Pays de l’expéditeur	Pays d’origine lorsqu’un produit n’en a pas
Contents type	Type de marchandises déclaré sur le CN22 (Merchandise, Cadeau, Documents, Échantillon commercial, Marchandises retournées)
Pays DDP	Pays de destination expédiés en DDP (droits à votre charge) ; toutes les autres destinations sont envoyées en DDU

La Description du contenu (la description du contenu de l’envoi, Goods par défaut) et le Code SH (le code tarifaire utilisé lorsqu’un produit n’en a pas) ne sont pas des paramètres du transporteur — ce sont des options avancées que vous renseignez par expédition dans la fenêtre d’export.

Paiement à la livraison (PDL)

ShippyPro prend en charge le paiement à la livraison. Lorsque la commande comporte un montant restant à encaisser, Globe envoie ce montant avec la devise de la commande, et ShippyPro le transmet au transporteur final. Les commandes sans montant à encaisser sont exportées comme des expéditions ordinaires. La disponibilité réelle du paiement à la livraison — et les devises acceptées — dépend du contrat transporteur qui se trouve derrière le service sélectionné dans votre compte ShippyPro.

Statut de livraison

La synchronisation des statuts de livraison n’est pas disponible pour ShippyPro : les statuts des colis ne sont pas réécrits dans Shopify, il faut donc suivre leur progression dans ShippyPro ou sur la page de suivi du transporteur final. Le numéro de suivi et le lien de suivi restent tout de même attachés au traitement de la commande. Les étiquettes de retour ne sont pas prises en charge non plus ; créez-les directement dans ShippyPro.

Impression des étiquettes

Les étiquettes sont demandées à ShippyPro au moment de l’impression, dans la taille choisie, et toutes les étiquettes d’un lot sont fusionnées en un seul PDF multipage :

Format	Description
A6	Étiquette générée en 10,5 × 14,8 cm
A4 (4-up)	Étiquette générée en 21 × 29,7 cm

Comme ShippyPro génère l’étiquette lui-même, la mise en page exacte provient du modèle d’étiquette du transporteur final. Les étiquettes peuvent être réimprimées à tout moment — Globe récupère une nouvelle URL de téléchargement pour chaque expédition et, à défaut, utilise l’URL d’étiquette enregistrée lors de l’export.

Dépannage

Problème	Solution
« Invalid API key — please check your ShippyPro credentials »	La clé a été rejetée par ShippyPro. Copiez-la de nouveau depuis votre compte ShippyPro et enregistrez le transporteur.
« ShippyPro API key is not configured »	Le champ de la clé API est vide sur le compte transporteur. Renseignez-le et enregistrez.
« No carriers configured. Use the ‘Fetch carriers’ button »	La liste des transporteurs n’a jamais été téléchargée. Ouvrez les paramètres du transporteur et cliquez sur Fetch carriers.
« Please select a carrier before exporting. »	Le service choisi pour la commande ne figure pas dans la liste récupérée — généralement après une modification de la liste. Récupérez de nouveau les transporteurs et réassociez la méthode d’expédition.
« Order has no weight set. »	ShippyPro exige un poids non nul. Ajoutez les poids des produits dans Shopify, puis exportez de nouveau.
Export rejeté avec un message d’erreur du transporteur	ShippyPro transmet l’erreur de validation du transporteur final, accompagnée de la correction suggérée — généralement une adresse incomplète, une destination non prise en charge ou un service non activé sur votre compte.
Colis envoyé à l’adresse au lieu du point de retrait	Le service transporteur n’a pas d’option de point de retrait enregistrée. Cliquez de nouveau sur Fetch carriers pour actualiser les options du transporteur, puis réexportez.
« Could not retrieve label for order … »	Ni la nouvelle URL d’étiquette ni celle enregistrée n’ont pu être téléchargées. Patientez un instant et réimprimez le lot ; si l’échec persiste, réexportez la commande.

Browse all supported carriers in Globe for Shopify — pickup points & label printing →