evenement-organisation

Événement (AsyncAPI) — version 0.1.0. Producteur : entreprise.

L’identité, la structure et la correspondance des organisations servies : dossier client, entité juridique, rattachements, périmètres, correspondants et mandats. Une structure modifiée énumère les relations affectées, jamais le graphe complet ; une charge de correspondant ne contient ni identité ni coordonnées.

La spécification

asyncapi: 3.0.0
info:
  title: entreprise — les événements d'organisation et de correspondant
  version: 0.1.0
  x-ruptures: []   # première publication — aucune rupture
  description: >-
    L'identité, la structure et la correspondance des organisations servies : dossier
    client, entité juridique, rattachements, périmètres, correspondants et mandats. Une
    structure modifiée énumère les relations affectées, jamais le graphe complet ; une
    charge de correspondant ne contient ni identité ni coordonnées.
  x-producteurs:
    - entreprise
  x-consommateurs: []
defaultContentType: application/json
channels:
  organisation:
    address: entreprise.organisation.v1
    description: >-
      Canal logique des organisations et correspondants. Les faits d'identité et de
      structure sont ordonnés par organisation ; les faits de correspondant par
      correspondant_id.
    messages:
      faitDOrganisation:
        $ref: '#/components/messages/faitDOrganisation'
      faitDeCorrespondant:
        $ref: '#/components/messages/faitDeCorrespondant'
operations:
  publierLesFaitsDOrganisation:
    action: send
    channel:
      $ref: '#/channels/organisation'
    summary: Entreprise publie les faits d'organisation et de correspondance.
    messages:
      - $ref: '#/channels/organisation/messages/faitDOrganisation'
      - $ref: '#/channels/organisation/messages/faitDeCorrespondant'
components:
  messages:
    faitDOrganisation:
      name: fait-d-organisation
      title: Fait d'organisation
      summary: >-
        Identité, rattachement, structure ou cycle de la relation de service — sept types
        (dossier-client.ouvert, .active, .rattachement-modifie, .sortie-ouverte,
        .cloture ; organisation.identite-modifiee, .structure-modifiee).
      contentType: application/json
      payload:
        allOf:
          - $ref: '#/components/schemas/enveloppe'
          - type: object
            properties:
              data:
                $ref: '#/components/schemas/chargeDOrganisation'
    faitDeCorrespondant:
      name: fait-de-correspondant
      title: Fait de correspondant
      summary: >-
        Affectation ou mandat d'un correspondant — deux types (correspondant.affecte,
        correspondant.mandat-modifie), ordonnés par correspondant_id.
      contentType: application/json
      payload:
        allOf:
          - $ref: '#/components/schemas/enveloppe'
          - type: object
            properties:
              data:
                $ref: '#/components/schemas/chargeDeCorrespondant'
  schemas:
    enveloppe:
      type: object
      description: >-
        L'enveloppe commune du domaine (enveloppe-commune.md). Les consommateurs sont
        tolérants : un champ inconnu s'ignore.
      required:
        - event_id
        - event_type
        - occurred_at
        - tenant_id
        - subject_id
        - subject_version
        - sequence
        - schema_version
        - data
      properties:
        event_id:
          type: string
          format: uuid
        event_type:
          type: string
          description: Le type versionné, parmi les neuf du canal.
          enum:
            - entreprise.dossier-client.ouvert.v1
            - entreprise.dossier-client.active.v1
            - entreprise.dossier-client.rattachement-modifie.v1
            - entreprise.organisation.identite-modifiee.v1
            - entreprise.organisation.structure-modifiee.v1
            - entreprise.dossier-client.sortie-ouverte.v1
            - entreprise.dossier-client.cloture.v1
            - entreprise.correspondant.affecte.v1
            - entreprise.correspondant.mandat-modifie.v1
        occurred_at:
          type: string
          format: date-time
        tenant_id:
          type: string
        subject_id:
          type: string
          description: >-
            L'organisation pour les faits d'identité et de structure ; le correspondant
            pour les faits de correspondant.
        subject_version:
          type: integer
        sequence:
          type: integer
        correlation_id:
          type: string
        causation_id:
          type: string
        schema_version:
          type: integer
        data:
          type: object
    chargeDOrganisation:
      type: object
      description: La charge des faits d'identité, de rattachement et de structure.
      required:
        - entite_id
        - date_effet
        - statut
      properties:
        entite_id:
          type: string
          format: uuid
          description: L'entité juridique concernée.
        dossier_client_id:
          type: string
          format: uuid
          description: Le dossier client, quand le fait s'y rattache.
        date_effet:
          type: string
          format: date
        nature:
          type: string
          description: Par exemple ENTITE_JURIDIQUE, ETABLISSEMENT, PERIMETRE.
        identifiants_officiels:
          type: array
          items:
            type: object
            required: [type, valeur]
            properties:
              type:
                type: string
                description: Par exemple SIREN, SIRET, LEI.
              valeur:
                type: string
        denomination:
          type: string
        statut:
          type: string
          description: Code métier complet (ENT-STA-001), par exemple ACTIF.
        role_dans_dossier:
          type: string
          description: >-
            RESPONSABLE, EMPLOYEUR, ADHERENTE, CENTRALISATRICE ou PAYEUSE — sur un fait
            de rattachement.
        finalite:
          type: string
          description: Par exemple TENUE_DE_COMPTE, PLAN — sur un fait de rattachement.
        modifications:
          type: array
          description: >-
            Les aspects modifiés (par exemple DENOMINATION) — ou les relations affectées
            sur une structure modifiée, jamais le graphe complet.
          items:
            type: string
    chargeDeCorrespondant:
      type: object
      description: >-
        La charge des faits de correspondant — ni identité ni coordonnées : le détail des
        pouvoirs se lit par API avec une habilitation adaptée.
      required:
        - correspondant_id
        - tiers_id
        - dossier_client_id
        - statut
      properties:
        correspondant_id:
          type: string
          format: uuid
        tiers_id:
          type: string
          description: La personne, chez Relation tiers — identifiant publié seulement.
        dossier_client_id:
          type: string
          format: uuid
        fonction:
          type: string
          description: Par exemple RH, PAIE, FINANCE, JURIDIQUE, EPARGNE_SALARIALE.
        date_debut:
          type: string
          format: date
        date_fin:
          type: string
          format: date
        statut:
          type: string
          description: Code métier complet, par exemple ACTIF, SUSPENDU.