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.
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.