Búsqueda de DiagnosticReport

Esta sección describe cómo buscar informes de diagnóstico utilizando el identificador del integrador.

Solicitud

La búsqueda se realiza mediante una solicitud GET al endpoint de DiagnosticReport, utilizando el parámetro identifier para localizar informes por su identificador único en el sistema del integrador.

Parámetros de búsqueda

• identifier (obligatorio): Identificador del informe en formato system|value. Corresponde al campo DiagnosticReport.identifier informado durante la publicación.
  • system: URI que define el namespace del identificador.
  • value: Identificador único del informe dentro del namespace.
  • Ejemplo: https://misistema.com/laboratorio/informes|INF-2024-000123

Nota

La búsqueda por identifier utiliza la misma combinación de system y value que se documenta en la sección de Identificadores del endpoint de publicación.

GET/fhir/r4/DiagnosticReport?identifier={system|value}

Busca un DiagnosticReport por su identificador único (system|value).

Ejemplo de Solicitud

GET /fhir/r4/DiagnosticReport?identifier=https://misistema.com/laboratorio/informes|INF-2024-000123

Ejemplo de Respuesta

{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "fullUrl": "https://api.quralo.com/fhir/r4/DiagnosticReport/3a7c9f3e-1b2d-4e5f-8a9b-0c1d2e3f4a5b",
      "resource": {
        "resourceType": "DiagnosticReport",
        "id": "3a7c9f3e-1b2d-4e5f-8a9b-0c1d2e3f4a5b",
        "identifier": [
          {
            "system": "https://misistema.com/laboratorio/informes",
            "value": "INF-2024-000123"
          }
        ],
        "status": "final",
        "code": {
          "coding": [
            {
              "system": "http://loinc.org",
              "code": "11579-0",
              "display": "Laboratorio clinico"
            }
          ]
        },
        "subject": {
          "reference": "Patient/4b8d2a1e-3c5f-4e6d-9a7b-8c0d1e2f3a4b"
        },
        "effectiveDateTime": "2024-07-09T10:00:00Z",
        "conclusion": "Valores dentro de rangos normales."
      }
    }
  ]
}

Códigos de Respuesta

Código: 200 OK

Búsqueda exitosa. Retorna un Bundle de tipo searchset con los resultados.

Código: 400 Bad Request

Si el parámetro identifier no tiene el formato esperado (system|value).

Headers

• Content-Type: application/fhir+json

Ejemplo de Respuesta

{
  "resourceType": "OperationOutcome",
  "issue": [
      {
          "severity": "error",
          "code": "structure",
          "diagnostics": "Invalid identifier format. Expected format: system|value"
      }
  ]
}

Código: 401 Unauthorized

Si el token de autorización no es válido o no está presente.

Headers

• Content-Type: application/fhir+json

Ejemplo de Respuesta

{
  "resourceType": "OperationOutcome",
  "issue": [
      {
          "severity": "error",
          "code": "security",
          "diagnostics": "Authentication is required to access this resource."
      }
  ]
}