Inventaire/Emplacement du stock
Votre guide d'intégration V5 !
L'intégration de l'inventaire/localisation des stocks entre la traçabilité V5 et le système ERP d'un client permet marchandise les détails de l'inventaire tels que les numéros de lot, les quantités disponibles et les emplacements à envoyer à V5 Traçabilité. Ces détails permettront ensuite à ces produits d'être utilisés pour la production/commande, etc.
En fonction de la configuration de notre ERP, nous pouvons gérer les stocks de différentes manières :
- ERP comme stock master : Ici, l'ERP alimenterait les données d'inventaire dans la V5, puis la V5 renverrait les ajustements/consommation/production/etc. (le plus courant) (stocker, se déconnecter). Cela peut être fait de 2 manières ; La valeur du stock mise à jour à partir du journal (le lot 123 est maintenant de 50 LB ); Ou vous pouvez consulter la valeur d'ajustement dans le journal (Lot123 -50LBS). La première option maintient les choses plus synchronisées mais présente plus de risques de manquer une transaction.
- V5 comme stock master : La V5 transmet les données d'inventaire à l'ERP. L’ERP renvoie ensuite les niveaux de stocks mis à jour à intervalles réguliers. (stock en rupture, stock disponible)
- ERP comme stock master : L'ERP alimente le stock V5, puis V5 renvoie régulièrement les niveaux de stock et l'ERP met à jour son décompte. Ceci est avantageux car l’ERP et la V5 seront toujours synchronisés. Cependant, cela peut être problématique en raison du timing et de la fréquence de synchronisation, surtout si le stock peut être déduit dans l'ERP lui-même, ces niveaux ajustés peuvent être écrasés lors de la prochaine synchronisation V5. Cette méthode peut être utile si l'ERP/MRP n'ajuste pas directement les stocks, mais les conserve uniquement pour les données financières. (stock entrant, stock épuisé)
Si vous n'êtes pas sûr de la meilleure voie à suivre pour votre configuration ERP particulière, SG Systems peut organiser une séance de consultation pour évaluer au mieux la méthodologie optimale pour votre système.
Table des Matières
1. Disposition du centre de contrôle
En ce qui concerne la façon dont nous pouvons relier les détails de l'inventaire/emplacement du stock à ce que nous voyons dans le centre de contrôle, nous utiliserons ce point de terminaison principalement pour remplir le panneau inférieur gauche afin d'importer et d'exporter nos niveaux/emplacements de stock pour les produits existants.
En utilisant la passerelle V5, nous pouvons facilement remplir les données ici en utilisant deux points de terminaison, ‘Stock’ et ‘StockLocation’.
2. Liens API
Pour en savoir plus sur les définitions de ces classes de base de données, veuillez consulter les liens suivants :
3. Modèle d'intégration
Le modèle d'intégration pour Stock Location peut être téléchargé ici.
4. Guide de terrain de l'emplacement des stocks
4.1. Clés primaires
Les clés primaires sont l'identifiant unique de chaque table dans l'API V5. Pour StockLocation, ceux-ci sont:
location.code – Le code d’identification unique du emplacement des stocks.
stock.commodity.code – Le code d’identification unique du marchandise
stock.lotNo – Le numéro de lot du stock.
Pour Stock, les clés primaires sont :
lotNo – Le numéro de lot du stock.
commodity.code – Le code d’identification unique de la marchandise.
Notez que les numéros de lot peuvent être générés automatiquement par le système ou saisis manuellement. Les numéros de lot des fournisseurs peuvent être saisis à l'aide du champ décrit ci-dessous. Les numéros de lot peuvent être générés globalement (aucun numéro de lot ne peut être identique) ou par produit.
4.2. Champs obligatoires
Les autres champs requis par SG pour remplir une ligne de produits valide dans le centre de contrôle V5 sont :
stock.expiry – La date de péremption du lot concerné.
qty – La quantité de marchandise dans ce lot.
4.3. Champs préférés
Les champs préférés servent à ajouter plus d'informations sur le produit en question et, bien qu'ils ne soient pas obligatoires, sont utiles lorsqu'il s'agit d'ajouter des fonctionnalités dans V5 Traçabilité.
stock.supplier.code - Le code du fournisseur qui a fourni le lot de la marchandise.
stock.cost - Le coût (par UdM) du produit.
stock.dateReceived - Date à laquelle le lot a été enregistré en stock.
stock.supplierLotNo - Le numéro de lot attribué par le fournisseur.
4.4. Champs supplémentaires
Des champs supplémentaires peuvent également être inclus, tels que :
stock.commodity.description - La description de la marchandise.
stock.commodity.units.code - UdM par défaut du produit.
stock.commodity.recordStock – Si l'utilisation de ce produit sera suivie avec la traçabilité V5.
Notez que ces champs supplémentaires peuvent être utilisés pour créer des entrées de marchandises dans V5 Traçabilité ainsi que pour leur attribuer des emplacements de stock et des quantités. Lors de l'utilisation du Méthode CSV Lors de l'échange de données, nous devons nous assurer que « Créer des entités enfants » est sélectionné dans la « Passerelle » du Control Center. Toutefois, les produits existants ne peuvent pas être mis à jour dans le V5-API en utilisant ce point de terminaison, nous devons plutôt les résoudre directement en utilisant le 'Marchandise' point de terminaison à la place.
5. Méthodologie
En fonction de l'objectif de notre intégration API, nous pouvons utiliser le ‘StockLocation’ or ‘Stock’ point de terminaison pour les importations et les exportations JSON et CSV. Nous pouvons maintenant examiner cela ci-dessous.
5.1. JSON – Importation
StockLocation:
Nous pouvons utiliser le ‘StockLocation’ point final pour insérer des enregistrements de stock pour les produits (existants ou non) dans la traçabilité V5 qui contient des informations relatives aux dates de réception/expiration, aux numéros de lot/fournisseur et bien sûr, à l'emplacement du stock.
‘StockLocation’ importer le point de terminaison/URI –
http://host:port/V5-API/api/integrate/import/stock_location
Pour cet exemple d'importation à l'aide du ‘StockLocation’ point final, nous pouvons structurer un fichier d'importation de base pour un seul lot comme ci-dessous :
Cet exemple de fichier JSON peut être téléchargé ici.
En utilisant le manuel de l'API, nous pouvons voir ici que nous utilisons uniquement le ‘qty’ valeur de la ‘StockLocation’ classe, avec toutes les autres valeurs imbriquées sous la classe ‘stock’ or ‘location’ classe. On peut également voir que le ‘code’ et ‘units’ les points de données sont imbriqués plus loin sous le ‘commodity’ classe.
Nous pouvons voir un résumé de ce processus de flux de données ci-dessous :
Si nous exécutons le fichier JSON ci-dessus, nous verrons que notre lot pour les matières premières ‘I015’ (Jalepenos) ce lot est maintenant importé dans Control Center.
Cependant, ce que nous ne pouvons pas faire avec le ‘StockLocation’ le point final correspond aux valeurs de modification telles que le numéro de lot du fournisseur et la date d’expiration du stock existant. Pour ce faire, nous aurions besoin d'utiliser le ‘Stock’ point final.
Stock:
Comme mentionné ci-dessus, le ‘StockLocation’ le point de terminaison peut être utilisé pour insérer des enregistrements de stock et leurs emplacements associés. Cependant, si nous souhaitons mettre à jour les détails de ces lots qui relèvent du ‘Stock’ en-tête, nous devons utiliser le ‘Stock’ point final. Cela inclut des détails tels que le numéro de lot du fournisseur, la date de péremption et le poids reçu.
‘Stock’ importer le point de terminaison/URI –
http://host:port/V5-API/api/integrate/import/stock
Pour un très basique ‘Stock’ fichier d'importation qui mettra à jour la date d'expiration et le numéro de lot fournisseur du lot que nous avons créé ci-dessus, nous pouvons utiliser ce qui suit :
Ce qui entraîne la mise à jour des informations sur le lot dans la V5 :
5.2. JSON – Exporter
En termes de réception des fichiers relatifs aux emplacements de stock en provenance de l'API V5, si l'on vérifie les résumés de méthode sous la rubrique IntegrationExport classe, on pourrait penser que ‘StockLocations’ (export/locations/stock) serait ce que nous recherchons. Ce n'est cependant pas le cas, car ce point de terminaison exportera une liste des emplacements de stock (par rapport aux emplacements de production) qui existent dans le système.
Pour recevoir des informations sur l'emplacement et les niveaux de stock de nos produits, nous pouvons utiliser :
Marchandise individuelle + stock de lots :
Exporter le point de terminaison/URI –
http://host:port/V5-API/api/integrate/export/stock/{commodityCode}/{lotNumber}
Ce point de terminaison exportera un fichier JSON avec toutes les informations associées pour le lot spécifié d'un produit unique. Si nous exécutons cette requête en utilisant les informations du lot que nous venons d'importer, nous obtiendrons un fichier qui ressemble à ceci :
Un exemple de fichiers JSON de ce type peut être téléchargé ici.
Tous les stocks :
Exporter le point de terminaison/URI –
http://host:port/V5-API/api/integrate/export/stock/{all}
Ce point de terminaison exportera un fichier JSON qui comprend une liste de toutes les informations associées pour tous les lots de chaque produit du système, en fonction de la valeur du champ {all}. Si c'est ‘true’ alors nous retirerons tous les lots de stock, alors que si ‘false’ nous obtiendrons alors simplement un retour pour les nouveaux articles en stock (c'est-à-dire de nombreux produits qui ne sont pas marqués comme déjà exportés).
Si nous exécutons cette requête comme ‘true’ (alors http://host:port/V5-API/api/integrate/export/stock/true) , nous obtiendrons un fichier qui ressemble à ceci :
Un exemple de fichiers JSON de ce type peut être téléchargé ici.
Les points de terminaison ci-dessus fourniront uniquement les niveaux de stock actuels. Mais que se passe-t-il si nous voulons suivre nos niveaux de stocks au fur et à mesure de la production ? Ici, nous avons quelques options différentes en fonction de la manière dont nous utilisons l'API et intégrons un système ERP.
Nous pouvons également utiliser une variété de points de terminaison transactionnels et de journalisation pour récupérer des informations plus pertinentes sur les modifications du niveau de stock.
Pour Journal du système points finaux, ce sont :
Journaux système consommés/produits
Journaux du système de réglage
Pour Transactionnel/Générique points finaux, ce sont :
5.3. CSV – Importer
Nom du fichier de définition d'en-tête/colonne : “stockLocation.csvh”
Les fichiers d'en-tête complétés doivent être placés dans : “<installdir>\SG Control Center\gateway\import\column_defs”
Importer le nom du fichier CSV : “stockLocation-datetime.csv”
Les fichiers CSV à importer doivent être placés dans : “<installdir>\SG Control Center\gateway\import”
En tête de fichier:
Les fichiers d'en-tête seront généralement compilés par SG Systems avant les intégrations CSV, mais nous pouvons voir un exemple de base de celui que nous pouvons utiliser pour l'inventaire/stock, en utilisant le fichier précédemment défini. définitions de classe, au dessous de:
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.
Un exemple de fichier d'importation CSV pourrait ressembler à ceci :
Ici, nous pouvons voir que nous importons 3 nouveaux lots de 2 fournisseurs différents. Cet exemple de fichier d'importation peut être téléchargé ici.
Une fois l'importation terminée, nous pouvons voir que ces lots supplémentaires de Jalapeno ont été ajoutés au Control Center. Notez ici la différence entre ‘Qty’ (à portée de main) et ‘Stock_WeightReceived’ dans notre fichier csv d'importation.
5.4. CSV – Exporter
Comme pour les exportations JSON, nous proposons ici plusieurs options :
StockLocation:
Lors de l'exportation de produits à l'aide de cette méthode, nous pouvons utiliser le même point final et définitions de classe comme nous l'avons fait pour les importations.
Nom du fichier de définition d'en-tête/colonne : “stockLocation.csvh”
Les fichiers d'en-tête complétés doivent être placés dans : “<installdir>\SG Control Center\gateway\export\order”
Exporter le nom du fichier CSV : “StockLocation-datetime.csv”
Les CSV pour les exportations seront générés dans : “<installdir>\SG Control Center\gateway\export”
Cette exportation devra également être activée dans la section Passerelle du Control Center. On peut choisir ici d'exporter ‘Stock’ .
En tête de fichier:
À partir de là, il suffirait simplement de structurer notre fichier d'en-tête d'exportation en fonction des informations que nous souhaitons recevoir du système.
Nous pourrions le structurer d'une manière très similaire à la façon dont nous avons structuré l'en-tête d'importation :
Cet exemple de fichier d'en-tête peut être téléchargé ici.
Fichier d'exportation CSV :
Cela donnerait un CSV de retour pour nos importations récentes qui ressemblerait à l'exemple ci-dessous. Nous pouvons voir ici que nous avons récupéré toutes les lignes de stock précédemment non exportées, y compris l'ajout de certains produits fabriqués plus tôt dans la journée.
Cet exemple de fichier d'exportation peut être téléchargé ici.
Cependant, comme pour les exportations JSON ci-dessus, cela ne renverra aucune donnée transactionnelle, nous pouvons donc encore une fois utiliser le ‘SystemLog’ point final pour récupérer des données plus pertinentes en termes de transactions et d'ajustements de stocks.
SystemLog:
Ce point de terminaison peut être utilisé pour extraire une grande variété de données en parcourant les points de données disponibles liés à partir d'ici. Nous pouvons voir les définitions que nous pouvons utiliser ici.
Nom du fichier de définition d'en-tête/colonne : “SystemLog.csvh”
Les fichiers d'en-tête complétés doivent être placés dans : “<installdir>\SG Control Center\gateway\export\order”
Exporter le nom du fichier CSV : “SystemLog-datetime.csv”
Les CSV pour les exportations seront générés dans : “<installdir>\SG Control Center\gateway\export”
Comme ci-dessus, cela devra être activé dans la section Passerelle du Control Center :
En tête de fichier:
À partir de là, nous pouvons structurer notre en-tête en fonction des données transactionnelles que nous souhaitons renvoyer à l'ERP. Pour nos besoins ici, cela pourrait ressembler à ceci :
Cet exemple de fichier d'en-tête peut être téléchargé ici.
Fichier d'exportation CSV :
Nous pouvons donc voir ici que nous allons recevoir des données spécifiquement adaptées à nos besoins, y compris des données telles que le produit, son numéro de lot, la quantité d'origine, les éventuels ajustements et l'utilisateur qui a effectué l'action, ainsi que les raisons et la tâche pertinente. /informations sur le lot.
Si nous exécutons le journal système avec l'en-tête ci-dessus, nous obtiendrons une exportation qui ressemble à ceci :
Cet exemple de fichier d'exportation peut être téléchargé ici.
