OrganizationAffiliation — Affiliation entre organisations
Une Organization est membre, fournisseur, partenaire d'une autre. OrganizationAffiliation porte la relation. Pivot des annuaires de prestataires (Provider Directory).
Objet de la ressource
OrganizationAffiliation modélise les liens entre établissements : cabinet affilié à un GHT, clinique partenaire d'un réseau d'assurance, hôpital agréé par l'assureur, laboratoire prestataire d'analyses. Utilisé par les annuaires (US Healthcare Directory, ANS RPPS étendu) pour répondre aux requêtes « quels prestataires couvrent cette zone ? ».
Champs clés
| Champ | Type | Cardinalité | Rôle |
|---|---|---|---|
identifier | Identifier[] | 0..* | External identifiers. |
active | boolean | 0..1 | Affiliation active. |
period | Period | 0..1 | Validity period. |
organization | Reference(Organization) | 0..1 | Hosting organisation. |
participatingOrganization | Reference(Organization) | 0..1 | Participating organisation. |
network | Reference(Organization)[] | 0..* | Healthcare networks. |
code | CodeableConcept[] | 0..* | Role. |
specialty | CodeableConcept[] | 0..* | Concerned specialties. |
location | Reference(Location)[] | 0..* | Concerned locations. |
endpoint | Reference(Endpoint)[] | 0..* | Affiliation-specific endpoints. |
Exemple JSON
Affiliation clinique → réseau hospitalier :
{
"resourceType": "OrganizationAffiliation",
"id": "example",
"identifier": [{ "system": "http://example.org/affiliations", "value": "AFF-2026-001" }],
"active": true,
"period": { "start": "2026-01-01" },
"organization": { "reference": "Organization/clinic-affiliated" },
"participatingOrganization": { "reference": "Organization/hospital-network" },
"network": [{ "reference": "Organization/insurer-network" }],
"code": [{
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/organization-role",
"code": "member",
"display": "Member"
}]
}],
"specialty": [{
"coding": [{ "system": "http://snomed.info/sct", "code": "394814009", "display": "General medicine" }]
}]
}Pièges courants
- organization = participatingOrganization : auto-référence interdite, vérifier côté écriture.
- period absent : impossible de savoir si l'affiliation est encore valide.
- Confusion avec PractitionerRole : OrganizationAffiliation = Org↔Org, PractitionerRole = Practitioner↔Org.
Ressources liées
- Organization — Les organisations liées.
- PractitionerRole — Affiliation pratique-organisation.
- HealthcareService — Services portés.
- Endpoint — Endpoints techniques.