link_company_reference

Lier une société au référentiel

Référence générée depuis le contrat versionné · Version Markdown

Rôle#

Rattache une société à un numéro d'entreprise (SIREN, neuf chiffres) du registre : la fiche hérite du référentiel (identité légale, site, logo, secteur), l'historique de la fiche garde la trace, la synchronisation part en tâche de fond. Choisir le SIREN parmi les candidats de get_link_dossier. Action company:link_reference, approbation activable. Exige le module Référentiel sociétés ; la société doit être modifiable par le porteur (même garde qu'à l'écran).

Accès#

Scope principal : companies:write. Le scope ne remplace pas les gardes de visibilité, d'organisation, de module ni les scopes complémentaires des gestes composés.

Catalogue complet · Approbations

Paramètres#

Le schéma ci-dessous est produit par la fonction qui enregistre les outils, y compris idempotency_key lorsqu'elle s'applique. Consultez les objets imbriqués dans le schéma complet.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "companyId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "SIREN à neuf chiffres"
    },
    "idempotency_key": {
      "description": "Clé d'idempotence (recommandée) : rejouer la MÊME mutation avec la même clé renvoie la réponse originale sans ré-exécuter - TTL 24 h",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "companyId",
    "siren"
  ],
  "additionalProperties": false
}