API Gestion Evénement rechercher Frais Transport

Version : ACE 1.1

Edition spéciale ES0

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

GestionEvenementrechercherFraisTransport

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

OUT

Cette API permet de rechercher le coût du frais de transport associé à un événement commercial pour tous les tarifs transporteurs possibles. Elle accepte en entrée les éléments permettant d’identifier l’événement à considérer, le paramètre à tester (TRPFAC ou TRPREE), et un pourcentage de variation, optionnel, qui permet de simuler une variation du tarif transporteur.

En sortie, elle fournit un ensemble de lignes de tarifs représentant chacune des coûts de transport calculés en fonction de tous les tarifs de transport applicables.

L’algorithme général de cette API est le suivant :

§ Collecte des informations permettant de rechercher le ou les tarifs transports applicables, à partir des données de l’événement à traiter et du paramètre fourni en entrée.
§ Déclenchement de l’API GestionTransportrechercherTarifsApplicables qui permet de rechercher tous les tarifs transports applicables en fonction des données précédemment collectées.

Pour en savoir plus sur le calcul du coût de transport, consultez la documentation « Les coûts de transport ».

API imbriquées : GestionTransportrechercherTarifsApplicables - GestionEvenementValoriserMontant – GestionEvenementValoriserColisage - GestionTransportCalculerCoutTransport -

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

Les « frais d’exclusion » ne sont pas gérés par cette API, mais par l’API qui permet de créer le frais de transport sur l’événement commercial. Les frais d’exclusion permettent de ne pas générer le frais de transport si un frais spécifique existe déjà sur l’événement. En effet, il peut être parfois nécessaire de rechercher le meilleur transporteur afin de mettre à jour le sigle transporteur de l’événement, sans pour cela générer de frais de transport.

Paramétrage (PPE)

TRPFAC – TRPREE -

Processus, contrôles et règles de gestion

Etape	Description du Processus
1	Lecture du paramétrage et test sur le code Achat/Vente de l’événement : · Si le code achat/vente de l’événement est différent de ‘V’, aucun frais de transport n’est calculé. · Utilisation du paramétrage : TRPFAC ou TRPREE . · Si le paramètre correspondant n’est pas positionné ou s’il est désactivé, aucun frais de transport n’est calculé.
2	Collecte des informations permettant de rechercher les tarifs transport applicables. Les informations collectées sont ensuite exploitées par l’API GestionTransportRechercherTarifsApplicables. L’API GestionEvenementValoriserMontant fournit le montant HT de l’événement. L’API GestionEvenementValoriserColisage fournit le poids, le volume et le nombre de palettes de l’événement. Date du transport alimentée par : la date de livraison de l’événement, ou la date d’expédition de l’événement, ou la date de l’événement, ou la date du jour. Site de départ : voir fonctionnement des paramètres TRPFAC et TRPREE. Transporteur, Régime de transport et Type de véhicule : voir fonctionnement des paramètres TRPFAC et TRPREE. Adresse d’arrivée : adresse de livraison de l’événement.
3	Appel de l’API GestionTransportRechercherTarifsApplicables.
Entrée	Le champ « codsoc » est optionnel. S’il n’est pas renseigné, il est récupéré de la session métier. Le numéro d’événement est obligatoire. Le champ « mode » est obligatoire. Il contient en effet le code du paramètre à tester pour rechercher le frais de transport (TRPFAC ou TRPREE). Le pourcentage de variation à appliquer aux tarifs transporteurs est optionnel. Cette fonctionnalité est utilisée pour simuler des variations de tarifs.
Sortie	Le schéma de sortie de l’API est quasiment le même schéma de sortie de l’API GestionTransportCalculerCoutTransport. Il comporte en plus l’élément « evenement » et peut contenir plusieurs lignes, en fonction du nombre de tarifs répondant aux critères de recherche.