API SPS

Globe Pickup Points s’intègre à SPS (Slovak Parcel Service) via l’API SOAP WebShip, ce qui permet d’exporter les commandes et d’imprimer les étiquettes d’expédition directement depuis Shopify. Avec cette intégration, vous pouvez :

Exporter vos commandes vers SPS WebShip directement depuis Shopify
Imprimer des étiquettes d’expédition dans Shopify
Expédier vers les points de retrait Balíkovo, les terminaux à colis SPS ou à l’adresse du client
Prendre en charge le paiement à la livraison (PDL) avec versement sur votre compte bancaire

Activer l’intégration API SPS

Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Ajoutez un nouveau transporteur et sélectionnez SPS.
Saisissez votre Nom d’utilisateur et votre Mot de passe — ce sont vos identifiants WebShip. Contactez votre représentant commercial SPS pour obtenir l’accès au service web.
Si vous utilisez le paiement à la livraison, saisissez l’IBAN pour contre remboursement et le SWIFT/BIC remboursement du compte bancaire sur lequel SPS doit verser les montants encaissés.
Vous pouvez également définir une Valeur d’assurance par défaut appliquée à toutes les expéditions. Si vous la laissez vide, le total de la commande est utilisé.
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 SPS convenus avec le transporteur.

Il n’existe pas d’environnement de test SPS — WebShip ne dispose que d’un seul point d’accès de production, les identifiants que vous saisissez créent donc de véritables expéditions.

Export des commandes et impression des étiquettes

Vous pouvez exporter vos commandes vers SPS 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 est créée et son étiquette générée en un seul appel API : les étiquettes sont donc prêtes à imprimer dès l’export. La référence de colis envoyée à SPS est le nom de votre commande Shopify sans le # initial, raccourci à 35 caractères si nécessaire.

Une fois exporté, le colis reçoit un numéro d’expédition SPS utilisé pour le suivi du traitement de la commande et consultable sur la page de suivi SPS. Si la commande comporte une adresse e-mail client, Globe demande également à SPS de notifier le destinataire par e-mail.

Types de services

Lorsque vous associez vos méthodes d’expédition ou exportez une commande, sélectionnez le service SPS correspondant à votre accord :

Service	Description
SPS Standard	Livraison standard à domicile ou en entreprise
SPS Express	Livraison express
SPS 9:00	Livraison garantie avant 9 h
SPS 12:00	Livraison garantie avant 12 h
SPS Saturday Delivery	Livraison le samedi
SPS Balíkovo	Livraison vers un point de retrait Balíkovo
SPS Parcel Terminal	Livraison vers un terminal à colis SPS (casier)

Les commandes peuvent être exportées vers 11 pays de destination : Slovaquie, Tchéquie, Autriche, Hongrie, Allemagne, Pologne, Roumanie, Croatie, Slovénie, Bulgarie et Serbie.

Points de retrait ou livraison à domicile

SPS Balíkovo et SPS Parcel Terminal envoient le colis vers le point de retrait sélectionné par le client au paiement. Globe transmet l’identifiant du point à SPS et inscrit le nom du client sur l’étiquette comme personne de contact.
Tous les autres services livrent à l’adresse de livraison du client.

Si un service Balíkovo ou Parcel Terminal est utilisé alors que la commande ne comporte aucun point de retrait, l’expédition est créée vers l’adresse postale du client au lieu d’un point de retrait. Vérifiez que vos méthodes d’expédition de type point de retrait sont bien associées au service Balíkovo ou Parcel Terminal et que le sélecteur est actif au paiement — voir Ajouter des transporteurs de points de retrait.

Valeur d’assurance

SPS exige une valeur d’assurance sur chaque expédition. Globe la détermine dans cet ordre :

La Valeur d’assurance définie sur l’expédition au moment de l’export
La Valeur d’assurance par défaut des paramètres du transporteur
Le total de la commande, si aucune des deux n’est définie

Paiement à la livraison (PDL)

SPS prend en charge le paiement à la livraison. Lorsqu’une commande comporte un montant restant à encaisser, Globe envoie ce montant avec la devise de la commande ainsi que l’IBAN pour contre remboursement et le SWIFT/BIC remboursement de vos paramètres transporteur, afin que SPS sache où verser l’argent. Les commandes sans montant à encaisser sont exportées comme des expéditions ordinaires.

Statut de livraison

La synchronisation des statuts de livraison n’est pas disponible pour SPS : les statuts des colis ne sont pas réécrits dans Shopify, il faut donc suivre leur progression sur la page de suivi SPS ou dans votre portail SPS. Le numéro d’expédition 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 ; organisez les retours directement avec SPS.

Impression des étiquettes

Les étiquettes SPS sont générées au format PDF lors de l’export et peuvent être imprimées dans les formats suivants :

Format	Étiquettes par feuille
A6	1
A6 sur A4	4 (grille 2×2)

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

Dépannage

Problème	Solution
« Username or password is not configured »	Le nom d’utilisateur et le mot de passe WebShip sont tous deux obligatoires. Renseignez-les sur le compte transporteur et enregistrez.
Erreur d’authentification WebShip	Vérifiez vos identifiants WebShip et confirmez auprès de votre représentant commercial SPS que l’accès au service web est activé pour le compte.
Export rejeté avec un message d’erreur SPS	WebShip valide l’expédition et renvoie le motif du rejet — généralement une adresse incomplète, un code postal de destination non pris en charge ou un service non activé sur votre compte. Corrigez la commande et exportez de nouveau.
« SPS did not return a tracking number »	SPS a accepté la demande mais n’a renvoyé aucun numéro d’expédition. Vérifiez dans le portail SPS qu’il n’y a pas de doublon avant de réexporter.
Colis envoyé à l’adresse du domicile au lieu d’un point de retrait	La commande a été exportée avec un service Balíkovo ou Parcel Terminal sans point de retrait associé. Vérifiez que le client a sélectionné un point au paiement et que l’association des méthodes d’expédition est correcte.
« No label URLs found for these SPS orders »	Les étiquettes ne sont plus disponibles pour ce lot. Réexportez les commandes pour générer de nouvelles étiquettes.
Les étiquettes ne peuvent pas être récupérées depuis SPS WebShip	Les PDF d’étiquettes n’ont pas pu être téléchargés depuis SPS. Patientez un instant et réimprimez le lot.

Add SPS pickup points to your Shopify store — pricing, demo & setup →