Aller au contenu
Documentation de la Plateforme

consultation-du-referentiel

Interface synchrone (OpenAPI) — version 0.1.0. Producteur : entreprise. Consommateurs déclarés : operations, conformite.

date_effet vaut la date courante si elle est absente ; connu_a est réservé aux lectures d’audit. La clé de cache inclut tenant, vue, date et version ; toute vue retourne un ETag exploitable en lecture conditionnelle. Une ressource d’un autre tenant est traitée comme inexistante.

La spécification

Section intitulée « La spécification »
openapi: 3.1.0
info:
  title: entreprise — la consultation du référentiel
  version: 0.1.0
  summary: >-
    Lire les vues datées, versionnées et minimisées du référentiel des organisations, de
    l'emploi et des règles conventionnelles.
  description: >-
    date_effet vaut la date courante si elle est absente ; connu_a est réservé aux
    lectures d'audit. La clé de cache inclut tenant, vue, date et version ; toute vue
    retourne un ETag exploitable en lecture conditionnelle. Une ressource d'un autre
    tenant est traitée comme inexistante.
  x-producteurs:
    - entreprise
  x-consommateurs:
    - composant: operations
    - composant: conformite
  x-ruptures: []   # première version publiée sous cette forme — aucune rupture
paths:
  /entreprise/v1/dossiers-clients/{id}:
    get:
      operationId: lireUnDossierClient
      summary: La relation de service, son statut et sa version.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }, { $ref: '#/components/parameters/connuA' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/dossiers-clients/{id}/rattachements:
    get:
      operationId: lireLesRattachementsDUnDossier
      summary: Les entités rattachées — rôles, finalités et périodes.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/dossiers-clients/{id}/historique:
    get:
      operationId: lireLHistoriqueDUnDossier
      summary: Les versions et transitions du dossier.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/dossiers-clients/{id}/correspondants:
    get:
      operationId: lireLesCorrespondantsDUnDossier
      summary: Les fonctions actives — sans coordonnées copiées.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/dossiers-clients/{id}/journal:
    get:
      operationId: lireLeJournalDUnDossier
      summary: Les actes significatifs, paginés — sans état civil ni charge sensible.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/curseur' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/entites/{id}:
    get:
      operationId: lireUneEntite
      summary: L'identité légale à une date.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }, { $ref: '#/components/parameters/connuA' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/entites/{id}/dossiers-clients:
    get:
      operationId: lireLesDossiersDUneEntite
      summary: Les rattachements de l'entité à une date.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/entites/{id}/liens-emploi:
    get:
      operationId: lireLesLiensDUneEntite
      summary: Les liens d'emploi autorisés de l'entité — filtrés et paginés.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }, { $ref: '#/components/parameters/curseur' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/perimetres/{id}:
    get:
      operationId: lireUnPerimetre
      summary: La finalité et les membres à une date.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/correspondants/{id}:
    get:
      operationId: lireUnCorrespondant
      summary: Le tiers_id, le statut et les affectations.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/correspondants/{id}/mandats:
    get:
      operationId: lireLesMandatsDUnCorrespondant
      summary: Les pouvoirs et les preuves accessibles.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/mandats/{id}:
    get:
      operationId: lireUnMandat
      summary: Le périmètre, les actes permis et la période.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/autorisations/effectives:
    get:
      operationId: lireLesAutorisationsEffectives
      summary: Les autorisations d'un correspondant à une date.
      security: [{ authentification: [entreprise:consultation] }]
      parameters:
        - { $ref: '#/components/parameters/tenant' }
        - { $ref: '#/components/parameters/correlation' }
        - { $ref: '#/components/parameters/dateEffet' }
        - name: correspondant_id
          in: query
          required: true
          schema: { type: string }
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/liens-emploi/{id}:
    get:
      operationId: lireUnLienEmploi
      summary: L'employeur, la qualité, les dates et la version.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }, { $ref: '#/components/parameters/connuA' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/liens-emploi/{id}/donnees-sociales:
    get:
      operationId: lireLesDonneesSocialesDUnLien
      summary: Les faits minimisés, par nature et période.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/personnes/{epargnant_id}/emplois:
    get:
      operationId: lireLesEmploisDUnePersonne
      summary: >-
        Les liens de la personne dans le tenant — fermée aux administrateurs d'une
        entreprise, réservée aux services du tenant habilités : elle traverse les
        périmètres d'habilitation des employeurs.
      security: [{ authentification: [entreprise:masse] }]
      parameters:
        - { $ref: '#/components/parameters/tenant' }
        - { $ref: '#/components/parameters/correlation' }
        - { $ref: '#/components/parameters/dateEffet' }
        - name: epargnant_id
          in: path
          required: true
          schema: { type: string }
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutoriseMasse' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/chargements-rh/{id}:
    get:
      operationId: lireUnChargement
      summary: Le statut, les compteurs et les anomalies.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/chargements-rh/{id}/lignes:
    get:
      operationId: lireLesLignesDUnChargement
      summary: Les résultats — sans état civil.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/curseur' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/populations/{id}:
    get:
      operationId: lireUnePopulation
      summary: La photographie, ses compteurs et son empreinte.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/populations/{id}/lignes:
    get:
      operationId: lireLesLignesDUnePopulation
      summary: Les liens, statuts et motifs.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/curseur' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/attestations-completude/{id}:
    get:
      operationId: lireUneAttestation
      summary: L'autorité, la preuve et la révocation éventuelle.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/actes/{id}:
    get:
      operationId: lireUnActe
      summary: >-
        Les métadonnées, parties, mode de conclusion, preuves, signatures et dépôts.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/dispositifs/{id}:
    get:
      operationId: lireUnDispositif
      summary: L'identité stable et le statut.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/dispositifs/{id}/versions:
    get:
      operationId: lireLesVersionsDUnDispositif
      summary: Les versions et leurs périodes.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/dispositifs/{id}/offre:
    get:
      operationId: lireLOffreDUnDispositif
      summary: Les supports et flux à une date.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/versions-parametrage/{id}:
    get:
      operationId: lireUneVersionDeParametrage
      summary: Les paramètres et les applicabilités.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/jeux-abondement/{id}:
    get:
      operationId: lireUnJeuDAbondement
      summary: Les règles ordonnées et les périodes.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/regles-abondement/{id}:
    get:
      operationId: lireUneRegleDAbondement
      summary: Le ciblage, la formule, les tranches et le plafond.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/regles-calcul-enveloppe/{id}/versions:
    get:
      operationId: lireLesVersionsDeFormule
      summary: La formule, les indicateurs, les seuils et les clauses.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/regles-repartition/{id}/versions:
    get:
      operationId: lireLesVersionsDeRepartition
      summary: Les composantes, pondérations, assimilations et arrondis.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/enveloppes/{id}:
    get:
      operationId: lireUneEnveloppe
      summary: >-
        Le déclarant, le périmètre, le montant, l'exercice, la population, les versions
        figées et l'opération collective.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/paniers/{id}/versions/{numero}:
    get:
      operationId: lireUneVersionDePanier
      summary: L'allocation cible.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/numero' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/strategies/{id}/versions/{numero}:
    get:
      operationId: lireUneVersionDeStrategie
      summary: Les profils et les paliers.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/numero' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/conventions/{id}:
    get:
      operationId: lireUneConvention
      summary: >-
        Le statut, les parties, signatures, adhésions, la couverture et les versions.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/conventions/{id}/prestations:
    get:
      operationId: lireLesPrestationsDUneConvention
      summary: Les services applicables.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/conventions/{id}/tarifs:
    get:
      operationId: lireLesTarifsDUneConvention
      summary: Les versions tarifaires.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }, { $ref: '#/components/parameters/dateEffet' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/decisions/{id}:
    get:
      operationId: lireUneDecision
      summary: Le résultat, les motifs et les versions citées.
      security: [{ authentification: [entreprise:consultation] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/id' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutorise' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/masse/dossiers-clients:
    get:
      operationId: lireLesDossiersEnMasse
      summary: Lecture de masse des dossiers clients — réservée aux services du tenant.
      security: [{ authentification: [entreprise:masse] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/finalite' }, { $ref: '#/components/parameters/photographie' }, { $ref: '#/components/parameters/curseur' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutoriseMasse' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/masse/liens-emploi:
    get:
      operationId: lireLesLiensEnMasse
      summary: Lecture de masse des liens d'emploi — réservée aux services du tenant.
      security: [{ authentification: [entreprise:masse] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/finalite' }, { $ref: '#/components/parameters/photographie' }, { $ref: '#/components/parameters/curseur' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutoriseMasse' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/masse/dispositifs:
    get:
      operationId: lireLesDispositifsEnMasse
      summary: Lecture de masse des dispositifs — réservée aux services du tenant.
      security: [{ authentification: [entreprise:masse] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/finalite' }, { $ref: '#/components/parameters/photographie' }, { $ref: '#/components/parameters/curseur' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutoriseMasse' }
        '404': { $ref: '#/components/responses/introuvable' }
  /entreprise/v1/masse/conventions:
    get:
      operationId: lireLesConventionsEnMasse
      summary: Lecture de masse des conventions — réservée aux services du tenant.
      security: [{ authentification: [entreprise:masse] }]
      parameters: [{ $ref: '#/components/parameters/tenant' }, { $ref: '#/components/parameters/correlation' }, { $ref: '#/components/parameters/finalite' }, { $ref: '#/components/parameters/photographie' }, { $ref: '#/components/parameters/curseur' }]
      responses:
        '200': { $ref: '#/components/responses/vueServie' }
        '401': { $ref: '#/components/responses/nonAuthentifie' }
        '403': { $ref: '#/components/responses/nonAutoriseMasse' }
        '404': { $ref: '#/components/responses/introuvable' }
components:
  parameters:
    tenant:
      name: X-Tenant-Id
      in: header
      required: true
      description: >-
        Le teneur de compte — injecté et signé par la passerelle. Une ressource d'un
        autre tenant est traitée comme inexistante.
      schema: { type: string, minLength: 1 }
    correlation:
      name: X-Correlation-Id
      in: header
      required: true
      description: La corrélation de bout en bout.
      schema: { type: string, minLength: 1 }
    id:
      name: id
      in: path
      required: true
      description: L'identifiant publié de la ressource.
      schema: { type: string, minLength: 1 }
    numero:
      name: numero
      in: path
      required: true
      description: Le numéro de version.
      schema: { type: integer }
    dateEffet:
      name: date_effet
      in: query
      required: false
      description: La date d'effet — la date courante si elle est absente.
      schema: { type: string, format: date }
    connuA:
      name: connu_a
      in: query
      required: false
      description: Le temps de connaissance — réservé aux lectures d'audit.
      schema: { type: string, format: date-time }
    curseur:
      name: curseur
      in: query
      required: false
      description: La pagination par curseur.
      schema: { type: string }
    finalite:
      name: finalite
      in: query
      required: true
      description: La finalité déclarée de la lecture de masse — exigée.
      schema: { type: string, minLength: 1 }
    photographie:
      name: date_photographie
      in: query
      required: true
      description: La date de photographie de la lecture de masse — exigée.
      schema: { type: string, format: date }
  securitySchemes:
    authentification:
      type: http
      scheme: bearer
      description: >-
        L'exigence : tout appel est authentifié (401) et autorisé par famille d'accès (403 hors
        famille) — chaque opération déclare sa famille en portée, sous la forme
        entreprise:famille. Ce contrat ouvre
        entreprise:consultation (vues unitaires) et entreprise:masse (lectures de masse
        et vue par personne, réservées aux services du tenant). Le mécanisme est OIDC ;
        sa déclinaison relève de l'assemblage.
  responses:
    vueServie:
      description: >-
        La vue datée, versionnée et minimisée. Un ETag est retourné pour les lectures
        conditionnelles ; la clé de cache inclut tenant, vue, date et version.
      headers:
        ETag:
          description: L'empreinte de la vue servie.
          schema: { type: string }
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Vue'
    nonAuthentifie:
      description: Aucune identité présentée (401).
    nonAutorise:
      description: >-
        L'identité présentée n'a pas la famille d'accès entreprise:consultation (403).
        Les 403 croisés entre familles sont prouvés par les tests d'assemblage.
    nonAutoriseMasse:
      description: >-
        L'identité présentée n'a pas la famille d'accès entreprise:masse (403) — la
        famille des lectures de masse et de la vue par personne, réservée aux services
        du tenant ; entreprise:consultation ne l'ouvre pas.
    introuvable:
      description: >-
        Ressource absente ou invisible — y compris une ressource d'un autre tenant (le
        régime de la muraille : 404, jamais 403).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erreur'
  schemas:
    Vue:
      type: object
      description: >-
        Une vue du référentiel — datée, versionnée, minimisée. Toute vue expose au moins la
        ressource, sa version et la corrélation.
      required: [resource_id, version, correlation_id]
      properties:
        resource_id:
          type: string
        version:
          type: integer
        correlation_id:
          type: string
    Erreur:
      type: object
      required: [code, message, correlation_id]
      properties:
        code:
          type: string
        message:
          type: string
        correlation_id:
          type: string
        details:
          type: array
          items:
            type: object
            properties:
              champ: { type: string }
              motif: { type: string }