🔢 Calculs et formules
Cette page documente toutes les formules de calcul utilisées par téo. Utile pour comprendre d'où viennent les chiffres et vérifier leur cohérence.
Cliquez sur un titre pour copier le lien direct vers la formule. Pratique pour partager avec un collègue !
Durées
Durée d'une séance
durée = heure_fin - heure_début
Exemple : Séance de 14h00 à 16h30 → 2h30
Durée réelle vs prévisionnelle
| Type | Description |
|---|---|
| Durée prévisionnelle | Durée initialement prévue |
| Durée réelle | Durée effectivement réalisée |
Si durée_réelle renseignée → utilise durée_réelle
Sinon → utilise durée_prévisionnelle
Durée bénéficiaire (collectifs)
Pour les séances collectives, le temps passé par le bénéficiaire peut différer :
Si durée_benef renseignée → utilise durée_benef
Sinon → utilise durée_séance
Total heures dossier
total = Σ(durée des séances validées et facturables)
Conditions pour être comptée :
- Séance validée (état = VA)
- Action marquée comme facturable
- Non exclue de l'échéancier
Total heures groupe
total = Σ(durée de toutes les séances du groupe)
Taux d'assiduité
assiduité = (heures_réalisées / heures_prévues) × 100
Exemple :
- Prévu : 24 heures
- Réalisé : 20 heures
- Assiduité : 83,3%
Utilisé pour :
- Échéances conditionnées à l'assiduité
- Indicateurs de pilotage
- BPF (Bilan Pédagogique et Financier)
Heures facturables
Selon le type d'heures configuré dans la tarification :
| Type | Code | Séances comptées |
|---|---|---|
| Heures conseiller | CONS | action.cons = 1 |
| Heures bénéficiaire | BENEF | action.benef = 1 |
| Heures face-à-face | FF | action.cons = 1 ET action.benef = 1 |
| Toutes heures | TOUT | Toutes les séances facturables |
Conditions pour être comptée :
- Séance validée (état = VA) ou prévisionnelle si calcul prévisionnel
- Action marquée comme facturable
- Non exclue de l'échéancier
Montants de facturation
Forfait
montant = forfait_tarification
Montant fixe défini dans la tarification, indépendant des heures.
À l'heure
montant = nombre_heures × tarif_horaire
Exemple : 20 heures × 50 €/h = 1 000 €
Par action
montant = nombre_actions × tarif_unitaire
Compte le nombre d'actions du déroulé réalisées.
Par financeur
montant = Σ(forfaits des financeurs du dossier)
Prorata
montant = montant_base × (heures_réalisées / heures_prévues)
Délais contractuels
Séance hors délai minimum
hors_délai_min = date_séance < (date_début_dossier + délai_min)
→ Séance trop tôt après le début du dossier.
Séance hors délai maximum
hors_délai_max = date_séance > (date_début_dossier + délai_max)
→ Séance trop tard après le début du dossier.
Dossier hors commande
hors_commande = date_séance > date_fin_bon_commande
→ Séance après la date de fin du bon de commande.
Places disponibles (collectifs)
places_disponibles = places_max - places_occupées
Exemple :
- Capacité : 12 places
- Inscrits : 8
- Disponibles : 4 places
TVA
Montant TVA
montant_TVA = montant_HT × (taux_TVA / 100)
Exemple : 1 000 € HT × 20% = 200 € de TVA
Montant TTC
montant_TTC = montant_HT + montant_TVA
Montant HT depuis TTC
montant_HT = montant_TTC / (1 + taux_TVA / 100)
Exemple : 1 200 € TTC / 1,20 = 1 000 € HT
Répartition multi-financeurs
Quand plusieurs financeurs se partagent le paiement :
montant_payeur = montant_total × (pourcentage_payeur / 100)
Exemple :
- Total : 2 000 €
- Financeur A : 60% → 1 200 €
- Financeur B : 40% → 800 €
Prorata (abandon)
En cas d'abandon ou sortie anticipée :
montant_prorata = (jours_réalisés × tarif_base) / jours_prévus
| Variable | Description |
|---|---|
| jours_prévus | Durée prestation ou date_fin_cde - date_début_cde |
| jours_réalisés | date_fin_réelle - date_début |
Si la tarification définit une "valeur 1 jour", c'est ce montant fixe qui est utilisé pour un seul jour de présence.
Solde client
solde = Σ(factures_TTC) - Σ(avoirs_TTC) - Σ(règlements)
| Résultat | Signification |
|---|---|
| Solde positif | Client doit de l'argent |
| Solde négatif | Trop-perçu (à rembourser ou reporter) |
| Solde = 0 | Compte équilibré |
Facture soldée
Une facture est considérée comme soldée si :
| Condition | Description |
|---|---|
| Règlement complet | Total règlements lettrés = Total TTC facture |
| Soldée manuellement | Flag "soldée" activé (ex: abandon de créance) |
Jours ouvrés
date_fin = date_début + N jours ouvrés
Jours exclus :
- Samedis
- Dimanches
- Jours fériés (selon calendrier configuré)
Utilisé pour :
- Calcul des échéances
- Délais contractuels
- Dates prévisionnelles
Numérotation des factures
numéro = préfixe + séquence + suffixe
| Élément | Exemple |
|---|---|
| Préfixe | FA |
| Séquence | 000123 (auto-incrémenté) |
| Suffixe | -2024 (exercice) |
| Résultat | FA000123-2024 |
Configuration : Admin > Paramètres > Comptabilité
Dossier incomplet
Un dossier est incomplet si au moins un champ obligatoire est vide.
| Source | Champs vérifiés |
|---|---|
| Fiche personne | Nom, prénom, email, mobile... (selon config) |
| Dossier | Dates, prescripteur, tarification... |
| Prestation | Champs définis dans Admin > Prestations > Données obligatoires |
Questions fréquentes
Pourquoi mon total d'heures ne correspond pas ?
Vérifiez :
- Les séances sont-elles validées (état VA) ?
- Les actions sont-elles marquées facturables ?
- Des séances sont-elles exclues de l'échéancier ?
Le calcul de TVA semble faux ?
Vérifiez le taux de TVA appliqué. Certaines prestations peuvent être exonérées ou avoir un taux réduit.
L'assiduité est à 0% alors qu'il y a des séances ?
Les séances doivent être validées pour compter dans l'assiduité. Les séances prévisionnelles ne sont pas comptées.
Comment est calculé le prorata pour un abandon ?
Le prorata dépend de la configuration de la tarification. Voir la section Prorata ci-dessus.
Voir aussi
- Règles métiers - Automatismes de téo
- Facturation - Module facturation
Cet article vous a été utile ?