API Gestion Encours actualiser Encours

 

Version : 5.0-00

Edition spéciale ES1

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

GestionEncoursactualiserEncours

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

Cette API permet de mettre à jour l'encours d'un tiers au travers des événements commerciaux.

Cette méthode permet de mettre à jour les compteurs d’encours financiers d’un compte tiers au travers des opérations définies sur les événements commerciaux. Les opérations sur les événements commerciaux sont paramétrées dans la fonction GENC.

API imbriquées : aucune.

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

  • La hiérarchie financière n’est pas gérée (voir paramètre HIEFIN).
  • Les encours financiers du tiers sont identifiés uniquement pas le code comptable du tiers (zone « cpttie » présente dans l’écran GTIE_1).

Paramétrage (PPE)

DEVNAT -

Processus, contrôles et règles de gestion

Etape Description du Processus
 

Schéma d’entrée

  • codsoc : code société de la session métier par défaut.
  • cpttie : compte tiers concerné par la mise à jour de l’encours.
  • devise : devise dans laquelle s’expriment les montants « cumttc » et « cumttcevo ». Par défaut, il s’agit de la devise nationale (voir paramètre DEVNAT). La parité est celle de la devise « coddev » par rapport à cette devise nationale.
  • montantCourant : montant associé à l’opération courante du paramétrage de la fonction GENC.
  • montantPrecedent : montant associé à l’opération précédente du paramétrage de la fonction GENC.
 

Schéma de sortie

  • signe : signe de l’opération « + » ou « - ».
  • numenc : numéro du compteur d’encours mis à jour.
  • montant : montant à mettre à jour.

Cas d’erreurs

Cause Effet

Cas d’erreurs levant une exception :

  • Erreur lors de la conversion du montant dans la devise de gestion des encours.
  • Erreur lors de la conversion du montant précédent dans la devise de gestion des encours.
  • Paramétrage encours non renseigné pour l’événement courant donné par le triplet achvte/typeve/codeta affecté au schéma d’entrée à défaut de la session métier, et éventuellement l’événement précédent dont les caractéristiques sont données par l’événement courant.
 
Le montant courant ou le montant précédent n’est pas renseigné. L’API ne se déclenche pas.