Practitioner — Professionnel de santé

Le professionnel de santé en FHIR : médecin, infirmier, pharmacien, kiné, sage-femme. Toute prescription, observation ou document signé référence un Practitioner.

Objet de la ressource

Practitioner décrit une personne physique avec un rôle formel dans la fourniture de soins ou de services associés (administration, juridique). Distinct de PractitionerRole, qui décrit le rôle du Practitioner dans une Organization donnée.

Pratiquement, Practitioner stocke l'identité portable du professionnel — nom, identifiants nationaux (NPI, RPPS, ADELI, GMC…), qualifications — et PractitionerRole stocke l'affectation dans un établissement (cardiologue junior du service de cardiologie de tel CHU, sur tel créneau horaire).

Champs clés

Identifiants par pays

Exemple JSON

Dr James Smith, cardiologue, NPI américain + identifiant français hypothétique :

{
  "resourceType": "Practitioner",
  "id": "example",
  "identifier": [{
    "use": "official",
    "system": "http://hl7.org/fhir/sid/us-npi",
    "value": "1234567890"
  }, {
    "use": "official",
    "system": "urn:oid:1.2.250.1.71.4.2.1",
    "value": "10003456789"
  }],
  "active": true,
  "name": [{
    "use": "official",
    "family": "Smith",
    "given": ["James", "A."],
    "prefix": ["Dr"]
  }],
  "telecom": [{
    "system": "phone",
    "value": "+1-555-555-1234",
    "use": "work"
  }, {
    "system": "email",
    "value": "james.smith@hospital.example.org",
    "use": "work"
  }],
  "address": [{
    "use": "work",
    "line": ["Cardiology Department", "100 Hospital Drive"],
    "city": "Anytown",
    "state": "CA",
    "postalCode": "90210",
    "country": "USA"
  }],
  "gender": "male",
  "birthDate": "1975-03-15",
  "qualification": [{
    "identifier": [{
      "system": "urn:oid:2.16.840.1.113883.4.642.4.1116",
      "value": "MD"
    }],
    "code": {
      "coding": [{
        "system": "http://terminology.hl7.org/CodeSystem/v2-0360",
        "code": "MD",
        "display": "Doctor of Medicine"
      }],
      "text": "Doctor of Medicine"
    },
    "period": { "start": "2002-06-30" },
    "issuer": {
      "display": "Stanford University School of Medicine"
    }
  }, {
    "code": {
      "coding": [{
        "system": "http://snomed.info/sct",
        "code": "394579002",
        "display": "Cardiology"
      }]
    }
  }],
  "communication": [{
    "language": {
      "coding": [{
        "system": "urn:ietf:bcp:47",
        "code": "en-US",
        "display": "English (United States)"
      }]
    },
    "preferred": true
  }]
}

• Deux identifier typés official, l'un US NPI, l'autre OID français.
• qualification[0] = MD (Doctor of Medicine) délivré par Stanford en 2002.
• qualification[1] = Cardiology (SNOMED 394579002) — spécialité.
• communication = anglais (en-US) préféré.

API REST

• GET /Practitioner/example — fetch direct.
• GET /Practitioner?identifier=http://hl7.org/fhir/sid/us-npi|1234567890 — recherche par NPI.
• GET /Practitioner?family=Smith&given=James — recherche par nom.
• GET /Practitioner?qualification-code=http://snomed.info/sct|394579002 — tous les cardiologues.
• GET /Practitioner?active=true&communication=fr — actifs francophones.

Profils

Pièges courants

• Mélanger Practitioner et PractitionerRole : spécialité dans Practitioner.qualification = générale (le médecin est cardiologue, n'importe où). PractitionerRole.specialty = contextuelle (le médecin exerce comme cardiologue dans cette Organization).
• Identifier sans system : un NPI sans system=http://hl7.org/fhir/sid/us-npi n'est pas dédupliquable et fait échouer les profils US Core.
• RPPS / ADELI confondus : deux référentiels distincts en France, avec OID distincts. ADELI est progressivement remplacé par RPPS mais coexiste encore.
• Plusieurs name sans use : si un Practitioner a un nom marital, un nom de jeune fille et un nom usuel, marquer chacun explicitement (official, maiden, usual).
• Qualification sans period : une qualification expirée doit être bornée. Sinon le système la considère perpétuelle.
• Gender vs identité de genre : idem Patient — gender est uniquement administratif. Pour l'identité de genre, utiliser une extension.

Ressources liées

• PractitionerRole — affectation du Practitioner à une Organization, avec specialty, location, healthcareService, période, disponibilité.
• Organization — établissement.
• Location — lieu physique (bureau, salle, hôpital).
• HealthcareService — service offert par l'Organization.
• Patient — sujet des soins (via generalPractitioner).
• Encounter — référence Practitioner via participant.
• MedicationRequest — référence Practitioner via requester.
• Equivalent HL7 v2 — composant XCN dans EVN-5, PV1-7, PV1-17, OBR-16, ORC-12.