AFF-ACO : Liste des lignes d'acompte disponible pour une entité donnée
Anciennes versions | Documentation |
|---|---|
04.16.22 | T0-AFF-ACO _ Liste des lignes d'acompte pour un critère donné-270324-163953.pdf |
BUT
Utilisée dans toute requête de type REB et en particulier dans le cadre du calcul de facturation, cette fonction permet de connaître :
Pour une facture, la liste des lignes d’acomptes disponibles pour la facture avec leur montant et taux de TVA
Pour un client, la liste des lignes d'acomptes disponibles pour le client avec leur montant et taux de TVA
Pour une commande, la liste des lignes d'acomptes disponibles rattachées à la commande avec leur montant et taux de TVA
ATTENTION : ne fonctionne qu’avec les acomptes HT (multi-tva)
TYPE
CARACTERE
SYNTAXE
Variable = AFF-ACO(ENTITE=Code entité, CLE1=cle1 entité, CLE2=cle2 entité, CLE3=cle3 entité)
PARAMETRES
Paramètre | E/S | O | Type | Description |
ENTITE | E | O | CARACTERE | Les valeurs possibles sont CLIENT pour un client, FAC pour une facture, CDE pour une commande commerciale. |
CLE1 | E | O | CARACTERE | Doit contenir
Peut être donné par une variable locale, une constante globale, une constante locale ou une variable critère. |
CLE2 | E | O | CARACTERE | Doit contenir la référence du client pour l’entité CLIENT. Non utilisé pour les autres entités. Peut être donné par une variable locale, une constante globale, une constante locale ou une variable critère. |
CLE3 | E | O | CARACTERE | Pas de correspondance pour les entité présentes. Peut être donné par une variable locale, une constante globale, une constante locale ou une variable critère. |
NOTES
Si la fonction s’est bien déroulée, la variable résultat est vide sinon elle contient le libellé de l’erreur détectée.
La fonction renvoie une erreur si :
Les paramètres sont vides
Le numéro de facture est renseigné mais la facture n’existe pas
Le numéro de commande est renseigné mais la commande n’existe pas
Le réseau et la référence du client sont renseignés mais le client n’existe pas
Si la fonction est utilisée dans la requête de calcul de facturation, les factures en cours de génération sont connues par la fonction (WfCDFaEn, WfCDFaLi, WfCDFaDe). On peut alors l’utiliser avec l’entité FAC, pour une facture en cours de génération en indiquant son numéro. Dans ce cas, les lignes des acomptes déjà affectées aux factures en cours de génération ne sont plus considérées comme disponibles et ne sont plus proposées.
La fonction renvoie le résultat dans une liste standard WfFacAco qui contient
CdeFacRef : Non utilisé
CdeFacAco : Numéro d’acompte
CdeNumCom : Numéro de commande rattachée à l’acompte
CdeAcoLig : Ligne d’acompte
CdeTvaRef : Code TVA
CdeTvaPou : Taux de TVA
CdeAcoTTC : Montant d’acompte TTC disponible
CdeAcoHT : Montant d’acompte HT disponible
CdeFacDes : Désignation de l’acompte
AcoVal : Acompte validé ?
CdeAcoTotHT : Montant HT initial de la ligne d’acompte
CdeAcoTotTTC : Montant TTC initial de la ligne d’acompte
La liste standard est vidée lors de chaque appel à la fonction.
EXEMPLES
Dans une requête de type REB, on peut utiliser AFF-ACO de la façon suivante :
VLO.cle1 = SCR.CliResRef
VLO.cle2 = SCR.CliGenRef
VLO.resAffAco= AFF-ACO( ENTITE= CLIENT, CLE1= VLO.cle1 , CLE2= VLO.cle2 , CLE3= VLO.cle1 )
Dans l’exemple ci-dessus, la fonction est paramétrée pour afficher la liste des acomptes disponibles pour un CLIENT, avec comme clé1, son réseau et en clé2 sa référence client.
VLO.cle1 = CLO.factureReference
VLO.resAffAco= AFF-ACO( ENTITE= FAC, CLE1= VLO.cle1 , CLE2= VLO.cle1 , CLE3= VLO.cle1 )
Ici, les paramètres CLE2 et CLE3 sont inutiles.
Enfin, on peut faire de même avec une commande:
VLO.cle1 = CLO.commandeReference
VLO.resAffAco= AFF-ACO( ENTITE= CDE, CLE1= VLO.cle1 , CLE2= VLO.cle1 , CLE3= VLO.cle1 )
Idem que lors de l’utilisation de la fonction en mode “facture”, les paramètres CLE2 et CLE3 sont inutiles.