Création d’adresse/client

Récupération du client modèle (si nécessaire)

GET /api/v2/OdataTiers(9900+<code_societe>,1,0)?$format=application/json;odata.metadata=none

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=none

Création

POST /api/v2/OdataTiers?validateAddress=true
{
	"CODE_SOCIETE": 1,
	"TY_COMPTE_TIERS" : 1,
	"ParentGN_ADRESSES":{
		"CODE_SOCIETE": 1,
		"FORMAT_ADRESSE":2, //1 = société, 2 = individu
		"TITRE_MONSIEUR": "Société",
		"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"
	}
}
note

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.

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>)
note

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

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,
	"TITRE_MONSIEUR": "Monsieur",
	"VILLE": "Romanel-sur-Lausanne",
}

Les modifications d’adresses ne génèrent pas de nouvelle(s) validation(s)