Requêteur

Le requêteur permet de créer des extractions de données personnalisées. Les utilisateurs pourront ensuite exécuter ces requêtes depuis leur module (Dossiers, Facturation ou Annuaire).

Menu : Admin > Requêteur

Les 3 modules disponibles

Module	Description	Tables principales	Accès utilisateurs
Production	Données métier	Dossiers, groupes, bénéficiaires, conseillers, prestations	Dossiers > Rapports > Requêtes
Facturation	Données financières	Factures, encaissements, clients, règlements	Facturation > Rapports > Requêtes
Annuaire	Données contacts	Personnes, sociétés, types d'entités	Annuaire > Rapports > Requêtes

Créer une requête

1. Cliquez sur Nouvelle requête
2. Remplissez les informations :
   • Nom : Nom explicite (ex: "Dossiers terminés par mois")
   • Module : Production, Facturation ou Annuaire
   • Description : Explication pour les utilisateurs
3. Cliquez sur Enregistrer

Options par module

Module Production

Option	Description
Groupes	Requêter sur les groupes de dossiers plutôt que les dossiers individuels

Module Facturation

Option	Description
Groupes	Requêter sur les groupes plutôt que les dossiers
Factures groupées	Activer si vos factures portent sur plusieurs dossiers

---

Les filtres

Les filtres limitent les résultats de la requête.

Filtres à valeur fixe

La valeur est définie à la création et ne peut pas être modifiée à l'exécution.

Exemple : Afficher uniquement les dossiers à l'état "En cours"

Filtres dynamiques

L'utilisateur saisit la valeur au moment d'exécuter la requête.

Type	Usage	Ce que voit l'utilisateur
Saisie texte	Recherche textuelle	Champ de saisie libre
Saisie nombre	Valeur numérique	Champ numérique
Liste déroulante	Choix dans une liste	Menu déroulant
Intervalle de dates	Période du/au	Deux champs date
Intervalle de nombres	Valeur entre X et Y	Deux champs numériques
Intervalle d'heures	Durée entre X et Y	Deux champs durée

Ajouter un filtre

1. Section Filtres, cliquez sur Ajouter un filtre
2. Sélectionnez la table (dossier, bénéficiaire, facture...)
3. Sélectionnez le champ (date de création, état, nom...)
4. Si le champ est lié à une liste :
   • Laisser vide → Filtre dynamique
   • Choisir une valeur → Filtre fixe

Filtres suggérés

Lors du premier filtre, téo propose automatiquement les champs de date pertinents. Commencez par là !

Un seul filtre par champ

Une requête ne peut contenir qu'un seul filtre par champ. Si un filtre existe déjà sur le champ choisi, téo refuse le second et affiche le message « Filtre déjà présent sur ce champ ». Pour changer la valeur recherchée, modifiez ou supprimez le filtre existant. Cette limite ne concerne pas les champs utilisés comme colonnes ou comme axes d'un tableau croisé.

---

L'affichage

Deux modes disponibles. Le choix est définitif.

Mode Liste (par défaut)

Tableau classique avec une colonne par champ.

| Bénéficiaire | Prestation | Date début | État     |
|--------------|------------|------------|----------|
| Dupont Marie | Bilan      | 01/01/2024 | En cours |
| Martin Jean  | VAE        | 15/01/2024 | Terminé  |

Configuration :

1. Cliquez sur Ajouter une colonne
2. Sélectionnez table puis champ
3. Répétez pour chaque colonne
4. Réordonnez avec les flèches haut/bas

Valeurs affichées pour la prestation

Quand vous ajoutez la colonne Prestation > Prestation, le résultat affiche le nom de la prestation (par exemple « Bilan » ou « VAE »), et non un numéro technique. Le même principe s'applique aux autres champs issus d'une liste (état, sous-gamme, etc.) : c'est le libellé lisible qui apparaît dans le tableau et dans l'export Tableur.

Résultat du mode Liste

Le mode Liste n'affiche pas de doublons exacts. Si une table de détail sert uniquement à filtrer, par exemple Lignes de facture, la facture correspondante apparaît une seule fois dans le résultat.

Pour obtenir le détail de chaque ligne, ajoutez aussi une colonne issue de cette table.

Mode Tableau croisé

Comptage par combinaison de deux dimensions.

| État / Prestation | Bilan | VAE | Orientation |
|-------------------|-------|-----|-------------|
| En cours          | 12    | 8   | 5           |
| Terminé           | 45    | 23  | 34          |

Configuration :

1. Dans la section Affichage, cliquez sur Ajouter une colonne
2. Choisissez le mode Tableau croisé (le choix Liste (par défaut) / Tableau croisé n'apparaît qu'à la première colonne)
3. Renseignez les deux axes :
   • Abscisse (horizontal) : table + champ
   • Ordonnée (vertical) : table + champ
4. Enregistrez

La section Affichage devient alors Tableau croisé. Chaque axe est repéré comme Horizontale ou Verticale.

Compléter un axe manquant :

Situation	Action
Abscisse présente, ordonnée absente	Bouton Ajouter une verticale
Ordonnée présente, abscisse absente	Bouton Ajouter une horizontale

Modifier un axe :

1. Cliquez sur la ligne de l'axe à modifier
2. La fenêtre s'ouvre sur Modifier l'abscisse (horizontal) ou Modifier l'ordonnée (vertical)
3. Changez la table et le champ de cet axe uniquement
4. Enregistrez — l'autre axe n'est pas modifié

Supprimer un axe :

1. Ouvrez l'axe à supprimer
2. Cliquez sur l'icône poubelle
3. Confirmez (Supprimer l'abscisse ou Supprimer l'ordonnée)

Mode non modifiable

Une fois choisi, impossible de basculer vers l'autre mode.

---

Tables et champs disponibles

Module Production

Table	Champs principaux
Dossier	État, dates (création, début, fin), durées, montants, informations complémentaires, UUID
Groupe	Nom, état, dates, durées, informations complémentaires, abandonné
Prestation	Prestation, code, Sous-gamme, durée bénéficiaire, durée de production
Bénéficiaire	Nom, prénom, adresse, email, téléphones, date naissance, sexe, âge (calculé), genre
Bénéficiaire (autres données)	Niveau formation, qualification, situation pro/familiale, handicap (RQTH)
France Travail	N° DE, date d'inscription
Conseiller	Nom, prénom, email, téléphones, fonction
Société du bénéficiaire	Raison sociale, SIRET
Gestionnaire	Nom, prénom, coordonnées
Commercial	Nom, prénom, coordonnées
Financeur	Raison sociale, adresse, SIRET, secteur
Financeur bénéficiaire	Indicateur bénéficiaire
Centre	Nom, adresse, téléphone
Lieu	Nom, adresse, CP, ville
Tarification	Tarification, dates, numéro de convention, numéro de lot
Facture	Numéro, date, montants HT/TVA/TTC, soldée
Événements	Événement, date
Échéances	Événement, numéro de facture, montant prévu, date facture

Module Facturation

Table	Champs principaux
Facture	Numéro, date, échéance, montants, taux TVA, comptes, soldée, exportée, type, avoir
Dossier	État, dates, durées
Groupe	Nom, état
Encaissement	Date, montants, mode paiement, n° chèque, exporté
Client	Raison sociale, adresse, SIRET
Client bénéficiaire	Nom, prénom, coordonnées
Compte	Nom, numéro
Lignes de facture	Description, PU HT, quantité, montant HT
Prestation du dossier (ou du groupe)	Prestation, code, Sous-gamme, durées
Tarification du dossier (ou du groupe)	Tarification, dates, numéro de convention
Bénéficiaire	Nom, prénom
Conseiller	Nom, prénom
Centre	Nom, adresse
Lieu	Nom, adresse

Module Annuaire

Table	Champs principaux
Personne	Nom, prénom, adresse, email, téléphones, date naissance, fonction, service
Société	Raison sociale, adresse, SIRET, secteur
Profil de société	Code type d'entité
Profil de personnes	Code type d'entité

---

Tester la requête

1. Cliquez sur Tester (icône engrenages) depuis l'écran d'édition
2. Renseignez les filtres dynamiques
3. Cliquez sur Appliquer
4. Vérifiez les résultats

« Tester » ne montre qu'un aperçu

Le bouton Tester affiche uniquement un court extrait des données (les premières lignes), destiné à valider rapidement la structure et le tri de votre requête.

Pour obtenir l'extraction complète (toutes les lignes, export Excel/CSV), passez par le module qui exécute la requête :

Source de données principale	Chemin d'exécution
Dossiers / Production	Production > Rapports > Requêtes
Facturation / Factures / Règlements	Facturation > Rapports > Requêtes
Annuaire / Personnes / Sociétés	Annuaire > Rapports > Requêtes

Le bouton Tableur (Excel) en haut à droite des résultats permet de télécharger l'extraction complète — avec les mêmes colonnes que le résultat affiché.

Filtre sur plusieurs valeurs : un seul filtre, plusieurs cases

Pour récupérer par exemple les dossiers qui sont soit Prévisionnel, soit Sans suite, soit Refusé, créez un seul filtre État et cochez les trois valeurs dans le sélecteur.

Vous ne pouvez pas ajouter trois filtres État séparés (un par valeur) : téo refuse un second filtre sur un champ déjà filtré. Plusieurs filtres sur le même champ se combineraient en « État = Prévisionnel ET État = Sans suite ET État = Refusé » — situation impossible, aucun dossier ne pouvant avoir trois états simultanés.

La règle générale : plusieurs filtres = ET (cumul), plusieurs valeurs cochées dans un même filtre = OU (alternatives).

Calculer un CA net avec les avoirs

Le requêteur n'applique pas de calcul métier : il extrait les montants tels qu'ils sont stockés en base. Les avoirs apparaissent donc avec un montant positif dans la requête (et ne sont pas déduits automatiquement du total des factures).

Pour reconstituer un CA net (factures − avoirs) :

1. Ajoutez la colonne Facture > Avoir à votre requête. Elle renvoie 1 pour les avoirs et 0 (ou vide) pour les factures classiques.
2. Exportez en tableur.
3. Dans Excel, filtrez sur la colonne Avoir pour soustraire les montants des avoirs au total des factures (ou utilisez une formule conditionnelle =SI(Avoir=1; -Montant; Montant) cumulée).

Si vous cherchez le CA net directement dans téo sans tableur intermédiaire, utilisez plutôt Pilotage > Comptabilité > CA par conseiller / Société / Période : ces écrans intègrent nativement la déduction des avoirs.

Messages d'erreur

Message	Solution
"La requête doit être liée à un dossier ou un groupe"	Ajoutez une colonne dossier
"La requête doit être liée à la facture ou le règlement"	Ajoutez une colonne facture ou encaissement
"Requête incohérente"	Vérifiez les dépendances entre tables
"Limite atteinte (2000)"	Ajoutez des filtres pour réduire le périmètre

---

Options avancées

Dépendances entre tables

Certaines tables nécessitent d'autres tables :

Table	Nécessite
Prestation, Tarification, Centre, Lieu, Conseiller	Dossier ou Groupe
Bénéficiaire, Bénéficiaire (autres données), France Travail	Dossier
Lignes de facture, Client	Facture
Compte	Encaissement

Requêtes sur les groupes

1. Cochez Groupes à la création
2. La table "Groupe" remplace "Dossier"
3. Accédez aux dossiers individuels via la table "Dossier"

Factures groupées

1. Cochez Factures groupées à la création
2. Permet d'accéder aux infos de chaque dossier d'une facture multi-dossiers

---

Cas pratiques

Liste des dossiers créés ce mois

• Module : Production
• Filtre : Date de création (intervalle)
• Colonnes : Dossier > numéro, Bénéficiaire > nom/prénom, Prestation > Prestation, Dossier > état

Liste des dossiers avec e-mail des bénéficiaires

• Module : Production
• Filtres : selon le besoin (état, période, conseiller…)
• Colonnes : Dossier > numéro, Bénéficiaire > nom / prénom / email, Prestation > Prestation, Dossier > état

Le bouton Tableur de la recherche de dossiers n'inclut pas l'e-mail, car cette colonne n'est pas affichée dans la liste. Une requête dédiée permet d'obtenir exactement ces colonnes.

CA mensuel par tarification

• Module : Facturation
• Filtre : Date de facture (intervalle)
• Colonnes : Facture > numéro/date, Tarification du dossier > tarification, Facture > total HT

Répartition dossiers par conseiller et état (tableau croisé)

• Module : Production
• Mode : Tableau croisé
• Abscisse (horizontal) : Conseiller > nom
• Ordonnée (vertical) : Dossier > état

Export contacts d'une catégorie

• Module : Annuaire
• Filtre : Profil de personnes > code (valeur fixe)
• Colonnes : Personne > nom/prénom/email/téléphone, Société > raison sociale

---

Pourquoi certaines lignes manquent dans mon résultat ?

Quand vous ajoutez des colonnes provenant de plusieurs blocs (Dossier, Bénéficiaire, Société, Conseiller…), téo ne remonte que les pièces qui sont rattachées à toutes ces tables simultanément. Une facture qui n'est liée à aucun dossier (cas typique : facture de société sans bénéficiaire derrière) est exclue dès qu'une colonne du bloc « Dossier » ou « Bénéficiaire » est présente, même si vous ne filtrez pas dessus.

C'est le comportement qui explique le « j'ai 174 factures dans Facturation > Factures mais seulement 123 dans ma requête ».

Comment voir l'ensemble des factures, qu'elles soient rattachées à un dossier ou non

Deux stratégies, à choisir selon votre besoin :

Option 1 — Une seule requête « universelle » sans colonne dossier

1. Supprimez de votre requête toutes les colonnes provenant de Dossier et Bénéficiaire.
2. Ajoutez à la place : Facture > Numéro, Facture > Date, Facture > Total HT, Facture > Société > Raison sociale, Facture > Compte produit.
3. Vous obtenez toutes les factures, qu'elles soient adressées à un bénéficiaire ou à une société.

Option 2 — Deux requêtes séparées

Requête	Cible	Colonnes spécifiques à conserver
« Factures bénéficiaires »	Factures liées à un dossier	Bénéficiaire, Dossier, Prestation
« Factures sociétés »	Factures adressées à une société	Société (raison sociale, SIRET, contact facturation)

L'option 2 est plus lisible quand vous voulez filtrer différemment les deux populations (par exemple : groupe de droits différent côté société, prestation côté bénéficiaire).

Vérifier rapidement ce qu'une requête « rate »

Comparez le nombre de lignes affiché en bas de votre requête au compteur de Facturation > Factures (avec les mêmes filtres date / centre). Une différence importante est le signe qu'une jointure est trop restrictive — typiquement une colonne dossier alors que vous voulez voir aussi les factures société.

Bonnes pratiques

Nommage cohérent

Préfixez vos requêtes : "PROD - Dossiers...", "FACTU - Factures...", "ANNUAIRE - Contacts..."

Commencez par les filtres

Ajoutez toujours un filtre date dès le départ pour limiter le volume.

Testez régulièrement

Testez après chaque modification pour détecter les erreurs rapidement.

Performance

Limitez les colonnes et utilisez des filtres sur les dates pour éviter les requêtes lentes.

---

Modifier ou supprimer

Modifier une requête

1. Cliquez sur la requête dans la liste
2. Modifiez les informations, filtres, colonnes
3. Testez et enregistrez

Supprimer

1. Ouvrez la requête
2. Cliquez sur Supprimer (icône poubelle)
3. Confirmez

Suppression définitive

Vérifiez que la requête n'est plus utilisée avant de la supprimer.