export_shareholder_registry

Pour les émetteurs : générer un export téléchargeable du registre des actionnaires d’une société gérée à une date donnée. Les formats supportés sont XLSX (feuille de calcul) et PDF (imprimable / signable). Le registre complet — y compris les adresses email et autres coordonnées — est écrit dans le fichier. Le contenu du fichier n’est pas intégré au contexte de conversation ; l’outil retourne un lien de téléchargement à courte durée de vie et à usage unique.

Authentification

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

Entrées

Champ	Type	Requis	Description
`company`	integer	Oui	Id de la société d’une société que l’utilisateur connecté est autorisé à gérer.
`date`	string	Oui	Date du 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 sur données) ou `PDF` (pour une copie imprimable / signable).

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 transmet au navigateur.

Exemples de Prompts

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

Notes pour les Agents

Le fichier n’entre pas dans la conversation. C’est intentionnel — les noms, adresses et adresses email sont sensibles et la plateforme Aktionariat les écrit uniquement dans le fichier. Rendez le lien retourné clairement visible pour que l’utilisateur sache l’ouvrir dans un navigateur.
Le lien expire dans 5 minutes et est à usage unique. Si l’utilisateur rate cette fenêtre, appelez à nouveau cet outil pour générer un lien frais.
Un 403 signifie que l’utilisateur connecté n’a pas accès émetteur pour la company donnée. Relancez list_managed_companies et réessayez avec un id valide.
Si l’utilisateur veut seulement un résumé (principaux actionnaires, participation), préférez shareholder_registry — il retourne un petit tableau Markdown directement dans la conversation.