Sistema Nacional de Receta Electronica
0.9.5 - draft Chile flag

Sistema Nacional de Receta Electronica - Local Development build (v0.9.5). See the Directory of published versions

Operaciones

Operaciones Básicas basadas en Métodos

Las Operaciones que se pueden ejecutar como base en el manejo de recursos en FHIR se especifican desde el mismo estándar a través de Resumen de operaciones

Nota: se debe considerar que todos los requests pueden incluir un opcional Accept como cabecera que indica el formato que se debe usar como respuesta (esto incluso se aplica a DELETE dado que una OperationOutcome debe ser devuelta).

Operation Path Request
Method Content-Type Body Prefer Conditional (If apply)
read /[type]/[id] GET N/A N/A N/A O: ETag, If-Modified-Since, If-None-Match
vread /[type]/[id]/_history/[vid] GET N/A N/A N/A N/A
update /[type]/[id] PUT R Resource O O: If-Match
patch /[type]/[id] PATCH R (may be a patch type) Patch O O: If-Match
delete /[type]/[id] DELETE N/A N/A N/A N/A
create /[type] POST R Resource O O: If-None-Exist
search /[type]? GET N/A N/A N/A N/A
/[type]/_search? POST application/x-www-form-urlencoded form data N/A N/A
search-all ? GET N/A N/A N/A N/A
capabilities /metadata GET N/A N/A N/A N/A
transaction / POST R Bundle O N/A
history /[type]/[id]/_history GET N/A N/A N/A N/A
history-type /[type]/_history GET N/A N/A N/A N/A
history-all /_history GET N/A N/A N/A N/A
(operation) /$[name], /[type]/$[name] or /[type]/[id]/$[name] POST R Parameters N/A N/A
GET N/A N/A N/A N/A
POST application/x-www-form-urlencoded form data N/A N/A

Notas:

  • N/A = no Presente, R = Requerido, O = opcional
  • Para las operaciones definidas en todos los recursos, incluyendo acceso directo al meta elemento, ver Resource Operations

La aplicación específica de cada parámetro, para cada una de las operaciones, dependen de cada recurso, en los cuales el estándar especifica cuales se encuentran definidos para cada operación.

Interacción Respuesta
Content-Type Body Location Versionado Status Codes
read R R: Resource N/A R: ETag, Last-Modified 200, 404, 410
vread R R: Resource N/A R: ETag, Last-Modified 200, 404
update R if body O: Resource (Prefer) N/A R: ETag, Last-Modified 200, 201, 400, 404, 405, 409, 412, 422
patch R if body O: Resource (Prefer) N/A R: ETag, Last-Modified 200, 201, 400, 404, 405, 409, 412, 422
delete R if body O: OperationOutcome N/A N/A 200, 202, 204, 404, 405, 409, 412
create R if body O : Resource (Prefer) R R: ETag, Last-Modified 201, 400, 404, 405, 422
search R R: Bundle N/A N/A 200, 401?
search-all R R: Bundle N/A N/A 200, 401?
capabilities R R: CapabilityStatement N/A N/A 200, 404
transaction R R: Bundle N/A N/A 200, 400, 404, 405, 409, 412, 422
history R R: Bundle N/A N/A 200
history-type R R: Bundle N/A N/A 200
history-all R R: Bundle N/A N/A 200
(operation) R R: Parameters/Resource N/A N/A 200

Nota: Esta Tabla lista los códigos de estado, pero otros más pueden ser descrito por la especificación de HTTP. Códigos adicionales son comúnmente errores de servidor y de protocolos de autentificación.

El listado de recursos se define en:

sitio de recursos de FHIR

Búsquedas Soportadas

Los métodos y parámetros para la consulta de recursos se describen a continuación y se basan en la búsqueda sobre el recurso Paciente:

  1. En este caso los servidores DEBEN soportar buscar un recurso Patient usando el parámetro de búsqueda **[_id]:

    GET [base]/Patient[id]

    Ejemplos

    1. GET [base]/Patient/1032702
    2. GET [base]/Patient?id=1032702

Lo anterior es aplicable para un recurso ya creado, el cual se almacena con una identificación generada en el mismo momento de su generación.

  1. Los servidores DEBEN soportar buscar un recurso Patient mediante un identificador como el número RUN de la Cédula de Identidad Nacional por ejemplo, utilizando el parámetro de búsqueda **[identifier]:

    GET [base]/Patient?identifier={system }[code]

    Ejemplo:

    1. GET [base]/Patient?identifier=http://minsal.cl/API/Paciente |99999999
  2. Ejemplos de búsquedas por otros parámetros

    Ejemplo:

    1. GET [base]/Patient?name=Villanueva

Agregando recursos (creando recursos para ser almacenados)

POST [base]/Patient. En el Body, un recurso paciente compatible con el/los perfiles definidos en la guía de implementación Core-Cl (para este caso sería el perfil Paciente-CL)

Terminología

Vocabularios

Definición de Medicamentos: Se utiliza la Terminología Farmacéutica Chilena (TFC), expuesta por medio de un servicio de terminología Local o desde MINSAL.

Profesionales de la Salud: desplegados a través de la Superintendencia de Salud y el sistema Midas, este registro se expone por medio del recurso FHIR Practitioner, y su profesión por medio del recurso PractitionerRole.

Establecimientos de Salud: utiliza su identificación por medio de código DEIS, y su registro se expone a través de los recursos FHIR Location y Organization, según corresponda.

Farmacias: utiliza el registro de farmacias Farmanet y se expone como los recursos FHIR Location y Organization.

Pacientes: Se identifican por medio de su número identificador que puede ser cualquier tipo de documento, especificado en las tablas de HL7 V3 relacionados con identificadores de personas.

Tablas Maestras específicas: se incluyen las de comunas, provincias y regiones, entre otras pertenecientes a la normativa Nacional. Estas son expuestas en la GI y deben ser en muchos casos levantadas a nivel local.