API One by Allegro

Globe Pickup Points s’intègre à One by Allegro (anciennement WEDO), un transporteur tchèque qui livre vers des boîtes à colis, des points de retrait Intime et des adresses à domicile via l’API OneDelivery 3.0. Avec cette intégration, vous pouvez :

Exporter vos commandes vers One by Allegro directement depuis Shopify
Imprimer des étiquettes d’expédition dans Shopify
Expédier vers une boîte à colis, un point de retrait ou à l’adresse du client
Encaisser le paiement à la livraison

Activer l’intégration API One by Allegro

Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Ajoutez un nouveau transporteur et sélectionnez One by Allegro.
Saisissez votre ID du jeton et votre Mot de passe API. Vous trouverez les deux dans l’espace client One by Allegro, section paramètres API. Si vous ne les avez pas, contactez le support One by Allegro (eshop-onecz@allegro.com).
Cliquez sur Tester la connexion pour confirmer que les identifiants sont acceptés avant d’enregistrer.
Renseignez l’adresse de l’expéditeur — Expéditeur — nom de l’entreprise, Expéditeur — rue, Expéditeur — numéro, Expéditeur — ville et Expéditeur — code postal. L’adresse de l’expéditeur est imprimée sur chaque étiquette, sert à l’enlèvement des colis et est transmise avec chaque expédition (One by Allegro n’utilise pas d’adresse par défaut enregistrée sur votre compte). L’intégration indique toujours la Tchéquie comme pays de l’expéditeur.
Renseignez la Longueur par défaut en mm, la Largeur par défaut en mm et la Hauteur par défaut en mm. Ces champs sont obligatoires — One by Allegro rejette les expéditions sans dimensions de colis.
Vous pouvez également définir un Poids par défaut (kg), utilisé lorsqu’un produit n’a pas de poids dans Shopify.
Configurez les options de traitement et de tag selon vos besoins.
Associez vos méthodes d’expédition Shopify à One by Allegro.

Export des commandes et impression des étiquettes

Vous pouvez exporter vos commandes vers One by Allegro 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 commande exportée devient une expédition comportant un seul colis. Le numéro de colis renvoyé sert de numéro de suivi, et le lien de suivi pointe vers la page de suivi One by Allegro. Si le traitement automatique est activé, la commande est traitée dans Shopify avec le numéro de suivi et le nom de transporteur One by Allegro.

L’API n’accepte que les lettres, les chiffres, les espaces, les virgules et les points dans les champs de description du colis et de référence. Globe les nettoie automatiquement — la description est Order <order name> et le nom de la commande est utilisé comme numéro de référence 1, raccourci à 20 caractères.

Modes de livraison

One by Allegro détermine le mode de livraison au moment de l’export à partir du Type de produit que vous sélectionnez. La valeur par défaut est AUTO, que la plupart des marchands devraient conserver.

Type de produit	Comportement
AUTO	Utilise le point de retrait One by Allegro sélectionné au paiement — une boîte à colis devient BOX, une agence devient PUDO. Si la commande ne comporte aucun point One by Allegro, le colis est envoyé à l’adresse de livraison.
TO_DOOR	Livraison à l’adresse du client. Tout point de retrait sélectionné est ignoré.
BOX	Livraison vers une boîte à colis One Box. Nécessite un point One by Allegro sur la commande.
PUDO	Livraison vers un point de retrait avec personnel (agence Intime). Nécessite un point One by Allegro sur la commande.

Si vous choisissez explicitement BOX ou PUDO et que la commande ne comporte aucun point de retrait One by Allegro, l’export est rejeté pour cette commande. Les codes de point proviennent du point de retrait sélectionné par le client dans le sélecteur Globe — voir Ajouter des transporteurs de points de retrait.

Toutes les expéditions sont exportées avec le service Standard. Les numéros de téléphone tchèques et slovaques des destinataires sont automatiquement convertis au format international (+420 / +421) afin que les notifications SMS du transporteur puissent être envoyées.

Poids et dimensions du colis

One by Allegro rejette les expéditions sans dimensions de colis : les valeurs par défaut des paramètres du transporteur sont donc obligatoires, et non facultatives.

Poids — repris de la commande Shopify. Si la commande n’a pas de poids, le Poids par défaut (kg) des paramètres du transporteur est utilisé. Si aucun des deux n’est disponible, l’export échoue pour cette commande.
Dimensions — toujours reprises des champs Longueur / Largeur / Hauteur par défaut en mm. Si l’un d’eux est vide ou égal à zéro, l’export échoue avec un message vous invitant à les renseigner.

Paiement à la livraison (PDL)

One by Allegro prend en charge le paiement à la livraison. Lorsqu’une commande utilise un moyen de paiement à la livraison, le montant est repris de la commande et transmis avec l’expédition dans la devise de la commande. Il n’existe pas de champ de compte bancaire distinct dans les paramètres du transporteur — les versements sont gérés dans le cadre de votre contrat One by Allegro.

Statut de livraison

La synchronisation des statuts de livraison n’est pas disponible. One by Allegro ne fait pas partie de la synchronisation des statuts de livraison de Globe : 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, ce qui permet aux clients de suivre leur colis sur la page de suivi du transporteur.

Impression des étiquettes

Les étiquettes sont renvoyées par One by Allegro sous la forme d’un PDF unique couvrant l’ensemble du lot imprimé, dans l’un des deux formats suivants :

Format	Description
PDF_A6	Une étiquette par page (par défaut)
PDF_A4	Une étiquette par page A4

L’API OneDelivery ne permet pas d’imprimer à partir d’une position choisie sur la feuille : les planches d’étiquettes partiellement utilisées ne peuvent donc pas être réutilisées avec ce transporteur.

Retours et annulation

Les étiquettes de retour ne sont pas prises en charge par cette intégration.
Les expéditions ne peuvent pas être annulées. L’API OneDelivery ne propose aucun point d’accès d’annulation ou de suppression. Une fois une commande exportée, l’expédition reste dans votre compte One by Allegro — ne remettez simplement pas le colis, ou réglez le problème dans le portail One by Allegro.

Dépannage

Problème	Solution
`Failed to authenticate with One by Allegro`	Vérifiez l’ID du jeton et le mot de passe API dans les paramètres du transporteur et utilisez Tester la connexion. Une réponse 401 signifie que les identifiants sont invalides.
`Order requires a One by Allegro pickup point for BOX/PUDO delivery`	Le type de produit est défini sur BOX ou PUDO mais la commande ne comporte aucun point de retrait One by Allegro. Utilisez AUTO ou TO_DOOR, ou vérifiez que le client a bien sélectionné un point One by Allegro au paiement.
`Order … has no weight`	Renseignez le poids du produit dans Shopify, saisissez le poids manuellement lors de l’export, ou renseignez le Poids par défaut (kg).
`default package dimensions are not set`	Renseignez la longueur, la largeur et la hauteur par défaut (en mm) dans les paramètres One by Allegro — l’API les exige sur chaque expédition.
Le destinataire ne reçoit pas les notifications du transporteur	Seuls les numéros tchèques et slovaques reçoivent automatiquement un indicatif pays. Pour les autres pays, enregistrez le numéro de téléphone au format international complet sur la commande.
`One by Allegro did not return a PDF label`	L’API a répondu autre chose qu’un PDF. Relancez l’impression ; si l’échec persiste, contactez le support One by Allegro avec le numéro d’expédition.
Commande exportée par erreur	Les expéditions ne peuvent pas être supprimées via l’API. Ne remettez pas le colis et réglez l’expédition dans le portail One by Allegro.

Add One by Allegro pickup points to your Shopify store — pricing, demo & setup →