Adresse
Votre guide d'intégration V5 !
Le point de terminaison d'importation « Adresse » peut être utilisé pour ajouter des adresses aux fournisseurs et aux clients, qui peuvent ensuite être utilisées pour frais de livraison et recevoir. Les adresses peuvent également être ajoutées sous la forme «adresses de sites" qui sont utilisés pour Transferts.
Guides d'intégration liés :
Ce guide se concentrera sur la façon d'utiliser ce point de terminaison « Adresse », à la fois via l'importation CSV et en utilisant JSON via l'API V5.
Table des Matières
1. Disposition du centre de contrôle
Pour savoir comment relier le point de terminaison d'adresse à ce que nous voyons dans le centre de contrôle V5, nous examinerons ici la table « Client ». La table « Fournisseur » fonctionnerait exactement de la même manière puisque les fournisseurs et les clients partagent le même point de terminaison « Client ».
2. Liens API
Pour en savoir plus sur les définitions de cette classe de base de données « Adresse », veuillez consulter le lien suivant :
3. Guide du champ d'adresse
3.1. Clés primaires
Pour l'importation via le point de terminaison « Adresse », la clé primaire est :
Nom - Le nom unique de cette adresse
3.2. Champs obligatoires
Autres champs obligatoires pour créer une entrée valide dans V5 :
Type – le type d’adresse, cela doit être 0 pour une utilisation avec les clients et 1 pour une utilisation comme adresse de site pour les transferts (modlink).
Code_client – Si vous ajoutez une adresse client, celle-ci est nécessaire pour établir un lien avec le client/fournisseur.
3.3. Champs supplémentaires
Line1 - La première ligne de l'adresse.
Line2 - La deuxième ligne de l'adresse.
Line3 - La troisième ligne de l'adresse.
Ville – La ville dans laquelle se trouve l’adresse.
État – L’état dans lequel se trouve l’adresse.
Pays – Le pays dans lequel se trouve l’adresse.
Zip – Le code postal de l’adresse.
Contact – Un nom de contact pour l’adresse.
Téléphone – Numéro de téléphone associé à l’adresse.
Email – Adresse e-mail associée à l’adresse.
Les adresses de livraison (si différentes de l'adresse saisie à l'aide des détails ci-dessus) et les contacts/détails de rappel d'urgence peuvent également être ajoutés ici, mais nous utiliserons simplement les points de données ci-dessus dans notre exemple.
4. Exemple de jeu de données
Pour cette partie, nous allons chercher à ajouter une adresse au client indiqué dans le panneau CC ci-dessus. Ce client a été ajouté au système précédemment à l'aide de la commande «Projet' point final.
5. Méthodologie
5.1. JSON – Importation
'Adresse' importer Endpoint/URI –
http://host:port/V5-API/api/integrate/import/address
échantillons:
En utilisant le point de terminaison « Adresse », nous pouvons structurer un fichier d'importation pour les ajouts ci-dessus comme suit :
Cet exemple de fichier JSON peut être téléchargé ici.
Une fois que nous avons posté ceci dans le système, nous pouvons voir que cette adresse a été ajoutée au client « CUS01 » :
5.2. CSV – Importer
Étant donné que les clients/fournisseurs peuvent avoir plusieurs adresses qui leur sont attribuées, ajoutons simplement une autre adresse au client « CUS01 » que nous avons ajouté dans l'exemple JSON ci-dessus.
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 : « adresse.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 : « adresse-dateheure.csv »
Les fichiers CSV à importer doivent être placés dans : " \Centre de contrôle SG\passerelle\importation »
échantillons:
En tête de fichier:
Vous pouvez voir ci-dessous un exemple de fichier d'en-tête. Nous utiliserons les mêmes champs que pour l'importation JSON.
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. 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 :
Cet exemple de fichier d'importation peut être téléchargé ici.
Nous pouvons ensuite déposer ce fichier dans notre dossier d'importation comme défini ci-dessus, et une fois l'importation terminée, nous pouvons voir que cette adresse a été ajoutée pour le même client.
