API Gestion Tiers créer Tiers

Version : 5.0-00

Edition spéciale ES1

Package : fr.generix.metier.bc4j.tiers.common

GestionTierscreerTiers

Schémas d’entrée et de sortie :

OUT

Cette API permet de créer un tiers, ainsi que son adresse commerciale, ses autres adresses associées à l'adresse commerciale, le contact principal associé à l'adresse commerciale et l’agent utilisateur (code et mot de passe).

API imbriquées : aucune.

Contraintes et limites de fonctionnement (hors périmètre)

RAS.

Paramétrage (PPE)

TIEDEF - CTCEGX – ATTFIS -

Processus, contrôles et règles de gestion

Etape	Description du Processus
	Le tiers est créé en s'appuyant sur les données, indiquées dans l’option A2 du paramètre TIEDEF, d'un tiers existant : le tiers à dupliquer qui est passé dans le flux XML en entrée. Si le tiers à dupliquer n'est pas présent dans le flux XML en entrée, le tiers utilisé sera celui paramétré au niveau du paramètreTIEDEF : A1 = type de Tiers (par défaut, le type de tiers enregistré au niveau de paramétrage de l’événement, écran GPEV_1), M1= Sigle tiers.
	Le code agent présent en entrée ne doit pas déjà être défini dans le système. S’il n'est pas présent en entrée, il est déterminé automatiquement par le système : numérotation automatique si le paramètreCTCEGX est positionné dans le paramétrage de la cible, sinon ce sont les 8 derniers caractères du sigle tiers.
	Gestion des adresses en mode filière : dans ce mode, il y a en plus de tous les éléments déjà cités, création de la filière numéro 1 qui est définie comme étant la filière principale du tiers.
Schéma d’entrée	codsoc : code société. Par défaut, société sur laquelle l’utilisateur est connecté. tiersDupli : tiers par défaut utilisé pour créer le tiers. Si non renseigné, ACE prend le tiers indiqué par le paramètre TIEDEF. typtie : défini par le paramétrage. tiers : informations concernant le tiers à créer. contact : informations concernant le contact à créer. nom : nom et prénom. codeUti : pseudonyme (voir table UT_UTI). Si ce champ n’est pas renseigné et si le paramètre CTCEGXest positionné, le code utilisateur est numéroté automatiquement. Si ce champ n’est pas renseigné et si le paramètre CTCEGX n’est pas positionné, le code utilisateur est égal au 8 derniers caractères du sigle tiers. quesPenseBete : question à poser à l’utilisateur s’il a oublié son mot de passe. repPenseBete : réponse à obtenir de l’utilisateur s’il a oublié son mot de passe. commentaire : commentaires. donneeCompl : données complémentaires. adresse : informations concernant l’adresse du tiers à créer. L’adresse créée sera une adresse de type COM. Les autres adresses (LIV, FAC, PAY, etc.) seront définies en utilisant cette adresse. Si les adresses sont gérées en mode filière, une filière sera créée. centrePos : centre postal.
Schéma de sortie	codeUti : pseudonyme (voir table UT_UTI).

Cas d’erreur

Cause	Effet
Le sigle du tiers existe déjà.
Le code agent existe déjà.
Compteurs de numérotation automatique non définis (voir fonction UCPT): compteur de numérotation des codes agents : CTC, compteur de numérotation automatique des tiers : compteur = Type de tiers.