API Gestion Evénement valoriser Montant

 

Version : 5.0-00

Edition spéciale ES1

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

GestionEvenementvaloriserMontant

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

Que ce soit en commande, en livraison ou en facture, cette API permet d’obtenir le détail de la valorisation de votre événement commercial.

API imbriquées : GestionTiersactualiserEnCours - .

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

RAS.

Paramétrage (PPE)

CTSREP (pour les remises réparties) – ACOMPTTARTTCMTVALIESCACH -

Processus, contrôles et règles de gestion

Etape Description du Processus
 

On retrouve les montants contenus dans la partie gauche de l’écran GCOV_10, ainsi que le détail des taxes et des frais.

Si aucune devise n’est précisée dans le schéma d’entrée, les montants sont retournés exprimés dans la devise de l’événement commercial.

Différents modes de valorisation vous sont proposés.

Type de valorisation :
  • sans rien préciser : valorisation normale.

  • 1 : valorisation sur la base du reste à livrer,

  • 2 : valorisation avec déduction des acomptes .

Si le type de valorisation n'est pas renseigné :

  • Si le type de l’événement à valoriser correspond à un type de référence (typever) = FAC ou AVO, la valorisation est de type 2,
  • Dans les autres cas, le type de valorisation est de type 0.
Type de lecture :
  • sans rien préciser : valorisation complète (en tenant compte de tous les postes),
    • 1 : valorisation en ne tenant compte que des postes ayant une origine,

    • 2 : valorisation avec déduction des acomptes.

Cette méthode met à jour les montants de l’en-tête de l’événement commercial (champs « eve.cumht », « eve.cumttc », « eve.totht » et « eve.totttc ») si le mode « majEvenement » vaut 0.

Cependant, les champs « eve.totht » et « eve.totttc » ne sont pas mis à jour si l’on traite une facture ou un avoir d’achat (code achat/vente = « A », type de référence = « FAC » ou « AVO »), car ces champs sont alors saisis.

Rappel :

eve.cumht = Montant HT (sans les frais divers ni la remise globale).

eve.cumttc = Montant TTC

eve.totht = Montant HT (Frais divers et remise globale inclus)

eve.totttc = eve.cumttc = Montant TTC

Attention, exception sur Factures/Avoirs à l’achat :

eve.totht et eve.totttc sont des zones saisies.

Schéma d’entrée

typeValorisation : type de valorisation.

  • Si rien n’est précisé, valorisation normale,
  • Si « 1 », valorisation sur la base du reste à livrer,
  • Si « 2 », valorisation avec déduction des acomptes.

typeLecture :

  • Si rien n’est précisé, valorisation complète en tenant compte de tous les postes,
  • Si « 1 », valorisation qui ne tient compte que des postes ayant une origine,
  • Si « 2 », valorisation avec déduction des acomptes.

majEvenement :

  • NULL : dans ce cas, on prend le mode majEvenement = 1 si le typeValorisation demandé est égal à “1 " ,

Sinon, on prend le mode majEvenement = 0.

  • 0 : Mise à jour des champs de la table EVE,
  • 1 : Pas de mise à jour de la table EVE.
  • 2 : Mise à jour de l’encours client (grâce à l’API GestionTiersactualiserEnCours) avec la différence entre l’ancien montant TTC de l’évènement (champ « cumttc ») et le nouveau montant TTC. Ce mode complète le mode « 0 » et le mode « 1 », à savoir qu’il recalcule les montants de l’évènement, met à jour la table EVE et l’encours.
Schéma de sortie
  • modval : mode de valorisation (TTC ou HT),
  • montantHt : montant HT, sans les frais et la remise globale,
  • montantAvantRemise : en mode TTC, montant TTC (avant les frais et la remise globale). En mode HT, identique au montant HT,
  • tauxRemise : taux de remise moyen,
  • montantRemise : montant total de la remise globale,
  • montantTaxe : montant total de la taxe parafiscale,
  • baseTaxe : détail de la taxe parafiscale,
  • montantFrais : montant total des frais divers,
  • baseFrais : détail des frais divers,
  • totalHt : montant HT, après frais et remise globale,
  • montantTva : montant total de la TVA,
  • baseTva : détail de la TVA,
  • montantTtc : total TTC,
  • totalTtc : total TTC. A l’Achat, cette information est saisie et peut donc être différente du montant TTC (zone précédente),
  • MontantMaximumAutorise : Indique le montant maximum autorisé pour l’agent courant.