Organization — Entité morale en santé

L'hôpital, le laboratoire, le cabinet de groupe, l'assureur, le payor public, la pharmacie, l'éditeur logiciel. Toute structure référencée par une autre ressource FHIR passe par Organization.

Objet de la ressource

Organization modélise toute entité morale (juridique ou virtuelle) du domaine de la santé : hôpital, clinique, GHT, laboratoire, pharmacie, cabinet médical, assureur, payor public (Sécurité sociale, Medicare, NHS), distributeur, fabricant, éditeur logiciel, équipe de soins.

Organization est le pivot de la modélisation des structures : tout Practitioner peut être affilié à plusieurs Organizations (via PractitionerRole), toute Coverage référence un assureur (Organization), tout DiagnosticReport référence un laboratoire (Organization). La hiérarchie est gérée par partOf (un service hospitalier appartient à un hôpital qui appartient à un groupe).

Champs clés

Identifiants nationaux

Exemple JSON

Organisation Hôpital Universitaire Paris 1, identifiée par FINESS 750100018 et NPI américain (pour les flux internationaux), faisant partie de l'AP-HP, exposant un endpoint FHIR R5 :

{
  "resourceType": "Organization",
  "id": "hosp-paris-1",
  "identifier": [{
    "use": "official",
    "type": {
      "coding": [{
        "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
        "code": "PRN",
        "display": "Provider number"
      }]
    },
    "system": "http://ans.fr/finess",
    "value": "750100018"
  }, {
    "use": "secondary",
    "system": "http://hl7.org/fhir/sid/us-npi",
    "value": "1234567890"
  }],
  "active": true,
  "type": [{
    "coding": [{
      "system": "http://terminology.hl7.org/CodeSystem/organization-type",
      "code": "prov",
      "display": "Healthcare Provider"
    }]
  }],
  "name": "Hôpital Universitaire Paris 1",
  "alias": ["HUP1"],
  "contact": [{
    "purpose": {
      "coding": [{
        "system": "http://terminology.hl7.org/CodeSystem/contactentity-type",
        "code": "ADMIN"
      }]
    },
    "name": {
      "family": "Martin",
      "given": ["Sophie"]
    },
    "telecom": [{
      "system": "phone",
      "value": "+33 1 42 00 00 00",
      "use": "work"
    }, {
      "system": "email",
      "value": "contact@hup1.fr"
    }],
    "address": {
      "line": ["1 boulevard de l'Hôpital"],
      "city": "Paris",
      "postalCode": "75013",
      "country": "FR"
    }
  }],
  "endpoint": [{
    "reference": "Endpoint/hup1-fhir-r5"
  }],
  "partOf": {
    "reference": "Organization/aphp"
  }
}

• identifier[0] : FINESS officiel (use=official).
• identifier[1] : NPI secondaire pour les échanges US.
• type : prov = Healthcare Provider.
• contact : un contact administratif (Sophie Martin) avec téléphone, e-mail et adresse postale.
• endpoint : référence vers l'Endpoint FHIR R5 de l'établissement (URL + authentification dans Endpoint).
• partOf : appartient à Organization/aphp (Assistance Publique – Hôpitaux de Paris).

API REST

• GET /Organization?identifier=http://ans.fr/finess|750100018 — recherche par FINESS.
• GET /Organization?type=prov&active=true — providers actifs.
• GET /Organization?partof=Organization/aphp — toutes les structures appartenant à l'AP-HP.
• GET /Organization?_include=Organization:endpoint — organisation + ses endpoints.
• POST /Organization — créer.
• GET /Organization?address-city=Paris&_count=20 — pagination.

Profils

Pièges courants

• Identifier sans system — un FINESS nu, sans la URI http://ans.fr/finess, est ambigu pour les serveurs cross-region. Toujours qualifier avec le system canonique.
• Hiérarchie incomplète — pour les groupes hospitaliers (GHT français, IDN US), oublier partOf empêche le rollup analytique et les recherches par groupe.
• Plusieurs Organizations pour le même établissement — créer une Organization par flux d'intégration au lieu de les unifier via les identifiants nationaux casse l'index providers.
• Endpoint sans Authentication — référencer un endpoint ouvert sans documenter l'authentification dans l'Endpoint référencé induit en erreur les clients.
• Confusion avec Location — Organization = entité juridique, Location = lieu physique. Un hôpital (Organization) a plusieurs Location (services, étages, salles).

Ressources liées

• Practitioner / PractitionerRole — professionnels affiliés.
• Location — lieux physiques rattachés.
• Patient — patient géré par cette Organization (managingOrganization).
• OrganizationAffiliation — relations transverses entre organisations.
• Endpoint — endpoints techniques exposés.
• InsurancePlan — plan d'assurance émis.
• HealthcareService — services proposés.