Escenario: Gestionar el ciclo de vida de ServiceRequest

Cree, busque, lea, lea versiones, actualice y suprima recursos de ServiceRequest de FHIR R4, con operaciones de supresión permanente autorizadas por separado.

Autorización

Utilice un token de acceso OAuth 2.0 emitido por los dominios de identidad de OCI con los ámbitos de recursos de DDFS necesarios para cada interacción de ServiceRequest. Las operaciones de supresión permanente requieren su autorización documentada por separado. Configure el cliente y obtenga tokens siguiendo Crear una aplicación integrada y Referencia de autenticación de DDFS.

Interacciones anunciadas

R4 CapabilityStatement anuncia interacciones de creación, lectura, lectura de versiones, actualización, supresión y búsqueda de tipo para ServiceRequest:


POST   /api/fhir/r4/ServiceRequest
GET    /api/fhir/r4/ServiceRequest/{rid}
GET    /api/fhir/r4/ServiceRequest/{rid}/_history/{vid}
PUT    /api/fhir/r4/ServiceRequest/{rid}
DELETE /api/fhir/r4/ServiceRequest/{rid}
GET    /api/fhir/r4/ServiceRequest
      

Crear y actualizar una solicitud de servicio

La siguiente carga útil abreviada base-FHIR R4 es una ilustración. Proporcione el contenido requerido por los perfiles y el flujo de trabajo de órdenes seleccionados para la aplicación.

(application/fhir+json)
POST {base}/api/fhir/r4/ServiceRequest
Content-Type: application/fhir+json

{
  "resourceType": "ServiceRequest",
  "status": "active",
  "intent": "order",
  "subject": {
    "reference": "Patient/{patient_id}"
  },
  "code": {
    "text": "Complete blood count"
  }
}
      

Para conocer los requisitos de carga útil y solicitud de actualización, consulte PUT /api/fhir/r4/ServiceRequest/{rid}.

Buscar solicitud de servicio

La superficie de búsqueda R4 ServiceRequest anuncia authored, category, code, patient y status, además de _id, _lastUpdated, _profile, _tag, _count y _total.

Buscar por un parámetro clínico:


GET {base}/api/fhir/r4/ServiceRequest?status=active
GET {base}/api/fhir/r4/ServiceRequest?category={system}|{code}
GET {base}/api/fhir/r4/ServiceRequest?code={system}|{code}
      

Busque por referencia directa del paciente o con el modificador :identifier:


GET {base}/api/fhir/r4/ServiceRequest?patient=Patient/{patient_id}
GET {base}/api/fhir/r4/ServiceRequest?patient:identifier={system}|{value}
      

Buscar rangos de fechas

Los parámetros authored y _lastUpdated aceptan sus comparadores de fechas anunciados. Un rango puede utilizar un máximo de dos incidencias repetidas del mismo parámetro de fecha. No combine valores de fecha con una coma.


GET {base}/api/fhir/r4/ServiceRequest?authored=ge2026-01-01&authored=le2026-01-31
GET {base}/api/fhir/r4/ServiceRequest?_lastUpdated=ge2026-01-01T00:00:00Z&_lastUpdated=le2026-01-31T23:59:59Z
      

Utilice el parámetro _count anunciado al solicitar un tamaño de página.

Depurar recursos suprimidos anteriormente por tipo

La operación $purgeDeleted anunciada es de nivel de tipo:


POST {base}/api/fhir/r4/ServiceRequest/$purgeDeleted
Content-Type: application/fhir+json
      

Su entrada de parámetros FHIR necesita un valor before de tipo dateTime. Opcionalmente, acepta un entero limit del 1 al 50.

(application/fhir+json)
{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "before",
      "valueDateTime": "2026-01-01T00:00:00Z"
    },
    {
      "name": "limit",
      "valueInteger": 25
    }
  ]
}
      

La definición de operación necesita una salida OperationOutcome.

Supresión definitiva de un recurso suprimido

La operación $hardDelete anunciada es de nivel de instancia y tiene como destino una solicitud de servicio suprimida:


POST {base}/api/fhir/r4/ServiceRequest/{rid}/$hardDelete
      

La definición de operación necesita una salida OperationOutcome.

Advertencia

La supresión permanente no se puede deshacer. Siga las operaciones de supresión y depuración de datos antes de llamar a cualquiera de las operaciones de supresión permanente.

Referencias