Servicio de registro de prestaciones

Servicio de registro de prestaciones

La integración completa con Apross incluye 3 componentes.
  1. La autorización de las prestaciones.
  2. El registro de prestaciones.
  3. El registro de prescripciones.

En el presente documento se define técnicamente cómo interoperar con Apross a efectos de registrar una prestación.


Resumen

Las prestaciones recibidas ya han sido previamente autorizadas, por lo cual se entiende que son prestaciones efectivamente brindadas.
Con la información recibida, se procede a generar la liquidación mediante el flujo de GRD.

Protocolo de transporte: https
Metodo de trasnporte : post
Protocolo de servicio web: REST API
Seguridad: HTTP Basic Auth

Request

Headers

'Content-Type: application/json'
'Basic Auth: <username>:<password>'

Body

Los datos a transmitir serán estos:

Nombre
Tipo de dato
Descripción
numero_afiliado
string
Identificación numérica del Documento Nacional de Identidad (DNI) del afiliado.
  1. Not null.
numero_evento
string
Identificación numérica de episodio, atención, evento.
  1. Not null.
numero_autorizacion
string
Identificación alfanumérica de la autorización. Resultado del campo idValidacion del servicio de autorización de prestaciones.
  1. Not null.
tipo_episodio
int
(1 - 6)
  1. Opcional: valor por defecto 6 (Varios).
  2. Rango 1 - 6:
    1. Atención médica ambulatoria.
    2. Hospitalización.
    3. Métodos complementarios: diagnósticos por imágenes / laboratorio bioquímico / anatomía patológica / genética medicina nuclear microbiología.
    4. Otros servicios de salud: oncología & oncohematologia / dialisis ambulatoria / rehabilitacion / salud mental / nutrición anestesia / radioterapia / fertilización asistida / hemoterapia & hematologia.
    5. Medicamentos
    6. Varios: discapacidad / odontologia / insumos, dispositivos, protesis & ortesis / internacion domiciliaria / traslados / emergencia movil / inmunizacion / oxigenoterapia / hospitalizacion de larga estancia / varios.
    id_prestador
    		int
    Código de identificación del prestador donde se lleva a cabo el episodio, evento, atención.
    1. Not null.
    desc_prestador
    		string
    Descripción del prestador donde se lleva a cabo el episodio, evento, atención.
    1. Not null.
    id_efector
    		int
    Código de identificación del efector que indica el episodio, evento, atención.
    1. Not null.
    nombre_efector
    string
    Descripción del efector que indica el episodio, evento, atención.
    1. Not null.
    id_prescriptor
    int
    Código de identificación del prescriptor que indica el episodio, evento, atención en caso de corresponder.
    1. Opcional.
    nombre_prescriptor
    string
    Descripción del prescriptor que indica el episodio, evento, atención en caso de corresponder.
    1. Opcional
    fecha_ingreso
    string
    (ISO Date)
    Fecha ingreso-atención del afiliado en GMT. Se considera Fecha de ingreso para los pacientes hospitalizados y Fecha de atención para los pacientes ambulatorios.
    1. Not null.
    2. Validación de fecha + hora (ISO Date).
    fecha_egreso
    string
    Fecha egreso del afiliado en GMT.
    1. Opcional: se iguala con fecha_ingreso de ser nulo.
    2. Validación de fecha + hora (ISO Date).
    via_ingreso
    int
    (1 - 8)
    1. Opcional: valor por defecto 8 (Otro).
    2. Rango 1 - 8
      1. Urgencias o guardia
      2. Consulta externa ó programada
      3. Remitido
      4. Nacido en la institución
      5. Diálisis
      6. Oncología
      7. Cirugía ambulatoria
      8. Otro
    estado_salida
    int
    (1 - 9)
    1. Opcional: valor por defecto 9 (Otro).
    2. Rango 1 - 9
      1. Alta médica
      2. A domicilio
      3. Alta médica a residencia
      4. Traslado a otra institución
      5. Alta voluntaria
      6. Defunción
      7. Internación domiciliaria
      8. Fuga
      9. Otro
    diagnosticos
    		array de objetos del tipo { diagnostico: string, poa: string }
    Diagnosticos adicionales e identificadores “POA” asociados (present on admisión) para cada uno de los diagnosticos. Ordenados según prioridad,el primero es el principal, si la institución no registra este dato se debe dejar el espacio en blanco. Se recomienda que formato de los diagnosticos en CIE-10 contengan los "." separando entre padres e hijos correspondientes.
    1. Validación: CIE-10.
    2. El campo POA es una enumeración string tal que:
      1. "S" = Presente en el momento del ingreso hospitalario.
      2. "N" = No presente en el momento del ingreso hospitalario (valor por defecto).
    fecha_intervencion
    string
    (ISO Date)
    Fecha de la primera intervención quirúrgica del afiliado en GMT.
    1. Opcional.
    2. Validación de fecha + hora (ISO Date).
    tiempo_intervencion
    		float
    Horas de asistencia quirurgica, decimal con punto.
    1. Opcional: valor por defecto 0.0.
    2. Validación de decimal con punto (".").
    tiempo_ventilacion
    		float
    Horas de ventilación mecánica invasiva.
    1. Opcional: valor por defecto 0.0.
    2. Validación de decimal con punto (".").
    practicas
    		Practica[]Lista de practicas realizadas en el episodio.

    Practica


    Nombre
    Tipo de dato
    Descripción​​
    codigo
    string
    Código que identifica a la Prestacion, Insumo, Dispositivo, Prótesis, Órtesis de acuerdo al nomenclador utilizado.
    1. Not null.
    2. Validación de alfanumérico y "-" "_" "/".
    fecha
    string
    (ISO Date)
    Fecha de la prestación del afiliado.
    1. Not null.
    2. Validación de fecha + hora (ISO Date).
    cantidad
    float
    Cantidad prestación o práctica, acumulativa.
    1. Not null.
    2. Validación de decimal con punto (".").


    Formato

    El Json de entrada tendrá la siguiente forma.
    FORMATO DEL REQUEST:

    {
        "numero_afiliado": "string", 
        "numero_evento": "int",
        "numero_autorizacion": "string",
        "tipo_episodio": "enum",
        "id_prestador": "int",
        "desc_prestador": "string",
        "id_efector": "string", 
        "nombre_efector": "string",
        "id_prescriptor": "string",
        "nombre_prescriptor": "string",
        "fecha_ingreso": "1970-01-01T00:00:00Z    ",
        "fecha_egreso": "1970-01-01T00:00:00Z",
        "via_ingreso": "enum",
        "estado_salida": "enum",
        "diagnosticos": [
            {
                "cie10": "string",
                "poa" : "string"
            },
            {
                "cie10": "string",
                "poa": "string"
            }
        ],
        "fecha_intervencion": "1970-01-01T00:00:00Z",
        "tiempo_intervencion": "float",
        "tiempo_ventilacion": "float",
    "practicas": [
        {
            "codigo": "string", 
            "fecha": "1970-01-01T00:00:00Z",
            "cantidad": "float"
        },
            {
            "codigo": "string", 
            "fecha": "1970-01-01T00:00:00Z",
            "cantidad": "float"
        }
    ]
    }

    Ejemplo

    cURL

    curl --location --request POST 'https://servicios2.apross.gov.ar/v1/practicas' \
      --user <username>:<password> \
      --header 'Content-Type: application/json' \
      --data-raw '{
        "numero_afiliado": "26681266",
        "numero_evento": "E15",
        "numero_autorizacion": "2yub69m323m4cz4q6og",
        "tipo_episodio": 6,
        "id_prestador": "20-26681266-1",
        "desc_prestador": "Roberto",
        "id_efector": "20-26681266-1",
        "nombre_efector": "Francisco",
        "id_prescriptor": null,
        "nombre_prescriptor": null,
        "fecha_ingreso": "2022-08-01T10:00:00",
        "fecha_egreso": "2022-08-01T10:00:00",
        "via_ingreso": 8,
        "estado_salida": 9,
        "diagnosticos": [
            {
                "cie10": "A08.4",
                "poa": "S"
            },
            {
                "cie10": "A08.4",
                "poa": "N"
            }
        ],
        "fecha_intervencion": null,
        "tiempo_intervencion": 0.0,
        "tiempo_ventilacion": 0.0,
        "practicas": [
            {
                "codigo": "2605",
                "fecha": "2022-08-01T10:00:00",
                "cantidad": 1.0
            },
            {
                "codigo": "2605",
                "fecha": "2022-08-01T10:00:00",
                "cantidad": 2.0
            }
        ]
    }'

    Response

    Formato

    {
        "success": "bool",
        "message": "string",
        "response": {
            "codigo": "int",
            "descripcion": "string"
        }
    }

    Ejemplo

    Success

    {
    "success": true,
    "message": "Item creado con exito",
    "response": {
        "codigo": 0,
        "description": {
            "numero_afiliado": "26681266",
            "numero_evento": "E15",
            "numero_autorizacion": "2yub69m323m4cz4q6og",
            "tipo_episodio": 6,
            "id_prestador": "20-26681266-1",
            "desc_prestador": "Roberto",
            "id_efector": "20-26681266-1",
            "nombre_efector": "Francisco",
            "id_prescriptor": null,
            "nombre_prescriptor": null,
            "fecha_ingreso": "2022-08-01T10:00:00",
            "fecha_egreso": "2022-08-01T10:00:00",
            "via_ingreso": 8,
            "estado_salida": 9,
            "diagnosticos": [
                {
                    "cie10": "A08.4",
                    "poa": "S"
                },
                {
                    "cie10": "A08.4",
                    "poa": "N"
                }
            ],
            "fecha_intervencion": null,
            "tiempo_intervencion": 0.0,
            "tiempo_ventilacion": 0.0,
            "practicas": [
                {
                    "codigo": "2605",
                    "fecha": "2022-08-01T10:00:00",
                    "cantidad": 1.0
                },
                {
                    "codigo": "2605",
                    "fecha": "2022-08-01T10:00:00",
                    "cantidad": 2.0
                }
            ],
            "created_at": "2022-08-01T10:00:00",
            "updated_at": "2022-08-01T10:00:00"
        }
    }
}

    Error

    En el caso de un error sobre los campos del body:
    {
    "success": false,
    "message": "Error",
    "response": {
        "codigo": -1,
        "description": [
            {
                "loc": [
                    "estado_salida"
                ],
                "msg": "value is not a valid integer",
                "type": "type_error.integer"
            }
        ]
    }
}
    En el caso de basic auth error:
    {"detail":"Incorrect credentials"}


    Nomenclador de Apross

    Nomenclador de APROSS: Descargar

      • Related Articles

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

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

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

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