BUT Cette fonction permet de
-
réaliser des mises à jour de variables standards et spécifiques sur les entités FACE (facture client) et O_ECTRF (facture fournisseur), en ayant initialisé auparavant une ou plusieurs listes standards permettant de décrire les mises à jour souhaitées.
-
mettre à jour les détails de statut Factur-X (table CoStaFacX) reçus des plateformes agréées.
TYPE CARACTERE (rubrique Fonction Gestion pour les requêtes REB, PSD et RCT, libellé : Enreg. Action sur Facture (FACE - ECTRF) et table des statuts Factur-X.
SYNTAXE Variable = MAJ-FACX ( )
PARAMETRES
Aucun.
Le comportement de la fonction dépend de l’initialisation des listes standards suivantes :
-
WfFacxAct : Elle décrit les actions de mise à jour à effectuer sur une facture.
|
Nom |
Type |
Désignation |
Obligatoire (O) |
Commentaire |
|
ActNOr |
Caractère |
Ordre traitement des actions |
O |
Pris en compte |
|
Action |
Caractère |
Action à réaliser (MAJ). |
|
MAJ - mise à jour de l’entité/clé donnée SUP-CDV - purge de la table CoStaFacX de l’entité/clé donnée. Pas de WfFacxVar ou WfCoStaFacX dans ce cas. |
|
ActCle |
Caractère |
Clé de lien avec WfFacxVar |
O |
Elle doit être renseignée dans cette liste, ainsi que dans la liste WfFacxVar ou WfCoStaFacX. Le lien entre les listes ne se fera que par cette clé ! |
|
ActErr |
Caractère |
Libellé d’erreur de l’action |
|
Retourne le libellé si erreur |
|
EntTEn |
Caractère |
Type Entité (FACE, O_ECTRF) |
O |
Doit contenir FACE ou O_ECTRF |
|
EntCl1 |
Caractère |
Clé 1 Entité |
O |
CdeFacRef pour entité FACE
|
|
EntCl2 |
Caractère |
Clé 2 Entité |
|
Non utilisée pour l’instant |
|
EntCl3 |
Caractère |
Clé 3 Entité |
|
Non utilisée pour l’instant |
-
WfFacxVar : Détail des variables à mettre à jour liées à la facture.
|
Nom |
T |
Désignation |
Obligatoire (O) |
Commentaire |
|
ActCle |
Caractère |
Clé de lien avec WfFacxAct |
O |
Elle doit être renseignée dans cette liste, ainsi que dans la liste WfFacxAct. Le lien entre les listes ne se fera que par cette clé ! |
|
EntTVa |
Caractère |
Type de variable (SPE, VFA, STD, VOP) |
|
|
|
EntVar |
Caractère |
Référence de la variable |
O |
Liste des variables autorisées |
|
EntVaC |
Caractère |
Valeur variable caractère |
|
Pris en compte |
|
EntVaN |
Décimal |
Valeur variable numérique |
|
Pris en compte |
|
EntVaL |
Logique |
Valeur variable logique |
|
Pris en compte |
|
EntVaD |
Date |
Valeur variable date |
|
Pris en compte |
DIAPASON traite toutes les actions de la liste WfFacxAct dans l’ordre donné par le champ ActNOr (numéro d’ordre des actions).
Chaque action dispose d’un libellé d'erreur retour : WfFacxAct.ActErr.
L’action est composée d’un élément dans la liste WfFacAct et d’autant d’éléments correspondant aux différentes variable rattachées à une facture, définis dans WfFacxVar (au moins un élément (variable) doit être défini dans WfFacxVar).
MISES A JOUR POSSIBLES dans WfFacXAct
|
Entité |
Type Variable |
Référence Variable |
|---|---|---|
|
FACE |
SPE |
Statut FACTUR-X : CdeFacXSta_IS - Caractère - Paramètre FACX-STA Statut Technique : CdeFacStaTec_IS - Caractère - Paramètre FACX-STATE Date du statut : CdeFacDatMajSta_IS - Date Heure du statut : CdeFacHeuMajSta_IS - Entier ID FACTURX de soumission : CdeFacNumFacX_IS - Caractère Date de soumission PA : CdeFacDatEnvPA_IS - Date Heure de soumission PA : CdeFacHeuEnvPA_IS - Entier Erreur retournée par PA : CdeFacErrStaPa_IS - Caractère Reference PA : CdeFacPARef_IS - Caractère |
|
FACE |
VFA |
Variable typée VFA existante dans DTVaria |
|
O_ECTRF |
STD |
Statut FACTUR-X : ProFaEn.ProFacXSta_IS - Caractère |
|
O_ECTRF |
VOP |
Variable typée VOP existante dans DTVaria |
-
WfCoStaFacX: détails des statuts Factur-X.
Tous les statuts transmis par la PA doivent être enregistrés dans la table standard CoStaFacX. Elle ne peut être alimentée que via la fonction MAJ-FACX et la liste WfCoStaFacX liée à une entête WfFacXAct via le champ ActCle.
|
Nom |
T |
Désignation |
Obligatoire (O) |
Commentaire |
|
ActCle |
Caractère |
Clé de lien avec WfFacxAct |
O |
Elle doit être renseignée dans cette liste, ainsi que dans la liste WfFacxAct. Le lien entre les listes ne se fera que par cette clé ! |
|
CptDatMajSta_IS* |
Date |
Date mise à jour du statut |
O |
|
|
CptHeuMajSta_IS* |
Entier |
Heure de mise à jour du statut |
O |
|
|
CptStaSensCom_IS* |
Caractère |
Sens de communication |
O |
|
|
GenEnrOrdCre_IS* |
Entier |
Ordre de création |
O |
|
|
CptStaFacX_IS |
Caractère |
Statut Factur-X |
|
Statut FACTUR-X : CdeFacXSta_IS - Caractère - Paramètre FACX-STA |
|
CptStaCom_IS |
Caractère |
Commentaire |
|
Commentaire libre |
Si l’enregistrement de CoStaFacX existe déjà avec les champs de l’index primaire unique (* ), alors l’enregistrement sera modifié avec les valeurs du dernier enregistrement de la liste renseigné.
EXEMPLES
L’exemple ci-dessous contient 1 action sur FACE et 1 action sur O_ECTRF avec pour chaque action une mise à jour sur une variable standard :
CREATION Liste WfFacxAct :
PRENDRE WfFacxAct ActCle = CLO."CleLien1"
PRENDRE WfFacxAct EntTEn = CLO."FACE"
PRENDRE WfFacxAct ActCle = CLO."CleLien1"
PRENDRE WfFacxAct Action = CLO."MAJ"
PRENDRE WfFacxAct EntCl1 = CLO."GEN0000040"
FIN_BLOC
CREATION Liste WfFacxVar :
PRENDRE WfFacxVar ActCle = CLO."CleLien1"
PRENDRE WfFacxVar EntTVa = CLO."SPE"
PRENDRE WfFacxVar EntVar = CLO."CdeFacXSta_IS"
PRENDRE WfFacxVar EntVaC = CLO."OK"
FIN_BLOC
CREATION Liste WfFacxAct :
PRENDRE WfFacxAct ActCle = CLO."CleLien2"
PRENDRE WfFacxAct EntTEn = CLO."O_ECTRF"
PRENDRE WfFacxAct ActCle = CLO."CleLien1"
PRENDRE WfFacxAct Action = CLO."MAJ"
PRENDRE WfFacxAct EntCl1 = CLO."F0000194"
FIN_BLOC
CREATION Liste WfFacxVar :
PRENDRE WfFacxVar ActCle = CLO."CleLien2"
PRENDRE WfFacxVar EntTVa = CLO."STD"
PRENDRE WfFacxVar EntVar = CLO."ProFacXSta_IS"
PRENDRE WfFacxVar EntVaC = CLO."OK"
FIN_BLOC
VLO.Retour = MAJ-FACX( )