API Gestion Evenement actualiser Encours

Version : 5.0-00

Edition spéciale ES1

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

GestionEvenementactualiserEncours

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

OUT

Cette API permet de mettre à jour les encours financiers d'un tiers à partir d'un événement commercial. Les opérations de mise à jour des encours sont définies dans la gestion des encours (fonction GENC).

API imbriquées : aucune.

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

RAS.

Paramétrage (PPE)

HIERAR -

Processus, contrôles et règles de gestion

Etape

Description du Processus

L’API applique les règles de gestion suivantes :

pour activer l’API, il faut impérativement que l’indicateur « Mise à jour encours » soit positionné à « O » (paramétrage de l’événement, ecran GPEV_1 ) ainsi que le paramètre HIERAR .A3= « O » dans le configurateur fonctionnel (fonction GPEV ).
le type de référence de l’événement doit être renseigné (voir fonction GTTEV ). L’API de mise à jour de l’encours interprète les valeurs ‘CDE’, ‘FAC’, ‘AVO’ (respectivement Commande, Facture et Avoir).
les encours sont mis à jour à chaque étape de validation d’événement.
pour le solde et l’invalidation d’événement, si aucun état d’événement (champ « codeta ») n’est précisé dans le schéma d’entrée, on prend par défaut l’état validé défini dans le configurateur fonctionnel (écran GPEV_1 ).

Schéma d’entrée

codsoc : par défaut, code société de la session métier.

evenement : par défaut, type Achat/Vente et type événement de la session métier.

codeta : état d’arrivée de l’événement. Par défaut, état validé de la session métier. Attention, pour le solde et l’invalidation d’événement, il faut préciser l’état de départ.

action : opération impactant l’événement commercial (par défaut, « C » pour Création). Les valeurs possibles sont :

C : Création,
V : Validation,
D : suppression (= « Delete »),
I : Invalidation,
S : Solde.

Cas d’erreurs

Cause

Effet

· l’événement n’existe pas,

· l’action n’est pas référencée,

· le type de référence de l’événement n’est pas renseigné dans la fonction GTTEV ,

· l’opération courante de mise à jour de l’encours n’existe pas dans la fonction GENC ,

· l’opération précédente de mise à jour de l’encours n’existe pas dans la fonction GENC ,

· le tiers n’existe pas.

L’API ne se déclenche pas.