Aller au contenu

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

  1. 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.
  2. 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.
  3. 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.
  4. Dans Livraison payée par, sélectionnez qui paie la livraison à Speedy : Expéditeur (mon contrat Speedy) ou Destinataire (paie à la livraison).
  5. 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.
  6. 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é.
  7. 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.
  8. 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.


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 par 0. 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.


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 serviceDestination 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 addressToujours à 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.


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 BG suivi de l’ID d’agence Speedy complété à cinq chiffres : BG08009 correspond à 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.


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.


Les étiquettes Speedy sont des fichiers PDF. Les formats suivants sont disponibles :

FormatPositions par feuille
10x15 cm1
A6 on A44 (sur une seule feuille A4)
A41 (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.


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èmeSolution
Les paramètres Speedy sont incompletsRenseignez 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 passeVé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 SpeedyAjoutez 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èresCorrigez le nom de l’adresse de livraison dans Shopify.
L’adresse de livraison est hors de Bulgarie, incomplète ou trop longueLes é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 siteSpeedy 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 SpeedyLe 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 SpeedyChoisissez 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 SpeedyChoisissez une autre agence ou consigne Speedy avec l’action Modifier le point de retrait.
Speedy encaisse le paiement à la livraison uniquement en EURLa 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 poidsRenseignez 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 à SpeedyRien 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’envoiL’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 à SpeedyUne 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’enregistrerNe 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.