Unités de mesure
Votre guide d'intégration V5 !
L'intégration des unités de mesure entre V5 Traceability et le système ERP d'un client permet d'envoyer les unités de mesure utilisées par un système ERP/tiers à V5 Traceability. Ces unités peuvent ensuite être appliquées à l'entreposage et à la formulation/production au sein du système V5 Traceability.
La flexibilité du système de traçabilité V5 permet une configuration d'unités entièrement personnalisée, avec la possibilité de définir des conversions d'unités personnalisées pour de grandes quantités telles que des caisses et des fûts, ainsi que de définir des taux de conversion spécifiques aux produits. Les taux de conversion spécifiques sont particulièrement utiles pour les articles ayant une densité spécifique, comme nous le verrons dans l'exemple ci-dessous.
Seules les importations sont disponibles pour les classes « WeightUnit » et « UnitCommodity » que nous examinerons ici ; les exportations ne sont pas disponibles via les méthodologies JSON ou CSV.
Pour plus d'informations sur le fonctionnement des unités de mesure dans V5 Traceability, veuillez consulter notre guide du module ici.
Table des Matières
1. Disposition du centre de contrôle
En ce qui concerne la manière dont nous pouvons relier les unités et les taux de conversion spécifiques aux produits à ce que nous voyons dans le Centre de contrôle, nous pouvons voir que le panneau supérieur ici sert à saisir nos unités de mesure, le panneau inférieur étant destiné aux taux de conversion spécifiques aux produits pour l'unité sélectionnée dans le panneau supérieur.
Si une entrée dans le panneau inférieur n'est pas présente pour un produit donné, le système reviendra au taux de conversion défini dans le panneau supérieur lorsqu'un produit est utilisé avec cette unité. Une fois qu'un produit est ajouté dans le panneau inférieur et qu'un taux de conversion lui est ajouté (le « ProduitUnité »), celui-ci remplace alors le taux de conversion dans le panneau supérieur.
En utilisant la passerelle V5, nous pouvons facilement remplir les deux panneaux.
2. Liens API
Pour en savoir plus sur les définitions des 2 classes de base de données que nous utiliserons pour ajouter nos unités, veuillez consulter les liens suivants :
3. Modèle d'intégration
4. Guide pratique des unités
4.1. Clés primaires
Les clés primaires sont l'identifiant unique de chaque table au sein de l'API V5.
Pour Unité de poids, c'est:
code – Le code unique de l’unité de mesure (c’est-à-dire g, kg, lb, oz, etc.)
Pour UnitéCommodité, les clés primaires sont :
unité.code – le code unique de l’unité de mesure, comme ci-dessus.
et
marchandise.code – Le code unique du produit auquel appliquer le taux de conversion spécifique.
4.2. Champs obligatoires
Les autres champs requis par SG pour remplir une entrée valide dans Control Center sont :
Pour Unité de poids :
taux de conversion - Le taux de conversion pour cette unité, par rapport à l'unité avec l'ID 1 dans la base de données.
Pour UnitéCommodité:
taux de conversion – le taux de conversion spécifique pour le produit spécifique.
4.3. Champs préférés
Les champs préférés servent à ajouter plus d'informations à l'unité de mesure (Unité de poids), et bien que cela ne soit pas obligatoire, ils sont utiles en ce qui concerne les fonctionnalités de la traçabilité V5.
la description - description de l'unité (kilos, livres, etc.)
4.4. Champs supplémentaires
Des champs supplémentaires peuvent également être inclus pour Unité de poids, Tels que:
note – des notes supplémentaires pour l’unité
5. Méthodologie
Étant donné la nature relativement simple de cette classe, nous pouvons utiliser l'intégration JSON ou CSV pour importer des unités dans V5. Nous examinerons cela du point de vue d'une importation initiale pour intégrer les unités manquantes dans le système (weightUnit), après quoi nous attribuerons des conversions spécifiques aux produits en utilisant les unités du système (UnitCommodity). Notez encore une fois qu'aucune exportation n'est disponible pour l'un ou l'autre point de terminaison/classe.
6. Unité de poids
6.1. JSON – Importation
''WeightUnit'' importer Endpoint/URI –
http://host:port/V5-API/api/integrate/import/unit
échantillons:
Pour cet exemple d'importation, nous utiliserons le point de terminaison « WeighUnit » pour ajouter des livres et des onces au tableau des unités du centre de contrôle présenté ci-dessus dans l'introduction. Le fichier JSON pour effectuer cette opération ressemblerait à ceci :
Notez que les taux de conversion seront toujours calculés à partir de l'unité par défaut (c'est-à-dire la première unité du tableau des unités), nous calculons donc ici cela par rapport aux kilogrammes (kg).
Cet exemple de fichier JSON peut être téléchargé ici.
En utilisant le fichier ci-dessus, nous pouvons voir que nos nouvelles unités ont été créées dans le Centre de contrôle.
6.2. JSON – Exporter
Aucune exportation JSON n'est disponible pour la classe « WeightUnit ».
6.3. CSV – Importer
Nom du fichier de définition d'en-tête/colonne : « Unité de poids.csvh »
Les fichiers d'en-tête complétés doivent être placés dans : " \SG Control Center\gateway\import\column_defs"
Importer le nom du fichier CSV : « Unité de poids-dateheure.csv »
Les fichiers CSV à importer doivent être placés dans : " \Centre de contrôle SG\passerelle\importation »
échantillons:
En tête de fichier:
Les fichiers d'en-tête seront généralement compilés par SG Systems avant que les intégrations CSV n'aient lieu, mais nous pouvons voir un exemple de base de celui que nous pouvons utiliser pour les unités ci-dessous :
Pour plus d'informations sur la manière dont nous structurons ces fichiers, veuillez consulter le page d'intégration principale.
Cet exemple de fichier d'en-tête peut être téléchargé ici.
Fichier d'importation CSV :
Nous pouvons ensuite utiliser l'ordre défini des points de données dans l'en-tête pour structurer notre fichier d'importation. SG Systems peut fournir un fichier modèle pour cela, répertoriant les points de données pour chaque colonne afin de clarifier les choses lors du remplissage de la liste. Notez que cette première ligne peut être ignorée par Control Center et peut donc être conservée dans le fichier lors de la soumission pour importation.
Ici, nous pouvons voir que nous créons les mêmes nouvelles unités que celles que nous avons faites dans l'exemple JSON ci-dessus, bien que nous utilisions des lettres minuscules pour le code des unités afin de l'afficher plus clairement dans le Centre de contrôle.
Cet exemple de fichier d'importation peut être téléchargé ici.
Une fois l'importation terminée, nous pouvons voir qu'une fois de plus ces nouvelles unités ont été créées.
6.4. CSV – Exporter
Comme pour les exportations JSON, aucune exportation CSV n'est disponible pour la classe « WeightUnit ».
7. Unité de marchandise
7.1. JSON – Importation
Point de terminaison/URI d'importation « UnitCommodity » –
http://host:port/V5-API/api/integrate/import/unit_commodity
échantillons:
Pour cet exemple d'importation, nous utiliserons le point de terminaison « UnitCommodity » pour ajouter une conversion d'unité spécifique pour les litres de lait. Nous avons vu dans le centre de contrôle ci-dessus que les litres se convertissent généralement selon un rapport 1:1 de litres en kg, c'est-à-dire qu'un litre d'eau pèse 1 kg. Un litre de lait pèse cependant un peu plus que cela (1 kg), nous verrons donc comment configurer cela pour une importation JSON ci-dessous.
Ce que nous disons donc au système ici, c'est que, lorsque du lait est utilisé, la conversion utilisée sera celle de 1.035, remplaçant le taux de conversion par défaut pour l'unité litre.
Cet exemple de fichier JSON peut être téléchargé ici.
En utilisant le fichier ci-dessus, nous pouvons voir que notre taux de conversion spécifique pour le lait a été ajouté au panneau inférieur de « litre ».
7.2. JSON – Exporter
Aucune exportation JSON n'est disponible pour la classe « UnitCommodity ».
7.3. CSV – Importer
Nom du fichier de définition d'en-tête/colonne : « unitCommodity.csvh »
Les fichiers d'en-tête complétés doivent être placés dans : " \SG Control Center\gateway\import\column_defs"
Importer le nom du fichier CSV : « unitCommodity-datetime.csv »
Les fichiers CSV à importer doivent être placés dans : " \Centre de contrôle SG\passerelle\importation »
échantillons:
En tête de fichier:
Les fichiers d'en-tête seront généralement compilés par SG Systems avant que les intégrations CSV n'aient lieu, mais nous pouvons voir un exemple de fichier que nous pouvons utiliser pour la conversion d'unités spécifiques à un produit ci-dessous :
Pour plus d'informations sur la manière dont nous structurons ces fichiers, veuillez consulter le page d'intégration principale.
Cet exemple de fichier d'en-tête peut être téléchargé ici.
Fichier d'importation CSV :
Nous pouvons ensuite utiliser l'ordre défini des points de données dans l'en-tête pour structurer notre fichier d'importation. SG Systems peut fournir un fichier modèle pour cela, répertoriant les points de données pour chaque colonne afin de clarifier les choses lors du remplissage de la liste. Notez que cette première ligne peut être ignorée par Control Center et peut donc être conservée dans le fichier lors de la soumission pour importation.
Ici, nous pouvons voir que nous créons la même conversion d’unité spécifique au produit que celle que nous avons effectuée dans l’exemple JSON ci-dessus.
Cet exemple de fichier d'importation peut être téléchargé ici.
Une fois l'importation terminée, nous pouvons voir qu'une fois de plus cette nouvelle conversion d'unité spécifique au produit a été créée.
7.4. CSV – Exporter
Comme pour les exportations JSON, aucune exportation CSV n'est disponible pour la classe « UnitCommodity ».
