API Boxpi

Globe Pickup Points s’intègre à Boxpi, un agrégateur logistique transfrontalier. Une seule connexion API vous donne accès à plus de 60 services transporteurs sur 16 marchés européens, sans contrat distinct avec chaque transporteur national. Avec cette intégration, vous pouvez :

Exporter vos commandes vers Boxpi directement depuis Shopify
Imprimer des étiquettes d’expédition dans Shopify
Expédier vers des casiers à colis, des points relais et des bureaux de poste, ou à l’adresse du client
Prendre en charge le paiement à la livraison (PDL)
Synchroniser les statuts de livraison vers Shopify

Activer l’intégration API Boxpi

Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Ajoutez un nouveau transporteur et sélectionnez Boxpi.
Saisissez votre Clé API — contactez le service client Boxpi pour l’obtenir. Les environnements de production et de test utilisent des clés API différentes.
Sélectionnez l’Environnement — Production pour les expéditions réelles, Développement pour les tests avec l’API de test de Boxpi. La clé API doit correspondre à l’environnement sélectionné.
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, Tag personnalisé après l’export, Poids par défaut (kg)).
Associez vos méthodes d’expédition Shopify aux services Boxpi que vous souhaitez utiliser.

Export des commandes et impression des étiquettes

Vous pouvez exporter vos commandes vers Boxpi 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 général.

Chaque commande est enregistrée comme un colis Boxpi. L’enregistrement auprès du transporteur final est asynchrone — Globe attend quelques secondes que le code de suivi soit attribué. S’il n’est pas encore arrivé, l’export réussit tout de même et l’identifiant de colis Boxpi est utilisé en attendant ; la vérification du statut de livraison le remplace par le véritable numéro de suivi du transporteur final dès qu’il apparaît.

Boxpi exige un numéro de téléphone du destinataire pour chaque expédition. Les commandes qui n’en comportent pas sont rejetées avant l’envoi.

Services transporteurs

Boxpi est un agrégateur : le transporteur final est choisi commande par commande, en fonction du service auquel vous avez associé la méthode d’expédition. Les identifiants de service suivent le modèle CARRIER-SERVICE-COUNTRY, par exemple GLS-COURIER-SK, PACKETA-POINT-CZ ou SPS-POSTOFFICE-SK. La partie centrale indique le mode de livraison du colis :

Service	Livraison
COURIER	À l’adresse du client
POINT	Vers un point relais ou un casier à colis
POSTOFFICE	Vers un bureau de poste

62 services sont disponibles en Autriche, Belgique, Bulgarie, Croatie, Tchéquie, France, Allemagne, Grèce, Hongrie, Italie, Luxembourg, Pays-Bas, Pologne, Roumanie, Slovaquie et Slovénie — dont GLS, DPD, DHL, InPost, Packeta, PPL, SPS, Speedy, Sameday, Cargus, FAN Courier, BoxNow, Express One, BRT ainsi que les postes autrichienne et slovaque.

Points de retrait ou livraison à domicile

Services POINT / POSTOFFICE — la destination est déterminée uniquement par le point de retrait sélectionné par le client au paiement ; les champs d’adresse postale sont ignorés. Si la commande ne comporte aucun point de retrait, l’export est rejeté.
Services COURIER — la rue, la ville et le code postal sont obligatoires. La deuxième ligne d’adresse est envoyée comme numéro de rue lorsqu’elle compte 10 caractères ou moins, sinon elle est ajoutée à la rue. La province/région de la commande est transmise comme zone du pays, ce qu’exigent les coursiers roumains et bulgares.

Boxpi valide le point de retrait par rapport à ses propres listes de points. Les identifiants de point issus d’une intégration transporteur directe ne correspondent pas de façon fiable aux identifiants Boxpi : les méthodes d’expédition exportées via Boxpi doivent donc utiliser les points de retrait Boxpi dans le sélecteur au paiement — voir Ajouter des transporteurs de points de retrait.

Paiement à la livraison (PDL)

Boxpi prend en charge le paiement à la livraison. Le montant est repris de la commande et envoyé dans la devise de la commande — CZK et HUF sont arrondis à l’unité, les autres devises à deux décimales. La partie numérique du nom de la commande sert de symbole variable du paiement à la livraison.

Boxpi valide la devise par rapport au service sélectionné. Si le paiement à la livraison dans cette devise n’est pas autorisé pour le transporteur que vous avez associé, l’export est rejeté et le message d’erreur de Boxpi s’affiche sur la commande.

Activez Mettre à jour le statut de livraison dans Shopify automatiquement, puis Marquer les commandes contre remboursement comme payées automatiquement, pour que les commandes en paiement à la livraison soient marquées comme payées dans Shopify une fois le colis livré.

Statut de livraison

Boxpi fait partie des transporteurs pour lesquels la synchronisation des statuts de livraison est disponible. Avec l’option Mettre à jour le statut de livraison dans Shopify automatiquement activée, Globe interroge Boxpi et maintient le statut de traitement Shopify à jour, ce qui vous permet de filtrer les commandes par statut dans l’administration Shopify :

Statut dans Shopify	Description
Suivi ajouté	Enregistré chez Boxpi ou chez le transporteur, pas encore physiquement remis.
En transit	Reçu à l’entrepôt Boxpi ou par le transporteur, en cours d’acheminement.
En cours de livraison	En livraison à domicile, ou prêt à être récupéré au point de retrait.
Échec de livraison	Refusé par le transporteur, annulé, perdu, en retour ou retourné.
Livré	Livré, ou livré avec encaissement du paiement à la livraison.

L’option facultative Traiter uniquement lorsque le transporteur reçoit le colis reporte le traitement Shopify jusqu’à ce que Boxpi confirme que le colis est physiquement arrivé chez le transporteur, au lieu de le créer au moment de l’export.

Impression des étiquettes

Les étiquettes Boxpi sont générées au format PDF et peuvent être imprimées dans les formats suivants :

Format	Positions par feuille
A6	1
A4	4 (2×2 sur une seule feuille A4)

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

Les étiquettes sont créées de façon asynchrone du côté de Boxpi : une étiquette n’existe donc qu’une fois le colis enregistré chez le transporteur. Globe réessaie automatiquement pendant quelques secondes si vous imprimez immédiatement après l’export.

Les étiquettes de retour ne sont pas prises en charge par cette intégration — les retours doivent être organisés dans le portail Boxpi.

Dépannage

Problème	Solution
Échec de l’authentification Boxpi	Vérifiez la clé API et assurez-vous qu’elle correspond à l’environnement sélectionné — les clés de production et de test sont différentes.
`Invalid Boxpi carrier ID`	La méthode d’expédition est associée à une valeur qui n’est pas un service Boxpi. Réassociez-la à un service `CARRIER-SERVICE-COUNTRY`.
`Pickup point must be selected for pickup point delivery`	La commande utilise un service POINT ou POSTOFFICE mais ne comporte aucun point de retrait. Vérifiez que le client en a bien sélectionné un au paiement.
`Recipient phone number is missing`	Boxpi exige un numéro de téléphone pour chaque expédition. Ajoutez-le à la commande avant l’export.
`Missing required address fields`	Les services de type coursier nécessitent une rue, une ville et un code postal. Complétez l’adresse de livraison et exportez de nouveau.
Colis refusé par le transporteur	Le transporteur final a refusé l’expédition — Globe affiche son message d’erreur. Corrigez les données et exportez de nouveau la commande.
Étiquette pas prête à temps	L’enregistrement chez le transporteur est encore en cours. Patientez un instant et réimprimez.
Point de retrait non accepté	L’identifiant du point n’existe pas dans la liste Boxpi de ce transporteur. Assurez-vous que le paiement propose des points de retrait Boxpi pour cette méthode d’expédition.

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