Integración a los servicios de EMD APROSS

Objetivos del documento

Describir los aspectos técnicos de la API del EMD publicada en la plataforma de apross y cómo utilizarla.

Cuando un paciente es atendido por un centro médico, se abre un episodio, el cual tiene dentro diferentes tipos de prácticas. El objetivo principal de este documento es lograr que el usuario logre crear un episodio médico.

Información muy importante: entre el presente documento en pdf y el swagger, siempre será el swagger el que tiene la información actualizada en tiempo real, por tanto solicitamos tomar los ejemplos del presente documento solo a fines ilustrativos y siempre remitirse al swagger al momento de desarrollar.

Protocolo de transporte

Se implementa un certificado de servidor para la capa de transporte vía HTTPS.

Método de transporte

Los métodos de transporte a implementar son POST, GET y DELETE

Protocolo de API

El protocolo a implementar en los servicios será REST con peticiones donde los cuerpos serán en formato JSON

Seguridad API

El método de seguridad a implementar consta de un servicio capaz de gestionar identidad y acceso a través de un inicio de sesión único llamado keycloak. Decidimos utilizar este servicio ya que nos permite administrar usuarios de diferentes aplicaciones en un mismo lugar. Todos nuestros endpoints utilizan el método HTTP Bearer Token.

Nuestra API del EMD utiliza métodos de seguridad por medio de un token de acceso. (no me gusta esto)

API

Nuestra api se encuentra publicada y disponibilizada en el siguiente enlace

API HIS EMD - Swagger

En la documentación disponible en Swagger, encontrará:

Endpoints disponibles.
Headers requeridos.
Request y responses definidos.
Esquemas y maestros asociados a cada campo.
Plataforma de test nativo para probar los endpoints.

Autenticación

Antes que todo para comenzar a interactuar con nuestra api debemos obtener el token de acceso, el cual lo podemos obtener de la siguiente forma.

curl -XPOST 'https://servicios2.test.apross.gov.ar/auth/realms/APROSS/protocol/openid-connect/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=************' \
--data-urlencode 'client_secret=**************'

Con el token obtenido vamos a poder interactuar con nuestra api enviando el mismo por el header de la petición.

-H "Authorization: Bearer $TOKEN"

En nuestro swagger, arriba a la derecha encontramos un botón “Authorize” donde podemos introducir el token de acceso para poder interactuar con todos los endpoints presentes en el swagger.

Códigos de estado HTTP generales

200 - 201 - Success

{
  "detail": "Success"
}

500 - Internal Server Error

{
  "detail": "Error al conectarse con un servicio externo"
}

503 - Service Unavailable

{
  "detail": "Ocurrio un error al obtener información sobre la autenticación"
}

422 - Unprocessable Entity (Validation Error)

{
  "detail": "El episodio tiene que tener al menos un diagnostico y una practica asociada"
}

403 - Forbidden

{
  "detail": "No tiene los permisos para realizar esta acción"
}

401 - Unauthorized

{
  "detail": "Sin autenticación"
}

Manejo de la API

Para lograr crear un episodio completo con sus debidas prestaciones debemos seguir los siguientes pasos

Episodio

Crear un episodio con numero de afiliado y token totp (código presente en aplicación móvil)

Funcionalidad prevista:

Constata la identidad.
Valida que el afiliado está apto para recibir una atención (por ejemplo que no esté internado en otro prestador).
Crea un episodio de atención para el afiliado.
Genera un número de episodio unívoco que será usado de aquí en adelante para referir a este episodio de atención..

Petición

POST - /his/api/episodios/ | Swagger

Headers

'Accept: application/json'

'x-efector-cuit: *cuit*'

'Content-Type: application/json'

Body

{
  "tipo": 1,
  "fecha_admision": "2022-11-24T13:53:01.409Z",
  "totp": "142857",
  "nro_afiliado": "1-26681266-00-7"
}

Response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "prestador": "string",
  "estado": {
    "tipo": 0,
    "fecha_desde": "2023-05-10T21:23:00.867Z",
    "fecha_hasta": "2023-05-10T21:23:00.867Z"
  },
  "afiliado": {
    "id": 0,
    "created_at": "2023-05-10T21:23:00.867Z",
    "updated_at": "2023-05-10T21:23:00.867Z",
    "estado_civil": "string",
    "carencia": "string",
    "tipo_relacion_afiliatoria": "string",
    "dni": "4287097",
    "alta": "2023-05-10T21:23:00.867Z",
    "nacimiento": "2023-05-10T21:23:00.867Z",
    "sexo": "s",
    "categoria_titular": "string",
    "clasificacion_afiliado": "string",
    "es_jubilado": true,
    "es_estudiante": true,
    "ultima_modificacion": "2023-05-10T21:23:00.868Z",
    "id_plan": 2147483647,
    "telefono": "string",
    "telefono_emergencia": "string",
    "_id": 2147483647,
    "id_titular": 2147483647,
    "apellidos": "string",
    "nombres": "string",
    "numero_afiliado": "9-19506671-009",
    "es_titular": true,
    "es_afiliado_activo": true,
    "cuit_cuil": "2567323300-5",
    "email": "user@example.com",
    "episodio": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "referencia": "string",
  "created_at": "2023-05-10T21:23:00.868Z",
  "updated_at": "2023-05-10T21:23:00.868Z",
  "tipo": 1,
  "fecha_admision": "2023-05-10T21:23:00.868Z",
  "fecha_egreso": "2023-05-10T21:23:00.868Z",
  "asistencia_respiratoria_mecanica": 2147483647,
  "pedido_asociado": 0,
  "derivacion_asociada": 0
}

Ejemplo

curl -X 'POST' \
  'https://servicios2.test.apross.gov.ar/his/api/episodios/' \
  -H 'accept: application/json' \
  -H 'x-efector-cuit: 20-23651945-8' \
  -H 'Content-Type: application/json' \
  -d '{
  "tipo": 1,
  "fecha_admision": "2022-11-24T13:53:01.409Z",
  "totp": "142857",
  "nro_afiliado": "1-26681266-00-7"
}'

Diagnóstico

Crear un diagnóstico a partir del identificador del episodio generado en el paso anterior (1).

Funcionalidad prevista:

Dado un episodio, este método permite registrar el diagnóstico declarado por el profesional en esta atención.
El diagnóstico pasa a formar parte del historial de diagnósticos del paciente, para ser utilizado luego en otros registros (como la prescripción)
El diagnóstico registrado se utilizará en la valorización del episodio.
Se pueden registrar uno o varios diagnósticos por episodio.
Para cada diagnóstico se puede informar si estuvo presente en la admisión o no (POA).

Petición

POST - his/api/diagnóstico/ | Swagger

Headers

'Accept: application/json'

'x-efector-cuit: *cuit*'

'Content-Type: application/json'

Body

{
  "diagnostico": "R68.8",
  "episodio": "acc85d02-8840-4567-8be5-1bc3181c93a7",
  "fecha": "2022-12-22T13:06:27.832Z",
  "poa": true
}

*Para conseguir el número de diagnóstico (código cie) debemos consultarlo en el siguiente endpoint.

GET /api/his/nomenclador_diagnostico/ - Swagger

{
  "count": 42,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=3",
  "results": [
    {
      "id": 0,
      "codigo_cie": "string", (código buscado)
      "descripcion": "string",
      "clase": "E"
    }
  ]
}

Response

{
  "id": 0,
  "diagnostico": {
    "id": 0,
    "codigo_cie": "string",
    "descripcion": "string",
    "clase": "E"
  },
  "created_at": "2023-05-10T20:26:34.463Z",
  "updated_at": "2023-05-10T20:26:34.463Z",
  "num_autorizacion": 0,
  "poa": true,
  "fecha": "2023-05-10T20:26:34.463Z",
  "episodio": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "efector": 0
}

Ejemplo

curl -X 'POST' \
  'http://localhost:8000/api/diagnostico/' \
  -H 'accept: application/json' \
  -H 'x-efector-cuit: 20-23651945-8' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJyXzJhcHlLbFJaUThuWVQ0Wkl1T1Nla0RqYXNNMFV4QmZrenlDVUdRTVNFIn0.eyJleHAiOjE2ODM2MDgxODksImlhdCI6MTY4MzU3MjE5MCwiYXV0aF90aW1lIjoxNjgzNTcyMTg5LCJqdGkiOiJjZWRlNzljNS0zM2RhLTQ1YzUtOTZmOS1jOGNjYTJmMjk0ZjAiLCJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjkwMDAvYXV0aC9yZWFsbXMvQVBST1NTIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6ImYzMGM4MmQyLTk0OTAtNDgxMy1iODU4LTZjNmMxNzM2NmEwOCIsInR5cCI6IkJlYXJlciIsImF6cCI6ImF1dG9nZXN0aW9uMiIsIm5vbmNlIjoiZmJlODczNGYtZDc5YS00MDViLTgyNzYtMjNhNGQ3NDNiNDU1Iiwic2Vzc2lvbl9zdGF0ZSI6ImJmNDAwMjMyLTQ4OGItNDIzNS04OGM3LTA1NGY1NzAyY2YwZCIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiaHR0cDovL2xvY2FsaG9zdDo4MDgwIiwiaHR0cDovLzE3Mi4yOS4xNzQuMTU3OjgwODAvIiwiaHR0cC8vMTcyLjI5LjE3NC4xNTciLCJodHRwOi8vbG9jYWxob3N0OjUxNzMiLCJodHRwOi8vMTcyLjI5LjE3NC4xNTc6NTE3My8iXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbInByZXN0YWRvciIsIm9mZmxpbmVfYWNjZXNzIiwiZWZlY3RvciIsInVtYV9hdXRob3JpemF0aW9uIiwiZGVmYXVsdC1yb2xlcy1hcHJvc3MiXX0sInJlc291cmNlX2FjY2VzcyI6eyJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6Im9wZW5pZCBwcm9maWxlIGVtYWlsIHJlYWQ6cHJlc2NyaXBjaW9uZXMiLCJzaWQiOiJiZjQwMDIzMi00ODhiLTQyMzUtODhjNy0wNTRmNTcwMmNmMGQiLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsIm5hbWUiOiJFWkVRVUlFTCBHQVNUw5NOIE1BUlRJTkkiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiIyMC0yMzY1MTk0NS04IiwiZ2l2ZW5fbmFtZSI6IkVaRVFVSUVMIEdBU1TDk04iLCJmYW1pbHlfbmFtZSI6Ik1BUlRJTkkiLCJlbWFpbCI6ImV6ZXF1aWVsQGFzZC5jb20ifQ.Dyngpko0FHG_3dJOhEzRkleRq9EFegdbNlpEa3SRbvkTWAYhDkbQHNr1cZwCCxiTtr4GrnDawR2DthHWU53fsoeSz4f7QbCa91bELmHTZ9c5gjtsidpQg4Zcyfzjoe4roMtvX79ItApZ1WW_u05wMInfR_qz6W4hqYi4bD-PuFO5G7f9MfsYbHlKU6LbNAyidYawmyZSSHZm1jU-S_rs21CHHBuZODDL0cWsB2tTH6oBsNPsC8PLHC99OVHWdGJOEh5H55iX6wdXBAPsZboQlqm2ICp0IAqisnTXB98l2TJ6_kZV2gcR5HERPjDiWiCG1rhBaQQY4Ww7VqqlIun1tA' \
  -H 'Content-Type: application/json' \
  -d '{
  "diagnostico": "R68.8",
  "episodio": "acc85d02-8840-4567-8be5-1bc3181c93a7",
  "fecha": "2022-12-22T13:06:27.832Z",
  "poa": true
}'

Prestación

Crear diferentes prestaciones a partir del identificador del episodio generado en el paso 1.

Prestaciones: práctica, receta(prescripción)

3.1. Práctica

Funcionalidad prevista:

Dado un episodio, este método permite registrar la/las prácticas o procedimientos que el profesional o prestador haya brindado al paciente.
La práctica registrada debe pertenecer al nomenclador de Apross.
La práctica registrada se utilizará en la valorización del episodio.
Se pueden registrar una o varias prácticas por episodio.
Sobre cada práctica registrada se realizará una validación mediante reglas de negocios.

Petición

POST - his/api/practica/ | Swagger

Headers

'Accept: application/json'

'x-efector-cuit: *cuit*'

'Content-Type: application/json'

Body

{
  "cantidad": 1,
  "cod_nomenclador": "420101",
  "episodio": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "fecha_intervencion_quirurjica_inicio": "2022-02-10",
  "fecha": "2022-11-24T13:53:01.409Z"
}

Response

{
  "id": 0,
  "nomenclador": {
    "id": 0,
    "codigo": "string",
    "nombre": "string",
    "tipo": 0
  },
  "created_at": "2023-05-10T20:35:25.258Z",
  "updated_at": "2023-05-10T20:35:25.258Z",
  "num_autorizacion": 0,
  "cantidad": 0,
  "tiempo_intervencion_quirurjica": 0,
  "fecha": "2023-05-10T20:35:25.258Z",
  "episodio": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "efector": 0
}

Ejemplo

curl -X 'POST' \
  'http://localhost:8000/api/practica/' \
  -H 'accept: application/json' \
  -H 'x-efector-cuit: 20-23651945-8' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJyXzJhcHlLbFJaUThuWVQ0Wkl1T1Nla0RqYXNNMFV4QmZrenlDVUdRTVNFIn0.eyJleHAiOjE2ODM2MDgxODksImlhdCI6MTY4MzU3MjE5MCwiYXV0aF90aW1lIjoxNjgzNTcyMTg5LCJqdGkiOiJjZWRlNzljNS0zM2RhLTQ1YzUtOTZmOS1jOGNjYTJmMjk0ZjAiLCJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjkwMDAvYXV0aC9yZWFsbXMvQVBST1NTIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6ImYzMGM4MmQyLTk0OTAtNDgxMy1iODU4LTZjNmMxNzM2NmEwOCIsInR5cCI6IkJlYXJlciIsImF6cCI6ImF1dG9nZXN0aW9uMiIsIm5vbmNlIjoiZmJlODczNGYtZDc5YS00MDViLTgyNzYtMjNhNGQ3NDNiNDU1Iiwic2Vzc2lvbl9zdGF0ZSI6ImJmNDAwMjMyLTQ4OGItNDIzNS04OGM3LTA1NGY1NzAyY2YwZCIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiaHR0cDovL2xvY2FsaG9zdDo4MDgwIiwiaHR0cDovLzE3Mi4yOS4xNzQuMTU3OjgwODAvIiwiaHR0cC8vMTcyLjI5LjE3NC4xNTciLCJodHRwOi8vbG9jYWxob3N0OjUxNzMiLCJodHRwOi8vMTcyLjI5LjE3NC4xNTc6NTE3My8iXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbInByZXN0YWRvciIsIm9mZmxpbmVfYWNjZXNzIiwiZWZlY3RvciIsInVtYV9hdXRob3JpemF0aW9uIiwiZGVmYXVsdC1yb2xlcy1hcHJvc3MiXX0sInJlc291cmNlX2FjY2VzcyI6eyJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6Im9wZW5pZCBwcm9maWxlIGVtYWlsIHJlYWQ6cHJlc2NyaXBjaW9uZXMiLCJzaWQiOiJiZjQwMDIzMi00ODhiLTQyMzUtODhjNy0wNTRmNTcwMmNmMGQiLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsIm5hbWUiOiJFWkVRVUlFTCBHQVNUw5NOIE1BUlRJTkkiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiIyMC0yMzY1MTk0NS04IiwiZ2l2ZW5fbmFtZSI6IkVaRVFVSUVMIEdBU1TDk04iLCJmYW1pbHlfbmFtZSI6Ik1BUlRJTkkiLCJlbWFpbCI6ImV6ZXF1aWVsQGFzZC5jb20ifQ.Dyngpko0FHG_3dJOhEzRkleRq9EFegdbNlpEa3SRbvkTWAYhDkbQHNr1cZwCCxiTtr4GrnDawR2DthHWU53fsoeSz4f7QbCa91bELmHTZ9c5gjtsidpQg4Zcyfzjoe4roMtvX79ItApZ1WW_u05wMInfR_qz6W4hqYi4bD-PuFO5G7f9MfsYbHlKU6LbNAyidYawmyZSSHZm1jU-S_rs21CHHBuZODDL0cWsB2tTH6oBsNPsC8PLHC99OVHWdGJOEh5H55iX6wdXBAPsZboQlqm2ICp0IAqisnTXB98l2TJ6_kZV2gcR5HERPjDiWiCG1rhBaQQY4Ww7VqqlIun1tA' \
  -H 'Content-Type: application/json' \
  -d '{
  "cantidad": 1,
  "cod_nomenclador": "420101",
  "episodio": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "fecha_intervencion_quirurjica_inicio": "2022-02-10",
  "fecha": "2022-11-24T13:53:01.409Z"
}'

3.2. Prescripción

Funcionalidad prevista:

Dado un episodio, este método permite registrar la prescripción de tratamientos medicamentosos que el profesional le indica al afiliado.
Cada prescripción estará asociada a un diagnóstico que debe existir en el historial de diagnósticos del afiliado.
Si el consumo del método resulta exitoso, significa que la prescripción ya fue enviada tanto a las farmacias (vía integración) como al paciente (en su celular).
Se pueden registrar una o varias prescripciones por episodio.
Sobre cada prescripción registrada se realizará una validación mediante reglas de negocios.

Petición

POST - his/api/prescripcion/ | Swagger

Headers

'Accept: application/json'

'x-efector-cuit: *cuit*'

'Content-Type: application/json'

Body

{
  "episodio": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "prescripciones": [
    {
      "monodroga": "ibuprofeno",
      "presentacion": "comp.x 20",
      "cobertura": "Cobertura 50%",
      "empadronamiento": false,
      "diagnostico": 1,
      "cantidad": 1,
      "indicacion_comercial": 3744,
      "indicacion_cantidad": 1,
      "indicacion_presentacion": "Comprimido",
      "indicacion_periodicidad": 5,
      "indicacion_duracion": 5,
      "fecha_inicio": "2023-05-10"
    }
  ]
}

Response

{
  "id": 0,
  "prescripciones": [
    {
      "id": 0,
      "estado": {
        "tipo": 0,
        "fecha_desde": "2023-05-10T20:37:39.105Z",
        "fecha_hasta": "2023-05-10T20:37:39.105Z"
      },
      "es_transcripcion": true,
      "fecha_fin": "2023-05-10",
      "monodroga": "string",
      "presentacion": "string",
      "indicacion_comercial": {
        "id": 0,
        "troquel": 0,
        "nombre": "string",
        "presentacion": "string",
        "tipo_venta": 1,
        "iva": true,
        "codigo_barra": "string",
        "unidades": 0,
        "tamano": "1",
        "sifar": true,
        "gravamen": true
      },
      "indicacion_duracion": "7776000.0",
      "created_at": "2023-05-10T20:37:39.105Z",
      "updated_at": "2023-05-10T20:37:39.105Z",
      "codigo_referencia": "string",
      "numero_formulario": "string",
      "matricula": "string",
      "medico_original_nombre": "string",
      "medico_original_matricula": "string",
      "cantidad": 0,
      "indicacion_cantidad": 0,
      "indicacion_presentacion": "string",
      "indicacion_periodicidad": 0,
      "fecha_inicio": "2023-05-10",
      "observaciones": "string",
      "es_prolongado": true,
      "diagnostico": 0
    }
  ],
  "created_at": "2023-05-10T20:37:39.105Z",
  "updated_at": "2023-05-10T20:37:39.105Z",
  "num_autorizacion": 0,
  "nombre_plantilla": "string",
  "episodio": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "efector": 0
}

Ejemplo

curl -X 'POST' \
  'http://localhost:8000/api/prescripcion/' \
  -H 'accept: application/json' \
  -H 'x-efector-cuit: 20-23651945-8' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJyXzJhcHlLbFJaUThuWVQ0Wkl1T1Nla0RqYXNNMFV4QmZrenlDVUdRTVNFIn0.eyJleHAiOjE2ODM2MDgxODksImlhdCI6MTY4MzU3MjE5MCwiYXV0aF90aW1lIjoxNjgzNTcyMTg5LCJqdGkiOiJjZWRlNzljNS0zM2RhLTQ1YzUtOTZmOS1jOGNjYTJmMjk0ZjAiLCJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjkwMDAvYXV0aC9yZWFsbXMvQVBST1NTIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6ImYzMGM4MmQyLTk0OTAtNDgxMy1iODU4LTZjNmMxNzM2NmEwOCIsInR5cCI6IkJlYXJlciIsImF6cCI6ImF1dG9nZXN0aW9uMiIsIm5vbmNlIjoiZmJlODczNGYtZDc5YS00MDViLTgyNzYtMjNhNGQ3NDNiNDU1Iiwic2Vzc2lvbl9zdGF0ZSI6ImJmNDAwMjMyLTQ4OGItNDIzNS04OGM3LTA1NGY1NzAyY2YwZCIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiaHR0cDovL2xvY2FsaG9zdDo4MDgwIiwiaHR0cDovLzE3Mi4yOS4xNzQuMTU3OjgwODAvIiwiaHR0cC8vMTcyLjI5LjE3NC4xNTciLCJodHRwOi8vbG9jYWxob3N0OjUxNzMiLCJodHRwOi8vMTcyLjI5LjE3NC4xNTc6NTE3My8iXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbInByZXN0YWRvciIsIm9mZmxpbmVfYWNjZXNzIiwiZWZlY3RvciIsInVtYV9hdXRob3JpemF0aW9uIiwiZGVmYXVsdC1yb2xlcy1hcHJvc3MiXX0sInJlc291cmNlX2FjY2VzcyI6eyJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6Im9wZW5pZCBwcm9maWxlIGVtYWlsIHJlYWQ6cHJlc2NyaXBjaW9uZXMiLCJzaWQiOiJiZjQwMDIzMi00ODhiLTQyMzUtODhjNy0wNTRmNTcwMmNmMGQiLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsIm5hbWUiOiJFWkVRVUlFTCBHQVNUw5NOIE1BUlRJTkkiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiIyMC0yMzY1MTk0NS04IiwiZ2l2ZW5fbmFtZSI6IkVaRVFVSUVMIEdBU1TDk04iLCJmYW1pbHlfbmFtZSI6Ik1BUlRJTkkiLCJlbWFpbCI6ImV6ZXF1aWVsQGFzZC5jb20ifQ.Dyngpko0FHG_3dJOhEzRkleRq9EFegdbNlpEa3SRbvkTWAYhDkbQHNr1cZwCCxiTtr4GrnDawR2DthHWU53fsoeSz4f7QbCa91bELmHTZ9c5gjtsidpQg4Zcyfzjoe4roMtvX79ItApZ1WW_u05wMInfR_qz6W4hqYi4bD-PuFO5G7f9MfsYbHlKU6LbNAyidYawmyZSSHZm1jU-S_rs21CHHBuZODDL0cWsB2tTH6oBsNPsC8PLHC99OVHWdGJOEh5H55iX6wdXBAPsZboQlqm2ICp0IAqisnTXB98l2TJ6_kZV2gcR5HERPjDiWiCG1rhBaQQY4Ww7VqqlIun1tA' \
  -H 'Content-Type: application/json' \
  -d '{
  "episodio": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "prescripciones": [
    {
      "monodroga": "ibuprofeno",
      "presentacion": "comp.x 20",
      "cobertura": "Cobertura 50%",
      "empadronamiento": false,
      "diagnostico": 1,
      "cantidad": 1,
      "indicacion_comercial": 3744,
      "indicacion_cantidad": 1,
      "indicacion_presentacion": "Comprimido",
      "indicacion_periodicidad": 5,
      "indicacion_duracion": 5,
      "fecha_inicio": "2023-05-10"
    }
  ]
}'

Nota de Alta

Generar una nota de alta a partir del identificador del episodio generado en el paso 1.

Funcionalidad prevista:

Dado un episodio, este método permite registrar la nota de egreso del afiliado. Representa el fin de la atención del día de la fecha y su efecto inmediato es que cierra el episodio.
Todos los episodios abiertos por el prestador deben ser cerrados para poder valorizarse.
Para cerrar un episodio se debe haber registrado previamente al menos un diagnóstico y al menos una práctica.
Una vez cerrado el episodio, ya no se pueden registrar prestaciones en él.

Petición

POST - his/api/nota_alta/ | Swagger

Headers

'Accept: application/json'

'x-efector-cuit: *cuit*'

'Content-Type: application/json'

Body

{
  "descripcion": "Nota de alta",
  "episodio": "0f514830-c0a4-449b-9446-693b845e6507",
  "tipo": 0,
  "fecha_egreso": "2022-12-26T18:55:07.367Z"
}

Response

{
  "id": 0,
  "registro_clinico": {
    "id": 0,
    "num_autorizacion": 0,
    "tipo": 0,
    "episodio": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "efector": 0
  },
  "created_at": "2023-05-10T20:41:43.727Z",
  "updated_at": "2023-05-10T20:41:43.727Z",
  "descripcion": "string",
  "tipo": 0
}

Ejemplo

curl -X 'POST' \
  'http://localhost:8000/api/nota_alta/' \
  -H 'accept: application/json' \
  -H 'x-efector-cuit: 20-23651945-8' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJyXzJhcHlLbFJaUThuWVQ0Wkl1T1Nla0RqYXNNMFV4QmZrenlDVUdRTVNFIn0.eyJleHAiOjE2ODM2MDgxODksImlhdCI6MTY4MzU3MjE5MCwiYXV0aF90aW1lIjoxNjgzNTcyMTg5LCJqdGkiOiJjZWRlNzljNS0zM2RhLTQ1YzUtOTZmOS1jOGNjYTJmMjk0ZjAiLCJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjkwMDAvYXV0aC9yZWFsbXMvQVBST1NTIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6ImYzMGM4MmQyLTk0OTAtNDgxMy1iODU4LTZjNmMxNzM2NmEwOCIsInR5cCI6IkJlYXJlciIsImF6cCI6ImF1dG9nZXN0aW9uMiIsIm5vbmNlIjoiZmJlODczNGYtZDc5YS00MDViLTgyNzYtMjNhNGQ3NDNiNDU1Iiwic2Vzc2lvbl9zdGF0ZSI6ImJmNDAwMjMyLTQ4OGItNDIzNS04OGM3LTA1NGY1NzAyY2YwZCIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiaHR0cDovL2xvY2FsaG9zdDo4MDgwIiwiaHR0cDovLzE3Mi4yOS4xNzQuMTU3OjgwODAvIiwiaHR0cC8vMTcyLjI5LjE3NC4xNTciLCJodHRwOi8vbG9jYWxob3N0OjUxNzMiLCJodHRwOi8vMTcyLjI5LjE3NC4xNTc6NTE3My8iXSwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbInByZXN0YWRvciIsIm9mZmxpbmVfYWNjZXNzIiwiZWZlY3RvciIsInVtYV9hdXRob3JpemF0aW9uIiwiZGVmYXVsdC1yb2xlcy1hcHJvc3MiXX0sInJlc291cmNlX2FjY2VzcyI6eyJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6Im9wZW5pZCBwcm9maWxlIGVtYWlsIHJlYWQ6cHJlc2NyaXBjaW9uZXMiLCJzaWQiOiJiZjQwMDIzMi00ODhiLTQyMzUtODhjNy0wNTRmNTcwMmNmMGQiLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsIm5hbWUiOiJFWkVRVUlFTCBHQVNUw5NOIE1BUlRJTkkiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiIyMC0yMzY1MTk0NS04IiwiZ2l2ZW5fbmFtZSI6IkVaRVFVSUVMIEdBU1TDk04iLCJmYW1pbHlfbmFtZSI6Ik1BUlRJTkkiLCJlbWFpbCI6ImV6ZXF1aWVsQGFzZC5jb20ifQ.Dyngpko0FHG_3dJOhEzRkleRq9EFegdbNlpEa3SRbvkTWAYhDkbQHNr1cZwCCxiTtr4GrnDawR2DthHWU53fsoeSz4f7QbCa91bELmHTZ9c5gjtsidpQg4Zcyfzjoe4roMtvX79ItApZ1WW_u05wMInfR_qz6W4hqYi4bD-PuFO5G7f9MfsYbHlKU6LbNAyidYawmyZSSHZm1jU-S_rs21CHHBuZODDL0cWsB2tTH6oBsNPsC8PLHC99OVHWdGJOEh5H55iX6wdXBAPsZboQlqm2ICp0IAqisnTXB98l2TJ6_kZV2gcR5HERPjDiWiCG1rhBaQQY4Ww7VqqlIun1tA' \
  -H 'Content-Type: application/json' \
  -d '{
  "descripcion": "Nota de alta",
  "episodio": "0f514830-c0a4-449b-9446-693b845e6507",
  "tipo": 0,
  "fecha_egreso": "2022-12-26T18:55:07.367Z"
}'

Related Articles
Bitácora de cambios EMD
El presente documento se actualiza con cada cambio importante en el EMD. Recomendamos revisar este documento con frecuencia o cada vez que encuentre un cambio en la herramienta. Adjuntamos en cada registro suficiente información para que usted pueda ...
Servicio de registro de prestaciones
La integración completa con Apross incluye 3 componentes. La autorización de las prestaciones. El registro de prestaciones. El registro de prescripciones. En el presente documento se define técnicamente cómo interoperar con Apross a efectos de ...
Servicio de Autorización de prestaciones.
La integración completa con Apross incluye 3 componentes. La autorización de las prestaciones. El registro de prestaciones. El registro de prescripciones. En el presente documento se define técnicamente cómo interoperar con Apross a efectos de ...
Nueva receta electrónica de A.P.R.O.S.S.
Con el objetivo de simplificar la Recepción de la medicación recetada por parte de los beneficiarios de A.P.R.O.S.S. y mejorar la transparencia en la gestión de las Prescripciones de Medicamentos, A.P.R.O.S.S. a puesto a disposición para todos los/as ...

Integración a los servicios de EMD APROSS

Integración a los servicios de EMD APROSS

Objetivos del documento

Protocolo de transporte

Método de transporte

Protocolo de API

Seguridad API

API

Autenticación

Códigos de estado HTTP generales

200 - 201 - Success

{ "detail": "Success" }

500 - Internal Server Error

{ "detail": "Error al conectarse con un servicio externo" }

503 - Service Unavailable

{ "detail": "Ocurrio un error al obtener información sobre la autenticación" }

422 - Unprocessable Entity (Validation Error)

{ "detail": "El episodio tiene que tener al menos un diagnostico y una practica asociada" }

403 - Forbidden

{ "detail": "No tiene los permisos para realizar esta acción" }

401 - Unauthorized

Manejo de la API

Episodio

Petición

POST - /his/api/episodios/ | Swagger

Headers

Body

{ "tipo": 1, "fecha_admision": "2022-11-24T13:53:01.409Z", "totp": "142857", "nro_afiliado": "1-26681266-00-7" }

Response

Ejemplo

Diagnóstico

Petición

POST - his/api/diagnóstico/ | Swagger

Headers

Response

Prestación

3.1. Práctica

Body

Response

3.2. Prescripción

Headers

Body

Response

Ejemplo

Nota de Alta

Headers

Body

Response

Related Articles

Bitácora de cambios EMD

Servicio de registro de prestaciones

Servicio de Autorización de prestaciones.

Nueva receta electrónica de A.P.R.O.S.S.

`{ "detail": "Success" }`

`{ "detail": "Error al conectarse con un servicio externo" }`

`{ "detail": "Ocurrio un error al obtener información sobre la autenticación" }`

`{ "detail": "El episodio tiene que tener al menos un diagnostico y una practica asociada" }`

`{ "detail": "No tiene los permisos para realizar esta acción" }`

`{ "tipo": 1, "fecha_admision": "2022-11-24T13:53:01.409Z", "totp": "142857", "nro_afiliado": "1-26681266-00-7" }`