API Gestion Evénement créer Poste

 

Version : ACE 1.0

Edition spéciale ES1

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

GestionEvenementcreerPoste

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

Cette API permet de créer un poste d’événement.

Dans le cadre des produits à variante, elle permet également de générer les postes des variantes associées au produit de référence.

Dans le cadre des activités d’Import, elle permet aussi de gérer les particularités liées à un ajout de poste dans un acheminement.

API imbriquées : GestionEvenementcreerLigne (API permettant de créer une ligne correspondant au poste) - GestionEvenementrevaloriserEvenement (revalorisation de l’événement) - GestionQueQuerechercherQueQueGestionEvenementgenererPostesVariante -

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

RAS.

Paramétrage (PPE)

DATMARRECORICALFERBLPQUICODBLCMULVARPROREMTYPFOUCTRQTEPROPOSMAJEVPUNISAIGENLOT -

Processus, contrôles et règles de gestion

Etape Description du Processus
  Si des informations sur les zones complémentaires ou les commentaires sont présentes en entrée, un commentaire est créé (enregistrement dans la table EVT).
  Si aucun numéro de poste n’est précisé dans le schéma d’entrée, le dernier numéro est directement calculé.
 

Certaines informations sont alimentées automatiquement par le paramétrage (cible) :

  • le code achat/vente,
  • le type d’événement.
 

Lors de la création d’un poste d’événement, le contrôle suivant est effectué.

Si la zone A1 du paramètre BLPQUI est renseigné alors l’API recherche un éventuel code blocage en fonction d’un couple QUI/QUOI. Elle utilise, pour ce faire, une autre APIGestionQueQuerechercherQueQue qui lui permet d’obtenir le code blocage dans les paramètres de sortie.

S’il n’existe aucun code blocage, l’API passe aux étapes suivantes de création du poste, sinon elle ne crée pas le poste.

  Lors de la création du poste, on vérifie l’existence de l’en-tête précisée :
  • on lance la propagation sur le poste,
  • on vérifie les dates par rapport à la date de mise sur le marché du produit (si le paramètre DATMAR est positionné),
  • on lance la création de ligne (voir API GestionEvenementcreerLigne).
  Une fois le poste, les commentaires et la ligne créés, la revalorisation est lancée (voir API GestionEvenementrevaloriserEvenement).
  Si le paramètre CALFER est positionné, on contrôle les dates de l'en-tête. Si une date correspond à un jour férié, un message en avertit l’utilisateur.
 

L’attribut “mode” qui figure dans les schémas d’entrée et de sortie de cette API ne peut prendre que la valeur « PILOTAGE_QUANTITE ».

Lorsque cet attribut est renseigné (avec la valeur PILOTAGE_QUANTITE), si le poste d’événement est créé avec une quantité inférieure à la quantité minimale du produit, alors la quantité commandée est automatiquement ajustée à la quantité minimale.

Lorsque cet attribut n’est pas renseigné, ACE utilise le fonctionnement par défaut.

Variantes de produit

Si le paramètre MULVAR est positionné et que le produit défini en entrée est un produit de référence alors cette API génère les postes des variantes associées au produit passé en entrée.

L'API effectue en effet les traitements suivants :

  • la quantité du poste d’événement n’est pas alimentée :
    • § l’appel prix n’est pas déclenché,
    • § le poste n’est pas valorisé,
    • § la ligne d’événement créée n’est pas valorisée en quantité.
  • Une fois le poste créé, si la zone N1 du paramètre MULVA1 vaut « 1 », alors les postes des variantes associées sont automatiquement générés. L’API appelle une autre APIGestionEvenementgenererPostesVariante avec les critères suivants du produit de référence :
    • § type Achat/Vente
    • § type d’événement,
    • § numéro d’événement,
    • § numéro de poste d’évenement,
    • § quantite demandée.
Import

Achat de prestations d’Import

En création, si le poste d'événement fait référence à un poste d’origine (si evp.numpoo <> 0) les liens du poste d’origine, saisis par l'utilisateur, sont propagés.

Acheminement

Cette API gère les particularités liées à un ajout de poste dans un acheminement : au moment de la création du poste, le champ "evp.sigtie" est alimenté par le sigle fournisseur saisi par l'utilisateur, ou à défaut, par le sigle fournisseur de l’en-tête d'événement.

Collecte de céréales

Methods :

· Classe GestionEvenementImpl – méthode creerPosteComplement

· Classe GestionEvenementImpl – méthode actualiserPosteCout (JEvpViewRow evpRow)

· Classe GestionEvenementImpl – méthode rechercherTiersFactureCoutCereale (JEvpViewRow evpRow, String destcou)

· Classe GestionEvenementImpl – méthode rechercherCodsocFactureCoutCereale (JEvpViewRow evpRow, String destcou)