Données de référence : Ce que vous devez savoir

Comprendre les données de référence

Les données de référence sont des tables de correspondance qui aident Urbantz à comprendre les informations spécifiques à votre entreprise. Elles agissent comme des couches de traduction entre vos systèmes internes et Urbantz, ainsi qu'entre Urbantz et les transporteurs externes.

Par exemple, votre système de gestion d'entrepôt peut appeler un emplacement "Store_ABC_Paris", tandis qu'Urbantz y fait référence comme "Hub #789", et le transporteur le connaît comme "XYZ123". Les données de référence créent la connexion entre ces différents systèmes de nommage.

Cas d'utilisation courants

Intégration des transporteurs De nombreux clients utilisent les données de référence pour faire correspondre leurs identifiants internes avec les systèmes des transporteurs externes. Certains clients, par exemple, utilisent les données de référence pour traduire leurs identifiants de hub internes en identifiants de magasin requis par les transporteurs externes pour les livraisons.

Règles métier et configuration Les données de référence peuvent stocker la logique métier spécifique à vos opérations. Cela peut inclure les niveaux de priorité pour différents types de livraison, les exigences de temps de service basées sur les catégories d'articles, ou les matrices de prix qui varient selon la zone géographique.

Support des scripts Si vous utilisez des scripts personnalisés pour les annonces ou d'autres processus automatisés, les données de référence peuvent fournir les valeurs de configuration et les règles métier dont ces scripts ont besoin pour fonctionner correctement.

Fonctionnement des données de référence

Les données de référence sont structurées sous forme de tableaux, similaires aux feuilles de calcul Excel.

Lorsqu'Urbantz a besoin d'informations, il recherche dans la table de données de référence appropriée pour trouver la valeur correspondante. Par exemple, si le système doit trouver l'ID de magasin externe pour le Hub #789, il cherchera cet ID de hub dans vos données de référence et renverra l'ID externe correspondant.

Gestion de vos données de référence

Vous pouvez importer des données de référence à partir de fichiers CSV, XLS ou XLSX via l'interface Urbantz. Le système vous permet également d'exporter vos données au format XLSX pour sauvegarde ou modification. Notez que les données de référence ne peuvent être gérées que via l'interface web - l'accès API n'est pas disponible.

Éviter les problèmes courants

Problèmes d'en-têtes de colonnes L'un des problèmes les plus fréquents survient lorsque les en-têtes de colonnes ne correspondent pas exactement à ce que le système attend. Par exemple, si une fonctionnalité requiert une colonne nommée "name" mais que votre fichier a "Name" ou "item_name", le système ne pourra pas trouver les données dont il a besoin. Les colonnes sont sensibles à la casse et doivent être nommées exactement comme dans le système, sans symboles ou espaces supplémentaires.

Entrées en double Avoir le même identifiant apparaître plusieurs fois dans vos données de référence peut faire échouer le système. Chaque clé ou ID ne doit apparaître qu'une seule fois dans votre tableau. Avant de télécharger, vérifiez vos données pour vous assurer qu'il n'y a pas de doublons.

Considérations sur la taille des fichiers Les fichiers de données de référence volumineux peuvent avoir un impact significatif sur les performances du système. Essayez de maintenir vos fichiers en dessous de 5 Mo si possible en supprimant les colonnes inutiles ou en divisant les grands ensembles de données en plusieurs tableaux.

Données requises manquantes Certaines fonctionnalités, comme l'optimisation du bin packing, nécessitent des données spécifiques dans vos données de référence. Si ces informations sont manquantes, la fonctionnalité ne fonctionnera pas correctement. Assurez-vous de comprendre quelles données sont requises pour les fonctionnalités que vous utilisez.

Cohérence des données Un formatage incohérent peut provoquer des échecs de recherche. Par exemple, si vous écrivez parfois "Paris-Nord", parfois "paris nord", et parfois "PARIS_NORD", le système pourrait ne pas reconnaître qu'il s'agit du même emplacement. Établissez des conventions de nommage cohérentes et respectez-les.

Dépannage

Voici comment vérifier si quelque chose a changé :

Si quelque chose semble incorrect, vérifiez si des membres de votre équipe ont apporté des modifications dans les données de référence via la plateforme sous Administration > Logs > Sélectionnez "Reference_Data" :

Voici quelques exemples d'erreurs couramment rencontrées :

Les erreurs "Impossible d'analyser les données de référence" indiquent généralement des problèmes avec les en-têtes de colonnes ou le format des données. Vérifiez que vos noms de colonnes correspondent exactement à la documentation et que vos données sont au format attendu.

Les problèmes de performance sont souvent liés à la taille du fichier. Si vous remarquez des temps de réponse plus lents après avoir téléchargé des données de référence, envisagez de réduire la taille du fichier ou de le diviser en tableaux plus petits.

Les échecs d'optimisation après la mise à jour des données de référence signifient généralement que les informations requises sont manquantes ou mal formatées. Vérifiez les exigences pour toutes les fonctionnalités d'optimisation que vous utilisez.

Meilleures pratiques

Après le téléchargement, testez la fonctionnalité avec un petit lot avant de traiter de grands volumes. Surveillez les performances du système pour vous assurer que les nouvelles données ne causent pas de ralentissements.

Ne mettez à jour les données de référence que lorsque c'est nécessaire, et assurez-vous d'informer votre CSM des modifications apportées au préalable, car les changements peuvent parfois avoir des effets inattendus. Conservez des sauvegardes des versions fonctionnelles et documentez tous les changements que vous apportez pour référence future.

Obtenir de l'aide

Si vous rencontrez des problèmes avec les données de référence, contactez votre CSM, ou à defaut, l'équipe de support, avec le message d'erreur exact, le nom de la table de données de référence affectée, les détails des changements récents et des captures d'écran si applicable.