count_records
ChatGPTCompte les dossiers regroupés par une dimension, en un seul appel : les commandes par commercial, par client, par mois ou par état, les SAV par type ou par poseur, avec le montant associé à chaque groupe. C'EST l'outil pour « combien », « qui en a le plus », « le classement de », « la répartition par » et « la moyenne par ». Ne parcours JAMAIS une liste page par page pour compter toi-même : si tu t'apprêtes à demander la page 2, c'est que cet outil répond mieux. Ce que chaque groupe rapporte en plus du compte : - commandes et devis : le montant hors taxes ; - commandes : la marge attendue et réelle, en euros et en pourcentage, donc « la marge moyenne par commercial » ou « les particuliers sont-ils plus rentables que les professionnels » tient en un appel ; - commandes et SAV : le délai moyen de clôture, qui répond à « combien de temps pour fermer » ; - interventions : les heures réellement travaillées et les heures planifiées, qui répondent à « combien d'heures de pose par poseur » ou « la charge est-elle bien répartie » sans ouvrir un seul chantier. Ouverts : states: ["open", "draft"] (commandes) ou ["open"] (SAV) + archived: false. Regroupements utiles au-delà des évidents : - client : « quels clients ont plusieurs commandes ouvertes » — avec minCount: 2, qui ne garde que les clients au-dessus du seuil ; - client_type : particuliers contre professionnels ; - team sur les interventions : quelle équipe a été la plus productive ; - installer sur les SAV : quel poseur génère le plus de SAV sur ses chantiers ; - record sur les interventions, avec minCount: 2 : les dossiers où un technicien est déjà repassé une deuxième fois. Planning : regroupe les interventions par day ou par week sur une période pour voir la charge jour par jour — les journées absentes de la réponse sont les journées vides — et combine avec groupBy: technician sur la même période pour la répartition entre poseurs. Charge de travail : un comptage d'interventions par état SANS période donne, sur la ligne « à planifier », le nombre de poses en attente et le total des heures estimées — la charge restante en un appel. Le même comptage AVEC une période donne les heures déjà planifiées sur cette période : de quoi répondre à « sommes-nous en capacité d'absorber » sans ouvrir un seul chantier.
find_available_slots
ChatGPTLes créneaux libres que le moteur de planification peut proposer pour une intervention : il tient compte des disponibilités des poseurs, du temps de travail et des trajets. Avec une commande ou un SAV, il attend aussi que les produits soient arrivés ; sans dossier, il répond à « quand a-t-on une journée de libre pour une pose à deux » à partir de la durée, du nombre de poseurs et du type d'intervention. Répond à « quand pourrait-on poser ça ». Ne réserve RIEN.
get_activity_overview
ChatGPTLe point d'activité de l'espace sur une période : commandes et devis pris (nombre, montant HT et répartition par état), SAV ouverts, interventions, et les anomalies en cours. C'EST l'outil des questions d'ensemble : « comment se porte l'activité », « fais-moi le point du matin », « les chiffres clés du mois ». Un seul appel remplace les cinq ou six qu'il faudrait sinon enchaîner. Sans période, le mois en cours. Pour une seule de ces dimensions, ou pour un classement par commercial, par client ou par poseur, count_records reste plus précis et moins bavard. Un bloc vaut {"unavailable": true} quand les droits de l'utilisateur ne l'ouvrent pas : c'est un refus, pas un zéro. Dis-le dans la réponse — « je n'ai pas accès aux marges » — et ne présente jamais le reste comme un point complet.
get_after_sales
ChatGPTLe dossier complet d'un SAV : client, chantier, produits concernés, états et personnes en charge. Récupère l'identifiant avec search_after_sales d'abord. N'ouvre le détail que si la question porte sur CE dossier. Répond « introuvable » pour un SAV d'un autre espace, par construction.
get_anomaly_counters
ChatGPTLes compteurs d'anomalies de l'espace pour une vue donnée : combien de dossiers portent aujourd'hui chaque type d'anomalie. C'est l'outil pour « combien d'anomalies avons-nous », les tableaux de bord et les questions de tendance. Seuls les compteurs non nuls sont renvoyés : un type absent de la réponse est à zéro.
get_order
ChatGPTLe dossier complet d'une commande client : client, chantier, dates, états, montants et personnes en charge. Récupère l'identifiant avec search_orders d'abord, les références ne sont pas acceptées ici. N'ouvre le détail que si la question porte sur CETTE commande : ouvrir vingt dossiers pour remplir un tableau coûte cher et n'apporte rien de plus qu'une liste bien filtrée. Répond « introuvable » pour une commande d'un autre espace, par construction.
get_order_rentability
ChatGPTLe détail de marge d'une commande : prix de vente, remise, coût et marge attendus puis réels, répartis entre marchandise, pose et transport, avec les achats par fournisseur. withInstallationDetail explique un coût de main-d'œuvre : heures estimées contre heures réellement travaillées, poseurs concernés et leur coût. Récupère l'identifiant avec search_orders ou search_order_rentabilities.
get_planning
ChatGPTLes évènements planifiés sur une période : poses, métrages, visites SAV, absences et autres, pour des personnes données ou une équipe entière. C'est ce qui répond à « qu'est-ce qui est prévu pour X la semaine prochaine ». Sans userIds ni teamId, lit tout l'espace en un seul appel : c'est la bonne façon de répondre à une question de capacité. La période ne peut pas dépasser 45 jours.
get_quote
ChatGPTLe dossier complet d'un devis : client, commercial, dates (devis, validité, report, perte), montants, marge quand elle est connue, lignes (désignation, pièce, quantité, prix, TVA), actions en attente, motif de perte et historique horodaté, du plus récent au plus ancien. Récupère l'identifiant avec search_quotes d'abord. Répond « introuvable » pour un devis d'un autre espace, par construction.
get_rentability_overview
ChatGPTLa marge agrégée de l'espace sur une période : les commandes en cours d'un côté, les commandes clôturées de l'autre, avec le chiffre d'affaires, la marge attendue et réelle et la répartition des coûts. C'est la réponse à « comment on se porte ce trimestre ». Accepte les mêmes filtres que search_order_rentabilities, pour restreindre un chiffre à un commercial ou à un type de client.
list_interventions_to_plan
ChatGPTLes interventions restant à planifier : les poses, métrages et visites SAV qui n'ont pas encore de créneau. Répond à « qu'est-ce qu'il reste à planifier », éventuellement pour un poseur donné. Chaque ligne porte la durée estimée, ce qui suffit à dimensionner la charge sans ouvrir les commandes une par une. Une fois une intervention identifiée, find_available_slots propose quand la poser.
list_teams
ChatGPTLes équipes de l'espace et leurs membres. À utiliser quand l'utilisateur parle de « l'équipe X », puis passe l'identifiant d'équipe à get_planning, qui l'étend à tous ses membres.
list_technicians
ChatGPTLes personnes de l'espace, poseurs et responsables, avec leurs identifiants. get_planning attend des identifiants et non des noms : passe par ici quand l'utilisateur parle de quelqu'un par son nom.
list_workforce_rentability
ChatGPTLa productivité des équipes sur une période, par poseur ou par équipe : nombre de chantiers, heures prévues contre heures réellement travaillées, et combien se sont terminés avec réserve. Les lignes ne portent que des identifiants : résous les noms avec list_technicians ou list_teams.
search_after_sales
ChatGPTLes SAV de l'espace. À utiliser pour « quels SAV… », pour retrouver l'identifiant d'un dossier, lister les SAV en cours d'un client, ou ceux rattachés à une commande. notUpdatedSince répond en un appel à « les SAV sans action depuis N jours ». Pour compter ou classer, utilise count_records, qui donne aussi le délai moyen de clôture. SAV ouverts : states: ["open"] + archived: false. open couvre toutes les étapes du cycle.
search_anomalies
ChatGPTLes anomalies de tout l'espace, filtrées par type : QUELS dossiers portent aujourd'hui un problème donné. À utiliser pour « quelles commandes n'ont pas encore de commande fournisseur », « quels SAV sont en retard », « quelles commandes attendent une réception ». « Quelles commandes sont en retard » s'entend du point de vue du client : passe late: true. Cela couvre les poses, métrages et SAV passés leur date prévue, les interventions programmées sans leur marchandise, la marchandise non reçue à la date attendue et les retards annoncés par le fournisseur. Réponds par les commandes concernées, groupées par cause. Chaque ligne nomme le dossier concerné, avec sa référence et son intitulé : un seul appel remplace une boucle sur toutes les commandes. N'ouvre pas le détail des dossiers pour les identifier, la référence est déjà là. Passe resourceIdentifier pour se limiter à un dossier déjà connu. get_anomaly_counters donne les compteurs seuls, sans les dossiers.
search_interventions
ChatGPTLes interventions en tant que dossiers métier : poses, métrages et visites SAV, avec leur état, leurs dates prévues, les poseurs affectés, la durée estimée et la commande ou le SAV auquel elles se rattachent. À distinguer de get_planning, qui renvoie les évènements bruts du calendrier. Utilise celui-ci pour « quelles interventions sont en retard », « lesquelles ne sont pas planifiées » ou « les interventions de la commande X ». Pour compter les interventions ou totaliser les heures par poseur, utilise count_records. Avec from / to et sans state, la recherche ne renvoie que les interventions qui ont une date : celles restant à planifier n'appartiennent à aucune semaine et se demandent avec list_interventions_to_plan. receiptState répond directement à « quelles poses n'ont pas encore leurs produits » : chaque ligne porte déjà l'état de réception, inutile de passer par les anomalies.
search_order_rentabilities
ChatGPTLa marge des commandes de l'espace : prix de vente, coût attendu et réel, marge attendue et réelle. À utiliser pour « quelles commandes perdent de l'argent », « la marge des commandes de mars », « les chantiers les moins rentables du commercial X ». Les filtres de marge comparent un POURCENTAGE, pas un montant : marginValue: 10 avec marginOperator: "<" signifie « marge inférieure à 10 % ». sellingPriceValue, lui, compare un montant. Pour « la plus grosse commande » ou « la moins rentable », trie et demande une seule ligne. Pour une moyenne ou un classement par commercial, count_records répond en un appel.
search_orders
ChatGPTLes commandes CLIENTS de l'espace. À utiliser pour « quelles commandes… », pour retrouver l'identifiant d'une commande à partir d'une référence ou d'un nom de client, ou pour lister les commandes d'une période. Il n'existe pas de commande fournisseur séparée : l'approvisionnement est une étape de la vie d'une commande client, d'où les états in_supplier_order et in_goods_receipt sur CETTE ressource. Ne prétends jamais chercher une commande fournisseur. Pour compter ou classer, utilise count_records plutôt que de parcourir les pages. Pour « la plus grosse » ou « la plus récente », trie et demande une seule ligne. query cherche dans la référence, le client et le chantier. Combine-le avec states et une plage de dates pour garder un résultat court, et regarde truncated dans la réponse. Commandes ouvertes : states: ["open", "draft"] + archived: false. open couvre toutes les étapes du cycle (métrage, commande fournisseur, pose) : ne les énumère pas.
search_quotes
ChatGPTLes devis de l'espace. À utiliser pour « quels devis… », pour retrouver l'identifiant d'un devis à partir d'une référence ou d'un client, ou pour lister les devis d'un état, d'une période, d'un commercial ou ceux qui attendent une action. Chaque ligne porte le client, le commercial, la date de validité, le statut d'affichage (consulté par le client, sans réponse…) et les actions en attente (taskTypes : relance à faire, brouillon à compléter…). Il n'est pas nécessaire d'ouvrir le détail pour ces champs. Vocabulaire des états : sent signifie envoyé au client et en attente de sa réponse. Il n'existe pas d'état « gagné » ni « expiré » : gagné correspond à l'un des états signés, refusé correspond à lost, et un devis dont la validité est dépassée se repère par validUntil (tri validUntil croissant) ou par la relance follow_up_quote_expiring. « Quels devis relancer » se répond avec taskTypes (les relances que l'ERP a calculées), pas en ouvrant les dossiers. « Depuis quand » se lit sur quoteDate, la date du devis. from / to portent sur la date du devis. La liste s'arrête à 15 lignes par page : pour compter ou classer, utilise count_records.
whoami
ChatGPTQui pose la question et sur quel espace all manager. Accès en lecture seule : tous les autres outils sont cantonnés à cet espace et ne peuvent pas en atteindre un autre.
