Aller au contenu

API Spring GDS

Globe Pickup Points s’intègre à Spring GDS, un consolidateur transfrontalier qui remet vos colis à des transporteurs locaux du dernier kilomètre tels que PostNL, Royal Mail, DPD, Hermes, Colis Privé et Packeta. Avec cette intégration, vous pouvez :

  • Exporter vos commandes vers Spring GDS directement depuis Shopify
  • Expédier vers 49 pays de destination avec 34 services
  • Imprimer des étiquettes d’expédition dans Shopify
  • Transmettre toutes les données douanières (codes SH, pays d’origine, DDP/DDU) sur les envois internationaux

  1. Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Ajoutez un nouveau transporteur et sélectionnez Spring GDS.
  2. Saisissez votre Clé API — vous la trouverez dans votre compte Spring GDS.
  3. Renseignez les coordonnées de l’expéditeur utilisées sur chaque étiquette : Nom de l’expéditeur, Nom de la société expéditeur (facultatif), Rue de l’expéditeur, Ville de l’expéditeur, Code postal de l’expéditeur, Pays de l’expéditeur, Téléphone de l’expéditeur et Email de l’expéditeur.
  4. Si vous expédiez à l’international, ajoutez vos identifiants douaniers. Ils sont tous facultatifs :
    • Numéro de TVA de l’expéditeur — votre numéro de TVA. Pour la Norvège, utilisez le VOEC, pour la Suisse l’UID, pour Singapour le GST.
    • Numéro EORI de l’expéditeur — utilisé dans la solution douanière Spring Clear.
    • Numéro IOSS de l’expéditeur — utilisé dans la solution Spring Clear IOSS+ et Union OSS.
    • Numéro GB EORI de l’expéditeur — commence par GB, obligatoire pour les envois DDP vers le Royaume-Uni via Spring Clear.
  5. Choisissez l’URL de suivi envoyée aux clients dans l’e-mail de traitement de la commande : Suivi Spring GDS ou Suivi du transporteur final.
  6. Configurez les options de traitement et de tag selon vos besoins.
  7. Associez vos méthodes d’expédition Shopify aux services Spring GDS convenus avec Spring.

Export des commandes et impression des étiquettes

Section intitulée « Export des commandes et impression des étiquettes »

Vous pouvez exporter vos commandes vers Spring GDS 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 expédition exportée reçoit un numéro de suivi Spring GDS. Selon le paramètre URL de suivi, les traitements de commande sont créés soit avec la page de suivi Spring GDS, soit avec le lien de suivi du transporteur du dernier kilomètre renvoyé par Spring pour cette expédition.


Spring GDS propose 34 services. Choisissez celui qui correspond à votre contrat Spring et à votre destination — la liste complète est disponible dans la fenêtre d’export et dans l’association des méthodes d’expédition.

Groupe de servicesExemples
Réseau SpringSpring Tracked (TRCK), Spring Signature (SIGN), Spring Untracked (UNTR)
Spring CollectSpring Collect (CLLCT) — le seul service vers point de retrait
PostNLPacket Tracked / Registered / Non Tracked, Parcel EU, GlobalPack EMS et UPU, EPG, variantes Benelux avec et sans signature
Royal MailTracked 24 et Tracked 48, avec ou sans signature
Partenaires du dernier kilomètreDPD DE, Hermes, Colis Privé, Italian Post Crono et Crono Express, Sending Mainland et Islands, Spring Com Standard et Express, Packeta, Austrian Post Eurodis, Express

Spring Collect (CLLCT) est le seul service Spring GDS qui livre vers un point de retrait. Lorsqu’une commande est exportée avec ce service, Globe joint l’identifiant PUDO du point sélectionné par le client au paiement. Tous les autres services livrent à l’adresse de livraison du client.

Si une commande exportée en Spring Collect ne comporte aucun point de retrait, aucun emplacement PUDO n’est transmis avec l’expédition. Utilisez plutôt un service de livraison à domicile, ou assurez-vous que le client sélectionne un point au paiement.


Spring GDS est un transporteur transfrontalier : Globe envoie donc toujours une déclaration douanière avec l’expédition. Les lignes de produits portent le code SH et le pays d’origine issus de vos articles d’inventaire Shopify ; lorsque ces informations manquent, le Code SH saisi pour cette expédition au moment de l’export et votre pays d’expéditeur sont utilisés.

La section Douanes et taxes du compte transporteur contrôle :

ParamètreEffet
Pays DDPDestinations expédiées en DDP (Delivered Duty Paid). Tout le reste est envoyé en DDU.
Envoyer les valeurs hors TVA pour les paysLes valeurs des commandes et de l’expédition pour ces destinations sont envoyées hors TVA.
Pays à origine préférentielleAjoute le tag d’origine préférentielle à chaque ligne de produit. Obligatoire pour le Royaume-Uni dans le cadre de l’Accord de commerce et de coopération UE-UK.
Type de déclarationVente de marchandises (par défaut), Documents, Cadeau, Marchandises retournées ou Échantillon commercial.

Deux autres valeurs ne sont pas des paramètres du transporteur — le Code SH (6 à 10 chiffres, remplacé par les codes SH au niveau produit issus de Shopify lorsqu’ils sont disponibles) et la Description du contenu (par exemple Goods ou Clothing) sont des options avancées que vous renseignez par expédition dans la fenêtre d’export.


Chaque compte transporteur Spring GDS dispose d’une case Mode test. Lorsqu’elle est cochée, la création des expéditions et la récupération des étiquettes passent par l’environnement de test Spring GDS au lieu de la production. Désactivez-la avant de commencer à expédier de vraies commandes — les expéditions de test ne sont pas acheminées.


Spring GDS ne prend pas en charge le paiement à la livraison. Aucun montant n’est transmis avec l’expédition, quel que soit le moyen de paiement de la commande. Si vous avez besoin du paiement à la livraison, utilisez un autre transporteur pour ces commandes.


La synchronisation des statuts de livraison n’est pas disponible pour Spring GDS : ce transporteur ne fait pas partie de la synchronisation bidirectionnelle des statuts de livraison dont bénéficient Packeta, PPL, DPD ou GLS, les statuts des colis ne sont donc pas réécrits dans Shopify. Le numéro de suivi et le lien de suivi restent tout de même attachés au traitement de la commande, et les mises à jour de statut ultérieures proviennent du suivi propre à Shopify ou du portail Spring GDS.

Les étiquettes de retour ne sont pas prises en charge non plus pour Spring GDS.


Spring GDS renvoie des étiquettes PDF, que Globe peut imprimer dans deux formats :

FormatPositions par feuille
A61
A6 sur A44

Lors de l’impression A6 sur A4, vous pouvez choisir une position de départ (1–4) pour réutiliser des planches partiellement utilisées.


ProblèmeSolution
La clé API Spring GDS n’est pas configuréeLe compte transporteur n’a pas de clé API. Ajoutez-la dans les paramètres du transporteur — elle est également requise pour l’impression.
Erreur fatale de Spring GDSSpring a rejeté l’expédition. Le message renvoyé par Spring s’affiche avec la commande en échec — le plus souvent un code de service invalide pour la destination, ou des données douanières manquantes.
Aucun numéro de suivi renvoyéL’expédition a été acceptée mais Spring n’a pas renvoyé de numéro de suivi. Réexportez la commande et vérifiez que le service est activé sur votre compte Spring.
Aucune étiquette n’a pu être récupéréeL’étiquette n’est pas encore disponible pour ce numéro de suivi. Patientez un instant et réimprimez.
Spring Collect exporté sans point de retraitLa commande ne comporte aucun point de retrait sélectionné au paiement. Choisissez un service de livraison à domicile, ou faites sélectionner un point au client.
Les expéditions de test n’arrivent jamaisLe Mode test est encore activé sur le compte transporteur. Désactivez-le pour les expéditions de production.