Outils
Le serveur expose 81 outils, regroupés par domaine. Chaque page d'outil reprend le texte exact envoyé au modèle, les paramètres, le schéma du résultat, les annotations et la permission Oxygenius exigée.
La liste renvoyée par tools/list dépend de l'utilisateur connecté : un outil n'y figure que si l'utilisateur a la permission de l'écran correspondant dans Oxygenius, et les outils d'écriture seulement si sa société les a activés. Voir Authentification et accès.
Le catalogue complet est aussi disponible en JSON : /tools.json.
Dossiers (chantiers)
Le dossier est le cœur d'Oxygenius : un chantier, son client, son adresse, sa procédure et ses étapes.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
search_dossiers | Rechercher des dossiers | Lecture seuleIdempotent | dossier.list.view |
get_dossier | Détail d'un dossier | Lecture seuleIdempotent | dossier.details.view |
create_dossier | Créer un dossier | Écriture | dossier.new-dossier.create |
update_dossier | Modifier un dossier | ÉcritureDestructifIdempotent | dossier-detail.dossier.edit + dossier.details.view |
Tiers (clients, fournisseurs, contacts)
Clients, fournisseurs et contacts de l'entreprise, avec leurs coordonnées et leur régime de TVA.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
search_tiers | Rechercher des tiers | Lecture seuleIdempotent | tiers.list.view |
get_tiers | Détail d'un tiers | Lecture seuleIdempotent | tiers.list.view |
create_tiers | Créer un tiers | Écriture | tiers.new-tiers.create |
update_tiers | Modifier un tiers | ÉcritureDestructifIdempotent | tiers.tiers.edit |
check_vat | Vérifier un numéro de TVA | ÉcritureIdempotentMonde ouvert | tiers.new-tiers.create ou tiers.tiers.edit |
Planning et calendrier
Le planning des équipes et du matériel sur les chantiers, et le calendrier des rendez-vous.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
search_planning_events | Rechercher dans le planning | Lecture seuleIdempotent | planning.list.view |
get_planning_event | Détail d'un événement du planning | Lecture seuleIdempotent | planning.list.view |
search_calendar_events | Rechercher dans le calendrier | Lecture seuleIdempotent | calendar.list.view ou calendar-hybrid.list.view |
get_calendar_event | Détail d'un événement du calendrier | Lecture seuleIdempotent | calendar.list.view ou calendar-hybrid.list.view |
get_agenda_lists | Listes de l'agenda | Lecture seuleIdempotent | planning.list.view ou calendar.list.view ou calendar-hybrid.list.view |
create_planning_event | Planifier un événement | Écriture | planning.list.view |
update_planning_event | Modifier un événement du planning | ÉcritureDestructif | planning.list.view |
create_calendar_event | Ajouter un événement au calendrier | Écriture | calendar.list.view ou calendar-hybrid.list.view |
update_calendar_event | Modifier un événement du calendrier | ÉcritureDestructif | calendar.list.view ou calendar-hybrid.list.view |
Devis
Recherche, rédaction et suivi des devis : lignes, versions, impression et décision du client.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
search_estimates | Rechercher des devis | Lecture seuleIdempotent | estimate.list.view |
get_estimate | Détail d'un devis | Lecture seuleIdempotent | estimate.list.view |
create_estimate | Créer un devis | Écriture | dossier-detail.estimate.create + estimate.list.view |
update_estimate | Modifier un devis | ÉcritureDestructifIdempotent | estimate.list.view |
add_estimate_lines | Ajouter des lignes à un devis | Écriture | estimate.list.view |
update_estimate_lines | Modifier des lignes d'un devis | ÉcritureDestructifIdempotent | estimate.list.view |
remove_estimate_lines | Retirer des lignes d'un devis | ÉcritureDestructifIdempotent | estimate.list.view |
create_estimate_version | Nouvelle version d'un devis | Écriture | estimate.list.view |
print_estimate | Imprimer un devis | Écriture | estimate.list.view |
prepare_estimate_decision | Préparer la décision sur un devis | ÉcritureIdempotentPrépare une action, sans effet | estimate.list.view |
accept_estimate | Accepter un devis | ÉcritureDestructifExige un jeton de confirmation | estimate.list.view |
refuse_estimate | Refuser un devis | ÉcritureDestructifExige un jeton de confirmation | estimate.list.view |
Factures
Factures libres ou issues d'un devis (acompte, avancement, finale), brouillons et numérotation légale.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
search_invoices | Rechercher des factures | Lecture seuleIdempotent | invoice.list.view |
get_invoice | Détail d'une facture | Lecture seuleIdempotent | invoice.list.view |
create_invoice | Créer une facture | Écriture | dossier-detail.invoice.create + invoice.list.view |
update_invoice | Modifier une facture | ÉcritureDestructifIdempotent | invoice.list.view |
add_invoice_lines | Ajouter des lignes à une facture | Écriture | invoice.list.view |
update_invoice_lines | Modifier des lignes d'une facture | ÉcritureDestructifIdempotent | invoice.list.view |
remove_invoice_lines | Retirer des lignes d'une facture | ÉcritureDestructifIdempotent | invoice.list.view |
prepare_invoice_finalization | Préparer la numérotation d'une facture | ÉcritureIdempotentPrépare une action, sans effet | invoice.list.view |
finalize_invoice | Numéroter une facture | ÉcritureDestructifExige un jeton de confirmation | invoice.list.view |
Notes de crédit
Notes de crédit libres ou d'une facture, brouillons et numérotation légale.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
search_credit_notes | Rechercher des notes de crédit | Lecture seuleIdempotent | credit-note.list.view |
get_credit_note | Détail d'une note de crédit | Lecture seuleIdempotent | credit-note.list.view |
create_credit_note | Créer une note de crédit | Écriture | dossier-detail.credit-note.create + credit-note.list.view |
update_credit_note | Modifier une note de crédit | ÉcritureDestructifIdempotent | credit-note.list.view |
add_credit_note_lines | Ajouter des lignes à une note de crédit | Écriture | credit-note.list.view |
update_credit_note_lines | Modifier des lignes d'une note de crédit | ÉcritureDestructifIdempotent | credit-note.list.view |
remove_credit_note_lines | Retirer des lignes d'une note de crédit | ÉcritureDestructifIdempotent | credit-note.list.view |
prepare_credit_note_finalization | Préparer la numérotation d'une note de crédit | ÉcritureIdempotentPrépare une action, sans effet | credit-note.list.view |
finalize_credit_note | Numéroter une note de crédit | ÉcritureDestructifExige un jeton de confirmation | credit-note.list.view |
Facturation électronique et comptable
Envoi officiel d'une facture ou d'une note de crédit par Peppol, ou à l'expert-comptable, toujours en deux temps.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
prepare_peppol_send | Préparer un envoi Peppol | ÉcritureIdempotentPrépare une action, sans effet | peppol.all.send |
send_peppol | Envoyer par Peppol | ÉcritureDestructifMonde ouvertExige un jeton de confirmation | peppol.all.send |
prepare_accountant_send | Préparer un envoi au comptable | ÉcritureIdempotentPrépare une action, sans effet | invoice.list.view ou credit-note.list.view |
send_to_accountant | Envoyer au comptable | ÉcritureDestructifMonde ouvertExige un jeton de confirmation | invoice.list.view ou credit-note.list.view |
Articles, ouvrages et stock
Le catalogue des articles et des ouvrages, leurs prix et, avec le module Stock, leur disponibilité.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
search_items | Rechercher des articles | Lecture seuleIdempotent | item-job.list.view |
get_item | Détail d'un article | Lecture seuleIdempotent | item-job.list.view |
get_item_stock | Stock d'un article | Lecture seuleIdempotent | item-job.list.view + module Stock |
Tâches
Les demandes que les collaborateurs s'adressent entre eux, le plus souvent sur un dossier.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
search_tasks | Rechercher des tâches | Lecture seuleIdempotent | dashboard.tasksWidget.view ou dossier-detail.tab.task |
get_my_tasks | Mes tâches | Lecture seuleIdempotent | dashboard.tasksWidget.view ou dossier-detail.tab.task |
get_task | Détail d'une tâche | Lecture seuleIdempotent | dashboard.tasksWidget.view ou dossier-detail.tab.task |
list_task_types | Types de tâche | Lecture seuleIdempotent | dashboard.tasksWidget.view ou dossier-detail.tab.task |
create_task | Créer une tâche | Écriture | dashboard.tasksWidget.view ou dossier-detail.tab.task |
reply_task | Répondre à une tâche | ÉcritureDestructif | dashboard.tasksWidget.view ou dossier-detail.tab.task |
transfer_task | Transférer une tâche | ÉcritureDestructif | dashboard.tasksWidget.view ou dossier-detail.tab.task |
set_task_pinned | Épingler une tâche | ÉcritureIdempotent | dashboard.tasksWidget.view ou dossier-detail.tab.task |
update_my_task | Modifier une de mes tâches | ÉcritureDestructifIdempotent | dashboard.tasksWidget.view ou dossier-detail.tab.task |
Courriels
La messagerie Oxygenius, synchronisée avec Microsoft 365 : lecture, brouillons et envoi confirmé.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
search_emails | Rechercher des courriels | Lecture seuleIdempotentMonde ouvert | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
get_my_emails | Mes courriels | Lecture seuleIdempotentMonde ouvert | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
get_email | Détail d'un courriel | Lecture seuleIdempotentMonde ouvert | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
list_dossier_emails | Courriels d'un dossier | Lecture seuleIdempotentMonde ouvert | dossier-detail.tab.mailbox + dossier.details.view |
create_email_draft | Créer un brouillon de courriel | Écriture | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
create_document_email | Préparer l'envoi d'un document par courriel | Écriture | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
update_email_draft | Modifier un brouillon de courriel | ÉcritureDestructifIdempotent | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
attach_documents_to_email | Joindre des documents à un courriel | Écriture | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
remove_email_attachments | Retirer des pièces jointes d'un courriel | ÉcritureDestructif | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
prepare_email_send | Préparer l'envoi d'un courriel | ÉcritureIdempotentPrépare une action, sans effet | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
send_email | Envoyer un courriel | ÉcritureDestructifMonde ouvertExige un jeton de confirmation | mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
Documents
Les fichiers d'un dossier et les pièces jointes des courriels : liste, lecture du texte, lien de téléchargement.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
list_dossier_documents | Documents d'un dossier | Lecture seuleIdempotent | dossier-detail.tab.document + dossier.details.view |
read_document | Lire un document | Lecture seuleIdempotentMonde ouvert | dossier-detail.tab.document ou mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
get_document_download_link | Lien de téléchargement d'un document | Lecture seule | dossier-detail.tab.document ou mail-inbox.list.view ou mail-outbox.list.view ou mail-sendbox.list.view ou mail-trashbox.list.view ou all-mail.list.view ou dossier-detail.tab.mailbox |
Profil et listes de référence
Qui est connecté, qui désigner, et les valeurs des listes de choix des formulaires.
| Outil | Rôle | Comportement | Permission |
|---|---|---|---|
get_my_profile | Mon profil | Lecture seuleIdempotent | Aucune permission (données de l'utilisateur connecté) |
search_users | Rechercher une personne | Lecture seuleIdempotent | dashboard.tasksWidget.view ou dossier-detail.tab.task ou dossier.new-dossier.create ou dossier-detail.dossier.edit |
get_reference_lists | Listes de référence | Lecture seuleIdempotent | tiers.new-tiers.create ou tiers.tiers.edit ou dossier.new-dossier.create ou dossier-detail.dossier.edit ou invoice.list.view |