Aller au contenu principal

Tenant, Workspace, unité légale et établissement

Plusieurs identifiants apparaissent dans les APIs myBCS. Ils ne désignent pas tous la même chose.

Modèle simplifié​

Tenant​

Le tenant représente l'environnement logique isolé attribué à un client dans myBCS.

Côté Partner APIs, il est notamment référencé par un tenantSlug.

Le tenant n'est pas lui-même un SIREN ou un SIRET.

Workspace​

Dans le Portail Client, l'espace associé au tenant est présenté à l'utilisateur sous le nom de Workspace.

Le Workspace ID est l'identifiant utilisé par l'utilisateur pour accéder à son espace depuis le Portail Client.

Le terme tenant reste utilisé dans les APIs et dans la documentation technique, tandis que Workspace désigne le contexte présenté à l'utilisateur dans le Portail Client.

Organization-Id​

Organization-Id porte le contexte d'organisation attendu par les APIs métier de la Tenant Public API lorsqu'il est requis.

Il ne doit pas être confondu avec :

  • le tenantSlug, utilisé pour référencer ou administrer le tenant ;
  • le legalUnitId, utilisé pour identifier une unité légale dans les routes d'onboarding.

Unité légale​

L'unité légale représente l'organisation juridique faisant l'objet du parcours d'onboarding.

La plateforme lui attribue un identifiant canonique :

legalUnitId

Pour une entreprise française, l'identifiant métier principal est généralement le SIREN.

Identifiant API

Dans une route qui attend {legalUnitId}, utilisez le legalUnitId retourné par la plateforme. Ne remplacez pas cet identifiant par le SIREN ou le SIRET.

Établissement​

Un établissement correspond à une implantation ou unité rattachée à une entreprise.

En France, il est généralement identifié par un SIRET.

Une même unité légale peut donc être associée à plusieurs établissements.

De l'identité à l'adresse de facturation électronique​

Le SIREN et le SIRET identifient l'organisation. L'adresse de facturation électronique indique où une facture doit être routée.

Pour une entreprise française, les principales formes sont :

0225:<SIREN>
0225:<SIREN>_<SIRET>
0225:<SIREN>_<libellé_de_service>

Par exemple :

0225:123456789
0225:123456789_12345678900012
0225:123456789_COMPTA

Une même unité légale peut donc être associée à plusieurs adresses électroniques, chacune pouvant répondre à un besoin de routage différent.

Ces adresses sont ensuite inscrites sur le ou les réseaux demandés lors de l'onboarding.

Identité, adresse et ressource API

legalUnitId, SIREN/SIRET et adresse 0225:... ne sont pas interchangeables :

  • legalUnitId identifie la ressource dans l'API ;
  • SIREN/SIRET identifient juridiquement l'entreprise ou l'établissement ;
  • 0225:... identifie le point de routage de la facture électronique.

➡️ Comprendre l'adresse de facturation électronique

SIREN et SIRET​

IdentifiantReprésenteUsage courant
SIRENEntreprise / unité légale françaiseRecherche de l'entreprise, identification métier
SIRETÉtablissement françaisRecherche et adressage au niveau établissement
legalUnitIdRessource d'unité légale myBCSRoutes d'onboarding
tenantSlugTenant myBCSAdministration du tenant, notamment Partner APIs
Workspace IDWorkspace du Portail ClientAccès utilisateur au Portail Client
Organization-IdContexte d'organisationAPIs métier lorsqu'il est requis

Pourquoi cette distinction est importante​

Un problème d'intégration provient souvent d'un identifiant utilisé au mauvais niveau.

Avant un appel, posez-vous deux questions :

  1. Quelle ressource suis-je en train de manipuler ?
  2. Quel identifiant le contrat Swagger attend-il exactement ?

➡️ Unités légales — API Onboarding
➡️ Rechercher une entreprise ou un établissement