Serveur MCP
Connectez les outils IA à Flowtly via le Model Context Protocol à mcp.flowtly.eu.
Connecter
claude mcp add --transport http flowtly https://mcp.flowtly.eu/mcp
Sur cette page
Allocations_get
Outils
| allocations_get | Une allocation par id — la réservation d'une personne sur un projet, avec ses dates et son pourcentage. allocations_list permet de trouver l'id ; celui-ci lit l'enregistrement complet. Une allocation sans employé est un rôle OUVERT (demande non pourvue), pas une réservation. Nécessite le module resourcing. Lecture seule. |
Allocations_list
Outils
| allocations_list | Liste les allocations de resourcing — affectations datées d'un poste sur un projet à un employé (ou à personne pour l'instant, un rôle ouvert). Aucun filtre ; pagination par curseur. Chaque élément contient employeeId/employeeName et projectId/projectName déjà résolus (employeeId null signifie un rôle ouvert) ; positionId est brut — résolvez son nom via positions_list. source distingue les lignes importées depuis une feuille de celles créées directement dans Flowtly. Utilisez ceci pour rapprocher un import de feuille resourcing : relisez ce qui a été enregistré et comparez avec ce qui a été soumis. |
Bank Accounts_get
Outils
| bankAccounts_get | Récupère un compte bancaire par id — nom, devise, banque, et le format dans lequel ses relevés sont importés. |
Bank Accounts_list
Outils
| bankAccounts_list | Liste les comptes bancaires de l'organisation. Filtrez par banque, ou définissez hidden pour inclure les comptes archivés. Utilisez-le pour résoudre l'id bankAccount sur lequel filtre transactions_list. |
Clients_get
Outils
| clients_get | Récupère un client par id — nom, pays, devise, identifiant fiscal et statut. |
Clients_list
Outils
| clients_list | Liste les clients (les clients de l'organisation). Filtrez par status, ou par externalPaymentCustomerId pour trouver le client derrière un id de fournisseur de paiement. Utilisez-le pour résoudre l'id client sur lequel filtrent invoices_list, deals_list, projects_list et contracts_list. |
Config Keys_catalog
Outils
| configKeys_catalog | Liste toutes les clés de configuration de l'organisation reconnues par le backend, avec leur type et leurs valeurs autorisées. C'est le catalogue de ce qui est configurable — consultez-le avant configs_get ou configs_update plutôt que de deviner un nom de clé. La permission est appliquée par clé par le backend, donc l'apparition d'une clé ici ne garantit pas que l'utilisateur connecté puisse l'écrire. |
Configs_get
Outils
| configs_get | Lit une valeur de configuration de l'organisation par id, où l'id est une clé issue de configKeys_catalog (par ex. organization-logo-url, organization-icon-url). |
Contracts_get
Outils
| contracts_get | Récupère un contrat par id — parties, sens, valeur, conditions cycliques et dates. |
Contracts_list
Outils
| contracts_list | Liste les contrats. Filtrez par direction (entrant / sortant), contrepartie, projet, cyclic, nom ou tags. Utilisez-le pour résoudre l'id de contrat que lit contracts_paymentScheduleLines et auquel deals_win peut lier une affaire gagnée. |
Contracts_payment Schedule Lines
Outils
| contracts_paymentScheduleLines | Liste l'échéancier de paiement d'un contrat — les échéances auxquelles il doit être facturé ou payé. Passez le contractId issu de contracts_list. C'est le plan, pas le réalisé : comparez-le à transactions_list pour voir ce qui a réellement été payé. |
Cost Groups_list
Outils
| costGroups_list | Liste les groupes de coûts / centres de coûts — les catégories sous lesquelles sont classés les coûts, fournisseurs et factures entrantes. Utilisez-le pour résoudre l'id costGroup requis par suppliers_create et proposé par les suggestions de factures entrantes. |
Counterparties_get
Outils
| counterparties_get | Récupère une contrepartie par id. |
Counterparties_list
Outils
| counterparties_list | Liste les contreparties — chaque partie avec laquelle l'organisation transige. Les indicateurs supplier et client précisent le(s) rôle(s) joué(s) par une contrepartie, et un même enregistrement peut cumuler les deux. C'est la partie figurant sur une transaction bancaire, donc c'est elle qui sert de référence de rapprochement pour les factures entrantes et les transactions. Filtrez par type, supplier, client, cyclic ou budgetNeutral. |
CRM Notes_get
Outils
| crmNotes_get | Récupère une note CRM par id. |
CRM Notes_list
Outils
| crmNotes_list | Liste les notes rédigées sur les prospects et les affaires. Filtrez par lead ou deal pour lire le fil de commentaires d'un enregistrement. |
Deal Lost Reasons_get
Outils
| dealLostReasons_get | Récupère un motif de perte d'affaire par id. |
Deal Lost Reasons_list
Outils
| dealLostReasons_list | Liste les raisons pour lesquelles une affaire peut être marquée comme perdue, dans l'ordre. deals_lose requiert un lostReasonId issu d'ici. |
Deals_get
Outils
| deals_get | Récupère une affaire par id — titre, client, étape, montant, propriétaire, contact, dates de clôture prévue et réelle. |
Deals_list
Outils
| deals_list | Liste les affaires/opportunités — le pipeline commercial. Filtrez par status (open / won / lost), stage, owner, client, lead, ou par plages expectedCloseDate / closedAt. Les montants sont en unités mineures avec une devise explicite ; ne présumez pas de la devise par défaut de l'organisation. |
Deal Stage Histories_get
Outils
| dealStageHistories_get | Récupère un enregistrement de changement d'étape d'affaire par id. |
Deal Stage Histories_list
Outils
| dealStageHistories_list | Liste les transitions d'étape d'une affaire, la plus récente en premier. Filtrez par deal. Chaque deals_update qui change l'étape est enregistré automatiquement ici, c'est donc ainsi que vous reconstituez combien de temps une affaire est restée à chaque étape — l'affaire elle-même ne conserve que son étape actuelle. |
Holiday Requests_list
Outils
| holidayRequests_list | Les DEMANDES de congé et leur statut — en attente, approuvée, rejetée. À distinguer de holidays_list, qui recense les congés réservés : une demande encore en attente de décision n'est pas encore une absence, donc planifiez à partir de holidays_list et utilisez celui-ci pour voir ce qui attend une décision de quelqu'un. Fournit le holidayRequestId attendu par holidays_approve et holidays_bulkApprove. Lecture seule. |
Holidays_active
Outils
| holidays_active | Qui est absent EN CE MOMENT — tous les congés en cours, pour toute l'organisation. C'est l'outil pour « qui est absent aujourd'hui », et celui à vérifier avant de considérer le freePercent de resourcingBench_get comme une disponibilité, car le bench ne déduit pas les congés. Contrairement à holidays_list, il n'applique aucune restriction par projet et ne nécessite aucune permission au-delà d'être connecté, sa réponse couvre donc toute l'organisation. Renvoie chaque absence avec son type et ses dates. Lecture seule. |
Holidays_get
Outils
| holidays_get | Un enregistrement de congé par id, avec son type, ses dates et sa durée. Récupérez l'id depuis holidays_list ou holidays_active. Lecture seule. |
Holidays_list
Outils
| holidays_list | Congés réservés sur une période — la vue de planification, là où holidays_active ne répond que pour aujourd'hui. Filtrez par employé, par plage de dates, ou par projet. CE QUE VOUS VOYEZ DÉPEND DE VOS PERMISSIONS, et une liste courte n'est pas la preuve que personne n'est absent : un gestionnaire de congés ou un lecteur comptabilité obtient toute l'organisation, tandis qu'un chef de projet ou un lecteur DOIT passer un filtre de projet (ou interroger sur lui-même) et se voit refuser l'accès sans cela — ce refus est une limite de permission, pas un calendrier vide. Lecture seule. |
Incoming Invoices_get
Outils
| incomingInvoices_get | Récupère une facture entrante (fournisseur) ou un justificatif par id, avec ses champs OCRisés et son état de rapprochement actuel. |
Incoming Invoices_list
Outils
| incomingInvoices_list | Liste les factures entrantes (fournisseurs) et documents justificatifs — la boîte de réception comptable. Une facture entrante EST un document rattaché à une transaction bancaire, donc exists.transaction=false permet de trouver les documents pas encore rapprochés d'un paiement. Filtrez aussi par status, relatedMonth, counterparty, project, tags, ou hasDetectedProblems. Chaque document est identifié par une empreinte externalId 'upload_sha256:<sha256 des octets>' — hachez un fichier et recherchez cet externalId ici AVANT incomingInvoices_create, sinon vous créerez un doublon. |
Incoming Invoices_match Candidates
Outils
| incomingInvoices_matchCandidates | Liste les transactions bancaires susceptibles d'être le paiement de cette facture entrante, classées par le moteur de rapprochement du backend. Utilisez-le lorsqu'un document n'a pas de transaction associée et que vous devez en choisir une ; préférez ces candidats plutôt que de deviner vous-même à partir des montants. |
Incoming Invoices_suggestions
Outils
| incomingInvoices_suggestions | Lit les propositions de Flowtly pour une facture entrante — correspondance fournisseur, groupe de coûts, transaction bancaire correspondante, avertissement de doublon. Ce sont exactement les propositions qu'un humain voit dans l'application. Lisez-les d'abord, puis appliquez-en une par id avec incomingInvoices_applySuggestion, ou acceptez-les toutes avec acceptAllSuggestions. Passez refresh pour recalculer plutôt que de servir l'ensemble mis en cache. |
Incoming Invoices_suggestions Debug
Outils
| incomingInvoices_suggestionsDebug | Explique POURQUOI les suggestions d'une facture entrante sont sorties telles quelles — le scoring du moteur de rapprochement, pour diagnostiquer une suggestion manquante ou erronée. Diagnostic uniquement ; utilisez incomingInvoices_suggestions pour le travail courant. |
Invoices_get
Outils
| invoices_get | Récupère une facture sortante (vente) par id — client, lignes, totaux, dates de vente et d'émission, statut. |
Invoices_list
Outils
| invoices_list | Liste les factures sortantes (ventes). Filtrez par client, tags, search, ou une plage saleDate. Notez que saleDate — et non la date d'émission ni la date de création — est le champ sur lequel filtre invoices_export, utilisez donc le même ici lors du rapprochement d'un export. |
Lead Activities_get
Outils
| leadActivities_get | Récupère une activité de prospect (contact de prospection) par id. |
Lead Activities_list
Outils
| leadActivities_list | Liste les contacts de prospection d'un prospect — son fil d'activité (invitation envoyée, réponses, appels, relances). Filtrez par lead pour lire l'historique d'un prospect. C'est l'équivalent structuré de crmNotes_list : les activities forment le journal typé et daté des contacts ; les notes sont des commentaires libres. |
Lead Contacts_get
Outils
| leadContacts_get | Récupère un contact de prospect par id. |
Lead Contacts_list
Outils
| leadContacts_list | Liste les personnes de contact rattachées aux prospects. Filtrez par lead pour lire les contacts d'un prospect donné, ou par email pour retrouver de quel prospect provient un message. |
Lead List Memberships_get
Outils
| leadListMemberships_get | Récupère une appartenance prospect-liste par id. |
Lead List Memberships_list
Outils
| leadListMemberships_list | Liste quels prospects figurent sur quelles listes de prospection sortante, avec le statut de démarchage de chacun (contacted / replied / bounced). Filtrez par list, lead ou status — c'est ainsi que vous lisez l'état d'une campagne. |
Lead Lists_get
Outils
| leadLists_get | Récupère une liste de prospection sortante par id. |
Lead Lists_list
Outils
| leadLists_list | Liste les listes de prospection sortante. Utilisez-le pour résoudre l'id de liste attendu par leadListMemberships_create. |
Lead Lost Reasons_get
Outils
| leadLostReasons_get | Récupère un motif de perte de prospect par id. |
Lead Lost Reasons_list
Outils
| leadLostReasons_list | Liste, dans l'ordre, les motifs pour lesquels un prospect peut être marqué comme perdu. |
Leads_dedupe Check
Outils
| leads_dedupeCheck | Vérifie si un prospect est déjà dans le CRM, en utilisant les mêmes filtres que leads_list (companyName, source, owner, …). Appelez ceci AVANT leads_create : un lead en doublon répartit l'historique de prospection entre deux enregistrements, et rien en aval ne les fusionnera pour vous. |
Leads_get
Outils
| leads_get | Récupère un prospect par id — société, site web, source, statut, propriétaire et le client vers lequel il a été converti, le cas échéant. |
Leads_list
Outils
| leads_list | Liste les leads — cibles de prospection, avant qualification. Filtrez par status, source, owner, client, companyName, ou des plages createdAt/closedAt. Un lead qualifié devient un Client plus une Deal ouverte via leads_convert ; jusque-là, il n'existe que ici, pas dans clients_list. |
Lead Stages_get
Outils
| leadStages_get | Récupère une étape de prospect par id. |
Lead Stages_list
Outils
| leadStages_list | Liste les étapes que traverse un lead, dans l'ordre. Les leads ont leur propre ensemble d'étapes — les deals utilisent stages_list, qui est différent. |
Organizations_get
Outils
| organizations_get | Récupère une organisation par id. ATTENTION — cela ne vous indique PAS à quelle organisation vous êtes connecté. Une connexion OAuth est liée à exactement une org (liée au token), mais ce endpoint renvoie n'importe quelle org dont l'UTILISATEUR connecté est membre, donc une lecture réussie ici peut donner l'impression de confirmer que vous travaillez dans cette org alors que ce n'est peut-être pas le cas. Pour vérifier le tenant sur lequel vous opérez réellement, lisez plutôt des données scopées au tenant — people_list ou clients_list — et ne lancez jamais une écriture en masse sur la seule foi de cet appel. |
People_get
Outils
| people_get | Récupère une fiche personne/employé par id — noms, e-mails, téléphone, manager, et si la personne est active. |
People_list
Outils
| people_list | Liste les personnes/employés. Filtrez par isActive, reportsTo (l'id d'un manager), projectMembers.project, ou search ; paginez avec cursor. Les personnes et les employés partagent le même id, c'est donc ainsi que vous résolvez l'id employé attendu par les temps de travail, les responsabilités, l'appartenance aux projets et les outils de permissions. |
Permission Groups_get
Outils
| permissionGroups_get | Récupère un groupe de permissions par id, y compris les chaînes ROLE_* qu'il accorde. |
Permission Groups_list
Outils
| permissionGroups_list | Liste les groupes de permissions de l'organisation et les rôles que chacun accorde — par ex. le groupe « Business Owner » accorde ROLE_ADMIN. Lisez ceci avant people_setPermissionGroups : les rôles dans la réponse font autorité sur ce qu'un groupe permet réellement, vous n'avez donc jamais à deviner à partir de son nom. |
Pipelines_get
Outils
| pipelines_get | Récupère un pipeline commercial par id. |
Pipelines_list
Outils
| pipelines_list | Liste les pipelines de vente. Un pipeline possède un ensemble ordonné d'étapes — lisez-les avec stages_list filtré par pipeline. |
Positions_list
Outils
| positions_list | Liste les positions — les rôles nommés (par ex. « Backend Engineer ») qu'une allocation de projet pourvoit. Aucun filtre ; Position a la pagination désactivée, cet appel renvoie donc toujours le catalogue complet des rôles de l'organisation en un seul appel. Chaque élément est {id, name, roles}. Utilisez-le pour résoudre le nom du poste derrière le positionId d'une ligne d'allocations_list, et pour trouver l'id de poste qu'un import de resourcing doit faire correspondre. |
Projects_folder Counts
Outils
| projects_folderCounts | Combien de projets se trouvent dans chaque DOSSIER de projets, sous la forme folderId + total + active. Le folderId est un id de tagDefinition — résolvez les noms avec tagDefinitions_list, et repérez les groupes de dossiers avec tagGroups_list (allowedRelations contient "project"). Un folderId nul correspond au lot non catégorisé. Ne compte que les projets racines, car les dossiers regroupent les racines et les phases suivent leur parent. Lecture seule. |
Projects_get
Outils
| projects_get | Récupère un projet par id — nom, type, client, dates, description et prix. |
Projects_list
Outils
| projects_list | Liste les projets. Filtrez par type (fixed-price | time-and-material | non-billable | internal), client.name, employee, name, ou par plages dateFrom/dateTo. Utilisez-le pour résoudre l'id projet attendu par les tâches, la saisie de temps, les budgets et les contrats. |
Resource Request Candidates_get
Outils
| resourceRequestCandidates_get | Un candidat au recrutement par id. L'id provient de resourceRequestCandidates_list. Nécessite ROLE_HR_MANAGER. Lecture seule. |
Resource Request Candidates_list
Outils
| resourceRequestCandidates_list | Les candidats proposés pour des demandes de recrutement — des personnes dans un pipeline de recrutement, pas des employés disponibles pour allocation. Filtrez par l'id de demande issu de resourceRequests_list. Nécessite ROLE_HR_MANAGER. Lecture seule. |
Resource Requests_get
Outils
| resourceRequests_get | Une demande de recrutement par id, avec son poste et son statut. Récupérez l'id depuis resourceRequests_list. RH/recrutement, pas allocation de resourcing. Nécessite ROLE_HR_MANAGER. Lecture seule. |
Resource Requests_list
Outils
| resourceRequests_list | Demandes de recrutement ouvertes — une demande de recrutement pour un poste, dans le domaine RH. Malgré son nom, ce n'est PAS une demande d'allocation de resourcing : c'est du recrutement. Renvoie la collection ; resourceRequests_get en lit une, et resourceRequestCandidates_list donne les personnes proposées pour elle. Nécessite ROLE_HR_MANAGER. Lecture seule. |
Resourcing Requests_list
Outils
| resourcingRequests_list | Demandes de resourcing ouvertes — quelqu'un demandant qu'une personne soit allouée à un projet, le côté demande du resourcing. C'est le flux que rend la vue Requests de l'interface Resourcing. Ne le confondez PAS avec resourceRequests_list : celui-ci concerne le RECRUTEMENT RH (embauche pour un poste). Associez-le à resourcingRequestsHistory_list pour ce qui a déjà été décidé, et à resourcingBench_get pour savoir qui pourrait satisfaire une demande. Nécessite le module resourcing et ROLE_RESOURCING_MANAGER. Lecture seule. |
Resourcing Requests History_list
Outils
| resourcingRequestsHistory_list | Ce qui est déjà arrivé aux demandes de resourcing — l'historique des décisions (confirmée, refusée, modifiée) derrière les demandes ouvertes dans resourcingRequests_list. Utilisez-le pour répondre à « cela a-t-il déjà été demandé et refusé ? » avant de proposer à nouveau la même allocation. Nécessite le module resourcing et ROLE_RESOURCING_MANAGER. Lecture seule. |
Responsibilities_get
Outils
| responsibilities_get | Récupère une responsabilité par id. |
Responsibilities_list
Outils
| responsibilities_list | Liste les responsabilités au sein d'un groupe RACI. Filtrez par responsibilityGroup. Les responsabilités peuvent s'imbriquer via parent ; les personnes y sont affectées via responsibilityEmployees, pas directement. |
Responsibility Employees_get
Outils
| responsibilityEmployees_get | Récupère une affectation de responsabilité par id. |
Responsibility Employees_list
Outils
| responsibilityEmployees_list | Liste qui est affecté à quelle responsabilité, et à quel pourcentage. Filtrez par employee pour lire toute la charge RACI d'une personne à travers tous les groupes. |
Responsibility Groups_get
Outils
| responsibilityGroups_get | Récupère un groupe de responsabilité par id. |
Responsibility Groups_list
Outils
| responsibilityGroups_list | Liste les groupes de responsabilité / domaines RACI — les éléments de premier niveau « Odpowiedzialności », chacun avec une personne responsable (accountable). Les responsabilités individuelles se rattachent en dessous. |
Schedule Employees_get
Outils
| scheduleEmployees_get | Une affectation planning-employé par id. L'id provient de scheduleEmployees_list. Nécessite ROLE_SCHEDULES_MANAGER. Lecture seule. |
Schedule Employees_list
Outils
| scheduleEmployees_list | Quels employés sont affectés à quels horaires de travail. Utilisez-le pour aller d'un horaire (schedules_list) à ses employés, ou pour trouver l'horaire que suit un employé donné. Nécessite ROLE_SCHEDULES_MANAGER. Lecture seule. |
Schedule Plan_list
Outils
| schedulePlan_list | Les horaires en vigueur à UNE date donnée — passez la date dans le chemin. Utilisez-le pour répondre à « qui travaille aujourd'hui / à cette date » sans lire tous les horaires et résoudre vous-même leurs plages. Contrairement aux autres lectures d'horaires, celui-ci ne nécessite que ROLE_USER, c'est donc celui accessible à un employé ordinaire. Lecture seule. |
Schedule Ranges_get
Outils
| scheduleRanges_get | Une plage horaire d'un planning par id. L'id provient de scheduleRanges_list. Nécessite ROLE_SCHEDULES_MANAGER. Lecture seule. |
Schedule Ranges_list
Outils
| scheduleRanges_list | Les plages horaires qui composent les horaires de travail — les heures réelles couvertes par un horaire. Lisez d'abord le parent avec schedules_get ; ceci développe ses plages. Nécessite ROLE_SCHEDULES_MANAGER. Lecture seule. |
Schedules_get
Outils
| schedules_get | Un horaire de travail par id, avec ses plages et ses employés affectés. L'id provient de schedules_list ; scheduleRanges_list et scheduleEmployees_list en lisent les parties. Nécessite ROLE_SCHEDULES_MANAGER. Lecture seule. |
Schedules_list
Outils
| schedules_list | Horaires de travail — les modèles de poste/horaire qu'une organisation définit, PAS l'allocation de projet. Utilisez resourcingSchedule_get pour savoir qui est réservé sur quoi ; utilisez celui-ci pour les modèles horaires eux-mêmes. schedules_get en lit un par id. Nécessite ROLE_SCHEDULES_MANAGER. Lecture seule. |
Stages_get
Outils
| stages_get | Récupère une étape d'affaire par id. |
Stages_list
Outils
| stages_list | Liste les étapes des affaires, dans l'ordre. Filtrez par pipeline. deals_create requiert un id d'étape issu d'ici, et déplacer une affaire entre étapes est ce qu'enregistre dealStageHistories. |
Suppliers_list
Outils
| suppliers_list | Liste les fournisseurs/prestataires — servis depuis /contractors, donc « supplier » et « contractor » désignent le même enregistrement. Filtrez par cyclic pour les fournisseurs récurrents. Utilisez-le pour résoudre le fournisseur auquel un coût, un contrat ou une facture entrante est rattaché. |
Tag Definitions_list
Outils
| tagDefinitions_list | Liste les définitions de tags — les tags pouvant être attachés à des enregistrements, chacun à l'intérieur d'un groupe de tags. tags_create prend un id de tagDefinition issu d'ici plus l'enregistrement auquel l'attacher. |
Tag Groups_list
Outils
| tagGroups_list | Liste les groupes de tags — les conteneurs qui organisent les définitions de tags. |
Task Comments_list
Outils
| taskComments_list | Liste les commentaires sur les tâches de projet, du plus ancien au plus récent. Filtrez par task pour lire la discussion d'une tâche. |
Task Lists_list
Outils
| taskLists_list | Liste les listes de tâches — les colonnes/sections du tableau dans lesquelles les tâches sont classées. Filtrez par projet. tasks_create prend un id de liste issu d'ici. |
Tasks_get
Outils
| tasks_get | Récupère une tâche de projet par id — titre, projet, statut, liste, assignés, dates et récurrence. |
Tasks_list
Outils
| tasks_list | Liste les tâches de projet. Filtrez par project, list, status, assignees, isTemplate, ou des plages startAt/dueAt. Les tâches récurrentes exposent recurrenceParent et recurrenceRule, de sorte qu'une occurrence générée peut être retracée jusqu'à la règle qui l'a produite. Pour déterminer si une tâche est TERMINÉE, comparez son status à taskStatuses_list (isClosed) plutôt que de comparer le nom du statut. |
Task Statuses_list
Outils
| taskStatuses_list | Liste les statuts de tâche de projet, dans l'ordre du tableau. isClosed marque les états terminés et isDefault le statut qu'obtient une nouvelle tâche. Consultez ceci avant d'interpréter le statut d'une tâche — les noms sont configurables par l'organisation, donc « Done » n'est pas une chaîne fiable pour faire une correspondance. |
Tax Groups_list
Outils
| taxGroups_list | Liste les groupes de taxes. Utilisez-le pour résoudre l'id taxGroup sur lequel filtre taxRules_list et que portent les lignes de facture. |
Tax Rules_list
Outils
| taxRules_list | Liste les règles de taxe — les taux et les périodes auxquelles ils s'appliquent. Filtrez par taxGroup. |
Transactions_list
Outils
| transactions_list | Liste les transactions bancaires — le flux bancaire auquel les factures entrantes sont rapprochées. Filtrez par bankAccount, counterpartyRole, cost, ignored, hasDetectedProblems, une plage orderDate/execDate, ou amount.between. Notez que orderDate et execDate sont différents : un paiement peut être ordonné un mois et s'exécuter le mois suivant. |
Transactions_suggestions
Outils
| transactions_suggestions | Lit les propositions de Flowtly pour une transaction bancaire — à quelle contrepartie, groupe de coûts ou document elle devrait être rattachée. L'équivalent en miroir de incomingInvoices_suggestions, côté trésorerie. |
Work Times_get
Outils
| workTimes_get | Récupère une entrée de temps de travail par id — date, minutes, projet, notes et l'employé auquel elle appartient. |
Work Times_list
Outils
| workTimes_list | Liste les entrées de temps de travail (heures saisies). Filtrez par plage de dates (date.after / date.before, YYYY-MM-DD) et éventuellement par employee ou project ; paginez avec cursor. Chaque ligne porte employeeId/employeeName et projectId/projectName, c'est donc ainsi que vous exportez toutes les heures saisies sur une période. IMPORTANT : les résultats à l'échelle de l'organisation exigent ROLE_WORKING_HOURS_VIEWER. Sans ce rôle, le backend ne renvoie PAS d'erreur — il renvoie silencieusement uniquement les entrées de l'utilisateur connecté, si bien qu'un export « toutes les heures » peut ne contenir qu'une seule personne tout en paraissant parfaitement normal. Si toutes les lignes appartiennent à un seul employé et que vous n'avez pas filtré par employee, la réponse porte un scopeWarning le signalant — signalez-le à l'utilisateur plutôt que de présenter le résultat comme couvrant toute l'organisation. |
Work Times_log
Outils
| workTimes_log | Enregistre une entrée de temps de travail pour l'utilisateur Flowtly connecté (date, durationMinutes, project, notes). Écriture. |
Tasks_create
Outils
| tasks_create | Crée une tâche de projet (title + project requis ; status, list, assignees, dueAt, priority optionnels). Écriture. |
Tasks_update
Outils
| tasks_update | Met à jour une tâche de projet par id — change le status (y compris marquer comme terminée), assignees, dueAt, title, etc. Écriture. |
Task Comments_create
Outils
| taskComments_create | Ajoute un commentaire à une tâche de projet (id de task + content). Écriture. |
Suppliers_create
Outils
| suppliers_create | Crée une nouvelle fiche fournisseur/prestataire (name, tinType, costGroup requis). Écriture. |
Suppliers_update
Outils
| suppliers_update | Met à jour les détails d'un fournisseur/prestataire (nom, identifiant fiscal, conditions de paiement, etc.) par id. Écriture. |
People_create
Outils
| people_create | Crée une fiche personne/employé (firstname + lastname requis ; companyEmail, contactEmail, contactPhone optionnels). Écriture. |
People_update
Outils
| people_update | Met à jour une fiche personne/employé par id (name, companyEmail, contactEmail, contactPhone, etc.). Écriture. |
People_delete
Outils
| people_delete | Supprime une fiche employé/personne par id (par ex. pour retirer un employé factice/placeholder). Nécessite ROLE_EMPLOYEES_MANAGER ; le backend exécute un processeur de suppression qui détache aussi les enregistrements liés. Fort impact, irréversible. Écriture. |
Cost Groups_create
Outils
| costGroups_create | Crée un groupe de coûts / centre de coûts (name + type requis). Écriture. |
Cost Groups_update
Outils
| costGroups_update | Met à jour le nom ou le type d'un groupe de coûts / centre de coûts par id. Écriture. |
Tag Groups_create
Outils
| tagGroups_create | Crée un groupe d'étiquettes (nom requis) pour organiser des définitions d'étiquettes liées. C'est aussi ainsi que l'on crée un conteneur de DOSSIER DE PROJETS : passez allowedRelations : ["project"] et les définitions du groupe deviennent des dossiers dans la liste des projets. Un groupe dont allowedRelations est vide est universel et n'est PAS traité comme un dossier. Écriture. |
Tag Definitions_create
Outils
| tagDefinitions_create | Crée une définition d'étiquette (name, level, tagGroup requis) au sein d'un groupe d'étiquettes. Lorsque allowedRelations du groupe contient "project", chaque définition ici EST un dossier de projets — c'est l'outil qui en crée un. Écriture. |
Clients_create
Outils
| clients_create | Crée une nouvelle fiche client (name, country, currency, status, tinType requis). Écriture. |
Clients_update
Outils
| clients_update | Met à jour une fiche client par id. Écriture. |
Client Contacts_create
Outils
| clientContacts_create | Crée une personne de contact pour un client (client, type, name, email requis). Écriture. |
Bank Accounts_create
Outils
| bankAccounts_create | Crée un compte bancaire (type, name, currency, defaultImportFormat requis). Écriture. |
Bank Accounts_update
Outils
| bankAccounts_update | Met à jour un compte bancaire par id. Écriture. |
Counterparty Bank Accounts_create
Outils
| counterpartyBankAccounts_create | Attache un compte bancaire à une contrepartie (counterparty + accountNumber). Écriture. |
Contracts_create
Outils
| contracts_create | Crée un contrat. Écriture. |
Contracts_update
Outils
| contracts_update | Met à jour un contrat par id. Écriture. |
Contracts_delete
Outils
| contracts_delete | Supprime un contrat par id. Écriture. |
Tax Groups_create
Outils
| taxGroups_create | Crée un groupe de taxes (name + type requis). Écriture. |
Tax Groups_update
Outils
| taxGroups_update | Met à jour le nom ou le type d'un groupe de taxes par id. Écriture. |
Tax Rules_create
Outils
| taxRules_create | Crée une règle de taxe. Écriture. |
Tax Rules_update
Outils
| taxRules_update | Met à jour une règle de taxe par id. Écriture. |
Configs_update
Outils
| configs_update | Met à jour une valeur de configuration de l'organisation par id (type + name requis ; les permissions sont appliquées par le backend clé par clé). Écriture. |
Permission Groups_create
Outils
| permissionGroups_create | Crée un groupe de permissions (name requis ; roles = liste des chaînes ROLE_* qu'il accorde). Écriture. |
Permission Groups_update
Outils
| permissionGroups_update | Met à jour le nom, la description ou les rôles accordés d'un groupe de permissions par id. Écriture. |
People_set Permission Groups
Outils
| people_setPermissionGroups | Définit (remplace) les groupes de permissions d'une personne par des ids de groupe numériques (voir permissionGroups_list — par ex. le groupe « Business Owner » accorde ROLE_ADMIN). Accorde l'accès ; NE crée PAS de login et n'envoie pas d'e-mail à la personne. Écriture. |
Projects_create
Outils
| projects_create | Crée un projet (name + type requis ; type = fixed-price|time-and-material|non-billable|internal ; dateFrom/dateTo, client, publicDescription, notes, priceNet optionnels). Écriture. |
Projects_update
Outils
| projects_update | Met à jour un projet par id (name, type, dates, description, etc.). Écriture. |
Projects_archive
Outils
| projects_archive | Archive un projet par son id — la façon de retirer un projet qui ne peut pas être supprimé parce que du temps saisi, des factures ou des budgets y sont rattachés. Réversible avec projects_unarchive. Préférable à une antidatation de dateTo, qui ne fait que donner au projet l'apparence d'être terminé. Écriture. |
Projects_unarchive
Outils
| projects_unarchive | Restaure un projet archivé par son id, annulant projects_archive. Écriture. |
Responsibility Groups_create
Outils
| responsibilityGroups_create | Crée un groupe de responsabilités / zone RACI (name requis ; description optionnelle et responsibleEmployee = la personne responsable, indiquée comme un simple id d'employé tel que 6 (depuis people_list) ou l'IRI /people/6). C'est l'élément de plus haut niveau « Odpowiedzialności ». Ajoutez des responsabilités individuelles sous celui-ci via responsibilities_create. Écriture. |
Responsibility Groups_update
Outils
| responsibilityGroups_update | Met à jour un groupe de responsabilité par id (name, description, responsibleEmployee = id employé ou IRI). Écriture. |
Responsibilities_create
Outils
| responsibilities_create | Crée une responsabilité à l'intérieur d'un groupe (responsibilityGroup = id ou IRI du groupe, + name, requis ; description optionnelle ; parent optionnel = un autre IRI de responsabilité pour l'imbrication). Assignez-y des personnes via responsibilityEmployees_create. Écriture. |
Responsibilities_update
Outils
| responsibilities_update | Met à jour une responsabilité par id (name, description, parent, responsibilityGroup = id de groupe ou IRI). Écriture. |
Responsibility Employees_create
Outils
| responsibilityEmployees_create | Affecte un employé à une responsabilité (responsibility = id de responsabilité ou IRI, employee = id employé ou IRI, percentage 0-100, tous requis ; targets et description optionnels). Écriture. |
Responsibility Employees_update
Outils
| responsibilityEmployees_update | Met à jour une affectation de responsabilité par id (percentage, targets, description). Écriture. |
Responsibility Employees_delete
Outils
| responsibilityEmployees_delete | Retire l'affectation d'un employé à une responsabilité par id. Écriture. |
Leads_create
Outils
| leads_create | Crée un prospect (cible de prospection sortante/entrante ; companyName, source, status, owner, client lié optionnels). Écriture. |
Leads_update
Outils
| leads_update | Met à jour un prospect par id (company, website, source, status, owner, client lié). Écriture. |
Leads_delete
Outils
| leads_delete | Supprime un prospect par id (suppression douce). Écriture. |
Leads_convert
Outils
| leads_convert | Convertit un prospect qualifié en Client + un contact par contact de prospect + une Affaire ouverte. Nécessite un client existant (le client du prospect ou un clientId dans le corps de la requête). Écriture. |
Lead Activities_create
Outils
| leadActivities_create | Enregistre UN contact de prospection sur un lead — une invitation envoyée, une invitation acceptée, un message, une réponse, un appel, une relance (lead + type + occurredAt requis ; channel, contact, body optionnels). C'EST ici que doit résider l'historique de prospection d'un prospect : une crmNote est un commentaire libre, une activity est le journal de contacts structuré et filtrable que rend la timeline de la file de prospection. NE racontez PAS les contacts dans une note. type : invite_sent | invite_accepted | message_sent | reply_received | call | meeting | follow_up | … ; channel : linkedin | email | phone | …. Écriture. |
Lead Activities_update
Outils
| leadActivities_update | Met à jour une activité de prospection enregistrée par id (type, channel, occurredAt, body). Écriture. |
Lead Activities_delete
Outils
| leadActivities_delete | Supprime une activité de prospection enregistrée par id. Écriture. |
Lead Contacts_create
Outils
| leadContacts_create | Ajoute une personne de contact à un lead (lead + name requis ; email, phone, role, linkedinUrl, isPrimary optionnels). L'URL LinkedIn d'un contact doit être dans linkedinUrl, PAS dans une crmNote. Écriture. |
Lead Contacts_update
Outils
| leadContacts_update | Met à jour un contact de lead par id — par ex. définir linkedinUrl / email / phone une fois que vous les trouvez. Écriture. |
Lead Contacts_delete
Outils
| leadContacts_delete | Supprime un contact de prospect par id. Écriture. |
Deals_create
Outils
| deals_create | Crée une affaire/opportunité (title, client, stage requis ; amountMinor, currency, expectedCloseDate, owner, contact optionnels). Écriture. |
Deals_update
Outils
| deals_update | Met à jour une affaire par id (title, stage, amount, date de clôture, owner, contact). Le changement d'étape est journalisé automatiquement. Écriture. |
Deals_delete
Outils
| deals_delete | Supprime une affaire par id (suppression douce). Écriture. |
Deals_win
Outils
| deals_win | Marque une affaire comme gagnée — la déplace vers une étape gagnée et la marque comme clôturée ; un contractId optionnel la lie à un contrat existant. Écriture. |
Deals_lose
Outils
| deals_lose | Marque une affaire comme perdue — requiert lostReasonId (depuis dealLostReasons_list) ; lostReasonNote optionnel. Écriture. |
Deals_reopen
Outils
| deals_reopen | Rouvre une affaire gagnée/perdue et la remet à l'état ouvert. Écriture. |
Lead Lists_create
Outils
| leadLists_create | Crée une liste de prospection sortante (name requis). Écriture. |
Lead Lists_update
Outils
| leadLists_update | Met à jour une liste de prospection sortante par id. Écriture. |
Lead Lists_delete
Outils
| leadLists_delete | Supprime une liste de prospection sortante par id. Écriture. |
Lead List Memberships_create
Outils
| leadListMemberships_create | Ajoute un prospect à une liste de prospection sortante (list + lead requis ; status optionnel). Écriture. |
Lead List Memberships_update
Outils
| leadListMemberships_update | Met à jour l'appartenance d'un prospect à une liste — par ex. définir le statut de démarchage (contacted/replied/bounced). Écriture. |
Lead List Memberships_delete
Outils
| leadListMemberships_delete | Retire un prospect d'une liste de prospection sortante. Écriture. |
CRM Notes_create
Outils
| crmNotes_create | Ajoute une note à un prospect ou une affaire (body + exactement un des deux, lead ou deal). L'auteur est l'utilisateur connecté. Écriture. |
CRM Notes_update
Outils
| crmNotes_update | Met à jour le contenu d'une note CRM par id. Écriture. |
CRM Notes_delete
Outils
| crmNotes_delete | Supprime une note CRM par id. Écriture. |
Organization Logo_upload
Outils
| organizationLogo_upload | Charge/remplace le logo de l'organisation (image base64 + contentType + filename). Lisez l'actuel via configs_get organization-logo-url. Écriture. |
Organization Icon_upload
Outils
| organizationIcon_upload | Charge/remplace l'icône/favicon de l'organisation (image base64 + contentType + filename). Lisez l'actuelle via configs_get organization-icon-url. Écriture. |
Incoming Invoices_create
Outils
| incomingInvoices_create | Classe une facture entrante (fournisseur) ou un document justificatif dans la comptabilité — passez les octets en base64 avec un fileName et receivedAt. Flowtly l'analyse par OCR et suggère un fournisseur et une transaction bancaire correspondante. Le fichier est identifié par une empreinte externalId 'upload_sha256:<sha256 des octets>' : pour éviter un doublon, hachez les octets et vérifiez incomingInvoices_list pour cet externalId AVANT de charger le fichier. Écriture. |
Invoices_export
Outils
| invoices_export | Démarre un export zip des factures ÉMISES pour une période (from/to, toutes deux au format AAAA-MM-JJ, inclusives) filtrée sur la SALE DATE — et non la date d'émission ni la date de création. Seules les factures ÉMISES sont incluses ; les brouillons et factures non envoyées sont exclus, mais les corrections SONT incluses. Un client optionnel restreint à un seul client (id ou IRI depuis clients_list). Maximum 200 factures par export — si la période en contient plus, réduisez-la (par ex. exportez un mois à la fois) ; une période avec 0 facture émise est également rejetée. Cet appel ne fait que mettre le travail en file d'attente (le rendu d'un mois peut prendre plusieurs minutes) — il NE renvoie PAS de lien de téléchargement. Interrogez invoices_exportStatus avec l'exportId renvoyé jusqu'à ce qu'il indique « ready ». Écriture. |
Invoices_export Status
Outils
| invoices_exportStatus | Interroge le statut d'un export zip démarré par invoices_export, par exportId. Une fois le status à « ready », la réponse inclut downloadUrl (un lien signé de courte durée — expire au bout d'1 heure, voir expiresAt), filename, et byteSize ; les octets du fichier ne sont jamais renvoyés via cet outil. Si status est « failed », failureReason explique pourquoi. |
Invoices_import
Outils
| invoices_import | Classe une facture sortante (vente) DÉJÀ ÉMISE dans l'organisation — pour importer un historique de factures lors de l'onboarding. Le numéro de facture externe que vous passez est conservé tel quel, l'acheteur est résolu par numéro fiscal (créé s'il est absent), et la facture est enregistrée comme émise SANS générer de PDF, envoyer d'e-mail au client, ni soumettre à KSeF. Importer un numéro déjà existant est une opération sans effet qui renvoie la facture existante, donc un import en masse peut être relancé sans risque — mais cette garantie ne vaut que pour des appels séquentiels ; deux imports réellement concurrents du même numéro peuvent tous deux aboutir. Passez expectedGrossTotal (le montant brut imprimé sur le document source) et l'import est rejeté s'il diverge du total calculé à partir des lignes. buyer.tin est requis — l'acheteur n'est jamais mis en correspondance par nom. Utilisez invoices_create, pas celui-ci, pour créer une véritable nouvelle facture. Écriture. |
Invoice Transactions_create
Outils
| invoiceTransactions_create | Enregistre un paiement pour une facture sortante (vente). `invoice` est un IRI de facture issu de invoices_list ; `date` est la date à laquelle le paiement est considéré comme effectué. `transaction` est optionnel — omettez-le pour enregistrer un règlement sans ligne bancaire, ce que vous voulez pour les factures historiques dont le relevé bancaire n'a jamais été importé. `amount` est optionnel et vaut par défaut le solde dû de la facture. Enregistrer un paiement est ce qui empêche qu'une facture émise et échue soit traitée comme impayée, et c'est donc aussi ce qui empêche que des relances de paiement soient mises en file pour elle. Rien n'empêche d'enregistrer deux paiements pour une même facture, lisez donc d'abord invoices_get si vous n'êtes pas sûr qu'elle est déjà réglée. Écriture. |
Invoice Transactions_update
Outils
| invoiceTransactions_update | Met à jour un enregistrement de paiement de facture existant par id (depuis invoiceTransactions de invoices_get, ou en paginant invoiceTransactions). Usage le plus courant : rattacher un paiement enregistré sans ligne bancaire à une transaction que vous venez d'importer via transactions_importStatement, en définissant `transaction` sur un IRI/id de transaction issu de transactions_list. LE PIÈGE : c'est un PATCH, mais le backend requiert quand même `invoice` et `date` à chaque appel — il ne fusionne PAS les valeurs existantes pour vous. Lisez d'abord l'enregistrement (ou disposez-en déjà depuis l'appel de création) et renvoyez ses `invoice` et `date` inchangés en plus de ce que vous voulez réellement modifier, sinon la mise à jour est rejetée. `transaction` accepte null pour délier un paiement d'une ligne bancaire. `amount` est optionnel. Écriture. |
Invoice Transactions_delete
Outils
| invoiceTransactions_delete | Supprime un enregistrement de paiement d'une facture par son id — les ids se lisent dans invoiceTransactions de invoices_get. Cela retire L'ENREGISTREMENT INDIQUANT QU'UNE FACTURE A ÉTÉ PAYÉE, pas une transaction bancaire : à utiliser lorsqu'une facture porte un paiement qui n'aurait jamais dû exister, le cas habituel étant le même paiement comptabilisé deux fois — une fois à la main et une fois par l'import de relevé qui l'a ensuite rapproché. Vérifiez d'abord invoices_get et supprimez l'enregistrement dont la `transaction` est la mauvaise (gardez celui qui pointe vers la vraie ligne bancaire importée) ; supprimer le dernier paiement restant rend la facture de nouveau impayée, ce qui réarme ses relances de paiement. Nécessite ROLE_INVOICES_MANAGER. Irréversible, à fort impact. Écriture. |
Incoming Invoices_apply Suggestion
Outils
| incomingInvoices_applySuggestion | Accepte l'une des propositions de Flowtly sur une facture entrante — les mêmes propositions qu'un humain voit dans l'application (correspondance fournisseur, groupe de coûts, transaction bancaire correspondante, avertissement de doublon). Lisez-les d'abord avec incomingInvoices_suggestions, puis appliquez-en une par son id. Préférez ceci à une supposition : c'est le moteur de rapprochement de Flowtly, pas l'agent, qui décide de ce qui est plausible. Écriture. |
Incoming Invoices_accept All Suggestions
Outils
| incomingInvoices_acceptAllSuggestions | Accepte en un seul appel toutes les suggestions en attente sur une facture entrante — ce que fait un humain avec le bouton « tout accepter » de l'application. Le serveur applique, reconstruit, et applique à nouveau jusqu'à ce que plus rien de nouveau n'apparaisse : la correspondance de transaction n'existe PAS tant que le fournisseur et le montant n'ont pas été appliqués, donc une seule passe laisserait le document non rattaché. Renvoie un rapport (ce qui a été appliqué, ce qui a été refusé et pourquoi, et la transaction à laquelle le document a fini par être rattaché). Passez dryRun pour prévisualiser sans écrire. N'accepte jamais supplier_create ni une alerte de doublon. Écriture. |
Incoming Invoices_check EInvoices
Outils
| incomingInvoices_checkEInvoices | Récupère toute nouvelle e-facture KSeF dans l'organisation — ce que fait le bouton « Sprawdź e-faktury » de l'application. Appelez ceci avant de conclure qu'une facture fournisseur est manquante : sans cela, vous ne pouvez pas distinguer « le fournisseur ne l'a jamais envoyée » de « notre synchronisation n'a pas encore tourné ». Renvoie dès que la récupération est mise en file ; relisez ensuite incomingInvoices_list pour voir ce qui est arrivé. Écriture. |
Resourcing_import Timeline
Outils
| resourcing_importTimeline | Importe une feuille de timeline d'allocations de resourcing (récupérez-la via le MCP Drive, passez son CSV tel quel). C'est un miroir en REMPLACEMENT COMPLET des lignes Allocation de l'organisation pour `year` : les lignes de la feuille sont créées/mises à jour, et toute ligne existante pour cette année absente de la feuille est SUPPRIMÉE — ce n'est pas une fusion. DRY-RUN PAR DÉFAUT : un dryRun omis prévisualise et n'écrit rien ; passez dryRun:false pour appliquer. Le rapport donne `created` / `replaced` plus `unmatchedPeople` / `unmatchedProjects`. DEUX CHOSES SONT FACILES À MANQUER : une ligne de la feuille dont le projet ne se résout pas est IGNORÉE alors que l'appel signale quand même un succès, un résultat vert peut donc cacher un import partiel ; et un code de rôle que le catalogue de postes ne possède pas déjà est CRÉÉ comme nouveau poste plutôt que rejeté — voir `createdPositions`. Les deux sont signalés dans `warnings` lorsqu'ils se produisent ; faites remonter cela à l'utilisateur plutôt que de ne rapporter que `created`. Une feuille qui se résout en zéro ligne est refusée (cela ressemble exactement à une mauvaise lecture sur le point d'effacer toute la timeline) sauf si vous passez force:true. Lisez allocations_list ensuite pour voir ce qui a été enregistré. Fort impact. Écriture. |
Transactions_import Statement
Outils
| transactions_importStatement | Importe un fichier de relevé bancaire (par ex. un fichier MT940 .sta) — passez le contenu texte brut de chaque fichier tel quel (PAS en base64) avec un filename. IL N'Y A PAS de PARAMÈTRE bankAccount : le backend achemine un fichier en supprimant tous les caractères non numériques des numéros de vos comptes bancaires et des octets du fichier, puis importe dans chaque compte dont les chiffres apparaissent n'importe où dans le fichier — un seul fichier peut donc atterrir dans plusieurs comptes, et un relevé pour un compte non configuré dans Flowtly (ou dont le numéro est enregistré différemment de la façon dont la banque l'écrit) n'est importé dans aucun d'eux, échouant avec une erreur qui explique exactement pourquoi — lisez ce message, c'est le seul diagnostic que fournit ce endpoint. En cas de succès, la réponse est `{ imported, matching }` : `matching: "in_progress"` signifie que le rapprochement contrepartie/pièce jointe pour les nouvelles lignes est encore en cours après le retour de cet appel, un transactions_list immédiat peut donc montrer des lignes pas encore rapprochées — relisez un peu plus tard pour l'état final. Réimporter le même relevé ne crée pas de lignes en double ; l'importeur reconnaît les transactions déjà vues. Une fois un relevé importé, rattachez un paiement existant sans ligne bancaire à l'une de ses lignes avec… |
Transactions_delete
Outils
| transactions_delete | Supprime une transaction bancaire par son id — trouvez-la avec transactions_list. N'y recourez QUE pour annuler une erreur comptable impossible à corriger autrement : un relevé importé sur le mauvais compte bancaire, ou des lignes saisies à la main avant l'arrivée du vrai relevé et désormais dupliquées par celui-ci. Une transaction est l'enregistrement de ce qu'a fait la banque : en supprimer une sur un compte importé fait diverger le grand livre de la banque ; le backend ne l'autorise qu'à ROLE_ADMIN (un gestionnaire des transactions ne peut supprimer que sur les comptes de caisse et manuels). AVANT de supprimer un doublon présumé, prouvez la paire : rapprochez la ligne importée sur le montant ET le numéro de facture ET le tiers, pas sur le montant seul — un paiement arrivé après la date de fin du relevé n'a pas de contrepartie, et le supprimer détruit la seule trace de cette recette. Le backend DÉTACHE au lieu de supprimer ce qui en dépend : les paiements de factures subsistent, leur ligne bancaire effacée (repointez-les avec invoiceTransactions_update), les pièces jointes et les biens sont dissociés, tandis que les lignes de transaction de projet et de salarié sont supprimées avec elle. Irréversible, à fort impact. Écriture. |
Organization_whoami
Outils
| organization_whoami | Renvoie l'organisation à laquelle cette connexion MCP est liée — { orgId, name, slug, userId }. Appelez-le pour confirmer DANS QUEL tenant vous êtes sur le point d'écrire avant tout create/update : la connexion est liée à exactement une org par le token, et écrire des prospects/enregistrements dans la mauvaise org est un véritable incident. Lecture seule. |
Resourcing Actuals_get
Outils
| resourcingActuals_get | Heures déclarées par rapport au plan, par personne et par semaine, sur une fenêtre from/to — la question « l'équipe est-elle réellement dans les temps ? » à laquelle AUCUN autre outil de resourcing ne répond : les allocations indiquent ce qui était PLANIFIÉ, celui-ci indique ce qui a été LIVRÉ. Renvoie des colonnes hebdomadaires plus une ligne par personne (% planifié, % déclaré, écart, totaux, et une répartition par projet). reportedPercent à null signifie « pas de contrat cette semaine-là » et 0 signifie « un contrat existait et rien n'a été déclaré » — ne confondez PAS les deux. Passez financials pour le revenu/coût/marge, omis sinon. Nécessite le module resourcing et ROLE_RESOURCING_MANAGER. Lecture seule. |
Resourcing Bench_get
Outils
| resourcingBench_get | Qui N'EST PAS affecté sur une fenêtre from/to — le bench. Utilisez-le lorsqu'on vous demande qui affecter à un nouveau projet ou où de la capacité reste inutilisée ; resourcingActuals_get indique la charge des personnes, celui-ci indique qui n'a aucune charge du tout. IL NE CONNAÎT PAS LES CONGÉS : freePercent est 100 moins les allocations confirmées, rien d'autre, donc quelqu'un en congé approuvé pour trois semaines apparaît à 100% libre et aucun champ de la réponse n'indique le contraire. Répondre à « qui est disponible » à partir de cela seul mettra des personnes sur des projets pendant qu'elles sont absentes — vérifiez en croisant avec holidays_active ou holidays_list. Nécessite le module resourcing. Lecture seule. |
Resourcing Schedule_get
Outils
| resourcingSchedule_get | Le planning de resourcing prévu sur une fenêtre from/to — la timeline des allocations telle que la montre le planificateur. Utilisez-le pour ce qui est RÉSERVÉ à venir ; utilisez resourcingActuals_get pour ce qui a réellement été déclaré par rapport à cela. Nécessite le module resourcing et ROLE_RESOURCING_MANAGER. Lecture seule. |
Leads_bulk Import
Outils
| leads_bulkImport | Importe de nombreux leads en UN seul appel, chacun avec ses contacts, son appartenance à une liste et ses activités de prospection imbriqués — le serveur crée le lead puis propage son id dans les enfants, vous n'avez donc jamais à jongler avec des IRI intermédiaires. Idempotent par clés naturelles (companyName / email / (list,lead) / (type,occurredAt,contact)) : sûr à relancer et à découper en lots (≤100 leads/appel). C'est la voie en masse qu'un import de campagne devrait utiliser au lieu de N appels leads_create. Écriture. |