Client (Fournisseurs et Clients)
Votre guide d'intégration V5 !
Le point de terminaison d'importation « Client » peut être utilisé pour créer à la fois des fournisseurs et des clients au sein du système de traçabilité V5, qui peuvent ensuite être utilisés pour recevoir des bons de commande et expédier des commandes de vente respectivement.
Guides d'intégration associés :
Ce guide se concentrera sur la façon d'utiliser ce point de terminaison « Client », à la fois via l'importation CSV et en utilisant JSON via l'API V5.
Table des Matières
1. Dispositions du centre de contrôle
Pour ce qui est de la façon dont nous pouvons relier le point de terminaison client à ce que nous voyons dans le Centre de contrôle V5, cela concerne à la fois les fenêtres « Fournisseurs » et « Clients ». Donc, pour les fournisseurs :
Et pour les clients :
2. Liens API
Pour en savoir plus sur les définitions de ce « Client » et de la classe de base de données associée, veuillez consulter le lien suivant :
3. Guide pratique du client
3.1. Clés primaires
Pour l'importation via le point de terminaison « Client », la clé primaire est :
Code – Le code unique du fournisseur ou du client.
3.2. Champs obligatoires
Autres champs obligatoires pour créer une entrée valide dans V5 :
Type – le type de client ; cette valeur doit être 0 pour les fournisseurs et 1 pour les clients.
3.3. Champs supplémentaires
D'autres options ici que nous pouvons ajouter à partir de la classe de base de données « Client » sont :
Nom – Le nom du fournisseur/client.
SignatureRequired – 0 ou 1 pour indiquer si une signature est requise ou non lors de la réception/de l’expédition au client.
Il existe également des champs supplémentaires spécifiques aux fournisseurs :
Site web – Le site web du fournisseur.
Currency_Name – pour définir la devise utilisée par le fournisseur.
Et pour les clients :
LabelSet_Description – permet d'attribuer un ensemble d'étiquettes à utiliser avec les produits de ce client.
4. Exemple de jeu de données
Pour cet article, nous allons examiner l’importation d’un fournisseur et d’un client afin de voir comment nos méthodologies d’importation fonctionneront dans la pratique.
5. Méthodologie
5.1. JSON – Importation
Point de terminaison/URI d'importation « Client » –
http://host:port/V5-API/api/integrate/import/client
échantillons:
En utilisant le point de terminaison « Client », nous pouvons structurer un fichier d’importation pour ajouter un fournisseur et un client comme ci-dessous :
Ce fichier JSON d'exemple peut être téléchargé ici.
Une fois que nous avons publié ceci sur le système, nous pouvons voir que le nouveau fournisseur a été ajouté :
Avec le nouveau client :
5.2. CSV – Importer
Pour les importations CSV, nous devons d’abord construire un fichier d’en-tête pour nos importations.
Nom du fichier de définition d'en-tête/colonne : « client.csvh »
Les fichiers d'en-tête complétés doivent être placés dans : « <installdir>\SG Control Center\gateway\import\column_defs »
Nom du fichier CSV à importer : « client-datetime.csv »
Les fichiers CSV à importer doivent être placés dans : « <installdir>\SG Control Center\gateway\import »
échantillons:
En tête de fichier:
Un exemple de fichier d'en-tête est présenté ci-dessous. Comme ci-dessus, nous ajouterons un client et un fournisseur avec les mêmes paramètres :
Pour plus d'informations sur la structure de ces fichiers, veuillez consulter la page d'intégration principale . Vous pouvez télécharger cet exemple de fichier d'en-tête 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. Notez que cette première ligne peut être ignorée par le Centre de contrôle et peut donc être conservée dans le fichier lors de la soumission pour l'importation. Un exemple d'importation basé sur nos exigences ci-dessus ressemblerait à ceci :
Ce fichier d'importation d'exemple peut être téléchargé ici.
Nous pouvons ensuite déposer ce fichier dans notre dossier d'importation tel que défini ci-dessus, et une fois l'importation terminée, nous pouvons voir une fois de plus que notre fournisseur :
Et les clients ont été créés :
