Aller au contenu

API FAN Courier

Globe Pickup Points s’intègre à FAN Courier, transporteur roumain doté de consignes FANbox, de PayPoints et de bureaux FAN. Avec cette intégration, vous pouvez :

  • Exporter vos commandes vers FAN Courier directement depuis Shopify
  • Imprimer des étiquettes d’expédition dans Shopify
  • Livrer en Roumanie à l’adresse du client, dans une FANbox, un PayPoint ou un bureau FAN
  • Encaisser le paiement à la livraison en RON
  • Suivre les colis sur la page de suivi de FAN Courier

  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 FAN Courier.
  2. Saisissez votre Identifiant selfAWB et votre Mot de passe selfAWB : vos identifiants de connexion à selfAWB. FAN Courier réserve l’accès à l’API aux clients sous contrat. Si vous avez un contrat mais pas d’accès à selfAWB, écrivez à selfawb@fancourier.ro.
  3. Saisissez le Client ID (agence) de l’agence FAN Courier depuis laquelle vous expédiez, visible dans selfAWB. L’adresse de l’agence figure comme expéditeur sur chaque étiquette. Si votre compte n’a qu’une agence, laissez le champ vide : Globe utilise cette agence.
  4. Activez ePOD (étiquettes 10,5x14,8 cm) uniquement si l’ePOD est actif sur votre contrat FAN Courier. Avec l’ePOD, FAN Courier imprime une étiquette de 10,5×14,8 cm pour imprimantes thermiques et confirme la livraison par e-mail plutôt que sur papier. Sans ePOD, l’étiquette est imprimée sur le formulaire AWB A5.
  5. Configurez les options de traitement et de tags selon vos besoins :
    • Expédier les commandes automatiquement : traite la commande dans Shopify avec le numéro d’AWB et le lien de suivi, avec ou sans l’e-mail d’expédition.
    • Tagger les commandes avec le numéro de suivi : ajoute le numéro d’AWB à la commande sous forme de tag.
    • Tag personnalisé après l’export et Tag personnalisé après impression : ajoutent votre tag après chaque export réussi ou chaque impression réussie.
  6. Choisissez l’Option d’impression par défaut (voir Impression des étiquettes).
  7. Cliquez sur Afficher les paramètres avancés pour définir :
    • Dimensions du colis (cm) : longueur x largeur x hauteur, par exemple 30x20x10. FAN Courier exige les dimensions sur chaque AWB, et Globe envoie ces dimensions pour tous les colis de ce compte. Si le champ est vide, 30x20x10 est envoyé.
    • Poids par défaut (kg) : le poids d’envoi par défaut en kilogrammes. S’il est laissé vide, il est ignoré.
  8. Associez vos méthodes d’expédition Shopify aux types de service FAN Courier (voir Types de service). L’association est facultative, et vous pouvez changer de type de service lors de la création d’une étiquette.

Export des commandes et impression des étiquettes

Section intitulée « Export des commandes et impression des étiquettes »

Exportez vos commandes vers FAN Courier 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 AWB comprenant un colis pour chaque commande exportée. Les étiquettes FAN Courier dans Globe ne couvrent que les livraisons en Roumanie. Le numéro d’AWB sert de numéro de suivi, et les colis se suivent sur https://www.fancourier.ro/awb-tracking/?tracking=<AWB number>.

Chaque AWB est construit à partir de la commande et de vos paramètres :

  • Expéditeur : votre agence FAN Courier. La livraison est payée par l’expéditeur.
  • Poids : obligatoire. Définissez le poids des produits dans Shopify, saisissez-le dans le champ Poids de l’envoi (kg) du panneau de création d’étiquette, ou définissez le Poids par défaut (kg). FAN Courier n’enregistre que des kilogrammes entiers : Globe arrondit donc le poids au kilogramme le plus proche, avec un minimum de 1 kg.
  • Dimensions : les Dimensions du colis (cm) des paramètres du transporteur, chaque côté étant arrondi au centimètre entier supérieur.
  • Téléphone : obligatoire. Les numéros roumains sont envoyés au format national, par exemple 0723456789.
  • Adresse : pour une livraison à l’adresse, l’adresse de livraison doit comporter une rue et un département (județ) roumain. Un code postal à six chiffres est envoyé lorsque l’adresse en contient un.
  • Numéro de commande : imprimé sur l’étiquette et envoyé comme centre de coûts de l’AWB, que FAN Courier indique dans le rapport des bordereaux d’expédition.

Globe ne renvoie pas une demande d’AWB dont le délai de réponse a expiré, car FAN Courier a peut-être déjà créé l’AWB. Voir Dépannage pour savoir quoi faire dans ce cas.


Sélectionnez le type de service dans le champ Type lors de la création d’une étiquette, ou associez-le à vos méthodes d’expédition :

Type de serviceLivre à
FAN Courier (pickup point if selected, otherwise address)Le point FAN Courier choisi par le client au checkout. Une commande sans point de retrait part à l’adresse du client.
FAN Courier Standard (address)L’adresse du client, même lorsque la commande comporte un point de retrait.
FAN Courier pickup point (FANbox, PayPoint or FAN office)Le point FAN Courier de la commande. Une commande sans point est refusée.

Avec le premier et le troisième type de service, une commande dont le point de retrait appartient à un autre réseau est refusée et n’est jamais expédiée à l’adresse du client à la place. Pour l’expédier à l’adresse, choisissez FAN Courier Standard (address). Lorsqu’une commande avec un point de retrait est réglée sur FAN Courier Standard (address), le panneau de création d’étiquette affiche un avertissement avant l’export.

Globe choisit le service FAN Courier selon la destination et selon que la commande est en paiement à la livraison ou non :

DestinationServiceService avec paiement à la livraison
Adresse du clientStandardCont Colector
Bureau FANStandardCont Colector
FANboxFANboxFANbox Cont Colector
PayPointCollectPointCollectPoint Cont Colector

Les livraisons en point de retrait vont aux points propres de FAN Courier, que le client choisit au checkout parmi les points de retrait FAN Courier de Globe.

PointL’ID commence parPoids max.Taille max.
FANbox (consigne)F30 kg44×45×40 cm
PayPointP10 kg60×90×60 cm
Bureau FANSSans limiteSans limite
  • Globe vérifie le poids et les Dimensions du colis (cm) par rapport à ces limites avant de créer l’AWB. Chaque côté est arrondi au centimètre entier supérieur, et le colis peut être tourné dans n’importe quel sens pour entrer. Globe ne vérifie aucune limite de poids ou de taille pour les bureaux FAN.
  • L’AWB contient l’ID du point ainsi que le département et la localité que FAN Courier associe à ce point (Globe les recherche lors de la création de l’étiquette). L’adresse postale du client n’est pas envoyée.
  • Une livraison en FANbox nécessite le numéro de mobile roumain du client (07xxxxxxxx) et son e-mail pour le code de retrait.

FAN Courier encaisse le paiement à la livraison uniquement en RON, jusqu’à 10 000 RON par commande. Globe refuse les autres commandes en paiement à la livraison avant la création d’un AWB.

Lorsque la commande a été passée en paiement à la livraison, Globe renseigne le montant à encaisser à partir de la commande. Vous pouvez le modifier dans le champ Montant contre remboursement du panneau de création d’étiquette.

Les commandes en paiement à la livraison utilisent la variante Cont Colector du service (voir Types de service), qui verse l’argent encaissé sur le compte bancaire de l’agence FAN Courier depuis laquelle vous expédiez.

DestinationPaiement à la livraison
Adresse du clientPris en charge
Bureau FANPris en charge
FANboxLe client paie par carte à la consigne. Le paiement par carte (mPOS) doit être actif sur votre contrat FAN Courier, sinon FAN Courier refuse l’AWB.
PayPointRefusé lorsque le PayPoint n’accepte pas de paiements. Globe le vérifie avant de créer l’AWB.

Les étiquettes FAN Courier peuvent être imprimées dans les formats suivants. Choisissez le format par défaut dans Option d’impression par défaut.

Option d’impressionCe qui est imprimé
10.5x14.8 cm (ePOD, else A5)Les AWB ePOD en étiquette de 10,5×14,8 cm, les autres AWB en formulaire AWB A5
A5Le formulaire AWB A5
A4Le formulaire AWB A5 sur une page A4

Chaque option d’impression a une seule position par feuille : il n’y a donc pas de position de départ à choisir. Un AWB est ePOD lorsqu’il a été créé avec ePOD (étiquettes 10,5x14,8 cm) activé. Lorsque votre sélection mélange des AWB ePOD et d’autres AWB, Globe les imprime dans un seul PDF, en regroupant les pages de même taille.

Globe télécharge les étiquettes auprès de FAN Courier à chaque impression. Si FAN Courier ne renvoie pas certaines d’entre elles, Globe imprime les autres et liste les AWB manquants. Les commandes dont l’étiquette manque ne sont pas comptées comme imprimées et ne reçoivent pas le Tag personnalisé après impression.


ProblèmeSolution
L’identifiant et le mot de passe ne sont pas renseignés, ou FAN Courier les a refusésSaisissez vos identifiants de connexion à selfAWB dans Identifiant selfAWB et Mot de passe selfAWB. Si vous avez un contrat mais pas d’accès à selfAWB, écrivez à selfawb@fancourier.ro.
FAN Courier est injoignable ou la connexion a échoué avec un code HTTPGlobe n’a pas pu se connecter à FAN Courier : aucun AWB n’a été créé. Réessayez plus tard.
Votre compte a plusieurs agences, le Client ID n’est pas un nombre ou FAN Courier n’a renvoyé aucune agenceSaisissez dans Client ID (agence) le Client ID de l’agence depuis laquelle vous expédiez, tel qu’affiché dans selfAWB. Utilisez uniquement des chiffres. Si vous avez plusieurs agences, le message les liste avec leur Client ID.
Les étiquettes FAN Courier dans Globe ne couvrent que les livraisons en RoumanieL’adresse de livraison se trouve hors de Roumanie. Expédiez les commandes vers d’autres pays avec un autre transporteur.
Le point de retrait n’est ni une FANbox, ni un PayPoint, ni un bureau FAN CourierLe point appartient à un autre réseau, ou son ID n’est pas un ID FAN Courier. Choisissez un point FAN Courier avec Modifier le point de retrait, ou choisissez FAN Courier Standard (address) pour livrer à l’adresse du client.
La commande n’a pas de point de retrait FAN Courier, mais la livraison en point FAN Courier a été choisieChoisissez un point FAN Courier avec Modifier le point de retrait, ou un type de service qui livre à l’adresse.
FAN Courier ne liste plus le point de retrait ou le point ne correspond pas à son département et à sa localitéChoisissez un autre point FAN Courier avec Modifier le point de retrait.
La commande n’a pas de poidsDéfinissez le poids du produit dans Shopify, saisissez-le dans le champ Poids de l’envoi (kg) du panneau de création d’étiquette, ou définissez le Poids par défaut (kg) dans les paramètres du transporteur.
La commande est trop lourde ou les dimensions du colis ne conviennent pas à une FANbox ou à un PayPointVérifiez les limites sous Points de retrait et vos Dimensions du colis (cm). Choisissez un autre point avec Modifier le point de retrait, ou livrez à l’adresse avec FAN Courier Standard (address).
FAN Courier n’encaisse le paiement à la livraison qu’en RON et dans la limite de 10 000 RONVoir Paiement à la livraison (PDL). Expédiez ces commandes avec un autre transporteur.
Le PayPoint n’accepte pas de paiements ou le paiement par carte (mPOS) n’est pas actif pour une FANboxUne FANbox n’encaisse le paiement à la livraison que par carte, ce qui nécessite le paiement par carte (mPOS) sur votre contrat FAN Courier. Un PayPoint qui n’accepte pas de paiements ne peut pas encaisser le paiement à la livraison. Choisissez un autre point avec Modifier le point de retrait, ou livrez à l’adresse.
La commande n’a pas de numéro de téléphone du destinataire ou une livraison en FANbox n’a pas de numéro de mobile roumain ni d’e-mailAjoutez le numéro de téléphone du client à la commande. Une livraison en FANbox nécessite un numéro de mobile roumain (07xxxxxxxx) et une adresse e-mail.
Le département n’est pas un département roumain connu de FAN Courier, la rue manque ou The selected recipient.locality is invalid.Modifiez l’adresse de livraison dans Shopify. La province doit être un département roumain et la rue doit être renseignée. Si FAN Courier ne connaît pas la ville, vérifiez son orthographe et le code postal à six chiffres.
Le message vous demande de vérifier selfAWB avant de recréer l’étiquetteFAN Courier a peut-être créé l’AWB sans que Globe l’enregistre : la réponse n’est pas arrivée à temps, a été perdue ou illisible, ou Globe n’a pas pu l’enregistrer. Cherchez l’AWB dans selfAWB avant de recréer l’étiquette. Un nouvel export crée un deuxième AWB.
Autres messages commençant par FAN Courier:FAN Courier a refusé l’AWB : le texte qui suit les deux-points en donne la raison. Corrigez la commande et recréez l’étiquette.
X étiquettes FAN Courier imprimées sur Y ou erreur lors de l’impression des étiquettes FAN CourierFAN Courier n’a pas renvoyé tout ou partie des étiquettes, et le message indique la raison donnée par FAN Courier. Lors d’une impression partielle, le PDF contient les étiquettes reçues et le message liste les AWB manquants.