export_shareholder_registry

Pour les émetteurs : générez un export téléchargeable du registre des actionnaires d’une entreprise gérée à une date donnée. Les formats supportés sont XLSX (feuille de calcul) et PDF (imprimable / signnable). Le registre complet — incluant les adresses e-mail et autres coordonnées — est écrit dans le fichier. Le contenu du fichier n’est pas injecté dans le contexte de la conversation ; l’outil retourne plutôt un lien de téléchargement à courte durée de vie et à usage unique.

Authentification

Nécessite une connexion et un accès émetteur à l’entreprise demandée. Appelez d’abord list_managed_companies pour obtenir un companyId valide.

Entrées

Champ	Type	Requis	Description
`company`	integer	Oui	Id de l’entreprise qu’l’utilisateur connecté est autorisé à gérer.
`date`	string	Oui	Date de snapshot au format `YYYY-MM-DD`. Utilisez la date d’aujourd’hui sauf si l’utilisateur demande un snapshot historique.
`format`	string	Oui	`XLSX` (par défaut pour le travail de données) ou `PDF` (pour une copie imprimable / signnable).

Sortie

Un lien de ressource cliquable plus une courte ligne Markdown confirmant l’export. Le lien pointe vers https://mcp.ai.aktionariat.com/download/<token> et est valide pendant 5 minutes et à usage unique — au clic, le worker MCP Aktionariat récupère le fichier depuis le backend et le diffuse vers le navigateur.

Exemples de prompts

“Exporte mon registre des actionnaires en XLSX à partir d’aujourd’hui.”
“Donne-moi un PDF du registre des actionnaires de mon entreprise au 2025-12-31.”
“J’ai besoin de la liste complète des actionnaires avec les e-mails — envoie-moi une copie téléchargeable.”

Notes pour les agents

Le fichier n’entre pas dans la conversation. C’est volontaire — les noms, adresses et adresses e-mail sont sensibles et la plateforme Aktionariat les écrit uniquement dans le fichier. Affichez le lien retourné clairement pour que l’utilisateur sache l’ouvrir dans un navigateur.
Le lien expire dans 5 minutes et est à usage unique. Si l’utilisateur manque la fenêtre, appelez cet outil à nouveau pour créer un nouveau lien.
Un 403 signifie que l’utilisateur connecté n’a pas d’accès émetteur pour l’company donnée. Relancez list_managed_companies et réessayez avec un id valide.
Si l’utilisateur souhaite uniquement un résumé (principaux détenteurs, propriété), préférez shareholder_registry — elle retourne un petit tableau Markdown directement dans la conversation.