| API / API Web | |
|
Version : 5.0-00 Edition spéciale ES2 |
||
|
Package : fr.generix.metier.bc4j.evenement.common GestionEvenementgenererEvenement |
||
| Schémas d’entrée et de sortie : | IN | OUT |
Cette API permet de générer un événement à partir d’un événement origine et selon un mode « Livraison », « Facturation », « Avoir », « Litige » ou « Retour ».
API imbriquées : GestionEvenementrecalculerEcheance – GestionRepartitiondupliquerRepartition -
Contraintes et limites de fonctionnement (hors périmètre)
| RAS. |
Paramétrage (PPE)
| GENBLT (conditionne la génération des postes et lignes du BL) – QTENEG – PAIFRA (multi-échéances) – ATTFIS – ACOMPT – GENBPL – EVRP – FRDPST – GENEVE – |
Processus, contrôles et règles de gestion
| Etape | Description du Processus |
| Modes |
Mode « LIV » : Génération d'un bon de préparation ou de livraison. · L’en-tête et son complément sont dupliqués, · Pour chaque ligne dont la date d’expédition est antérieure ou égale à la date d’expédition de l’en-tête, le poste correspondant, la ligne et les compléments associés sont dupliqués. La quantité commandée devient la différence entre la quantité commandée et la quantité livrée de l’origine. |
|
Mode « FAC » : Génération d'une facture. Ce mode peut être utilisé pour générer :
· des avoirs sur prix à partir d'un événement origine (facture). Pour cela, le paramétrage de l'indicateur Annulation sur la cible doit être égal à "X". L'avoir est généré avec des prix négatifs. Duplication : · L’en-tête et son complément sont dupliqués, · Les postes et leur complément sont dupliqués, · Les lignes et leur complément sont dupliqués, · Les sous postes et leur complément sont dupliqués. La quantité commandée devient la différence entre la quantité commandée et la quantité livrée de l’origine. |
|
|
LIT : Génération d’un litige. Utilisé dans le module Achat (portail I_ACHAT_F). Ce mode est utilisé pour générer un litige à partir des écarts constatés sur l'événement origine. Ces écarts peuvent être constatés sur les quantités ou sur les prix. Les montants des postes peuvent être négatifs. Exemple de génération d'un litige sur une facture : Livraison n° 300015 1 - Produit P1 Qté=100 Prix=20.50€ Montant=2050€ 2 - Produit P2 Qté=200 Prix=12.20€ Montant=2440€ 3 - Produit P3 Qté=100 Prix=24€ Montant= 2400€ Montant total = 6890€ Facture n° 700017 1 - Produit P1 Qté=60 Prix=20.50€ Montant=1230€ 2 - Produit P2 Qté=200 Prix=14.20€ Montant=2840€ 3 - Produit P3 Qté=80 Prix=25€ Montant= 2000€ 4 - Produit P4 Qté=10 Prix=29.90 Montant = 299€ Montant total = 6369€ Litige généré sur la facture n° 700017 1 - Produit P1 Qté=40 Prix=20.50€ Montant=820€ 2 - Produit P2 Qté=200 Prix=-2.00€ Montant=-400€ 3 - Produit P3 Qté=20 Prix=25€ Montant= 500€ --> Prise en compte de l'écart sur la qté du poste n°3 de la facture 4 - Produit P3 Qté=100 Prix=-1€ Montant= -100€ --> Prise en compte de l'écart sur le prix du poste n° 3 de la facture 5 - Produit P4 Qté=-10 Prix=29.90 Montant = -299€ Montant total = 521€ |
|
|
AVO : Génération d’un avoir sans duplication des frais divers. Utilisé dans le module Achat (portail I_ACHAT_F) pour générer des avoirs sur facture origine. Deux modes peuvent être appliqués : AVO_COMPLET et AVO_PARTIEL. |
|
|
AVO_COMPLET : Génération d’un avoir avec duplication des frais divers. L'avoir complet est la génération d'un avoir sur la totalité de la facture. Ce mode prend en compte l'indicateur « Annulation » ("A", "L", "C" ou "X") de la cible pour effectuer soit des avoirs sur quantité (avec éventuellement annulation de la livraison ou la commande) ou des avoirs sur prix. |
|
|
AVO_PARTIEL L'avoir partiel est la génération d'un avoir sur une partie de la facture. Ce mo de s'effectue à partir d'une sélection des produits à positionner sur l'avoir , cette sélection doit être enregistrée dans la table temporaire EVPG suivant les critères :Type de traitement " EVP "/N° événement à traiter/Cible. |
|
|
RET : Génération d’un retour sur facture. Utilisé dans le module SAV (portail I_SAV_F) pour générer des retours sur facture origine. Les quantités du retour sont systématiquement négatives. Deux modes peuvent être appliqués : RET_COMPLET et RET_PARTIEL. |
|
|
RET_PARTIEL Génération d’un retour mais prise en compte ou non de l’existence de l’en-tête, qui permet donc d’ajouter des postes sur un retour existant, sans duplication des frais divers. Le retour partiel est la génération d'un retour sur une partie de la facture. Ce mode s'effectue à partir d'une sélection des produits à retourner, cette sélection doit être enregistrée dans la table temporaireEVPG suivant les critères : Type de traitement " RET "/ N° événement à traiter/Cible. |
|
|
RET_COMPLET Génération d’un retour avec duplication des frais divers. Le retour complet est la génération d'un événement retour sur la totalité de la facture. |
|
| REI : Génération d'une réception import . | |
| FAI : Génération d'une facture import. | |
| Si l'attribut "evenement" vaut "O", on est alors en mode complément de l’événement défini dans le schéma d’entrée. | |
| Acomptes | Les acomptes créés à la commande sont pris en compte lors de la génération des événements de type « Facture » et « Avoir » (voir paramètre ACOMPT). |
| Achat de prestations Import | En création, si l'en-tête de l'événement fait référence à un événement d’origine (si eve.numevo <> 0), les liens de l'événement d’origine saisis par l'utilisateur sont propagés. |
| Achat de marchandises Import |
|
| Flux poussés | Si le paramètre EVRP est positionné et si le poste a une origine (evp.numevo<>0), cette API déclenche une autre API, GestionRepartitiondupliquerRepartition. |
| Propagation des frais divers |
Lors de la génération d’un évènement de type Livraison ou Réception par rapport à une commande, les frais divers sont propagés de la commande vers le BL lors de sa génération (création), et du BL vers la facture lors de sa génération (création). Cette fonctionnalité est pilotée via l’attribut modeGenerationEvenement : si modeGenerationEvenement = LIV, FAC (facture), = AVO_COMPLET (avoir complet), ou = FAI (facture Import). Ce comportement est disponible en mode Client/Serveur grâce au paramètre VALOBL. |
Cas d’erreurs
| Cause | Effet |
|
ERR_CODETA : code état non valide ! ELT_PASTRO : élément non trouvé dans la table @ |
Erreurs bloquantes : l’événement n'est pas généré. |