Guía de Implmentación FHIR ADRES (Core) - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

• Narrative Content
• JSON

OperationDefinition: Consulta detallada BDUA ($bdua-detalle)

La operación $bdua-detalle permite consultar la información detallada de afiliación y estado de un usuario en el Sistema General de Seguridad Social en Salud (SGSSS) en Colombia, a través del servicio BDUA (Base de Datos Única de Afiliación). La operación está diseñada para ser utilizada por sistemas de información de salud y aplicaciones que necesiten acceder a los datos de afiliación de los usuarios del SGSSS, garantizando la interoperabilidad y el cumplimiento del estándar internacional HL7 FHIR.

Esta operación no es pública y su uso está restringido a aplicaciones de ADRES y entidades adscritas al Ministerio de Salud y Protección Social de Colombia.

Input

La operación $bdua-detalle requiere un recurso de tipo Parameters como entrada, que contenga los parámetros necesarios para realizar la consulta. Los parámetros esperados son:

• Tipo de documento de identidad del usuario (por ejemplo, CC, CE, TI, etc.).
• Número o cadena alfanumérica del documento de identidad del usuario.

La definición del recurso Parameters para la operación $bdua-detalle se encuentra en el perfil ParametersQueryBDUA, que especifica la estructura y los elementos requeridos para la solicitud.

Output

La respuesta de la operación $bdua-detalle es un recurso de tipo Bundle que contiene los recursos relacionados con la información de afiliación del usuario consultado. El Bundle puede incluir recursos correspondientes a los perfiles paciente, persona, cobertura de salud y EAPBS, dependiendo de la información disponible en el BDUA para el usuario consultado.

A diferencia de la operación $bdua, la operación $bdua-detalle proporciona información más completa y detallada sobre el usuario consultado, incluyendo datos adicionales sobre la persona que desempeña el rol de paciente o usuario del sistema de salud, así como información más específica sobre las coberturas de salud anteriores y las EAPBS asociadas.

Interacción

El siguiente diagrama UML ilustra la interacción entre el cliente que realiza la consulta y el servicio FHIR que proporciona la información de afiliación a través de la operación $bdua:

Ejemplos:

Método y Endpoint

POST [base]/Patient/$bdua-detalle

Cuerpo de la solicitud

{
  "resourceType": "Parameters",
  "meta": {
    "profile": [
      "https://fhir.adres.gov.co/core/StructureDefinition/ParametersQueryBDUA"
    ]
  },
  "parameter": [
    {
      "part": [
        {
          "name": "type",
          "valueString": "CC"
        },
        {
          "name": "value",
          "valueString": "665544332211"
        }
      ],
      "name": "identifier"
    }
  ]
}

Cuerpo de la respuesta

{
  "resourceType": "Bundle",
  "id": "Bundle-Respuesta-bdua-50bdf824",
  "type": "searchset",
  "total": 3,
  "entry": [
    {
      "resource": {
        "resourceType": "Patient",
        ...
      }
    },
    {
      "resource": {
        "resourceType": "Person",
        ...
      }
    },
    {
      "resource": {
        "resourceType": "Coverage",
        ...
      }
    },
    {
      "resource": {
        "resourceType": "Coverage",
        ...
      }
    },
    ...
    {
      "resource": {
        "resourceType": "Organization",
        ...
      }
    }
    ...
    {
      "resource": {
        "resourceType": "Organization",
        ...
      }
    }
  ]
}

Ejemplos de solicitud y respuesta