API Gestion Unités convertir Quantité

Version : 5.0-00

Edition spéciale ES1

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

GestionUnitesconvertirQuantite

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

OUT

Cette API permet de convertir une quantité entre deux unités.

API imbriquées : aucune.

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

RAS.

Paramétrage (PPE)

UNIPRO -

Processus, contrôles et règles de gestion

Etape	Description du Processus
	La conversion de quantité utilise les coefficients définis dans la fonction de gestion des articles (GART) et dans la fonction de gestion des unités (GTUNI).
	Ce composant permet de convertir une quantité exprimée dans une certaine unité dans une autre unité. Il tient compte du paramètre UNIPRO pour effectuer la recherche des différents coefficients de conversion : Si le A1 de UNIPRO est positionné dans la cible, on utilise les coefficients de conversion définis pour le produit s'ils ont été définis, à défaut, on utilise ceux de la table globale (table UNI ). En revanche, si le A1 n'est pas positionné, on n'utilise pas les coefficients définis pour le produit mais toujours ceux de GTUNI . Le A2 et/ou A3 de UNIPRO permettent de signaler dans le flux en sortie qu'un coefficient a été recherché dans la table UNI qui lieu d'être pris parmi l'ensemble des coefficients définis pour le produit. si le coefficient de conversion de l'unité recherchée n'a pas été redéfini pour le produit, ou alors si le produit n'est pas présent dans le flux en sortie, c'est le coefficient de la table globale (table UNI) qui est utilisé. Le flux en sortie signale toutefois l'anomalie. Si l'unité recherchée est bien définie mais avec un coefficient de conversion égal à 0, le coefficient de cette dernière est forcé à 1. L'unité "U" est traitée de façon particulière : Si elle n'est pas définie (ni parmi les coefficients définis pour le produit, ni dans la table globale) le système ne signale pas d'anomalie dans le flux en sortie et utilise un coefficient de conversion à 1. En ce qui concerne l'unité de vente, le coefficient utilisé pour l'unité de vente dépend de la valeur du N1 du paramètre UNIPRO. Si N1 = 1, le système ne recherche pas le coefficient de conversion de l'unité de vente. Il utilise toujours un coefficient de 1 quelle que soit la valeur de ce coefficient défini pour le produit ou dans la table globale. Si N1 <> 1, la recherche du coefficient de conversion de l'unité de vente s'effectue comme pour les autres unités. Le N1 du paramètre UNIPRO permet également d'exploiter la notion de sous unité. Si le coefficient de l'unité recherchée a été défini pour le produit, c'est ce coefficient qui est utilisé, Sinon, on récupère dans la table globale (table UNI) la sous unité associée à l'unité recherchée et on recherche dans les coefficients du produit, le coefficient de conversion de cette sous unité. Le coefficient trouvé pour la sous unité est alors multiplié par le coefficient de la table UNI pour l'unité recherchée. Si la sous unité n'est pas définie pour le produit , on utilise alors le coefficient de conversion trouvé dans la table UNI pour l'unité recherchée.
Schéma d’entrée	produit : code produit pour lequel est effectuée la conversion de quantité. Cette information est exploitée si l’on a défini des coefficients de conversion pour le produit (table PRU). Par défaut, ce sont les coefficients de conversion enregistré par la fonction GTUNI qui sont utilisés. coduniln : unité dans laquelle est exprimé la quantité à convertir. Par défaut, il s’agit de l’unité de vente du produit. qteIn : quantité à convertir. coduniOut : unité dans laquelle il faut convertir la quantité. Par défaut, c’est l’unité de vente du produit.
Schéma de sortie	coduniOut : unité dans laquelle a été convertie la quantité. qteOut : quantité convertie.

Cas d’erreur

Cause	Effet
L'unité d'entrée ou de sortie n'existe pas. Lorsque l'unité d'entrée ou de sortie n'est pas précisée en entrée, le système convertit la quantité dans l'unité de vente du produit pour lequel est demandée la conversion. Dans ce cas, l'absence du code produit dans le flux en entrée provoque une erreur.