API Gestion Evénement valoriser Colisage

Version : 5.0-00

Edition spéciale ES1

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

GestionEvenementvaloriserColisage

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

OUT

Cette API permet de valoriser le colisage d’un évènement ou d’un poste d’évènement. Plusieurs fonctionnalités sont offertes :

obtenir le poids et le volume total d’un événement commercial,
valoriser un poste d'événement en fonction du poids et du volume (voir documentation de référence I_AICOL_F),
piloter le mode de valorisage :
- à colisage théorique (mode actuel),
- à colisage réel (tient compte des données forcés par l'utilisateur),
- à colisage du reste à livrer (avec filtre possible sur la date de livraison).

API imbriquées : aucune.

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

RAS.

Paramétrage (PPE)

Processus, contrôles et règles de gestion

Etape	Description du Processus
	Les poids et le volume de l’événement commercial sont obtenus en cumulant respectivement les poids et le volume des postes de l’événement (). Les poids et volume des postes sont calculés en tenant compte des données de colisage de la fiche produit (). Le nombre de colis est obtenu en cumulant le nombre de colis de chaque poste. (*) : Les cumuls sont fournis avec une précision de 3 décimales.
Entrée	Quantité à valoriser (champ “Qtecde”). Ce paramètre n'est exploité que lorsque le paramètre d'entrée « numpos » est renseigné. Il permet de valoriser une autre quantité que celle du poste. Exemple d'utilisation : Au niveau du colisage, pour valoriser en poids et volume, la quantité colisée du produit.
	Numéro du poste (champ « numpos ») Si le numéro de poste est renseigné, on effectue alors la valorisation du colisage uniquement pour ce poste
	Mode de calcul (champ « modeCalcul ») Lorsque ce paramètre n'est pas renseigné ou est égal à « 0 », l’API utilise par défaut le mode de calcul « 1 ». 1 : Poids et volume théorique (mode par défaut) Dans ce mode, l’API calcule les poids et volume à partir des données de colisage du produit. 2 : Poids et volume réel Dans ce mode, en plus du poids et volume théorique, l’API utilise les poids et volume réel de l'événement. Il s'agit des poids et volume éventuellement forcés par l'utilisateur sinon des poids et volume calculés à partir des poids et volume de tous les postes de l'acheminement. Dans ce mode, les champs d'entrée numpos et datliv ne sont pas exploités. 3 : Poids et volume du reste à livrer Dans ce mode, l’API utilise les poids et volume du reste à livrer de l'événement ou d’un poste. Pour chaque poste d'événement, le reste à livrer correspond à la somme de (evl.qtecde - evl.qteliv) de l'ensemble des lignes attachées à ce poste. Dans ce mode, le champ de sortie « nbcol » n'est pas valorisé.
	Date de livraison (champ « datliv ») Cette information n'est exploitée que lorsque le modeCalcul vaut 1 ou 3. Elle permet de valoriser les données de colisage ne concernant que les lignes d'événement dont la date de livraison (evl.datliv) est égale à la « datliv » fournie en entrée.
Sortie	Attributs du colisage (champ “colisageReel”) Caractéristiques du colisage : à poids brut (champ “poidsBrut”), à poids net (champ “poidsNet”), à volume (champ “volume”), à nombre de colis (champ “nbcol”). Ces champs sont renseignés uniquement lorsque modeCalcul = 2.