Création de tiers (avec création d'adresse)
- Michael Jordan
Création d’adresse/tiers
Récupération du client modèle (si nécessaire)
GET /api/v2/OdataTiers(9900+<code_societe>,1,0)?$format=application/json;odata.metadata=noneLe “client modèle” sert de base de création de client lorsque les utilisateurs créé un client dans Oasis.
Ce “client modèle” permet d’avoir des champs déjà prérempli, ce qui facilite la saisie.
Récupération d’une adresse afin de connaitre la structure de l’objet d’adresse (si nécessaire)
GET /api/v2/OdataAdresses?$top=1&$format=application/json;odata.metadata=noneCréation
POST /api/v2/OdataTiers?validateAddress=true{
"CODE_SOCIETE": 1,
"TY_COMPTE_TIERS" : 1, //1 = client, 2 = fournisseur
"ParentGN_ADRESSES":{
"CODE_SOCIETE": 1,
"FORMAT_ADRESSE": 2, //1 = société, 2 = individu
"TITRE_MONSIEUR": "Monsieur",
"RAISON_SOCIALE_NOM": "Silicom",
"BRANCHE_PROFESSION": "Informatique",
"ADRESSE_1": "",
"ADRESSE_2": "",
"RUE_NUMERO": "En Fayard 2",
"CASE_POSTALE": "",
"CODE_POSTAL": "1032",
"VILLE": "Romanel",
"NO_TELEPHONE_1": "058 861 81 81",
"NO_TELEPHONE_2": "",
"ADRESSE_EMAIL": "info@silicomgroup.ch"
}
}Création du client
Avec l’exemple fourni ci-dessus, le client sera créé avec les valeurs du “client modèle”, directement.
Validation d’adresse
Le paramètre “validateAddress” passé à vrai, permet la validation ultérieure de l’adresse par les utilisateurs d’Oasis.
En cas d’utilisation de la méthode de validation, il ne sera pas possible de créer une commande pour le client, tant que son adresse ne sera pas validée.
Les champs “vide” peuvent être omis.
Validation d’adresse
Pour valider les adresses créées avec validation nécessaire, il vous faut vous rendre dans Oasis au menu suivant :
Services → Généralités → Valider adresses
Dans ce programme sont listées toutes les adresses “à valider”. Vous pouvez décider de les valider ou de les supprimer.
Vous disposez d’un bouton “Adresse” afin d’accéder et modifier (si nécessaire) la fiche adresse et d’un bouton “Tiers” afin d’accéder et modifier (si nécessaire) le client lié à cette adresse.
Modification d’une adresse
Récupérer l’adresse d’un tiers
Récupérer le champ “NO_ADRESSE” sur FI_TIERS
Modifier l’adresse
PATCH /api/v2/OdataAdresses(<code_societe>,<no_adresse>)Lors d’un “PATCH”, il n’est pas nécessaire de renvoyer tous les champs.
Vous pouvez ne renvoyez que les champs qui ont effectivement été modifiés, en plus des enregistrements servant de “clé”.
Ici : CODE_SOCIETE, NO_ADRESSE
{
"CODE_SOCIETE": 1,
"NO_ADRESSE": 630,
"FORMAT_ADRESSE": 1,
"TITRE_MONSIEUR": "Monsieur",
"VILLE": "Romanel-sur-Lausanne",
}Les modifications d’adresses ne génèrent pas de nouvelle(s) validation(s)