API Gestion Tarifs rechercher Prix

Version : 5.0-00

Edition spéciale ES1

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

GestionTarifsrechercherPrix

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

OUT

Cette API permet de rechercher le prix de vente ou le prix d'achat selon le code Achat/Vente précisé en entrée. Les prix restitués sont des prix à barème et/ou à colonnes et/ou sans colonnes, en fonction des éléments fournis en entrée.

Le numéro d'événement et le numéro de poste fournis en entrée sont utilisés uniquement pour la recherche du barème par QUI/QUOI.

En ce qui concerne le prix d'achat, le prix retourné par le composant est le prix d'achat chez le fournisseur principal si aucun fournisseur n'a été précisé en entrée.

Dans le cadre des activités d’Import, cette API permet également de restituer le prix de revient d'un produit et le dernier prix de revient définitif.

API imbriquées : aucune.

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

RAS.

Paramétrage (PPE)

BARCAL – TYPMAG – TYPDEP – TYPSOC – CODBAR -

Processus, contrôles et règles de gestion

Etape	Description du Processus
Schéma d’entrée	achvte : code Achat/Vente. Par défaut, celui de la session métier. numeve : numéro d’événement utilisé pour la recherche du barème par QUI/QUOI sur les donnée d’en-tête d’événement. tiers : utilisé lorsqu’on recherche le prix d’achat d’un fournisseur autre que le fournisseur principal. codbar : utilisé lorsqu’on recherche le prix d’un barème précis. coddev : code devise dans laquelle on souhaite exprimer le prix. Par défaut, devise nationale. quantite : information exploitée lorsqu’on a défini des tarifs à colonne. coduni : unité dans laquelle sera exprimé le prix. Par défaut, unité de vente du produit.
Schéma de sortie	prxrev : prix de revient si un prix de revient a été défini pour le produit. prxtar : prix tarif. Prix de Vente ou prix d’Achat suivant le code Achat/Vente. Le prix d’achat est celui du fournisseur principal du produit si aucun fournisseur n’a été précisé. codbar : code barème, si le prix retourné est un barème. unifac : unité de facturation. coduni : unité dans laquelle sont exprimés les prix. Par défaut, unité de vente. coddev : devise nationale par défaut. sigfou : sigle fournisseur pour le tarif d’achat. dprDefinitif : dernier prix de revient définitif.
Cas du prix de cession	Cette API permet également de retrouver le PVG actuel (stocké dans le champ « Prxtar ») lorsque le code achat/vente en entrée a la valeur « G ». Le PVG est un tarif éclaté par entrepôt. Si le sigle entrepôt n’est pas alimenté en entrée, l’API effectue une recherche de l’entrepôt : Recherche de l’entité de connexion Lecture de la fiche dépôt correspondant à l’entité de connexion (le type de tiers correspond à la valeur A1 du paramètre TYPMAG). Si la nature du dépôt trouvé correspond à la valeur de la zone A2 du paramètre TYPMAG, alors il s’agit d’un magasin. L’API utilise alors la fiche stock du produit sur le magasin pour déterminer l’entrepôt approvisionneur Si la nature du dépôt trouvé correspond à la valeur de la zone A1 du paramètre TYPDEP, alors il s’agir d’un entrepôt. Si la fiche dépôt n’a pas été trouvé ou que le dépôt n’est toujours pas alimenté, l’API utilise la fiche Société correspondant à l’entité de connexion (le type de tiers correspond à la valeur A1 du paramètre TYPSOC) et retrouve l’entrepôt principal défini sur la société. Comme le PVG est défini par barème, une recherche du barème défini sur la fiche dépôt de la société de connexion est activée au préalable. Par contre, lorsqu’un code barème est déjà renseigné en entrée de l’API GestionTarifsappelPrix , c’est à partir de ce code barème qu’est effectuée directement cette recherche de tarif. Ce 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).

Cas d’erreur

Cause	Effet
Produit inexistant
Unité inexistante