Gestionar un recurso FHIR a través de su ciclo de vida

Cree, lea, actualice, lea una versión anterior y suprima lógicamente un recurso de FHIR de DDFS.

Este escenario sigue a un paciente a través de las interacciones estándar de creación, lectura, actualización, lectura con versiones (vread) y eliminación de FHIR. Las solicitudes utilizan la superficie de API de FHIR R4 (4.0.1). Utilice el mismo patrón de interacción en la superficie de la boleta FHIR R64 (6.0.0-ballot4) solo cuando su declaración de capacidad desplegada anuncia el recurso y la interacción.

Un DELETE estándar realiza una supresión lógica. La eliminación permanente es un flujo de trabajo administrativo independiente y no forma parte del proceso CRUD ordinario.

Requisitos

  • Llame a GET /api/fhir/r4/metadata y confirme que el paciente anuncia create, read, update, vread y delete.
  • Utilice un token de acceso de OAuth con los permisos necesarios para cada interacción.
  • Use un valor de identificador único para que el recurso de ejemplo se pueda distinguir de otros recursos del paciente.
  • Conservar el ID lógico y los ID de versión devueltos por el servicio. Los ejemplos utilizan marcadores de posición {rid} y {vid}.

Flujo de trabajo

EscalónInteracciónResultado
1CrearEl servicio asigna un ID lógico y una versión inicial.
2LecturaEl servicio devuelve la versión actual.
3ActualizarEl servicio crea una nueva versión del mismo recurso lógico.
4Versión leídaEl servicio devuelve la versión histórica solicitada.
5SuprimirEl servicio suprime lógicamente el recurso sin borrar permanentemente su historial almacenado.

Ejemplos

1. Creación del paciente

La cabecera Prefer: return=representation solicita el recurso de respuesta porque este ejemplo consume el cuerpo de respuesta.

POST /api/fhir/r4/Patient
Accept: application/fhir+json
Content-Type: application/fhir+json
Prefer: return=representation

{
  "resourceType": "Patient",
  "identifier": [
    {
      "system": "urn:example:patient-identifier",
      "value": "{unique-id}"
    }
  ],
  "active": true,
  "name": [
    {
      "use": "official",
      "family": "Test",
      "given": ["Lifecycle"]
    }
  ],
  "gender": "unknown",
  "birthDate": "1970-01-01"
}

Respuesta de ejemplo:

201 Created
ETag: W/"1"
Location: /api/fhir/r4/Patient/{rid}/_history/{vid}
Content-Type: application/fhir+json

{
  "resourceType": "Patient",
  "id": "{rid}",
  "meta": {
    "versionId": "1",
    "lastUpdated": "{timestamp}"
  },
  "identifier": [
    {
      "system": "urn:example:patient-identifier",
      "value": "{unique-id}"
    }
  ],
  "active": true,
  "name": [
    {
      "use": "official",
      "family": "Test",
      "given": ["Lifecycle"]
    }
  ],
  "gender": "unknown",
  "birthDate": "1970-01-01"
}

Guarde {rid} de la id asignada y guarde el ID de versión inicial de meta.versionId, ETag o la versión Location.

2. Leer la versión actual

GET /api/fhir/r4/Patient/{rid}
Accept: application/fhir+json

Ejemplo de respuesta:

200 OK
ETag: W/"1"
Content-Type: application/fhir+json

{
  "resourceType": "Patient",
  "id": "{rid}",
  "meta": {"versionId": "1", "lastUpdated": "{timestamp}"},
  "active": true,
  "birthDate": "1970-01-01"
}

3. Actualizar el paciente

Envíe el recurso de sustitución completo con el ID lógico tanto en la ruta de solicitud como en el cuerpo. En este ejemplo, se cambia active y se conservan los demás datos.

Para evitar sobrescribir una actualización simultánea, envíe ETag desde la última lectura como If-Match. Los puntos finales PUT del recurso en FHIR R4 y FHIR R6 6.0.0-ballot4 lo soportan cuando CapabilityStatement del recurso anuncia versioned-update.

Una versión coincidente permite la actualización. Una versión obsoleta o desconocida devuelve 412 Precondition Failed con OperationOutcome y no realiza ningún cambio. Lea el recurso actual, concilie los cambios y vuelva a intentarlo con su nuevo ETag. No vuelva a intentarlo ciegamente con la misma versión obsoleta.

If-Match es opcional. Sin ella, la actualización es incondicional; un meta.versionId en el cuerpo de la solicitud no protege contra la pérdida de actualizaciones. Las etiquetas entre comillas, como "1" y las etiquetas débiles, como W/"1", comparan exactamente el valor de versión. Una lista separada por comas se ejecuta correctamente si alguna versión coincide; * comprueba la existencia sin proteger una versión específica. Las cabeceras con formato incorrecto devuelven 400 Bad Request.

PUT /api/fhir/r4/Patient/{rid}
Accept: application/fhir+json
Content-Type: application/fhir+json
Prefer: return=representation
If-Match: W/"1"

{
  "resourceType": "Patient",
  "id": "{rid}",
  "identifier": [
    {
      "system": "urn:example:patient-identifier",
      "value": "{unique-id}"
    }
  ],
  "active": false,
  "name": [
    {
      "use": "official",
      "family": "Test",
      "given": ["Lifecycle"]
    }
  ],
  "gender": "unknown",
  "birthDate": "1970-01-01"
}

Respuesta de ejemplo:

200 OK
ETag: W/"2"
Content-Type: application/fhir+json

{
  "resourceType": "Patient",
  "id": "{rid}",
  "meta": {"versionId": "2", "lastUpdated": "{timestamp}"},
  "active": false,
  "birthDate": "1970-01-01"
}

4. Leer la versión anterior

Utilice el ID de versión inicial guardado después de la creación. Una lectura versionada recupera esa versión histórica; no devuelve la versión actual.

GET /api/fhir/r4/Patient/{rid}/_history/{vid}
Accept: application/fhir+json

Ejemplo de respuesta para la versión inicial:

200 OK
ETag: W/"1"
Content-Type: application/fhir+json

{
  "resourceType": "Patient",
  "id": "{rid}",
  "meta": {"versionId": "1", "lastUpdated": "{timestamp}"},
  "active": true,
  "birthDate": "1970-01-01"
}

5. Eliminación lógica del paciente

DELETE /api/fhir/r4/Patient/{rid} realiza una supresión lógica. Una solicitud correcta no devuelve ningún cuerpo de respuesta.

DELETE /api/fhir/r4/Patient/{rid}
Accept: application/fhir+json
204 No Content

Después de la eliminación, no siga utilizando el recurso como registro activo. Manejar una lectura posterior según el estado de FHIR y OperationOutcome devuelto por el servicio.

La supresión permanente es un flujo de trabajo administrativo independiente

Una supresión lógica es distinta de las dos operaciones de supresión permanente:

  • POST /api/fhir/r4/Patient/{rid}/$hardDelete elimina permanentemente un paciente eliminado lógicamente.
  • POST /api/fhir/r4/Patient/$purgeDeleted elimina permanentemente los recursos de paciente elegibles eliminados lógicamente seleccionados por las entradas de la operación.

Ambas operaciones son irreversibles y requieren autorización adicional. Confirme que el recurso es elegible y revise Permanently Delete FHIR Resources antes de utilizar cualquiera de las operaciones.

Códigos de Estado

CódigoSignificado
200Una lectura, actualización o lectura con versiones finalizó correctamente y devolvió el recurso.
201El recurso ha sido creado correctamente.
204El recurso se ha suprimido de forma lógica correctamente y la respuesta no tiene cuerpo.