API Gestion Tarifs appel Prix

Version : ACE 1.0

Edition spéciale ES1

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

GestionTarifsappelPrix

Pour les flux entre la centrale d’achat et les magasins, les événements sont valorisés au prix de cession. C’est pourquoi cette API permet aussi de déterminer le prix de cession de l’entrepôt expéditeur.

Si la zone A3 du paramètre TARPVG est égale à « G » :

Quand l’appel prix est appelé avec un code Achat/Vente « G », la recherche du tarif utilise le champ "PRO.codtar » ou, à défaut, « PRO.codpro ».

Le code barème passé en entrée de l’API est issu soit du code barème de l’en-tête de l’évènement, soit du code barème du poste de l’évènement ou soit d’une recherche par QUI/QUOI avec un code achat/vente identique à l’évènement courant (ce dernier cas correspond à l’option « N1 = 4 » du paramètre CODBAR).

Si modeCodtar = true et que le produit commercial est différent du produit tarif trouvé, on alimente le paramètre de sortie codtar avec le code du produit tarif trouvé.

Si modeConversionDevnatUV = true, alors on effectue d’abord la conversion dans l’unité de vente puis la conversion dans la devise nationale si nécessaire.

ACE 1.3

Si le champ « modeCodtar » vaut « true », alors l’API ne lance pas l’appel prix si le produit commercial pointe sur un produit tarif pour le type de tarif recherché (achat, vente, cession, revient).

Si le champ « modeConversionDevnatUV » vaut « true », alors, après l’appel prix, l’API convertit le tarif dans l’unité de vente du produit commercial (champ « pro.coduni ») et dans la devise nationale (la devise est définie par le paramètre DEVNAT). Ce mode est surtout utilisé à l’achat.

Si ces deux paramètres ne sont pas présents ou si leur valeur est différente de « true » alors le

fonctionnement de l’API reste inchangé.

Le champ « ModeAppel » permet de trier les conditions tarifaires lors d’un appel-prix, en fonction du paramètre CTSCRE.

En effet, lorsque le paramètre CTSCRE est positionné, l’appel prix ne tient pas compte par défaut des conditions de type Promotion (catégories indiquées par le paramètre). Le champ ModeAppel permet de piloter ce comportement :

• Sans valeur (mode par défaut), les conditions tarifaires de type Promotion ne sont pas prises en compte dans l’appel-prix,
• Le mode « P » (comme Promotion) permet de ne tenir compte que des conditions tarifaires de type Promotion et d’exclure les autres. Ce mode est utile lorsque l’on veut récupérer le pourcentage de remise promotion par exemple,
• Le mode « T » (comme Toutes Cts) permet de tenir compte de toutes les cts. Ce mode est utile si on veut récupérer le prix vendu réel alors que le ppe est positionné sur la cible.

Exemple d’application

Dans la gestion des produits (I_PRO_F), lorsque le paramètre CTSCRE est positionné, il est ainsi possible d’afficher :

• le prix d’achat remisé hors-promotion, via l’invocation de cette API avec le champ « ModeAppel » à blanc,
• le prix d’achat promotion, qui tient compte de toutes les conditions tarifaires (conditions tarifaires classiques + promotion), via l’invocation de cette API avec le champ « ModeAppel » à « T ».