API Gestion Evénement panacher

Version : 5.0-00

Edition spéciale ES1

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

GestionEvenementpanacher

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

OUT

Cette API permet de panacher les conditions tarifaires applicables sur les postes d’un événement commercial. Le moteur de panachage complexe déclenche la mise à jour des conditions tarifaires étendues et des postes d’événement (respectivement tables EVR et EVP).

API imbriquées : GestionEvenementgenererPosteGratuit (génération des postes gratuits en panachage des conditions tarifaires) -

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

RAS.

Paramétrage (PPE)

PANCPX – CTRPLF – GENPGR – FRDCPX – MINCFR – TRPFAC – TRPREE FRDPST -

Processus, contrôles et règles de gestion

Etape	Description du Processus
	Ce service intègre plusieurs modes de traitement de panachage des conditions tarifaires (CTS), ce mode étant renseigné en entrée de l’API. Les différents modes sont : PAN_PANCPX (panachage avec conditions complexes), PAN_GENPGR (génération de postes gratuits), PAN_FRDCPX (génération de frais divers sur l’événement), PAN_TOTAL (panachage total : cumul des 3 modes précédents). Par défaut, c’est le mode PAN_TOTAL qui est actif. Ces différents modes de panachage ont une partie commune de traitement des conditions tarifaires. L’API charge la liste des postes de l’événement. Il est possible de combiner plusieurs modes de traitement en entrée de l’API. Exemple : « PAN_PANCPX/PAN_GENPGR » pour déclencher l’application des remises par panachage avec conditions complexes, ainsi que la génération des postes gratuits. Le caractère de séparation entre ces différents modes n’a pas d’importance.
Panachage des CTS complexes	Il faut positionner et paramétrer le paramètre PANCPX. Si la zone N 1 = 0 ou 2 (paramètre PANCPX), les prix forcés ne sont pas pris en compte dans le cumul des postes. Si la zone N 4=1, on trie la liste des postes d’événement par ordre décroissant du montant tarif du poste. Pour chaque poste, on connaît alors la liste des conditions tarifaires applicables. Contrôle de validité du déclenchement de la CTS : retenue ou non retenue. Si type de valeur de la CTS = « R » : remise en montant à répartir, calcul du montant de remise répartie sur chacun des postes dont la CTS de type « R » a été retenue. Pour chaque poste de panachage dont le prix n’est pas forcé (prxfrc <> « O »), création des conditions tarifaires (table EVR) correspondant aux CTS appliquées sur le poste. Deux modes sont actifs. Si le paramètre N3=1 (paramètre PANCPX), on écrase l’evr existant. Sinon, on récupère et on complète l’evr existant sur le poste. è On vérifie que la CTS est bien retenue. Le Type de CTS (typcot) est équivalent au mode de panachage. On vérifie que la CTS doit être conservée sur les autres postes (cas des CTS « uniques »). Si type de valeur = « R », on convertit la CTS en CTS de type montant =« 2 ». On convertit la CTS dans l’unité de facturation du poste. On trie les CTS en fonction de leur ordre de priorité. On élimine les CTS dont la base est inférieure au prix net. Si type de valeur = « 4 », on sélectionne la CTS la plus avantageuse sur les gratuits. On calcule l’ensemble des remises, ristournes et gratuits à appliquer (suivant leur base) afin d’obtenir le prix vendu du poste et le taux rermise effective appliquée sur ce poste. Si le paramètre CTRPLF est positionné, contrôle par rapport au plafond de remise applicable. Si N1 = 1 ==> contrôle par rapport à un taux maximum autorisé. Exception : les CTS de type « R » (remise répartie) ne sont pas soumises au contrôle sur le plafonnement. Lecture du taux maximum enregistré dans une donnée complémentaire des éléments du catalogue (table CAE ). Le N° de la valzn est stocké dans le paramètre N2 de CTRPLF. Si taux de remise applicable > taux max. On supprime toutes les CTS retenues sur le poste. Lecture de la CTS remise max. dont le N° (numcot) est stocké dans le paramètre N3 de CTRPLF. Recalcule du prix vendu du poste. création de l’enregistrement dans les conditions tarifaires (table EVR ). Mise à jour du poste d’événement (table EVP).
Génération de postes gratuits	Il faut positionner et paramétrer le paramètre GENPGR. L’API déclenche la suppression des postes gratuits déjà générés au niveau de l’événement à traiter. les postes dont le N° est supérieur ou égal au paramètre N1 de GENPGR. Pour chaque poste, on connaît la liste des conditions tarifaires applicables. Contrôle de validité du déclenchement de la CTS ==> retenue ou non retenue. Si le paramètre A2 = « REFVTE » (paramètre GENPGR) : codproGrt de la CTS contient la référence de vente (champ « refext » des éléments de catalogue, table CAE) du produit gratuit. Sinon, codproGrt de la CTS contient le code produit du produit gratuit à générer. Lecture de la fiche article correspondante. Appel de l’API GestionEvenementgenererPosteGratuit.
Génération de frais divers	Il faut positionner et paramétrer le paramètre FRDCPX. Voir documentation de ce paramètre FRDCPX.
Contrôle du minimum franco	Si le paramètre MINCFR est positionné, l’API contrôle le minimum de franco et le minimum de commande par rapport au total TTC (ou HT) de la commande. Si le minimum n’est pas atteint, l’API génère le frais franco et valorise l'événement (pour tenir compte du frais généré).
Calcul des frais de transport	Les calculs des frais de transport réel et à facturer sont déclenchés dans l’API « GestionEvenementpanacher », elle-même appelée par l’API « GestionEvenementrevaloriserEvenement », déclenchée automatiquement lors de la validation des événements commerciaux. 1) Calcul du frais de transport réel Si le paramètre TRPREE est positionné avec N2=0, alors l’API GestionEvenementactualiserFraisTransport est appelée avec le critère « TRPREE ». 2) Calcul du frais de transport à facturer (sans minimum franco) Si le paramètre TRPFAC est positionné avec N2=0 et si le paramètre MINCFR n’est pas positionné, alors l’API GestionEvenementactualiserFraisTransport est appelée avec le critère « TRPFAC ».