Notions de champ et commande
Les champs sont des données directement stockées dans une des tables du fichier de données. Elle peuvent avoir un formatage simple prédéfini (par exemple les noms sont en majuscules). Dans les courriers ou les états, un champs est indiqué de la façon suivante : [NomDeLaTable]NomDuChamp.
Les commandes sont des données complexes ou formatées (par exemple le cumul brut des paies d'un contrat ou le numéro de sécurité social d'un salarié formaté avec des espaces).
Certaines commandes s'utilisent sans paramètres (Abattement par exemple), d'autres avec un ou plusieurs paramètres, qui peuvent être obligatoires ou facultatifs.
Les différents paramètres sont séparés par des ponts virgules, leur format est fonction de leur type :
- paramètre de type texte : "paramètre"
- paramètre de type date : !JJ/MM/AA!
- paramètre de type numérique : n
Par exemple : CumulCotisationsCaisse("FNAS";2012;0;!01/07/2012!;!31/08/2012!)
Les commandes sont a priori utilisables dans tous les courriers et état. Lorsqu'une commande ne fonctionne qu'à partir de certaines tables une note le précise (la commande Abattement par exemple, n'est utilisables que dans un courrier ou un état de type Paie).
Liste des commandes sPAIEctacle
Abattement
Retourne le montant théorique de l'abattement forfaitaire pour frais professionnels de la paie, soit [Paie]Brut x TauxAbattement. La commande ne tient donc pas compte de l'éventuel plafonnement de l'abattement.
Commande de type Paie - voir aussi les commandes BrutAbattu, TauxAbattement et ChoixAbattement.
AnalytiquePaieLibelle - AnalytiquePaieTaux
Retourne le libellé ou le taux de l'analytique.
AnalytiquePaieLibelle(n) retourne le libellé du nième analytique de la paie (les différents analytiques étant classés par pourcentage décroissant). AnalytiquePaieLibelle est équivalent à AnalytiquePaieLibelle(1).
Commandes de type Contrat ou Paie - en l'absence d'analytique les commandes ne renvoient rien.
Brut
Retourne le salaire brut de la paie dans un courrier ou état de type Paie.
Retourne le total du montant des rubriques soumises à cotisations dans un courrier ou état de type Contrat.
BrutAbattu
Retourne la base brut abattu plafonné de la paie dans un courrier ou état de type Paie.
Dans un courrier ou état de type Contrat, la commande retourne le montant des rubriques soumises à cotisations sans tenir compte de l'éventuel abattement pour frais professionnels.
Cachets
Cachets retourne le nombre de cachets de la paie ou le nombre de cachets dans les rubriques du contrat.
Cachets(1) retourne le nombre de cachets isolés et Cachets(2) retourne le nombre de cachets groupés.
Commande de type Contrat ou Paie. La commande s'appuie sur la Spécificité Assedic Intermittent des Rubriques de paie utilisées.
CaisseAdresse - CaisseCodePostal - CaisseVille
CaisseAdresse("Nom caisse") retourne l'adresse de la fiche caisse dont le nom est donné en paramètre
CaisseAdresse ("Type retenue") retourne l'adresse de la fiche caisse, associée dans la fiche société, au type retenue donné en paramètre.
CategorieSalariale
Retourne le libellé de Catégorie salariale de la paie, du contrat (ou du dernier contrat dans un courrier ou un état de type salarié).
ChoixAbattement
Retourne le choix du salarié quant à la pratique de l'abattement forfaitaire pour frais professionnels. La valeur retournée est oui, non ou inconnu.
ChoixAbattement est équivalent à ChoixAbattement(dernier exercice du fichier de données).
Commande de type Salarié, Contrat ou Paie.
Civilite
Retourne la civilité du salarié. La valeur retournée est Monsieur, Madame ou Mademoiselle.
Commande de type Salarié, Contrat ou Paie.
CiviliteContact
Retourne la civilité du contact défini dans la fiche Société (quelque soit le paramétrage de l'onglet Emeteur des Préférences). La valeur retournée est Monsieur, Madame ou Mademoiselle.
CongesAcquis - CongsAPrendre - DroitsReposCompensateur - DroitsRTT
Dans un courrier ou un état de type Salarié, CongesAcquis retourne le solde du compteur des congés acquis à la date du jour (les pré-paies et paies postérieures à la date du jour ne sont pas prises en compte).
CongesAcquis(!date!) retourne le solde du compteur de congés acquis à la date donnée en paramètre (les pré-paies ne sont pas prises en compte).
Dans un courrier ou un état de type Paie, CongesAcquis retourne le compteur de congés acquis pour la période de la paie.
ContratBrut
Retourne le total du montant des rubriques soumises à cotisations dans un courrier ou état de type Contrat.
ContratDateFin
Retourne la date de fin du contrat (ou du dernier contrat dans un modèle de type Salarié)
Commande de type Salarié, Contrat ou Paie.
ConventionCollective
Retourne le libellé de la convention collective de la société, du contrat ou de la paie (ou du dernier contrat pour un courrier ou un état de type Salarié).
CoutEmployeur
Retourne l'information définie dans le contrat pour un courrier ou un état de type contrat.
Retourne le Coût employeur calculé dans la paie pour un courrier ou un état de type paie.
CumulBrut - CumulCotisationsEmployeur - CumulCotisationsSalariales - CumulCoutEmployeur - CumulHeures - CumulJours - CumulNetAPayer - CumulNetImposable
CumulBrut retourne le cumul des salaire brut des paies. Les paies prises en compte sont déterminées par 4 paramètres.
CumulBrut( paramètre1 ; paramètre2 ; paramètre3 ; paramètre4 ) :
- paramètre 1
exercice souhaité (exercice en cours par défaut - 0 pour avoir tous les exercices) - paramètre 2
permet de prendre ou non en compte les pré-paies
0 = paies (paramètre par défaut)
1 = paies + pré-paies calculées
2 = pré-paies calculées
3 = pré-paies calculées ou non
4 = paies et pré-paies, calculées ou non - paramètre 3
permet de ne prendre en compte que les paies dont la date de règlement ultérieure ou égale à une date donnée
(depuis les contrats la date par défaut est la plus petite date de règlement des paies, depuis les paies la date par défaut est la date de règlement de la paie) - paramètre 4
permet de ne prendre en compte que les paies dont la date de règlement est antérieure ou égale à une date donnée
(depuis les contrats la date par défaut est la plus grande date de règlement des paies, depuis les paies la date par défaut est la date de règlement de la paie)
Exemple : CumulBrut(2012;0;!01/07/2012!;!31/08/2012!) retourne le cumul brut des paies de juillet et août 2012.
Si on souhaite ne renseigner que le premier paramètre, il n'est pas nécessaire de renseigner les autres. En revanche, si l'on veut faire une recherche sur le quatrième paramètre, la saisie des 3 autres paramètres est impérative.
Une date invalide (ex. : !35/09/12!) sera ignorée pour la recherche (et se retrouvera traitée comme la date !00/00/00!).
CumulCotisationsCaisse - CumulCotisEmplCaisse - CumulCotisSalCaisse
Dans un courrier ou un état de type Contrat ou Paie, CumulCotisationsCaisse("code caisse") retourne le cumul des cotisations du contrat à la caisse dont le code est donnée en paramètre.
Dans un courrier ou un état de type Salarié CumulCotisationsCaisse("code caisse") retourne le cumul pour le salarié, des cotisations à la caisse dont le code est donnée en paramètre.
Il est possible d'ajouter des paramètres à la commande - CumulCotisationsCaisse( paramètre1 ; paramètre2 ; paramètre3 ; paramètre4 ; paramètre 5 ) :
- paramètre 1 (obligatoire)
code caisse - paramètre 1
exercice souhaité (exercice en cours par défaut - 0 pour avoir tous les exercices) - paramètre 2
permet de prendre ou non en compte les pré-paies
0 = paies (paramètre par défaut)
1 = paies + pré-paies calculées
2 = pré-paies calculées
3 = pré-paies calculées ou non
4 = paies et pré-paies, calculées ou non - paramètre 3
permet de ne prendre en compte que les paies dont la date de règlement ultérieure ou égale à une date donnée - paramètre 4
permet de ne prendre en compte que les paies dont la date de règlement est antérieure ou égale à une date donnée
Exemple : CumulCotisationsCaisse("FNAS";2012;0;!01/07/2012!;!31/08/2012!) retourne le cumul des cotisations à la caisse dont le code est FNAS, pour les paies de juillet et août 2012.
Seul le premier paramètre est obligatoire. En revanche, si l'on veut faire une recherche sur le quatrième paramètre, la saisie des 3 premiers paramètres est impérative.
Une date invalide (ex. : !35/09/12!) sera ignorée pour la recherche (et se retrouvera traitée comme la date !00/00/00!).
CumulEpargneRetraite - CumulHSExoHeures - CumulHSExoMontant - CumulRetenueSource
Fonctionnement identique à la commande CumulBrut. C'est la spécificité DSN des Rubriques de paie (et des Retenues pour la Retenue à la source) qui est utilisée pour isoler les montants correspondants.
CumulSalaireNet
Fonctionnement identique à la commande CumulBrut. Retourne le « Net payé » des paies, diminué du montant des rubriques cochées « Avance ou acompte » sur l’onglet Particularités.
La commande CumulSalaireNet(1) renvoie elle le montant brut des paies, diminué du total des retenues salariales.
DateDebutMois(!date!) - DateFinMois(!date!)
Retourne la date de début ou de fin de mois, de la date donnée en paramètre.
Dans un modèle de type paie DateDebutMois est équivalent à DateDebutMois([Paie]DateFin).
DateDuJour
Retourne la date du jour (telle que définie dans l'horloge système de l'ordinateur).
DatesTravaillees
Retourne les dates travaillées (prend en compte les pré-paies).
Commande de type Contrat ou Paie.
DonneePerso("nom du champ personnalisable")
Retourne la ou les valeurs du champ personnalisable donné en paramètre.
Commande de type Salarié (champs personnalisables de type Salariés et Sociétés) Contrat (champs personnalisables de tout type) ou Paie (champs personnalisables de tout type).
DureeDuTravail
Retourne la durée du travail telle que définie sur l'onglet Chiffres Clés de la fiche Société.
Il est possible d'ajouter des paramètres à la commande - DureeDuTravail( paramètre1 ; paramètre2 ) :
- paramètre 1 : date (date du jour par défaut)
- paramètre 2 : 1 = hebdomadaire; 2 = mensuelle; 3 = annuelle; 4 = trimestrielle (hebdomadaire par défaut)
Exemple : la commande DureeDuTravail([Contrat]DateDebut;2) retourne la durée mensuelle de travail de l'entreprise à la date de début de contrat.
EmetteurContactCourriel - EmetteurContactNom - EmetteurContactTelephone
Retourne la valeur définie en Fichier > Préférences. Si l'Emetteur est la "Société courante", les informations peuvent être modifiées dans la fiche Société. Si l'Emetteur est un "Tiers déclarant", les informations peuvent être modifiées directement dans les Préférences.
FiscalementEtranger
Retourne Vrai ou Faux.
Valeur de la fiche Salarié pour un courrier ou un état de type Salarié ou Contrat, valeur de la fiche Paie pour un courrier ou un état de type Paie.
Heures - Jours
Retourne le nombre d'heures ou de jours, de la paie ou des rubriques du contrat.
ImputationAnalytique
ImputationAnalytique retourne la liste des analytiques du contrat ou de la paie.
LabelPrestataire - LicenceSpectacle
Retourne l'information définie sur l'onglet Divers de la fiche Société.
LibelleCaisse
LibelleCaisse("Type retenue") retourne le nom de la fiche caisse, associée dans la fiche société, au type retenue donné en paramètre.
ModeReglement
Retourne le mode de règlement précisé dans la fiche salarié ou dans la fiche paie.
Commande de type Salarié ou Paie.
Mutuelle
Retourne la catégorie mutuelle de la fiche Contrat ou de la fiche Paie (ou du dernier contrat pour un courrier ou un état de type Salarié).
NetAPayer
Retourne le Net à payer calculé dans la paie pour un courrier ou un état de type paie
NetAvantPAS
Retourne l'information définie dans le contrat pour un courrier ou un état de type contrat
Retourne le Net avant PAS calculé dans la paie pour un courrier ou un état de type paie
Commande de type Contrat ou Paie.
NetImposable
Retourne le net imposable de la paie.
Commande de type paie. Voir aussi la commande CumulNetImposable.
NIR
Retourne le n° de sécurité sociale du salarié formaté (X XX XX XX XXX XXX XX).
Commande de type Salarié, Contrat ou Paie.
NumeroAffiliation
NumeroAffiliation("Type retenue") retourne le numéro d'affiliation à la caisse, associée dans la fiche société, au type retenue donné en paramètre.
NumeroObjet
NumeroObjet(n) retourne le numéro d'objet du contrat (ou du dernier contrat pour un courrier ou un état de type Salarié).
Le paramètre n peut prendre les valeur suivante :
0 = numéro d'objet (critère par défaut) ; 1 = critère 1 ; 2 = critère 2 ; 3 = date ; 4 = code numéro d'objet
NumeroPaie
Retourne le numéro de la Paie. Commande de type Paie.
PaysNaissance - PaysNationalite - PaysResidence
Retourne le pays de naissance, de nationalité ou de résidence du salarié. Commande de type Salarié, Contrat ou Paie.
Plus65ans - Retraite
Retourne Vrai ou Faux. Valeur de la fiche Salarié pour un courrier ou un état de type Salarié ou Contrat, valeur de la fiche Paie pour un courrier ou un état de type Paie.
Profession
Retourne la profession du contrat ou de la paie (ou du dernier contrat pour un courrier ou un état de type Salarié).
RetenuePaieBase - RetenuePaiePP - RetenuePaiePS
RetenuePaieBase("nom de la retenue") retourne la base de la retenue dont le nom est donné en paramètre. Les commande Retenues PaiePP et Retenues PaiePP retournent elles respectivement la part patronale ou la part salariale de la retenue citée en argument.
Commandes de type Paie.
Si plusieurs retenues portent le même nom dans le fichier de données, ces commandes ne fonctionneront pas.
RubriquePaieAnalytique
Dans la cas d'une répartition analytique par rubriques de paie, RubriquePaieAnalytique("code rubrique") retourne le libellé de l'analytique affecté à la rubrique de paie dont le code est donné en paramètre, RubriquePaieAnalytique("ligne n") retourne le libellé de l'analytique affecté à la rubrique de paie en nième ligne.
Commande de type Contrat ou Paie.
RubriquePaieBase - RubriquePaieLibelle - RubriquePaieMontant - RubriquePaieQuantite
RubriquePaieBase("code rubrique") retourne la base de la rubrique de paie dont le code est donné en paramètre.
RubriquePaieBase(n) retournela base de la rubrique en nième ligne.
Dans un modèle ou un état de type contrat, en passant 1 en second paramètre, la commande renvoie la moyenne des bases des paies du contrat.
Un troisième paramètre permet de préciser l'exercice (par défaut celui en cours - la valeur 0 renvoie tous les exercices).
On pourra par exemple utiliser la commande RubriquePaieBase("M35";1;0) pour avoir la moyenne de la rémunération mensuelle sur un contrat.
Commande de type Contrat ou Paie.
SalaireNet
Retourne le "Net payé" de la paie, diminué du montant des rubriques cochées "Avance ou acompte" sur l'onglet Particularités.
La commande SalaireNet(1) renvoie elle le montant brut de la paie, diminué du total des retenues salariales.
Commande de type paie. Voir aussi la commande CumulNet pour avoir le net à payer de la paie.
SiSinonNumerique
Teste une condition et renvoie une valeur de type numérique ou date si la condition est respectée, une autre valeur de type numérique ou date sinon.
Par exemple :
- SiSinonNumerique ([Paies]Brut>3031;3031;[Paies]Brut) retourne 3031 si le salaire brut est supérieur à 3031, le salaire brut sinon
- SiSinonNumerique ([Paies]Date début>!01/01/12!;[Paies]Brut) retourne le salaire brut si la date de début est en postérieure au 01/01/12, 0 sinon
SiSinonTexte
Teste une condition et renvoie une valeur de type texte si la condition est respectée, une autre valeur de type texte sinon.
Par exemple :
- SiSinonTexte (Civilite="Monsieur";"Cher";"Chère") retourne "Cher" si le salarié est un homme, "Chère" dans les autres cas.
- SiSinonTexte (Mutuelle#"";"Mutuelle choisie : "+Mutuelle;"Aucune mutuelle") retourne "Mutuelle choisie : " suivie du nom de la mutuelle si la catégorie mutuelle est non vide, "Aucune mutuelle" sinon.
SituationFamiliale
Retourne la situation familiale du salarié. La valeur retournée est Célibataire, Marié(e), Divorcé(e), Veuf(ve) ou Vivant maritalement. Commande de type Salarié, Contrat ou Paie.
SocieteAdresse - SocieteCodeAPE - SocieteCodePostal - SocieteComplementAdresse - SocieteSiret - SocieteTelecopie - SocieteTelephone - SocieteVille
SocieteAdresse(n) retourne l'adresse de la société (1ère ligne de la zone Adresse de la fiche Société).
Le paramètre n peut prendre les valeur suivante :
0 = établissement (critère par défaut) ; 1 = siège social ; 2 = correspondance
SocieteCompteBanque / SocieteCompteBanque(n)
Retourne les coordonnées bancaires de la Société.
Le paramètre n peut prendre les valeur suivante :
0 = IBAN formaté (critère par défaut) ; 1 = BIC
SommeEnLettres (valeur numérique)
Retourne une valeur numérique convertit en toutes lettres suivi de " Euros".
Pour retourner une valeur en francs, il convient de passer "F" en deuxième paramètre : SommeEnLettres([PAIES]Net;"F").
TA - TB - TC
Retourne la base tranche A, B ou C de la paie. Commande de type Paie.
TauxAbattement
TauxAbattement(Paramètre 1;Paramètre 2) retourne le taux d'abattement pour frais professionnels de la paie, du contrat ou celui applicable à la profession. Dans un courrier ou un état de type Salarié c'est le taux d'abattement du dernier contrat qui est retourné. Commande de type Salarié, Contrat ou Paie.
- Paramètre 1
- 0 pour donnée du contrat (par défaut)
- 1 pour données de la profession
Le taux contrat dépend du choix société et du choix salarié, le taux profession est "théorique".
- Paramètre 2
Paramètre de type date. Si le paramètre n'est pas renseigné, on prendra la date de fin de contrat par défaut si elle existe, la date de début du plus grand exercice du fichier de données sinon.
Exemples :
- TauxAbattement = TauxAbattement(0) = Taux d'abattement appliqué à une paie ou à un contrat.
- TauxAbattement(1) = TauxAbattement(1;!01/01/2024!) = Taux d'abattement applicable pour la profession en 2024 (quelque soit le choix du salarié).
TauxAnalytique
TauxAnalytique ("LibelléAnalytique") retourne le taux de l'analytique donné en paramètre. La valeur retournée est comprise entre 0 et 1.
Si l'analytique analysé n'est pas affecté à la paie ou au contrat, la commande renvoie 0.
Commande de type Contrat ou Paie.
Telephone
Retourne la valeur du champ Téléphone de la fiche Salarié. Commande de type Salarié, Contrat ou Paie.
TitreSejour
TitreSejour ou TitreSejour(0) tenvoient le n° du titre de la fiche Salarié.
TitreSejour(1) renvoie sa date d'expiration.
Commande de type Salarié, Contrat ou Paie.
TypeContrat
Retourne le type contrat de la paie ou du contrat. Les valeurs possibles sont Permanent CDI, Permanent CDD, ou Intermittent.
Pour un CDD transformé en CDI, la valeur retournée est Permanent CDI.