API GLS Spain
Globe Pickup Points s’intègre à GLS Spain (GLS Spain y Portugal). Avec cette intégration, vous pouvez :
- Exporter vos commandes vers GLS Spain directement depuis Shopify
- Imprimer des étiquettes d’expédition dans Shopify
- Expédier vers les GLS ParcelShop et les consignes en Espagne et au Portugal, ou à l’adresse du client
- Expédier vers les autres pays de l’UE avec EuroBusinessParcel
- Envoyer des colis en paiement à la livraison (PDL) vers des adresses en Espagne et au Portugal
Cette intégration s’adresse aux marchands disposant d’un contrat GLS Spain. Les comptes GLS d’Europe centrale utilisent l’intégration API MyGLS.
Activer l’intégration API GLS Spain
Section intitulée « Activer l’intégration API GLS Spain »- Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Cliquez sur Ajouter une intégration transporteur et sélectionnez GLS Spain.
- Saisissez votre UID cliente : l’UID de 36 caractères que votre agence GLS délivre pour l’accès au service web, au format
1A2B3C4D-1A2B-1A2B-1A2B-1A2B3C4D5E6F. Demandez-le à votre agence GLS Spain. - Les champs de l’expéditeur sont facultatifs : Nom de la société expéditeur, Rue de l’expéditeur, Code postal de l’expéditeur, Ville de l’expéditeur, Téléphone de l’expéditeur et E-mail de l’expéditeur. S’ils restent vides, GLS imprime l’adresse d’expéditeur qu’il a enregistrée pour votre UID. Pour imprimer une autre adresse, par exemple celle de votre entrepôt, renseignez le nom, la rue, le code postal et la ville. Le code postal doit être espagnol (cinq chiffres) ou portugais (NNNN-NNN).
- Configurez les options de traitement et de tags selon vos besoins (Expédier les commandes automatiquement, Tagger les commandes avec le numéro de suivi, Tag personnalisé après l’export). Le Poids par défaut (kg), sous Paramètres avancés, est utilisé pour les commandes sans poids.
- Associez vos méthodes d’expédition Shopify aux types de services GLS Spain. Pour les méthodes d’expédition avec point de retrait, utilisez GLS (ParcelShop if selected, otherwise address) ou GLS ParcelShop.
Export des commandes et impression des étiquettes
Section intitulée « Export des commandes et impression des étiquettes »Exportez vos commandes vers GLS Spain et imprimez les étiquettes d’expédition directement depuis Shopify, par lots ou une par une. Le fonctionnement général est décrit dans Créer des étiquettes d’expédition.
Chaque étiquette correspond à un envoi GLS Spain comprenant un seul colis de 40 kg maximum. Le nom de la commande Shopify sert de référence d’envoi, imprimée sous la mention Ref.Cli. sur l’étiquette. La référence est limitée à 15 caractères : pour un nom de commande plus long, seuls les 15 derniers caractères sont conservés.
Lorsque Globe ne peut pas savoir si GLS Spain a créé un envoi, par exemple parce que GLS Spain n’a pas répondu à temps, le message d’erreur vous demande de vérifier le portail client de GLS Spain (MyGLS) avant de recréer l’étiquette. Globe s’arrête alors avant la commande suivante du lot. Les commandes qu’il n’a pas envoyées peuvent être exportées à nouveau sans risque.
Types de services
Section intitulée « Types de services »Sélectionnez le type de service lors de l’export d’une commande, ou associez-le à une méthode d’expédition :
| Type de service | Fonctionnement |
|---|---|
| GLS (ParcelShop if selected, otherwise address) | Livre au GLS ParcelShop ou à la consigne choisis par le client. Sans point, livre à l’adresse du client : BusinessParcel en Espagne et au Portugal, EuroBusinessParcel vers les autres pays de l’UE. |
| GLS (address) | Livre à l’adresse du client, même lorsque la commande comporte un point de retrait : BusinessParcel en Espagne et au Portugal, EuroBusinessParcel vers les autres pays de l’UE. |
| GLS EconomyParcel (address) | EconomyParcel à l’adresse du client, uniquement en Espagne et au Portugal. |
| GLS Express 14:00 (address) | Express 14:00 à l’adresse du client, uniquement en Espagne et au Portugal. |
| GLS ParcelShop | Livre au GLS ParcelShop ou à la consigne choisis par le client. Une commande sans point est refusée. |
EconomyParcel et Express 14:00 ne fonctionnent que si votre contrat GLS les inclut. GLS refuse un envoi avec un service que votre agence n’a pas activé pour votre UID cliente.
ParcelShop
Section intitulée « ParcelShop »En Espagne et au Portugal, le fournisseur de points de retrait GLS n’affiche au checkout que les ParcelShop et les consignes de la liste propre à GLS Spain, et chacun d’eux comporte le code ParcelShop de GLS Spain.
Lorsqu’une commande part vers le GLS ParcelShop ou la consigne choisis par le client :
- Globe transmet le code ParcelShop propre à GLS Spain et l’adresse du ParcelShop, avec le nom, le téléphone et l’e-mail du client.
- Le ParcelShop doit se trouver en Espagne ou au Portugal, dans le même pays que l’adresse de livraison.
- Un point de retrait d’un autre réseau est refusé : la commande n’est jamais expédiée à l’adresse à la place. Choisissez un GLS ParcelShop avec l’action Modifier le point de retrait, ou choisissez GLS (address) pour expédier à l’adresse du client.
- Un ParcelShop que GLS Spain ne liste plus, ou qu’il indique comme fermé, est refusé. Choisissez un autre ParcelShop avec l’action Modifier le point de retrait.
Utiliser votre propre application d’étiquettes
Section intitulée « Utiliser votre propre application d’étiquettes »Si vous créez les étiquettes GLS Spain dans une autre application, celle-ci a besoin du code ParcelShop de GLS Spain. L’ID de point relais d’un point GLS ({{ point.id }}) est l’ID ParcelShop du groupe GLS, que les systèmes de GLS Spain n’utilisent pas. Ajoutez le code de GLS Spain à la commande sous forme d’attribut de commande :
ParcelShopCode: {{ point.special.glsEsCode }}Le code est renseigné pour les points du fournisseur de points de retrait GLS en Espagne et au Portugal, pas pour les points de GLS (as used in MyGLS portal). La configuration des attributs est décrite dans Attributs de commande.
Paiement à la livraison (PDL)
Section intitulée « Paiement à la livraison (PDL) »GLS Spain encaisse le paiement à la livraison pour les livraisons à une adresse en Espagne ou au Portugal, uniquement en EUR. Globe transmet le montant à encaisser de la commande avec l’envoi.
- Dans un ParcelShop, GLS n’encaisse pas le paiement à la livraison. Mettez le Montant contre remboursement à 0, ou choisissez GLS (address) pour expédier à l’adresse du client.
- EuroBusinessParcel vers les autres pays de l’UE ne propose pas le paiement à la livraison. Mettez le Montant contre remboursement à 0, ou expédiez la commande avec un autre transporteur.
- Une commande avec un montant à encaisser libellé dans une autre devise que l’EUR est refusée.
Envois internationaux
Section intitulée « Envois internationaux »GLS Spain expédie en EuroBusinessParcel vers les autres pays de l’UE : Autriche, Belgique, Bulgarie, Croatie, Chypre, Tchéquie, Danemark, Estonie, Finlande, France, Allemagne, Grèce, Hongrie, Irlande, Italie, Lettonie, Lituanie, Luxembourg, Malte, Pays-Bas, Pologne, Roumanie, Slovaquie, Slovénie et Suède. GLS (address) et GLS (ParcelShop if selected, otherwise address) l’utilisent tous deux pour ces pays.
- La commande a besoin de l’adresse e-mail et du numéro de téléphone du client.
- Un colis par envoi, jusqu’à 40 kg.
- Pas de paiement à la livraison.
- Pas de livraison en ParcelShop : une commande avec un GLS ParcelShop situé hors d’Espagne et du Portugal est refusée. Choisissez GLS (address) pour l’expédier à l’adresse du client.
- EconomyParcel et Express 14:00 ne sont pas disponibles à l’international.
Les destinations hors UE sont refusées.
Impression des étiquettes
Section intitulée « Impression des étiquettes »GLS Spain renvoie chaque étiquette sous la forme d’une page PDF de 92 × 143 mm. Les formats suivants sont disponibles :
| Format | Positions par feuille |
|---|---|
| Label printer, 10x15 cm (A6) | 1 |
| A6 on A4 | 4 |
Lors de l’impression d’étiquettes A6 sur A4, vous pouvez choisir la position de départ sur la feuille (positions 1 à 4) pour réutiliser des feuilles déjà entamées.
Globe récupère l’étiquette chez GLS Spain à chaque impression. GLS ne fournit une étiquette que tant que le colis est en sa possession, pas après la livraison. Si GLS ne fournit pas l’étiquette de l’un des envois sélectionnés, Globe n’en imprime aucune et indique l’envoi manquant.
Chaque envoi reçoit un numéro de suivi et un lien de suivi. Lorsque Expédier les commandes automatiquement est activé, Globe ajoute les deux au traitement Shopify, avec GLS comme transporteur.
- Espagne : le numéro de suivi est le code-barres à 14 chiffres de GLS Spain, et le lien ouvre le colis sur la page de suivi de GLS Spain.
- Portugal et autres pays de l’UE : le numéro de suivi est le TrackID GLS, et le lien ouvre la page de suivi GLS (
https://gls-group.eu/track/<TrackID>), qui redirige vers la page GLS du pays de destination.
Dépannage
Section intitulée « Dépannage »| Problème | Solution |
|---|---|
| GLS Spain ne connaît pas l’UID cliente | Vérifiez l’UID cliente auprès de votre agence GLS : c’est l’UID de 36 caractères qu’elle délivre pour l’accès au service web. Globe arrête le lot à ce stade ; les commandes restantes n’ont pas été envoyées. |
| Les paramètres GLS Spain sont incomplets | Saisissez l’UID cliente au format de GLS (36 caractères). Si vous avez renseigné une partie de l’expéditeur, complétez le nom, la rue, le code postal et la ville, ou videz les champs de l’expéditeur. |
| Le point relais n’est pas un GLS ParcelShop, ou « Wrong carrier for this order » | Choisissez un GLS ParcelShop avec l’action Modifier le point de retrait, ou choisissez GLS (address) pour expédier à l’adresse du client. |
| GLS Spain ne liste pas le ParcelShop, ou l’indique comme fermé | Choisissez un autre GLS ParcelShop avec l’action Modifier le point de retrait, ou choisissez GLS (address) pour expédier à l’adresse du client. |
| GLS n’encaisse pas le paiement à la livraison dans un ParcelShop | Mettez le Montant contre remboursement à 0, ou choisissez GLS (address) pour expédier à l’adresse du client. |
| EuroBusinessParcel a besoin de l’adresse e-mail et du numéro de téléphone du client | Ajoutez l’adresse e-mail ou le numéro de téléphone manquant à la commande et recréez l’étiquette. |
| GLS exige un code postal espagnol à cinq chiffres, ou portugais au format NNNN-NNN | Corrigez le code postal dans l’adresse de livraison. Les mêmes formats s’appliquent au Code postal de l’expéditeur. |
| GLS accepte les colis jusqu’à 40 kg | Si le poids de la commande est erroné, corrigez-le dans le panneau de création d’étiquette ; sinon, expédiez la commande avec un autre transporteur. |
| Votre agence GLS n’a pas activé ce service pour votre UID (code -53) | Demandez à votre agence GLS d’activer le service, ou choisissez un type de service inclus dans votre contrat. |
| GLS Spain n’a pas fourni l’étiquette | Réessayez dans une minute, ou imprimez l’étiquette dans le portail client de GLS Spain (MyGLS). GLS ne fournit les étiquettes que tant que le colis est en sa possession. |
| GLS Spain n’a pas confirmé l’envoi | L’envoi existe peut-être. Vérifiez le portail client de GLS Spain (MyGLS) avant de recréer l’étiquette. |