API Gestion Déclinaison créer Produit Déclinaison

Version : 5.0-00

Edition spéciale ES1

Package : fr.ACE.metier.bc4j.produit.common

GestionDeclinaisoncreerProduitDeclinaison

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

OUT

Cette API permet de dupliquer le produit de référence et d’affecter au nouveau produit les caractéristiques de déclinaison du produit de référence. Elle peut également être utilisée en mode « modification » afin de mettre à jour les variantes produit pour un produit de référence.

API imbriquées : GestionProduitdupliquerProduit.

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

RAS.

Paramétrage (PPE)

NUMPRO – MULVAR – NUMVAR -

Processus, contrôles et règles de gestion

Etape	Description du Processus
	Si le code société n’est pas renseigné, la valeur prise par défaut est celle de la session métier. Si le code produit n’est pas renseigné, la valeur prise par défaut est la valeur fournie par le paramètre NUMPRO. L’attribut « codunic » met à jour le champ « codunic ». L’attribut « pourcentage » met à jour le champ « repart ». Chaque libellé de valeur de critère de déclinaison est enregistré dans les champs design1 à design9. L’API recherche dans la table PRO s’il existe un enregistrement ayant la même valeur pour le champ « codunic ». S’il en existe un, la déclinaison a déjà été créée. Sinon, création du produit décliné en dupliquant le produit de référence. API GestionProduitdupliquerProduit () avec en entrée : Le code produit du produit de référence. Le code produit du produit décliné (si renseigné)
	Si la déclinaison n’a pas déjà été créée, pour chaque critère de déclinaison, un enregistrement est créé dans la table ZOD. Les 3 premiers caractères de l’attribut code mettent à jour le champ « typzod ». Les 3 derniers caractères de l’attribut code mettent à jour le champ « numzod ». L’attribut valeur met à jour le champ « valzod ». L’attribut codpro met à jour le champ « clezod ». La chaîne de caractères ‘PRO’ met à jour le champ « entzod ». La chaîne de caractères ‘ ‘ met à jour le champ « datzod ».
	Si la déclinaison n’a pas déjà été créée, si le champ N4 du paramètre MULVAR est positionnée à 1 ou 2 et si il n’existe pas déjà, un enregistrement est créé dans la table RCA. La valeur du champ A1 du PPE MULVAR met à jour le champ « typrca ». L’attribut codpro de l’objet « ProduitReference » met à jour le champ « codrca ».
	Si la déclinaison n’a pas déjà été créée et si le champ N4 du paramètre MULVAR est positionnée à 2, un enregistrement est créé dans la tablePRB. L’attribut codpro de l’objet « ProduitDeclinaison » met à jour le champ codpro. L’attribut codpro de l’objet « ProduitReference » met à jour le champ codrca.
	Si le catalogue est renseigné en entrée de l’API, Insertion du produit créé dans le catalogue (CAE) au même niveau que le produit de référence.
	Pour une variante produit, la numérotation suit des règles particulières : · utilisation de l'API GestionProduitdupliquerProduit pour créer une variante produit (champ « suiref » renseigné à « N » en entrée), · si l’une des zones D1, D2 ou D3 du paramètre MULVAR est renseignée, les zones paramétrées de la variante produit sont alimentées avec les valeurs des critères.
	La répartition sur chaque variante produit (champ « pro.repart ») est mise à jour grâce aux champs suivants en entrée : codsoc : code société (facultatif), catalogue (facultatif), produitReference (obligatoire) Codpro ou Gencod ou Reference ou Quantite (obligatoire), produitdeclinaison : produit variante (obligatoire) produitDeclinaison.critereDeclinaison0.code, produitDeclinaison.critereDeclinaison0.valeur, produitDeclinaison.critereDeclinaison1.code, produitDeclinaison.critereDeclinaison1.valeur, produitDeclinaison.critereDeclinaison2.code, produitDeclinaison.critereDeclinaison2.valeur, produitDeclinaison.pourcentage = pourcentage ou ratio de répartition. La valeur « produitDeclinaison.pourcentage » est enregistré dans le champ « repart » du produit variante (table PRO).