API Gestion Tarifs modifier Tarif

Version ACE : 1.3  

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

GestionTarifsmodifierTarif

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

Cette API permet de mettre à jour une période tarifaire sans colonne (table TSC). Si cette période n’existe pas alors l’API la crée.

API imbriquées : aucune.

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

RAS.

Paramétrage (PPE)

Aucun.

Processus, contrôles et règles de gestion

ETAPE DESCRIPTION DU PROCESSUS
Déclenchement

Conditions de déclenchement de l’API

Les champs suivants doivent être renseignés:

  • code Achat/Vente (achvte),
  • code produit (codpro),
  • code devise (coddev),
  • date de début de période (datdeb),
  • sigle tiers (sigtie) si achvte = « A » ou « G ».
1

Rechercher, dans la table des tarifs sans colonne (TSC) la période tarifaire correspondant aux champs fournis en entrée :

  • codsoc
  • achvte
  • sigtie
  • codpro
  • codreg
  • codetb
  • coddev
  • codbar
  • codvar
  • datdeb
2

Si la période n’a pas été trouvée, alors l’API en crée une dans la table TSC avec les données fournies en entrée.

3

L’API met à jour la période tarifaire :

  • Si « achvte » = ‘A’, ‘V’ ou ‘G’, alors mise à jour du champ « tsc.prxtar » avec le prix passé en entrée.
  • Si « achvte » = ‘R’, alors mise à jour du champ « tsc.prxrev » avec le prix passé en entrée.
  • Si le champ « coduni » est alimenté en entrée (différent de ‘ ‘), alors mise à jour du champ « tsc.coduni ».

    L’unité est soit renseignée en entrée de l’API, soit non transmise. Dans ce dernier cas, l’API conserve l’unité définie pour la période tarifaire. En cas de création d’une période tarifaire, l’API utilise l’unité du catalogue fournisseur à l’achat, à défaut celle du produit (règle de l’objet métier TSC).

  • Si le champ « marge » existe en entrée, alors mise à jour du champ « tsc.marge ». La marge peut être forcée à 0.
  • Si le champ « rglarr » existe en entrée, alors mise à jour du champ « tsc.rglarr ». La règle d’arrondi n’est utilisée que pour un tarif de vente (achvte = ‘V’).
  • Si le champ « datfin » existe en entrée, alors mise à jour du champ « tsc.datfin ».

Erreurs possibles

   

L’API détecte les erreurs bloquantes gérées par l’objet métier TSC.

 

Les contrôles d’existence des codes liés à des relations étrangères sont déjà réalisés par l’objet métier TSC (exemple : contrôle d’existence du produit, de l’unité de mesure, etc.).

Il en est de même pour les contrôles de cohérence (date de fin postérieure ou égale à la date de début, etc...).