Statut d'importation

Conditions préalables

• Connexion à l'API Deliveo souscrite.
• Autorisation d'installer l'extension.
• Autorisation d'utiliser l'extension.

Installation et accès

L'extension peut être installée sur le Portail de gestion, sous le menu « Extensions ». Une fois installée, elle est accessible via le menu « Extensions / Importation de statuts ». Seuls les utilisateurs disposant des droits d'accès appropriés peuvent procéder à l'installation et à l'utilisation de l'extension.

Téléchargement de fichiers

L'extension prend en charge les formats de fichiers suivants :

• CSV
• XLSX
• XLS

La taille maximale du fichier à télécharger est de 10 Mo. Le fichier doit comporter une ligne d'en-tête. Le système utilise les noms de colonnes figurant dans l'en-tête pour associer les colonnes du fichier aux champs de Deliveo.

Pour importer le fichier :

1. Ouvrez le menu « Extensions / Importation de statut ».
2. Faites glisser le fichier dans la zone de téléchargement ou cliquez pour parcourir votre ordinateur.
3. Sélectionnez le fichier à traiter.
4. Cliquez sur le bouton « Importer ».

Une fois le téléchargement terminé, l'interface de mise en correspondance des champs et l'aperçu du contenu du fichier s'affichent.

Mise en correspondance des champs

Pour le traitement, les colonnes du fichier doivent être associées aux champs correspondants de Deliveo.

Champs obligatoires

Identifiant de l'envoi

Sélectionnez la colonne du fichier qui contient l'identifiant de l'envoi.

Type d'identifiant d'envoi

Les types d'identifiant suivants peuvent être utilisés :

• DeliveoIDL'identifiant primaire unique de vos envois dans le système Deliveo.
• ESID (External Shipment ID, identifiant reçu du partenaire)

Le type d'identifiant sélectionné doit correspondre au type des identifiants figurant dans le fichier.

Autres champs pouvant être mis en correspondance

Nom du destinataire

Nom de la personne qui réceptionne l'envoi.

Date de livraison

Date et heure de la livraison réussie.

L'heure indiquée ne peut pas être antérieure à celle du dernier changement de statut de l'envoi.

Mode de paiement

Valeurs acceptées :

• CASH – paiement en espèces
• CARD – paiement par carte bancaire

ID du statut d'échec

Identifiant du statut correspondant à une livraison échouée. Il s'agit de l'ID figurant dans la première colonne du tableau du menu « Paramètres / Retours ».

Date et heure de l'échec

Date et heure de l'événement de livraison échouée. Il n'est pas nécessaire de faire correspondre tous les champs disponibles. N'attribuez que les champs qui figurent dans le fichier téléchargé et que vous souhaitez importer.

Enregistrement du modèle de mise en correspondance

La mise en correspondance des champs configurée peut être enregistrée à l'aide du bouton « Enregistrer le modèle ». Si vous téléchargez ultérieurement un fichier comportant les mêmes en-têtes de colonnes, le système appliquera automatiquement la mise en correspondance précédemment enregistrée. Cela accélère le traitement des fichiers de statut qui présentent régulièrement la même structure. Le mappage actuel peut être réinitialisé à l’aide du bouton « Réinitialiser ».

Traitement des statuts

Une fois les champs mis en correspondance, cliquez sur le bouton « Traitement des statuts ». Le système procède, ligne par ligne, comme suit :

1. recherche l’envoi à partir de l’identifiant fourni ;
2. vérifie les données importées ;
3. effectue la modification de statut correspondante ;
4. affiche le résultat du traitement.

Résultat du traitement

Une fois le traitement terminé, le système affiche un récapitulatif :

• nombre de lignes traitées ;
• nombre de lignes traitées avec succès ;
• nombre de lignes erronées ;
• la progression du traitement ;
• les messages d'erreur détaillés concernant les lignes erronées.

En cas d'erreur, le système affiche :

• le numéro de la ligne erronée ;
• l'identifiant de l'envoi ;
• la cause de l'erreur.

Par exemple, le traitement peut échouer si la date de livraison indiquée dans le fichier est antérieure à la date du dernier changement de statut de l'envoi. L'erreur empêche uniquement le traitement de la ligne concernée. Les autres lignes contenant des données valides peuvent être traitées.

Erreurs courantes

L'envoi est introuvable

Vérifiez :

• l'identifiant de l'envoi ;
• le type d'identifiant sélectionné ;
• si le fichier contient bien un DeliveoIDL'identifiant primaire unique de vos envois dans le système Deliveo. ou un ESID ;
• si l'identifiant ne contient pas d'espace superflu.

La date est antérieure à celle du dernier changement de statut

La date du statut ne peut pas être antérieure à la date du dernier statut actuel de l'envoi.

Corrigez la date et l'heure figurant dans le fichier, puis téléchargez-le à nouveau.

Le mode de paiement n'est pas accepté

Dans le champ « Mode de paiement », utilisez exclusivement les valeurs suivantes :

• CASH
• CARD

Les colonnes du fichier ne s'affichent pas

Vérifiez que :

• le fichier comporte une ligne d'en-tête ;
• les champs d'en-tête ne sont pas vides ;
• le fichier est au format CSV, XLSX ou XLS ;
• la taille du fichier ne dépasse pas 10 Mo.

Un champ a été associé de manière erronée

Cliquez sur le bouton « Réinitialiser », puis redéfinissez le mappage des champs. Si vous avez précédemment enregistré un modèle erroné, enregistrez à nouveau les paramètres corrects.