DocumentReference — Pointeur vers un document clinique

Compte-rendu PDF, photo clinique, CDA, ePub : DocumentReference est le pointeur FHIR vers tout document clinique. La porte d'entrée IHE XDS en mode REST.

Objet de la ressource

DocumentReference est le métadonnée d'un document clinique stocké quelque part (HTTP URL, base64 inline, IHE XDS). Elle porte type (LOINC), catégorie, auteur, authenticator, custodian, contexte (Encounter, Period), liens vers documents précédents (replaces, appends, signs, transforms), et le pointeur effectif vers le contenu (content[].attachment).

Champs clés

Champ	Type	Cardinalité	Rôle
`identifier`	Identifier[]	0..*	Identifiants externes.
`version`	string	0..1	Version métier.
`basedOn`	Reference(Any)[]	0..*	Demandes parentes.
`status`	code	1..1	Obligatoire. `current`, `superseded`, `entered-in-error`.
`docStatus`	code	0..1	État éditorial : `preliminary`, `final`, `amended`, `entered-in-error`.
`modality`	CodeableConcept[]	0..*	Modalité de production.
`type`	CodeableConcept	0..1	Type de document (LOINC).
`category`	CodeableConcept[]	0..*	Catégorie haut niveau (clinical-note, lab, radiology…).
`subject`	Reference(...)	0..1	Patient ou autre sujet.
`context`	Reference(...)[]	0..*	Contextes (Encounter, EpisodeOfCare, Period).
`event`	CodeableReference[]	0..*	Événements documentés.
`bodySite`	CodeableReference[]	0..*	Sites anatomiques.
`facilityType`	CodeableConcept	0..1	Type d'établissement.
`practiceSetting`	CodeableConcept	0..1	Cadre de pratique.
`period`	Period	0..1	Période couverte.
`date`	instant	0..1	Date de saisie.
`author`	Reference(...)[]	0..*	Auteur(s).
`attester`	BackboneElement[]	0..*	Attesteur(s).
`custodian`	Reference(Organization)	0..1	Organisation conservatrice.
`relatesTo`	BackboneElement[]	0..*	Liens vers documents : `replaces`, `transforms`, `signs`, `appends`.
`description`	markdown	0..1	Description.
`securityLabel`	CodeableConcept[]	0..*	Labels de confidentialité.
`content`	BackboneElement[]	1..*	Obligatoire. Attachment(s) + format(s) IHE.

Exemple JSON

Compte-rendu TDM thorax final, qui amende un compte-rendu préliminaire :

json documentreference-cr-radio.json

{
  "resourceType": "DocumentReference",
  "id": "dr-cr-radio-001",
  "identifier": [{
    "system": "urn:oid:1.2.34",
    "value": "DR-2026-CR-RADIO-001"
  }],
  "status": "current",
  "docStatus": "final",
  "type": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "11503-0",
      "display": "Medical records"
    }, {
      "system": "http://loinc.org",
      "code": "59776-5",
      "display": "Procedure note"
    }]
  },
  "category": [{
    "coding": [{
      "system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category",
      "code": "clinical-note"
    }]
  }],
  "subject": { "reference": "Patient/doe-john" },
  "date": "2026-05-15T16:00:00+02:00",
  "author": [
    { "reference": "Practitioner/dr-radiologist-bernard" }
  ],
  "authenticator": { "reference": "Practitioner/dr-radiologist-bernard" },
  "custodian": { "reference": "Organization/radiology-dept" },
  "relatesTo": [{
    "code": {
      "coding": [{
        "system": "http://hl7.org/fhir/document-relationship-type",
        "code": "appends"
      }]
    },
    "target": { "reference": "DocumentReference/dr-cr-radio-prelim-001" }
  }],
  "description": "Compte-rendu TDM thorax du 2026-05-15, embolie pulmonaire exclue",
  "content": [{
    "attachment": {
      "contentType": "application/pdf",
      "language": "fr-FR",
      "url": "https://docs.hospital-1.example.org/reports/2026/05/CR-RADIO-001.pdf",
      "size": 245678,
      "hash": "...",
      "title": "Compte-rendu TDM thorax",
      "creation": "2026-05-15T15:45:00+02:00"
    },
    "format": {
      "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
      "code": "urn:ihe:rad:TEXT"
    }
  }],
  "context": [
    { "reference": "Encounter/enc-radio-2026-05-15" }
  ]
}

Pièges courants

Confondre status et docStatus — status = cycle de vie de la ressource (current/superseded), docStatus = état éditorial du document (preliminary/final).
Pas de category — rend la recherche difficile : on cherche tous les comptes-rendus radio d'un patient, sans category c'est lent.
Inline base64 pour gros fichiers — un PDF de 5 Mo inline gonfle la ressource. Préférer URL externe + Binary.
relatesTo oublié — sans lien vers la version précédente, l'historique éditorial est perdu.
Pas d'authenticator — sans signataire du document, valeur juridique réduite (signed=false).

Ressources liées

Composition — document FHIR-native vs document externe.
Binary — contenu brut référencé.
DiagnosticReport — peut contenir un DocumentReference dans presentedForm.
Encounter — contexte.
Consent — PDF signé.

Fondamentaux

Standards

Messages phares

Outils