API Speedy
Globe Pickup Points s’intègre à Speedy, le transporteur de colis bulgare qui exploite le réseau DPD en Bulgarie. Avec cette intégration, vous pouvez :
- Exporter vos commandes vers Speedy directement depuis Shopify
- Imprimer des étiquettes d’expédition dans Shopify
- Expédier en Bulgarie à l’adresse du client, dans une agence Speedy ou dans une consigne Speedy
- Envoyer des colis en paiement à la livraison en EUR, y compris vers les agences et les consignes
Activer l’intégration API Speedy
Section intitulée « Activer l’intégration API Speedy »- 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 Speedy.
- Saisissez votre Nom d’utilisateur et votre Mot de passe API Speedy. Speedy les délivre aux clients sous contrat : demandez-les à votre interlocuteur Speedy.
- Dans Service Speedy, sélectionnez le service de votre contrat Speedy : Standard 24 heures (505) ou Standard 24 heures colis (515). Ces deux services couvrent les colis à l’intérieur de la Bulgarie et livrent tous deux à domicile, en agence et en consigne.
- Dans Livraison payée par, sélectionnez qui paie la livraison à Speedy : Expéditeur (mon contrat Speedy) ou Destinataire (paie à la livraison).
- Si vous déposez les colis dans une agence ou une consigne Speedy, saisissez son ID dans Agence Speedy où vous déposez les colis (par exemple
77). Si un coursier les enlève à votre adresse, laissez le champ vide. - Si vous le souhaitez, cliquez sur Afficher les paramètres avancés :
- ID client de l’expéditeur : si votre contrat Speedy comporte plusieurs adresses d’expédition, saisissez l’ID client de celle d’où partent les colis. Laissez le champ vide pour expédier depuis l’adresse par défaut de votre compte Speedy.
- Client system ID : laissez ce champ vide, sauf si Speedy vous a attribué un client system ID.
- Poids par défaut (kg) : le poids d’envoi par défaut, en kilogrammes. S’il est vide, il est ignoré.
- Configurez les options de traitement et de tags selon vos besoins :
- Expédier les commandes automatiquement : Jamais, Oui, envoyer l’e-mail d’expédition avec le numéro de suivi ou Oui, ne pas envoyer l’e-mail d’expédition.
- Tagger les commandes avec le numéro de suivi : ajoute le numéro d’envoi Speedy à la commande sous forme de tag.
- Tag personnalisé après l’export : un tag ajouté à la commande après chaque export d’étiquette réussi.
- Associez vos méthodes d’expédition Shopify aux types de service Speedy décrits dans Types de service. Pour une méthode d’expédition avec point de retrait, utilisez Speedy (office or locker if selected, otherwise address) ou Speedy to office or locker. N’utilisez pas Speedy to address pour celle-ci : le colis partirait à l’adresse du client.
Agence Speedy où vous déposez les colis, ID client de l’expéditeur et Client system ID n’acceptent que des chiffres. Globe ne transmet aucune adresse d’expéditeur à Speedy. L’expéditeur est l’adresse par défaut de votre compte Speedy, ou l’adresse d’expédition définie avec ID client de l’expéditeur.
Export et impression des étiquettes
Section intitulée « Export et impression des étiquettes »Exportez vos commandes vers Speedy et imprimez les étiquettes d’expédition directement depuis Shopify, par lots ou une par une. Le fonctionnement général des étiquettes est décrit dans Créer des étiquettes d’expédition.
Globe crée un envoi Speedy comprenant un colis pour chaque commande. Le numéro d’envoi Speedy sert de numéro de suivi. Globe l’enregistre et récupère l’étiquette auprès de Speedy à chaque impression : vous pouvez donc réimprimer une étiquette plus tard. Le numéro de commande Shopify est imprimé sur l’étiquette.
Lorsque le traitement automatique est activé, le traitement reçoit le numéro d’envoi, Speedy comme transporteur et le lien de suivi https://www.speedy.bg/en/track-shipment?shipmentNumber=<shipment number>.
Les étiquettes Speedy dans Globe concernent les livraisons à l’intérieur de la Bulgarie. Avant l’envoi d’une commande, Globe vérifie les données exigées par Speedy :
- Le numéro de téléphone du destinataire, pour chaque livraison : à domicile, en agence ou en consigne. Speedy l’accepte sous la forme
+359…ou commençant par0. Les numéros étrangers sont acceptés avec le préfixe+. - Le nom du destinataire, d’au moins 3 caractères. Un nom de société de 3 caractères ou plus fait de la société le destinataire, avec le client comme personne de contact.
- Pour une livraison à domicile : la rue, et une ville ou un code postal à quatre chiffres. La ville peut être écrite en caractères latins ou cyrilliques. La rue et la ligne d’adresse 2 ne doivent pas dépasser 200 caractères au total.
Une commande qui ne passe pas l’une de ces vérifications n’est pas envoyée à Speedy. Les autres commandes du lot sont traitées normalement.
L’intégration Speedy ne synchronise pas les statuts de livraison vers Shopify. Globe n’annule pas les envois Speedy : annulez-les dans votre compte Speedy.
Types de service
Section intitulée « Types de service »Sélectionnez le type de service lors de l’export d’une commande, ou attribuez-le à une méthode d’expédition dans les paramètres du transporteur :
| Type de service | Destination du colis |
|---|---|
| Speedy (office or locker if selected, otherwise address) | À l’agence ou à la consigne Speedy choisie par le client au checkout. Une commande sans point de retrait part à l’adresse du client. |
| Speedy to address | Toujours à l’adresse du client, même lorsque la commande comporte un point de retrait. |
| Speedy to office or locker | À l’agence ou à la consigne Speedy indiquée dans la commande. Une commande sans agence ni consigne est refusée. |
Un point de retrait d’un autre réseau, ou un point DPD hors de Bulgarie, bloque l’export avec Speedy (office or locker if selected, otherwise address) et avec Speedy to office or locker. Globe n’envoie jamais une telle commande à l’adresse du client à la place. Pour l’expédier à l’adresse, créez l’étiquette avec Speedy to address.
Le service sélectionné dans Service Speedy s’applique aux trois types de service.
Agences et consignes Speedy
Section intitulée « Agences et consignes Speedy »Les agences et les consignes Speedy sont toutes deux identifiées par leur ID d’agence Speedy. L’intégration Speedy accepte les points Speedy de deux listes de points de retrait :
- Points de retrait DPD en Bulgarie. Chaque point DPD en Bulgarie est une agence ou une consigne Speedy. L’ID du point est
BGsuivi de l’ID d’agence Speedy complété à cinq chiffres :BG08009correspond à l’agence Speedy 8009. - Agences Speedy de Packeta (transporteur Packeta
BG Speedy PP). Il s’agit uniquement d’agences Speedy, sans consignes. L’ID du point est l’ID d’agence Speedy.
Les points DPD dans d’autres pays ne sont pas des points Speedy et sont refusés.
Les consignes Speedy acceptent les colis jusqu’à 20 kg. La limite d’une agence se situe entre 32 et 1 200 kg, selon l’agence. Speedy refuse les colis plus lourds.
Paiement à la livraison (PDL)
Section intitulée « Paiement à la livraison (PDL) »Speedy encaisse le paiement à la livraison en Bulgarie uniquement en EUR. Le montant contre remboursement est repris de la commande lorsque celle-ci utilise un moyen de paiement à la livraison. Le paiement à la livraison fonctionne pour les livraisons à domicile, en agence et en consigne.
Une commande en paiement à la livraison dans une autre devise, BGN compris, est bloquée avant son envoi à Speedy.
Impression des étiquettes
Section intitulée « Impression des étiquettes »Les étiquettes Speedy sont des fichiers PDF. Les formats suivants sont disponibles :
| Format | Positions par feuille |
|---|---|
| 10x15 cm | 1 |
| A6 on A4 | 4 (sur une seule feuille A4) |
| A4 | 1 (l’étiquette dans la moitié supérieure d’une page A4) |
Il n’est pas possible de choisir une position de départ sur la feuille A4. Avec 10x15 cm et A4, les étiquettes suivent l’ordre de votre sélection. Avec A6 on A4, Speedy les trie par numéro d’envoi.
Dépannage
Section intitulée « Dépannage »Lorsque Speedy refuse un envoi, rien n’est créé chez Speedy, et Globe affiche le message de Speedy, accompagné d’une indication pour les cas courants.
| Problème | Solution |
|---|---|
| Les paramètres Speedy sont incomplets | Renseignez le Nom d’utilisateur et le Mot de passe. Agence Speedy où vous déposez les colis, ID client de l’expéditeur et Client system ID n’acceptent que des chiffres. |
| Speedy a refusé le nom d’utilisateur ou le mot de passe | Vérifiez le Nom d’utilisateur et le Mot de passe dans les paramètres de l’intégration. Après cette erreur, Globe n’envoie pas les commandes restantes du lot. |
| Le numéro de téléphone manque ou n’a pas une forme acceptée par Speedy | Ajoutez ou corrigez le numéro de téléphone dans Shopify (+359…, un numéro commençant par 0, ou un numéro étranger avec +) et recréez l’étiquette. |
| Speedy exige un nom de destinataire d’au moins 3 caractères | Corrigez le nom de l’adresse de livraison dans Shopify. |
| L’adresse de livraison est hors de Bulgarie, incomplète ou trop longue | Les étiquettes Speedy dans Globe concernent les adresses en Bulgarie. L’adresse doit comporter la rue, et une ville ou un code postal à quatre chiffres. La rue et la ligne d’adresse 2 ne doivent pas dépasser 200 caractères au total, ni la ville 50 caractères. |
Invalid site | Speedy n’a pas pu faire correspondre la ville et le code postal, par exemple parce que le code postal appartient à une autre ville. Vérifiez la ville et le code postal de l’adresse de livraison. |
| Le point de retrait n’est ni une agence ni une consigne Speedy | Le point appartient à un autre réseau, ou c’est un point DPD hors de Bulgarie. Choisissez une agence ou une consigne Speedy avec l’action Modifier le point de retrait, ou créez l’étiquette avec Speedy to address pour expédier à l’adresse du client. |
| La commande n’a ni agence ni consigne Speedy, ou pas d’ID d’agence Speedy | Choisissez l’agence ou la consigne avec l’action Modifier le point de retrait, ou créez l’étiquette avec Speedy to address. |
| L’agence ou la consigne est fermée ou inconnue chez Speedy | Choisissez une autre agence ou consigne Speedy avec l’action Modifier le point de retrait. |
| Speedy encaisse le paiement à la livraison uniquement en EUR | La commande est libellée dans une autre devise. Voir Paiement à la livraison (PDL). Si Speedy refuse lui-même le paiement à la livraison, vérifiez le montant et votre contrat Speedy. |
| « The price cannot be determined for provided shipment parameters » | Votre contrat Speedy ne prévoit pas de prix pour ce service et ce payeur. Modifiez Service Speedy ou Livraison payée par dans les paramètres de l’intégration. |
| La commande n’a pas de poids | Renseignez le poids du produit dans Shopify, saisissez le poids lors de la création de l’étiquette, ou renseignez Poids par défaut (kg). |
| Speedy limite les requêtes ou Globe n’a pas pu se connecter à Speedy | Rien n’a été créé. Réessayez dans une minute. |
| Speedy n’a pas répondu à temps, la connexion a été interrompue ou Speedy n’a pas confirmé l’envoi | L’envoi existe peut-être déjà. Vérifiez votre compte Speedy avant de recréer l’étiquette. |
| Globe s’est arrêté avant d’envoyer une commande à Speedy | Une commande précédente du lot n’a pas reçu de réponse claire, ou Globe n’a pas pu enregistrer son envoi. Rien n’a été créé pour cette commande : vous pouvez donc recréer son étiquette. |
| Speedy a créé l’envoi, mais Globe n’a pas pu l’enregistrer | Ne recréez pas l’étiquette : Speedy créerait un deuxième envoi. Imprimez ou annulez dans votre compte Speedy l’envoi indiqué dans le message. |
| « Printed X of Y Speedy labels » ou « Error printing Speedy labels » | Le message liste les numéros d’envoi manquants et la raison, par exemple un numéro d’envoi que Speedy ne connaît pas. Si la raison est un problème de connexion, relancez l’impression. |