Download documentation/openapi_m1.json from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 125 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/4eccb2b8e83a8b064677e4d747ba13f326490a50/documentation/openapi_m1.json
- Command line
-
hf download hf://spaces/Modulo-6/api@4eccb2b8e83a8b064677e4d747ba13f326490a50/documentation/openapi_m1.json
-
curl -L -o openapi_m1.json https://huggingface.co/spaces/Modulo-6/api/resolve/4eccb2b8e83a8b064677e4d747ba13f326490a50/documentation/openapi_m1.json
125 kB
| {"openapi":"3.1.0","info":{"title":"API Módulo 1 - Historia Clínica Electrónica (HCE)","description":"Repositorio central de datos médicos del sistema Health Grid. Gestiona consultas, diagnósticos, tratamientos y fichas médicas.","version":"1.0.0"},"paths":{"/api/v1/dev/paciente":{"post":{"tags":["🔧 Desarrollo"],"summary":"[DEV] Crear o confirmar paciente de prueba en la caché local","description":"Inserta un paciente en la tabla local de HCE si no existe. Necesario antes de crear episodios en desarrollo.","operationId":"dev_crear_paciente_api_v1_dev_paciente_post","parameters":[{"name":"id_paciente","in":"query","required":false,"schema":{"type":"integer","default":10500,"title":"Id Paciente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/dev/login":{"post":{"tags":["🔧 Desarrollo"],"summary":"[DEV] Obtener token JWT de desarrollo","description":"Genera un JWT firmado con la misma clave que Core (M10). El token funciona en todos los endpoints protegidos.\n\n**Sin body**: genera token con el usuario por defecto (dr.dev, rol médico, todos los permisos).\n\n**Con body**: permite personalizar sub, username, role, permissions y duración.","operationId":"dev_login_api_v1_dev_login_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DevLoginRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DevLoginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/dev/simulador":{"get":{"tags":["🔧 Desarrollo"],"summary":"[DEV] Panel de Simulación de Integraciones","description":"Interfaz interactiva para testear y simular las llamadas de los Módulos 2, 3, 4 y 5.","operationId":"dev_simulador_api_v1_dev_simulador_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/v1/pacientes/{id_paciente}/ficha-medica":{"post":{"tags":["Ficha Médica (HCE)"],"summary":"Crear ficha médica de un paciente","description":"Crea la ficha médica permanente de un paciente en la Historia Clínica. Contiene datos clínicos estáticos como grupo sanguíneo, peso, altura y observaciones generales. Solo puede existir una ficha por paciente.","operationId":"crear_ficha_medica_api_v1_pacientes__id_paciente__ficha_medica_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FichaMedicaCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FichaMedicaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"409":{"description":"Ya existe una ficha médica para este paciente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Ficha Médica (HCE)"],"summary":"Obtener ficha médica de un paciente","description":"Retorna los datos clínicos permanentes del paciente registrados en su ficha médica.","operationId":"obtener_ficha_medica_api_v1_pacientes__id_paciente__ficha_medica_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FichaMedicaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Ficha Médica (HCE)"],"summary":"Actualizar ficha médica de un paciente","description":"Actualiza parcialmente la ficha médica del paciente. Solo se modifican los campos enviados en el body.","operationId":"actualizar_ficha_medica_api_v1_pacientes__id_paciente__ficha_medica_patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FichaMedicaUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FichaMedicaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes/{id_paciente}/ficha-completa":{"post":{"tags":["Ficha Médica (HCE)"],"summary":"Registrar ficha médica completa (con antecedentes y alertas)","description":"Crea de forma atómica la ficha médica del paciente junto con sus antecedentes y alertas clínicas en una sola transacción.","operationId":"crear_ficha_medica_completa_api_v1_pacientes__id_paciente__ficha_completa_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FichaMedicaCompletaCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FichaMedicaCompletaResponse"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Paciente no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes/{id_paciente}/antecedentes":{"get":{"tags":["Ficha Médica — Antecedentes"],"summary":"Listar antecedentes clínicos de un paciente","description":"Retorna todos los antecedentes registrados del paciente.","operationId":"listar_antecedentes_api_v1_pacientes__id_paciente__antecedentes_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AntecedenteSchema"},"title":"Response Listar Antecedentes Api V1 Pacientes Id Paciente Antecedentes Get"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Paciente no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Ficha Médica — Antecedentes"],"summary":"Registrar un antecedente clínico","description":"Agrega un nuevo antecedente al historial clínico del paciente.","operationId":"crear_antecedente_api_v1_pacientes__id_paciente__antecedentes_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AntecedenteCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AntecedenteSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Paciente no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes/{id_paciente}/antecedentes/{id_antecedente}":{"patch":{"tags":["Ficha Médica — Antecedentes"],"summary":"Actualizar un antecedente clínico","description":"Actualización parcial de un antecedente. Solo se pisan los campos enviados.","operationId":"actualizar_antecedente_api_v1_pacientes__id_paciente__antecedentes__id_antecedente__patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_antecedente","in":"path","required":true,"schema":{"type":"integer","title":"Id Antecedente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AntecedenteUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AntecedenteSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes/{id_paciente}/alertas":{"get":{"tags":["Ficha Médica — Alertas Clínicas"],"summary":"Listar alertas clínicas de un paciente","description":"Retorna todas las alertas del paciente (Activas y Resueltas).","operationId":"listar_alertas_api_v1_pacientes__id_paciente__alertas_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AlertaSchema"},"title":"Response Listar Alertas Api V1 Pacientes Id Paciente Alertas Get"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Paciente no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Ficha Médica — Alertas Clínicas"],"summary":"Registrar una alerta clínica","description":"Crea una nueva consideración/alerta de seguridad para el paciente.","operationId":"crear_alerta_api_v1_pacientes__id_paciente__alertas_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertaCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Paciente no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes/{id_paciente}/alertas/{id_alerta}":{"patch":{"tags":["Ficha Médica — Alertas Clínicas"],"summary":"Resolver una alerta clínica","description":"Cambia el estado de la alerta a Resuelta y registra la resolución.","operationId":"resolver_alerta_api_v1_pacientes__id_paciente__alertas__id_alerta__patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_alerta","in":"path","required":true,"schema":{"type":"integer","title":"Id Alerta"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertaUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/patients/{id_paciente}/episodes":{"get":{"tags":["Atención Clínica — Episodios"],"summary":"Listar episodios médicos de un paciente","description":"Permite a Facturación obtener el listado de episodios de un paciente para recopilar todos los actos médicos a liquidar.","operationId":"listar_episodios_api_v1_patients__id_paciente__episodes_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"estado","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Estado"}},{"name":"desde_fecha","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Desde Fecha"}},{"name":"hasta_fecha","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Hasta Fecha"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodioListResponse"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Atención Clínica — Episodios"],"summary":"Abrir un nuevo episodio médico","description":"Permite registrar/abrir un nuevo episodio de atención (guardia, consulta externa, etc.) para el paciente.","operationId":"crear_episodio_api_v1_patients__id_paciente__episodes_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodioCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodioDetalle"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/patients/{id_paciente}/episodes/{id_episodio}":{"get":{"tags":["Atención Clínica — Episodios"],"summary":"Obtener detalle completo de un episodio","description":"Retorna el detalle de un episodio médico específico incluyendo todos los actos médicos registrados. Principal insumo para liquidación.","operationId":"obtener_episodio_api_v1_patients__id_paciente__episodes__id_episodio__get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodioDetalle"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Atención Clínica — Episodios"],"summary":"Actualizar parcialmente un episodio médico","description":"Permite realizar modificaciones parciales en el episodio o cerrarlo enviando estado='closed'.","operationId":"actualizar_episodio_api_v1_patients__id_paciente__episodes__id_episodio__patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodioUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodioDetalle"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/patients/{id_paciente}/episodes/{id_episodio}/medical-acts":{"get":{"tags":["Atención Clínica — Actos Médicos"],"summary":"Listar actos médicos de un episodio","description":"Lista todos los actos médicos registrados dentro de un episodio. Cada acto incluye el codigo_nomenclador para facturación.","operationId":"listar_actos_medicos_api_v1_patients__id_paciente__episodes__id_episodio__medical_acts_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActoMedicoListResponse"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Atención Clínica — Actos Médicos"],"summary":"Registrar un acto médico en un episodio","description":"Permite registrar prestaciones/actos médicos dentro de un episodio activo de atención.","operationId":"crear_acto_medico_api_v1_patients__id_paciente__episodes__id_episodio__medical_acts_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActoMedicoCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActoMedicoSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Content"}}}},"/api/v1/patients/{id_paciente}/episodes/{id_episodio}/solicitud-internacion":{"post":{"tags":["Atención Clínica — Episodios"],"summary":"Solicitar internación del paciente (HCE → M6)","description":"El médico indica la necesidad de internar a un paciente desde una evolución activa. HCE realiza una llamada REST sincrónica al Módulo 6 (Camas) para crear la solicitud de asignación de cama. M6 procesará la solicitud y, una vez asignada la cama, notificará a HCE mediante POST /internacion/ingreso. Permission claim requerido: `hce:internacion:write`.","operationId":"solicitar_internacion_api_v1_patients__id_paciente__episodes__id_episodio__solicitud_internacion_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolicitudInternacionRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Token JWT ausente, inválido o expirado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Sin permiso requerido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Episodio no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Episodio cerrado o datos inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"M6 no disponible.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/patients/{id_paciente}/episodes/{id_episodio}/evoluciones":{"get":{"tags":["Atención Clínica — Evoluciones"],"summary":"Listar evoluciones médicas de un episodio","description":"Lista todas las notas de evolución registradas dentro de un episodio, ordenadas cronológicamente.","operationId":"listar_evoluciones_api_v1_patients__id_paciente__episodes__id_episodio__evoluciones_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolucionListResponse"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Atención Clínica — Evoluciones"],"summary":"Registrar una evolución médica en un episodio","description":"Permite registrar una nota de evolución clínica dentro de un episodio activo. El profesional autor se obtiene automáticamente del token JWT.","operationId":"crear_evolucion_api_v1_patients__id_paciente__episodes__id_episodio__evoluciones_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolucionCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolucionSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Content"}}}},"/api/v1/patients/{id_paciente}/episodes/{id_episodio}/evoluciones/{id_evolucion}":{"get":{"tags":["Atención Clínica — Evoluciones"],"summary":"Obtener detalle de una evolución médica","description":"Retorna el contenido completo de una nota de evolución específica.","operationId":"obtener_evolucion_api_v1_patients__id_paciente__episodes__id_episodio__evoluciones__id_evolucion__get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}},{"name":"id_evolucion","in":"path","required":true,"schema":{"type":"integer","title":"Id Evolucion"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolucionSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Atención Clínica — Evoluciones"],"summary":"Actualizar parcialmente una evolución médica","description":"Permite corregir el contenido de una nota de evolución existente.","operationId":"actualizar_evolucion_api_v1_patients__id_paciente__episodes__id_episodio__evoluciones__id_evolucion__patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}},{"name":"id_evolucion","in":"path","required":true,"schema":{"type":"integer","title":"Id Evolucion"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolucionUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolucionSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes":{"get":{"tags":["Ficha Médica (HCE)"],"summary":"Listar pacientes cacheados","description":"Retorna la lista de pacientes almacenados localmente en la caché de HCE.","operationId":"listar_pacientes_api_v1_pacientes_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"email","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filtrar por email (sincroniza con el Core si no está en la caché)","title":"Email"},"description":"Filtrar por email (sincroniza con el Core si no está en la caché)"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Registros a omitir para paginación","default":0,"title":"Skip"},"description":"Registros a omitir para paginación"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Límite de registros a retornar","default":100,"title":"Limit"},"description":"Límite de registros a retornar"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PacienteSchema"},"title":"Response Listar Pacientes Api V1 Pacientes Get"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes/{id_paciente}":{"get":{"tags":["Ficha Médica (HCE)"],"summary":"Obtener un paciente por ID","description":"Busca un paciente específico en la caché local de HCE por su ID.","operationId":"obtener_paciente_api_v1_pacientes__id_paciente__get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PacienteSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Paciente no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/recetas":{"get":{"tags":["Atención Clínica — Recetas"],"summary":"Consultar listado de recetas (sincronización masiva)","description":"Permite al Módulo 3 (Farmacia) obtener todas las recetas generadas. Útil para auditorías, cierres de lote o recuperación de datos tras caídas de Kafka.","operationId":"listar_recetas_api_v1_recetas_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"estado","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Estado"}},{"name":"id_paciente","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Paciente"}},{"name":"desde_fecha","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Desde Fecha"}},{"name":"id_episodio","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Episodio"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecetaListResponse"}}}},"401":{"description":"Token JWT ausente, inválido o expirado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Sin permiso requerido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/recetas/{id_receta}":{"get":{"tags":["Atención Clínica — Recetas"],"summary":"Obtener detalles de receta (con alertas farmacológicas)","description":"Endpoint al que Farmacia llama tras recibir el evento Kafka clinica.farmacia.receta_creada para obtener la medicación recetada y cruzarla con las alergias del paciente.","operationId":"obtener_receta_api_v1_recetas__id_receta__get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_receta","in":"path","required":true,"schema":{"type":"integer","title":"Id Receta"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecetaMedicaDetallada"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/patients/{id_paciente}/episodes/{id_episodio}/evoluciones/{id_evolucion}/recetas":{"post":{"tags":["Atención Clínica — Recetas"],"summary":"Registrar una receta médica","description":"Permite al médico registrar una receta electrónica asociada a la nota de evolución. Admite múltiples medicamentos. Al guardarse, se notifica automáticamente a Farmacia.","operationId":"registrar_receta_api_v1_patients__id_paciente__episodes__id_episodio__evoluciones__id_evolucion__recetas_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}},{"name":"id_evolucion","in":"path","required":true,"schema":{"type":"integer","title":"Id Evolucion"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecetaCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecetaMedicaDetallada"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Content"}}}},"/api/v1/recetas/{id_receta}/dispensar":{"patch":{"tags":["Atención Clínica — Recetas"],"summary":"Marcar receta como dispensada","description":"Permite al Módulo 3 (Farmacia) cambiar el estado de una receta a 'Dispensada'.","operationId":"dispensar_receta_api_v1_recetas__id_receta__dispensar_patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_receta","in":"path","required":true,"schema":{"type":"integer","title":"Id Receta"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecetaMedicaDetallada"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/medicamentos":{"get":{"tags":["Atención Clínica — Recetas"],"summary":"Consultar listado de medicamentos disponibles (Vademecum Mock)","description":"Retorna una lista estática de medicamentos comunes para autocompletar en el frontend.","operationId":"listar_medicamentos_api_v1_medicamentos_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sala-espera":{"get":{"tags":["Atención Clínica — Sala de Espera"],"summary":"Listar pacientes en la sala de espera","description":"Obtiene los registros de la sala de espera aplicando filtros por médico, sede y estado. Permite ordenar de forma flexible por llegada (orden de llegada), turno o prioridad.","operationId":"listar_sala_espera_api_v1_sala_espera_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_medico","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Filtrar por médico asignado","title":"Id Medico"},"description":"Filtrar por médico asignado"},{"name":"id_sede","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Filtrar por sede física","title":"Id Sede"},"description":"Filtrar por sede física"},{"name":"estado","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filtrar por estado (Esperando, Llamado, Atendido, Ausente)","title":"Estado"},"description":"Filtrar por estado (Esperando, Llamado, Atendido, Ausente)"},{"name":"ordenar_por","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Criterio de ordenamiento: 'llegada' (por defecto), 'turno', 'prioridad'","title":"Ordenar Por"},"description":"Criterio de ordenamiento: 'llegada' (por defecto), 'turno', 'prioridad'"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SalaEsperaSchema"},"title":"Response Listar Sala Espera Api V1 Sala Espera Get"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sala-espera/ingreso":{"post":{"tags":["Atención Clínica — Sala de Espera"],"summary":"Registrar ingreso manual a la sala de espera","description":"Registra de forma manual la llegada de un paciente. Si no existe un episodio consulta-externa abierto para el médico y sede, lo crea automáticamente.","operationId":"ingresar_paciente_manual_api_v1_sala_espera_ingreso_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaEsperaCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaEsperaSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Paciente no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"JWT Bearer":[]}]}},"/api/v1/sala-espera/{id_espera}/llamar":{"patch":{"tags":["Atención Clínica — Sala de Espera"],"summary":"Llamar a un paciente asignando consultorio","description":"Cambia el estado del paciente a 'Llamado' y le asigna un número de consultorio.","operationId":"llamar_paciente_api_v1_sala_espera__id_espera__llamar_patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_espera","in":"path","required":true,"schema":{"type":"integer","title":"Id Espera"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaEsperaLlamar"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaEsperaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Registro no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sala-espera/{id_espera}/atender":{"patch":{"tags":["Atención Clínica — Sala de Espera"],"summary":"Marcar paciente como siendo atendido","description":"Cambia el estado del paciente a 'Atendido' y opcionalmente asocia un episodio médico existente o crea uno nuevo.","operationId":"atender_paciente_api_v1_sala_espera__id_espera__atender_patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_espera","in":"path","required":true,"schema":{"type":"integer","title":"Id Espera"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SalaEsperaAtender"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaEsperaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Registro no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Episodio médico inválido para este paciente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sala-espera/{id_espera}/ausente":{"patch":{"tags":["Atención Clínica — Sala de Espera"],"summary":"Marcar paciente como ausente","description":"Cambia el estado del paciente a 'Ausente'.","operationId":"marcar_ausente_api_v1_sala_espera__id_espera__ausente_patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_espera","in":"path","required":true,"schema":{"type":"integer","title":"Id Espera"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaEsperaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Registro no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sala-espera/{id_espera}/prioridad":{"patch":{"tags":["Atención Clínica — Sala de Espera"],"summary":"Actualizar prioridad del paciente (Triage)","description":"Permite a los módulos de Triage/M9 o enfermería reclasificar la prioridad del paciente en la sala de espera.","operationId":"actualizar_prioridad_api_v1_sala_espera__id_espera__prioridad_patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_espera","in":"path","required":true,"schema":{"type":"integer","title":"Id Espera"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaEsperaPrioridad"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaEsperaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Registro no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sala-espera/{id_espera}/finalizar":{"patch":{"tags":["Atención Clínica — Sala de Espera"],"summary":"Marcar turno como finalizado","description":"Cambia el estado del paciente a 'Finalizado' al concluir la atención médica.","operationId":"finalizar_paciente_api_v1_sala_espera__id_espera__finalizar_patch","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_espera","in":"path","required":true,"schema":{"type":"integer","title":"Id Espera"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SalaEsperaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"description":"Registro no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/hce/health":{"get":{"tags":["Integración M10 (Core)"],"summary":"Health check del módulo HCE","description":"Endpoint de estado que Core puede usar para monitorear la disponibilidad del módulo HCE. No requiere autenticación.","operationId":"health_check_api_v1_hce_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/v1/hce/notify-permission-change":{"post":{"tags":["Integración M10 (Core)"],"summary":"Notificar a Core un cambio de permisos originado en HCE","description":"Proxy que reenvía la notificación al Módulo 10 (Core).","operationId":"notify_permission_change_api_v1_hce_notify_permission_change_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PermissionChangeNotification"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PermissionChangeResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable Content","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"JWT Bearer":[]}]}},"/api/v1/ordenes":{"get":{"tags":["Atención Clínica — Órdenes Médicas"],"summary":"Consultar órdenes pendientes (sincronización masiva)","description":"Endpoint utilizado por M4 y M5 como red de seguridad para consultar lotes completos de estudios pendientes.","operationId":"listar_ordenes_api_v1_ordenes_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"tipo_estudio","in":"query","required":true,"schema":{"type":"string","title":"Tipo Estudio"}},{"name":"estado","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"Pendiente","title":"Estado"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdenListResponse"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ordenes/{id_orden}":{"get":{"tags":["Atención Clínica — Órdenes Médicas"],"summary":"Obtener detalles de una orden (Smart Payload con alertas clínicas)","description":"Endpoint utilizado por M4 y M5 para descargar la información clínica de la orden y las alertas de seguridad.","operationId":"obtener_orden_api_v1_ordenes__id_orden__get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_orden","in":"path","required":true,"schema":{"type":"integer","title":"Id Orden"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdenMedicaCompleta"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ordenes/{id_orden}/resultado":{"get":{"tags":["Atención Clínica — Órdenes Médicas"],"summary":"Obtener resultado de una orden por su ID y tipo","description":"Permite recuperar el resultado clínico (analitos o informe PACS) asociado a una orden médica en base a su ID y el tipo de estudio.","operationId":"obtener_resultado_orden_api_v1_ordenes__id_orden__resultado_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_orden","in":"path","required":true,"schema":{"type":"integer","title":"Id Orden"}},{"name":"tipo_estudio","in":"query","required":true,"schema":{"$ref":"#/components/schemas/TipoEstudio"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultadoEstudioResumen"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes/{id_paciente}/ordenes":{"get":{"tags":["Atención Clínica — Órdenes Médicas"],"summary":"Listar órdenes de un paciente","description":"Retorna todas las órdenes médicas (bioquímicas y de imágenes) de un paciente.","operationId":"listar_ordenes_paciente_api_v1_pacientes__id_paciente__ordenes_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdenListResponse"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Atención Clínica — Órdenes Médicas"],"summary":"Crear orden médica de estudio","description":"El médico genera una orden de estudio (Laboratorio, Imágenes o Anatomía Patológica) para un paciente dentro de un episodio activo. Al crearse, HCE publica automáticamente el evento Kafka `clinica.estudios.orden_creada` para que M4 (Laboratorio) y M5 (Imágenes) lo procesen. Permission claim requerido: `hce:ordenes:write`.","operationId":"crear_orden_api_v1_pacientes__id_paciente__ordenes_post","deprecated":true,"security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdenCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdenCreatedResponse"}}}},"401":{"description":"Token JWT ausente, inválido o expirado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Sin permiso requerido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Datos inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/pacientes/{id_paciente}/ordenes/laboratorio":{"post":{"tags":["Atención Clínica — Órdenes Médicas"],"summary":"Crear orden médica de laboratorio (M4)","description":"Crea una orden de laboratorio vinculando una lista de IDs de estudios del catálogo de M4.","operationId":"crear_orden_laboratorio_api_v1_pacientes__id_paciente__ordenes_laboratorio_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdenLaboratorioCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdenCreatedResponse"}}}},"401":{"description":"Token JWT ausente, inválido o expirado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Sin permiso requerido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Paciente no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Datos inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/pacientes/{id_paciente}/ordenes/imagenes":{"post":{"tags":["Atención Clínica — Órdenes Médicas"],"summary":"Crear orden médica de imágenes diagnósticas (M5)","description":"Crea una orden de diagnóstico por imágenes especificando la modalidad (subtipo). Si se asocia a un eposiodo (id_episodio) o evolución (id_evolucion), se requiere que existan en el sistema.","operationId":"crear_orden_imagenes_api_v1_pacientes__id_paciente__ordenes_imagenes_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdenImagenCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdenCreatedResponse"}}}},"401":{"description":"Token JWT ausente, inválido o expirado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Sin permiso requerido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Paciente no encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Datos inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/resultados":{"post":{"tags":["Atención Clínica — Órdenes Médicas"],"summary":"Registrar resultado de estudio","description":"Endpoint utilizado por M5 (Imágenes) u otros para registrar los resultados de un estudio médico finalizado en la HCE.","operationId":"registrar_resultado_api_v1_resultados_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultadoEstudioRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultadoCreatedResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Datos inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"JWT Bearer":[]}]}},"/api/v1/resultados/laboratorio":{"post":{"tags":["Atención Clínica — Órdenes Médicas"],"summary":"Webhook para registrar resultados del Módulo 4 (Laboratorio)","description":"Endpoint expuesto para que el Core envíe los eventos de tipo laboratorio.resultado_listo tras la suscripción.","operationId":"registrar_resultado_laboratorio_api_v1_resultados_laboratorio_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultadoLaboratorioWebhook"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultadoCreatedResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Datos inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"deprecated":true,"security":[{"JWT Bearer":[]}]}},"/api/v1/internacion/ingreso":{"post":{"tags":["Integración M6 (Camas)"],"summary":"Notificar ingreso de paciente (M6 → HCE)","description":"Endpoint utilizado por el Módulo 6 para notificar a la HCE que un paciente fue ingresado físicamente a una cama. Esto dispara la creación del Episodio de Internación en la Historia Clínica.","operationId":"notificar_ingreso_api_v1_internacion_ingreso_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngresoInternacionRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngresoInternacionResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Datos de ingreso inválidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"JWT Bearer":[]}]}},"/api/v1/patients/{id_paciente}/episodes/{id_episodio}/solicitudes-cama":{"post":{"tags":["Solicitudes de cama (M6)"],"summary":"Crear solicitud de internación o pase de cama","operationId":"crear_solicitud_cama_api_v1_patients__id_paciente__episodes__id_episodio__solicitudes_cama_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolicitudCamaCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolicitudCamaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Conflict"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Solicitudes de cama (M6)"],"summary":"Listar solicitudes de cama del episodio + cama actual","operationId":"listar_solicitudes_cama_api_v1_patients__id_paciente__episodes__id_episodio__solicitudes_cama_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}},{"name":"id_episodio","in":"path","required":true,"schema":{"type":"integer","title":"Id Episodio"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolicitudCamaListResponse"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/solicitudes-cama/{id_solicitud}/resolver":{"post":{"tags":["Solicitudes de cama (M6)"],"summary":"Simular respuesta de M6 (aceptar con cama / rechazar)","operationId":"resolver_solicitud_cama_api_v1_solicitudes_cama__id_solicitud__resolver_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_solicitud","in":"path","required":true,"schema":{"type":"integer","title":"Id Solicitud"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolicitudCamaResolver"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolicitudCamaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Content"}}}},"/api/v1/solicitudes-cama/{id_solicitud}/cancelar":{"post":{"tags":["Solicitudes de cama (M6)"],"summary":"Cancelar una solicitud de cama pendiente","operationId":"cancelar_solicitud_cama_api_v1_solicitudes_cama__id_solicitud__cancelar_post","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_solicitud","in":"path","required":true,"schema":{"type":"integer","title":"Id Solicitud"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolicitudCamaSchema"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Content"}}}},"/api/v1/webhook/turnos/presentismo":{"post":{"tags":["Webhooks de integración (entrada)"],"summary":"M2 notifica check-in de paciente (webhook)","description":"Recibe el presentismo real del Módulo 2, lo adapta e ingresa al paciente en la sala de espera.","operationId":"webhook_presentismo_api_v1_webhook_turnos_presentismo_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/M2CheckinWebhook"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhook/laboratorio/resultado":{"post":{"tags":["Webhooks de integración (entrada)"],"summary":"Webhook para registrar resultados de Laboratorio (Módulo 4)","description":"Recibe el webhook de laboratorio.resultado_listo y lo guarda con analitos enriquecidos.","operationId":"webhook_resultado_laboratorio_api_v1_webhook_laboratorio_resultado_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultadoLaboratorioWebhook"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultadoCreatedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhook/imagenes/reporte":{"post":{"tags":["Webhooks de integración (entrada)"],"summary":"M5 notifica un reporte de imagen finalizado (webhook)","description":"Registra los detalles del reporte de imágenes. Si el informe o profesional vienen vacíos, los recupera dinámicamente llamando al API del Módulo 5.","operationId":"webhook_reporte_imagen_api_v1_webhook_imagenes_reporte_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReporteImagenWebhook"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultadoCreatedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/patients/{id_paciente}/insurance":{"get":{"tags":["Integración M7 (Facturación)"],"summary":"Obtener cobertura médica vigente del paciente","description":"Retorna la obra social o prepaga vigente del paciente. Facturación necesita este dato para aplicar el nomenclador correcto.","operationId":"obtener_cobertura_api_v1_patients__id_paciente__insurance_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsuranceResponse"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes/{id_paciente}/historial/recetas":{"get":{"tags":["Integración M8 (Portal del Paciente)"],"summary":"Consultar historial de recetas del paciente (Para M8)","description":"Endpoint sincrónico consumido por el Portal del Paciente (M8) para renderizar la sección 'Mi Salud', listando todas las recetas.","operationId":"historial_recetas_api_v1_pacientes__id_paciente__historial_recetas_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RecetaMedicaDetallada"},"title":"Response Historial Recetas Api V1 Pacientes Id Paciente Historial Recetas Get"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pacientes/{id_paciente}/historial/resultados":{"get":{"tags":["Integración M8 (Portal del Paciente)"],"summary":"Consultar resultados de estudios del paciente (Para M8)","description":"Endpoint sincrónico consumido por el Portal del Paciente (M8) para mostrar los resultados de estudios médicos finalizados.","operationId":"historial_resultados_api_v1_pacientes__id_paciente__historial_resultados_get","security":[{"JWT Bearer":[]}],"parameters":[{"name":"id_paciente","in":"path","required":true,"schema":{"type":"integer","title":"Id Paciente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResultadoEstudioResumen"},"title":"Response Historial Resultados Api V1 Pacientes Id Paciente Historial Resultados Get"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ActoMedicoCreate":{"properties":{"codigo_nomenclador":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Codigo Nomenclador","examples":["01.01.01"]},"descripcion":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Descripcion","examples":["Consulta médica ambulatoria"]},"tipo":{"$ref":"#/components/schemas/TipoActoMedico","examples":["consulta"]},"id_profesional":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Profesional","examples":[42]},"fecha_realizacion":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Realizacion","description":"Fecha de realización. Si no se envía, se usa la fecha/hora actual."},"cantidad":{"type":"integer","exclusiveMinimum":0.0,"title":"Cantidad","default":1,"examples":[1]},"observaciones":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observaciones"}},"type":"object","required":["tipo"],"title":"ActoMedicoCreate","description":"Payload para registrar un nuevo acto médico en un episodio."},"ActoMedicoListResponse":{"properties":{"id_episodio":{"type":"integer","title":"Id Episodio","examples":[700]},"total":{"type":"integer","title":"Total","examples":[4]},"actos_medicos":{"items":{"$ref":"#/components/schemas/ActoMedicoSchema"},"type":"array","title":"Actos Medicos"}},"type":"object","required":["id_episodio","total","actos_medicos"],"title":"ActoMedicoListResponse","description":"Lista de actos médicos de un episodio."},"ActoMedicoSchema":{"properties":{"id_acto_medico":{"type":"integer","title":"Id Acto Medico","examples":[9001]},"id_episodio":{"type":"integer","title":"Id Episodio","examples":[700]},"codigo_nomenclador":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Nomenclador","examples":["01.01.01"]},"descripcion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion","examples":["Consulta médica ambulatoria - primera vez"]},"tipo":{"$ref":"#/components/schemas/TipoActoMedico","examples":["consulta"]},"id_profesional":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Profesional","examples":[42]},"fecha_realizacion":{"type":"string","format":"date-time","title":"Fecha Realizacion","examples":["2025-03-10T09:15:00Z"]},"cantidad":{"type":"integer","title":"Cantidad","default":1,"examples":[1]},"observaciones":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observaciones"}},"type":"object","required":["id_acto_medico","id_episodio","tipo","fecha_realizacion"],"title":"ActoMedicoSchema","description":"Acto médico registrado dentro de un episodio."},"AlertaCreate":{"properties":{"tipo":{"$ref":"#/components/schemas/TipoConsideracion","examples":["Alergia"]},"severidad":{"$ref":"#/components/schemas/SeveridadAlerta","examples":["Severa"]},"descripcion":{"type":"string","title":"Descripcion","examples":["Alergia severa a penicilina y derivados."]}},"type":"object","required":["tipo","severidad","descripcion"],"title":"AlertaCreate","description":"Body para crear una nueva alerta clínica."},"AlertaSchema":{"properties":{"id":{"type":"integer","title":"Id"},"id_paciente":{"type":"integer","title":"Id Paciente"},"tipo":{"$ref":"#/components/schemas/TipoConsideracion"},"severidad":{"$ref":"#/components/schemas/SeveridadAlerta"},"descripcion":{"type":"string","title":"Descripcion"},"estado":{"$ref":"#/components/schemas/EstadoAlerta"},"fecha_registro":{"type":"string","format":"date-time","title":"Fecha Registro"},"id_medico_registro":{"type":"integer","title":"Id Medico Registro"},"fecha_resolucion":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Resolucion"},"id_medico_resolucion":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Medico Resolucion"},"motivo_resolucion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Motivo Resolucion"}},"type":"object","required":["id","id_paciente","tipo","severidad","descripcion","estado","fecha_registro","id_medico_registro"],"title":"AlertaSchema","description":"Respuesta completa de una alerta clínica."},"AlertaSmartPayload":{"properties":{"tipo":{"$ref":"#/components/schemas/TipoConsideracion"},"severidad":{"$ref":"#/components/schemas/SeveridadAlerta"},"descripcion":{"type":"string","title":"Descripcion"}},"type":"object","required":["tipo","severidad","descripcion"],"title":"AlertaSmartPayload","description":"Schema reducido para Smart Payload en órdenes y recetas.\nSolo incluye lo necesario para que M3/M4/M5 tomen decisiones clínicas."},"AlertaUpdate":{"properties":{"estado":{"$ref":"#/components/schemas/EstadoAlerta","examples":["Resuelta"]},"motivo_resolucion":{"type":"string","title":"Motivo Resolucion","examples":["Alergia superada, confirmado por alergista."]}},"type":"object","required":["estado","motivo_resolucion"],"title":"AlertaUpdate","description":"Body para resolver una alerta clínica (PATCH)."},"AntecedenteCreate":{"properties":{"tipo":{"$ref":"#/components/schemas/TipoAntecedente","examples":["Quirurgico"]},"descripcion":{"type":"string","title":"Descripcion","examples":["Colecistectomía laparoscópica"]},"fecha_suceso":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Suceso","examples":["2018-04-15"]},"observaciones":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observaciones","examples":["Sin complicaciones postoperatorias."]}},"type":"object","required":["tipo","descripcion"],"title":"AntecedenteCreate","description":"Body para registrar un nuevo antecedente."},"AntecedenteSchema":{"properties":{"id":{"type":"integer","title":"Id"},"id_paciente":{"type":"integer","title":"Id Paciente"},"tipo":{"$ref":"#/components/schemas/TipoAntecedente"},"descripcion":{"type":"string","title":"Descripcion"},"fecha_suceso":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Suceso"},"observaciones":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observaciones"},"fecha_registro":{"type":"string","format":"date-time","title":"Fecha Registro"},"id_medico_registro":{"type":"integer","title":"Id Medico Registro"}},"type":"object","required":["id","id_paciente","tipo","descripcion","fecha_registro","id_medico_registro"],"title":"AntecedenteSchema","description":"Respuesta completa de un antecedente clínico."},"AntecedenteUpdate":{"properties":{"descripcion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion"},"fecha_suceso":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fecha Suceso"},"observaciones":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observaciones"}},"type":"object","title":"AntecedenteUpdate","description":"Body para actualización parcial de un antecedente (PATCH)."},"CamaActual":{"properties":{"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector"},"habitacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Habitacion"},"cama":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cama"},"fecha_ingreso":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Ingreso"}},"type":"object","title":"CamaActual","description":"Ubicación actual del paciente internado (último movimiento)."},"DevLoginRequest":{"properties":{"sub":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sub","description":"ID del usuario (médico)","examples":[1]},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username","description":"Nombre de usuario","examples":["dr.dev"]},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"Rol del usuario","examples":["medico"]},"permissions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Permissions","description":"Lista de permisos","examples":[["hce:read","hce:write","hce:alertas:read","hce:alertas:write","hce:antecedentes:read","hce:antecedentes:write","hce:ficha-medica:read","hce:ficha-medica:write","hce:recetas:read","hce:recetas:write","hce:ordenes:read","hce:resultados:write","hce:internacion:write","hce:episodes:read","hce:episodes:write","hce:medical-acts:read","hce:insurance:read","hce:evoluciones:read","hce:evoluciones:write"]]},"sede_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sede Id","description":"ID de la sede","examples":[1]},"expire_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expire Hours","description":"Horas de validez del token (default: 24)","examples":[24]}},"type":"object","title":"DevLoginRequest","description":"Body opcional para personalizar el token de desarrollo.\nSi no se envía ningún campo, se usan los valores por defecto de settings."},"DevLoginResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"bearer"},"expires_in_hours":{"type":"integer","title":"Expires In Hours"},"user":{"additionalProperties":true,"type":"object","title":"User"}},"type":"object","required":["access_token","expires_in_hours","user"],"title":"DevLoginResponse","description":"Respuesta del endpoint de login de desarrollo."},"EpisodioCreate":{"properties":{"tipo":{"$ref":"#/components/schemas/TipoEpisodio","examples":["internacion"]},"estado":{"$ref":"#/components/schemas/EstadoEpisodio","default":"open","examples":["open"]},"id_sede":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Sede","examples":[3]},"diagnostico_principal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Diagnostico Principal","examples":["J18.9 - Neumonía no especificada"]}},"type":"object","required":["tipo"],"title":"EpisodioCreate","description":"Creación de episodio médico."},"EpisodioDetalle":{"properties":{"id_episodio":{"type":"integer","title":"Id Episodio","examples":[700]},"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"tipo":{"$ref":"#/components/schemas/TipoEpisodio","examples":["internacion"]},"estado":{"$ref":"#/components/schemas/EstadoEpisodio","examples":["closed"]},"id_sede":{"type":"integer","title":"Id Sede","examples":[3]},"id_medico_responsable":{"type":"integer","title":"Id Medico Responsable","examples":[42]},"diagnostico_principal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Diagnostico Principal","examples":["J18.9 - Neumonía no especificada"]},"fecha_apertura":{"type":"string","format":"date-time","title":"Fecha Apertura","examples":["2025-03-10T09:00:00Z"]},"fecha_cierre":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Cierre","examples":["2025-03-15T11:00:00Z"]},"actos_medicos":{"items":{"$ref":"#/components/schemas/ActoMedicoSchema"},"type":"array","title":"Actos Medicos"}},"type":"object","required":["id_episodio","id_paciente","tipo","estado","id_sede","id_medico_responsable","fecha_apertura"],"title":"EpisodioDetalle","description":"Detalle completo de un episodio con actos médicos."},"EpisodioListResponse":{"properties":{"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"total":{"type":"integer","title":"Total","examples":[5]},"episodios":{"items":{"$ref":"#/components/schemas/EpisodioResumen"},"type":"array","title":"Episodios"}},"type":"object","required":["id_paciente","total","episodios"],"title":"EpisodioListResponse","description":"Lista de episodios de un paciente."},"EpisodioResumen":{"properties":{"id_episodio":{"type":"integer","title":"Id Episodio","examples":[700]},"tipo":{"$ref":"#/components/schemas/TipoEpisodio","examples":["internacion"]},"estado":{"$ref":"#/components/schemas/EstadoEpisodio","examples":["closed"]},"id_sede":{"type":"integer","title":"Id Sede","examples":[3]},"fecha_apertura":{"type":"string","format":"date-time","title":"Fecha Apertura","examples":["2025-03-10T09:00:00Z"]},"fecha_cierre":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Cierre","examples":["2025-03-15T11:00:00Z"]},"id_medico_responsable":{"type":"integer","title":"Id Medico Responsable","examples":[42]},"cant_evoluciones":{"type":"integer","title":"Cant Evoluciones","description":"Cantidad de evoluciones clínicas en este episodio.","default":0},"cant_recetas":{"type":"integer","title":"Cant Recetas","description":"Cantidad de recetas digitales emitidas en este episodio.","default":0},"cant_estudios":{"type":"integer","title":"Cant Estudios","description":"Cantidad de pedidos de estudios médicos solicitados en este episodio.","default":0}},"type":"object","required":["id_episodio","tipo","estado","id_sede","fecha_apertura","id_medico_responsable"],"title":"EpisodioResumen","description":"Resumen de un episodio para listados."},"EpisodioUpdate":{"properties":{"tipo":{"anyOf":[{"$ref":"#/components/schemas/TipoEpisodio"},{"type":"null"}]},"estado":{"anyOf":[{"$ref":"#/components/schemas/EstadoEpisodio"},{"type":"null"}]},"id_sede":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Sede"},"id_medico_responsable":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Medico Responsable"},"diagnostico_principal":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Diagnostico Principal"},"fecha_cierre":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Cierre"}},"type":"object","title":"EpisodioUpdate","description":"Payload para actualizar un episodio médico (ej. cerrar o cambiar médico)."},"ErrorResponse":{"properties":{"error":{"type":"string","title":"Error","examples":["NOT_FOUND"]},"message":{"type":"string","title":"Message","examples":["El recurso solicitado no fue encontrado."]},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["error","message"],"title":"ErrorResponse","description":"Respuesta estándar de error del módulo HCE."},"EstadoAlerta":{"type":"string","enum":["Activa","Resuelta"],"title":"EstadoAlerta","description":"Estado del ciclo de vida de la alerta."},"EstadoEpisodio":{"type":"string","enum":["open","closed"],"title":"EstadoEpisodio"},"EstadoReceta":{"type":"string","enum":["Activa","Suspendida","Dispensada"],"title":"EstadoReceta"},"EstadoSalaEspera":{"type":"string","enum":["Esperando","Llamado","Atendido","Ausente","Finalizado"],"title":"EstadoSalaEspera"},"EvolucionCreate":{"properties":{"contenido":{"type":"string","title":"Contenido","description":"Texto libre con la nota clínica del profesional.","examples":["Paciente refiere mejoría del cuadro respiratorio. Se auscultan campos pulmonares limpios. Se indica continuar tratamiento."]},"fecha":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha","description":"Fecha/hora de la evolución. Si no se envía, se usa la fecha/hora actual."}},"type":"object","required":["contenido"],"title":"EvolucionCreate","description":"Body para registrar una nueva evolución médica en un episodio."},"EvolucionListResponse":{"properties":{"id_episodio":{"type":"integer","title":"Id Episodio"},"total":{"type":"integer","title":"Total"},"evoluciones":{"items":{"$ref":"#/components/schemas/EvolucionSchema"},"type":"array","title":"Evoluciones"}},"type":"object","required":["id_episodio","total","evoluciones"],"title":"EvolucionListResponse","description":"Respuesta de listado de evoluciones de un episodio."},"EvolucionSchema":{"properties":{"id_evolucion":{"type":"integer","title":"Id Evolucion"},"id_episodio":{"type":"integer","title":"Id Episodio"},"id_profesional":{"type":"integer","title":"Id Profesional"},"contenido":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contenido"},"fecha":{"type":"string","format":"date-time","title":"Fecha"}},"type":"object","required":["id_evolucion","id_episodio","id_profesional","fecha"],"title":"EvolucionSchema","description":"Schema de respuesta completo de una evolución médica."},"EvolucionUpdate":{"properties":{"contenido":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contenido","description":"Texto libre con la nota clínica corregida."}},"type":"object","title":"EvolucionUpdate","description":"Body para actualizar parcialmente una evolución médica (PATCH)."},"FichaMedicaCompletaCreate":{"properties":{"ficha_medica":{"$ref":"#/components/schemas/FichaMedicaCreate"},"antecedentes":{"items":{"$ref":"#/components/schemas/AntecedenteCreate"},"type":"array","title":"Antecedentes"},"alertas_clinicas":{"items":{"$ref":"#/components/schemas/AlertaCreate"},"type":"array","title":"Alertas Clinicas"},"dni":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dni","description":"DNI del paciente"},"fecha_nacimiento":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fecha Nacimiento","description":"Fecha de nacimiento (YYYY-MM-DD)"},"genero":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Genero","description":"Género/Sexo del paciente"},"obra_social":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Obra Social","description":"Obra social o cobertura médica"}},"type":"object","required":["ficha_medica"],"title":"FichaMedicaCompletaCreate","description":"Payload para registrar de forma atómica la ficha médica, antecedentes y alertas de un paciente."},"FichaMedicaCompletaResponse":{"properties":{"ficha_medica":{"$ref":"#/components/schemas/FichaMedicaSchema"},"antecedentes":{"items":{"$ref":"#/components/schemas/AntecedenteSchema"},"type":"array","title":"Antecedentes"},"alertas_clinicas":{"items":{"$ref":"#/components/schemas/AlertaSchema"},"type":"array","title":"Alertas Clinicas"}},"type":"object","required":["ficha_medica"],"title":"FichaMedicaCompletaResponse","description":"Schema de respuesta completo para la ficha médica consolidada con sus antecedentes y alertas."},"FichaMedicaCreate":{"properties":{"grupo_sanguineo":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Grupo Sanguineo","description":"Grupo sanguíneo y factor Rh del paciente.","examples":["A+"]},"peso_kg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Peso Kg","description":"Peso del paciente en kilogramos.","examples":[72.5]},"altura_cm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Altura Cm","description":"Altura del paciente en centímetros.","examples":[175.0]},"observaciones_generales":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observaciones Generales","description":"Notas generales y antecedentes del paciente visibles en la cabecera de la ficha.","examples":["Paciente con antecedentes de hipertensión arterial. Diabético tipo 2."]}},"type":"object","title":"FichaMedicaCreate","description":"Payload para crear/registrar la ficha médica de un paciente."},"FichaMedicaSchema":{"properties":{"grupo_sanguineo":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Grupo Sanguineo","description":"Grupo sanguíneo y factor Rh del paciente.","examples":["A+"]},"peso_kg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Peso Kg","description":"Peso del paciente en kilogramos.","examples":[72.5]},"altura_cm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Altura Cm","description":"Altura del paciente en centímetros.","examples":[175.0]},"observaciones_generales":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observaciones Generales","description":"Notas generales y antecedentes del paciente visibles en la cabecera de la ficha.","examples":["Paciente con antecedentes de hipertensión arterial. Diabético tipo 2."]},"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]}},"type":"object","required":["id_paciente"],"title":"FichaMedicaSchema","description":"Schema de respuesta completo de la ficha médica."},"FichaMedicaUpdate":{"properties":{"grupo_sanguineo":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Grupo Sanguineo","description":"Grupo sanguíneo y factor Rh del paciente.","examples":["A+"]},"peso_kg":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Peso Kg","description":"Peso del paciente en kilogramos.","examples":[72.5]},"altura_cm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Altura Cm","description":"Altura del paciente en centímetros.","examples":[175.0]},"observaciones_generales":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observaciones Generales","description":"Notas generales y antecedentes del paciente visibles en la cabecera de la ficha.","examples":["Paciente con antecedentes de hipertensión arterial. Diabético tipo 2."]}},"type":"object","title":"FichaMedicaUpdate","description":"Payload para actualizar parcialmente la ficha médica. Todos los campos son opcionales."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status","examples":["UP"]},"module":{"type":"string","title":"Module","examples":["hce"]},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["status","module","timestamp"],"title":"HealthResponse","description":"Respuesta del health check."},"IngresoInternacionRequest":{"properties":{"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"id_episodio":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Episodio","description":"Episodio de HCE que originó la solicitud. Si se envía, ese mismo episodio pasa a internación (no se crea uno nuevo). M6 debe reenviar el id_episodio que recibió en la solicitud.","examples":[700]},"sector":{"type":"string","title":"Sector","examples":["UTI"]},"habitacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Habitacion","examples":["Terapia A"]},"cama":{"type":"string","title":"Cama","examples":["Cama 4"]},"fecha_ingreso":{"type":"string","format":"date-time","title":"Fecha Ingreso","examples":["2026-04-17T14:30:00Z"]},"medico_solicitante":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medico Solicitante","examples":["Dr. Pérez"]}},"type":"object","required":["id_paciente","sector","cama","fecha_ingreso"],"title":"IngresoInternacionRequest","description":"Payload enviado por M6 para notificar ingreso de paciente a cama."},"IngresoInternacionResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success","examples":["success"]},"mensaje":{"type":"string","title":"Mensaje","default":"Episodio creado y cama asignada correctamente.","examples":["Episodio creado y cama asignada correctamente."]},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data","examples":[{"id_episodio":700,"id_movimiento":1}]}},"type":"object","title":"IngresoInternacionResponse","description":"Respuesta tras crear episodio de internación."},"InsuranceResponse":{"properties":{"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"id_obra_social":{"type":"integer","title":"Id Obra Social","examples":[15]},"nombre_obra_social":{"type":"string","title":"Nombre Obra Social","examples":["OSDE"]},"codigo_plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Plan","examples":["OSDE-210"]},"numero_afiliado":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numero Afiliado","examples":["1234567890"]},"vigente_desde":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Vigente Desde","examples":["2024-01-01"]},"vigente_hasta":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Vigente Hasta"}},"type":"object","required":["id_paciente","id_obra_social","nombre_obra_social"],"title":"InsuranceResponse","description":"Cobertura médica vigente del paciente."},"ItemRecetaCreate":{"properties":{"medicamento":{"type":"string","maxLength":300,"title":"Medicamento","examples":["Amoxicilina 500mg"]},"indicaciones":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indicaciones","examples":["Tomar 1 comprimido cada 8 horas por 7 días."]},"cantidad":{"type":"integer","title":"Cantidad","default":1,"examples":[1]}},"type":"object","required":["medicamento"],"title":"ItemRecetaCreate","description":"Payload para crear un ítem de receta."},"ItemRecetaSchema":{"properties":{"id_item":{"type":"integer","title":"Id Item","examples":[10]},"id_receta":{"type":"integer","title":"Id Receta","examples":[8502]},"medicamento":{"type":"string","maxLength":300,"title":"Medicamento","examples":["Amoxicilina 500mg"]},"indicaciones":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Indicaciones","examples":["Tomar 1 comprimido cada 8 horas por 7 días."]},"cantidad":{"type":"integer","title":"Cantidad","default":1,"examples":[1]}},"type":"object","required":["id_item","id_receta","medicamento"],"title":"ItemRecetaSchema","description":"Esquema detallado de un ítem de receta."},"LabAnalitoInfo":{"properties":{"nombre":{"type":"string","title":"Nombre"},"valor":{"type":"number","title":"Valor"},"unidad":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unidad"},"rango_normal":{"anyOf":[{"$ref":"#/components/schemas/LabRangoNormal"},{"type":"null"}]},"fuera_de_rango":{"type":"boolean","title":"Fuera De Rango"},"es_critico":{"type":"boolean","title":"Es Critico"},"observacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observacion"}},"type":"object","required":["nombre","valor","fuera_de_rango","es_critico"],"title":"LabAnalitoInfo"},"LabOrdenInfo":{"properties":{"id_laboratorio":{"type":"integer","title":"Id Laboratorio"},"id_orden_hce":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Orden Hce"},"descripcion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion"},"prioridad":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prioridad"},"fecha_solicitud":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Solicitud"},"fecha_resultado":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Resultado"}},"type":"object","required":["id_laboratorio"],"title":"LabOrdenInfo"},"LabPacienteInfo":{"properties":{"id":{"type":"integer","title":"Id"},"nombre":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nombre"},"dni":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dni"}},"type":"object","required":["id"],"title":"LabPacienteInfo"},"LabRangoNormal":{"properties":{"min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min"},"max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max"}},"type":"object","title":"LabRangoNormal"},"LabResumenInfo":{"properties":{"total_analitos":{"type":"integer","title":"Total Analitos"},"analitos_fuera_de_rango":{"type":"integer","title":"Analitos Fuera De Rango"},"hay_valores_criticos":{"type":"boolean","title":"Hay Valores Criticos"}},"type":"object","required":["total_analitos","analitos_fuera_de_rango","hay_valores_criticos"],"title":"LabResumenInfo"},"M2AppointmentInfo":{"properties":{"id":{"type":"integer","title":"Id","examples":[360]},"starts_at":{"type":"string","format":"date-time","title":"Starts At","examples":["2026-09-29T12:00:00Z"]},"checked_in_at":{"type":"string","format":"date-time","title":"Checked In At","examples":["2026-06-24T17:22:34Z"]}},"type":"object","required":["id","starts_at","checked_in_at"],"title":"M2AppointmentInfo"},"M2CheckinWebhook":{"properties":{"reason":{"type":"string","title":"Reason","examples":["El paciente hizo checkin"]},"appointment":{"$ref":"#/components/schemas/M2AppointmentInfo"},"patient":{"$ref":"#/components/schemas/M2PatientInfo"},"medic":{"$ref":"#/components/schemas/M2MedicInfo"},"disclaimer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disclaimer","examples":["Notificación enviada por APPS 2 - Modulo 2"]}},"type":"object","required":["reason","appointment","patient","medic"],"title":"M2CheckinWebhook","description":"Payload real del webhook de presentismo enviado por M2."},"M2MedicInfo":{"properties":{"id":{"type":"integer","title":"Id","examples":[1361561151]}},"type":"object","required":["id"],"title":"M2MedicInfo"},"M2PatientInfo":{"properties":{"id":{"type":"integer","title":"Id","examples":[3365611]}},"type":"object","required":["id"],"title":"M2PatientInfo"},"OrdenCreate":{"properties":{"tipo_estudio":{"$ref":"#/components/schemas/TipoEstudio","examples":["Imagen"]},"descripcion_pedido":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Descripcion Pedido","examples":["Resonancia Magnética de Cerebro con contraste"]},"prioridad":{"$ref":"#/components/schemas/PrioridadOrden","default":"Normal","examples":["Normal"]},"id_episodio":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Episodio","examples":[101]},"id_evolucion":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Evolucion","examples":[202]},"origen":{"anyOf":[{"$ref":"#/components/schemas/OrigenOrden"},{"type":"null"}],"default":"Ambulatorio","examples":["Ambulatorio"]}},"type":"object","required":["tipo_estudio"],"title":"OrdenCreate","description":"Payload para crear una nueva orden médica de estudio."},"OrdenCreatedResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success","examples":["success"]},"message":{"type":"string","title":"Message","default":"Orden creada y evento Kafka publicado.","examples":["Orden creada y evento Kafka publicado."]},"id_orden":{"type":"integer","title":"Id Orden","examples":[4050]}},"type":"object","required":["id_orden"],"title":"OrdenCreatedResponse","description":"Respuesta 201 tras crear una orden médica."},"OrdenImagenCreate":{"properties":{"subtipo":{"$ref":"#/components/schemas/SubtipoEstudio","description":"Tipo/modalidad del estudio de imagen","examples":["RESONANCE"]},"descripcion_pedido":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Descripcion Pedido","examples":["Resonancia de cerebro con contraste"]},"prioridad":{"$ref":"#/components/schemas/PrioridadOrden","default":"Normal","examples":["Normal"]},"id_episodio":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Episodio","examples":[101]},"id_evolucion":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Evolucion","examples":[202]},"origen":{"anyOf":[{"$ref":"#/components/schemas/OrigenOrden"},{"type":"null"}],"default":"Ambulatorio","examples":["Ambulatorio"]}},"type":"object","required":["subtipo"],"title":"OrdenImagenCreate","description":"Payload para crear una nueva orden de imágenes."},"OrdenLaboratorioCreate":{"properties":{"estudio_ids":{"items":{"type":"integer"},"type":"array","title":"Estudio Ids","description":"Lista de IDs de estudios del catálogo M4","examples":[[1,2]]},"descripcion_pedido":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Descripcion Pedido","examples":["Indicaciones adicionales para la extracción"]},"prioridad":{"$ref":"#/components/schemas/PrioridadOrden","default":"Normal","examples":["Normal"]},"id_episodio":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Episodio","examples":[101]},"id_evolucion":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Evolucion","examples":[202]},"origen":{"anyOf":[{"$ref":"#/components/schemas/OrigenOrden"},{"type":"null"}],"default":"Ambulatorio","examples":["Ambulatorio"]}},"type":"object","required":["estudio_ids"],"title":"OrdenLaboratorioCreate","description":"Payload para crear una nueva orden de laboratorio."},"OrdenListResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success","examples":["success"]},"cantidad":{"type":"integer","title":"Cantidad","examples":[1]},"data":{"items":{"$ref":"#/components/schemas/OrdenMedicaCompleta"},"type":"array","title":"Data"}},"type":"object","required":["cantidad","data"],"title":"OrdenListResponse","description":"Respuesta de listado de órdenes."},"OrdenMedicaCompleta":{"properties":{"id_orden":{"type":"integer","title":"Id Orden","examples":[4050]},"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"tipo_estudio":{"$ref":"#/components/schemas/TipoEstudio","examples":["Imagen"]},"descripcion_pedido":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descripcion Pedido","examples":["Resonancia Magnética de Cerebro"]},"prioridad":{"$ref":"#/components/schemas/PrioridadOrden","examples":["Urgente"]},"id_episodio":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Episodio","examples":[101]},"id_evolucion":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Evolucion","examples":[202]},"fecha_creacion":{"type":"string","format":"date-time","title":"Fecha Creacion","examples":["2026-06-25T14:30:00Z"]},"id_medico_solicitante":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Medico Solicitante","examples":[42]},"subtipo":{"anyOf":[{"$ref":"#/components/schemas/SubtipoEstudio"},{"type":"null"}],"examples":["RESONANCE"]},"estudio_ids":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Estudio Ids","examples":[[1,2]]},"estado":{"type":"string","title":"Estado","default":"Pendiente","examples":["Pendiente"]},"origen":{"anyOf":[{"$ref":"#/components/schemas/OrigenOrden"},{"type":"null"}],"default":"Ambulatorio","examples":["Ambulatorio"]},"alertas_clinicas":{"items":{"$ref":"#/components/schemas/AlertaSmartPayload"},"type":"array","title":"Alertas Clinicas"}},"type":"object","required":["id_orden","id_paciente","tipo_estudio","prioridad","fecha_creacion"],"title":"OrdenMedicaCompleta","description":"Orden médica con Smart Payload de alertas clínicas activas."},"OrigenOrden":{"type":"string","enum":["Internacion","Ambulatorio","Turno"],"title":"OrigenOrden"},"PacienteSchema":{"properties":{"id_paciente":{"type":"integer","title":"Id Paciente","description":"ID único del paciente (emitido por Core/M10)"},"datos_personales":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Datos Personales","description":"Datos demográficos del paciente"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id_paciente","created_at","updated_at"],"title":"PacienteSchema","description":"Representación de un paciente almacenado en la caché de HCE."},"PermissionChangeNotification":{"properties":{"id_usuario_afectado":{"type":"integer","title":"Id Usuario Afectado","examples":[42]},"tipo_cambio":{"$ref":"#/components/schemas/TipoCambioPermiso","examples":["revoke-access"]},"recurso_afectado":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recurso Afectado","examples":["hce:write"]},"motivo":{"type":"string","title":"Motivo","examples":["Profesional suspendido por auditoría interna."]},"id_usuario_notificador":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Usuario Notificador","examples":[10]},"fecha_ocurrencia":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Ocurrencia"}},"type":"object","required":["id_usuario_afectado","tipo_cambio","motivo"],"title":"PermissionChangeNotification","description":"Payload que HCE envía a Core para notificar cambio de permisos."},"PermissionChangeResponse":{"properties":{"acknowledged":{"type":"boolean","title":"Acknowledged","examples":[true]}},"type":"object","required":["acknowledged"],"title":"PermissionChangeResponse","description":"Respuesta de Core tras recibir la notificación."},"PrioridadInternacion":{"type":"string","enum":["Baja","Media","Alta","Emergencia"],"title":"PrioridadInternacion"},"PrioridadOrden":{"type":"string","enum":["Normal","Urgente","Emergencia"],"title":"PrioridadOrden"},"RecetaCreate":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ItemRecetaCreate"},"type":"array","minItems":1,"title":"Items"}},"type":"object","required":["items"],"title":"RecetaCreate","description":"Payload para que un médico cree una receta completa con múltiples medicamentos."},"RecetaListResponse":{"properties":{"total":{"type":"integer","title":"Total","examples":[15]},"data":{"items":{"$ref":"#/components/schemas/RecetaMedicaDetallada"},"type":"array","title":"Data"}},"type":"object","required":["total","data"],"title":"RecetaListResponse","description":"Respuesta paginada de recetas."},"RecetaMedicaDetallada":{"properties":{"id_receta":{"type":"integer","title":"Id Receta","examples":[8502]},"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"id_evolucion":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Evolucion","examples":[302]},"estado":{"$ref":"#/components/schemas/EstadoReceta","examples":["Activa"]},"fecha_creacion":{"type":"string","format":"date-time","title":"Fecha Creacion","examples":["2026-06-25T14:30:00Z"]},"items":{"items":{"$ref":"#/components/schemas/ItemRecetaSchema"},"type":"array","title":"Items"},"alertas_clinicas":{"items":{"$ref":"#/components/schemas/AlertaSmartPayload"},"type":"array","title":"Alertas Clinicas"}},"type":"object","required":["id_receta","id_paciente","estado","fecha_creacion"],"title":"RecetaMedicaDetallada","description":"Receta electrónica con Smart Payload de alertas clínicas activas del paciente."},"ReporteImagenWebhook":{"properties":{"id_orden_hce":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Orden Hce","examples":[4051]},"report_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Id","examples":["RPT-9001"]},"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"titulo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Titulo","examples":["Radiografía de Tórax"]},"informe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Informe","examples":["Sin hallazgos patológicos."]},"profesional_firmante":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profesional Firmante","examples":["Dra. Gómez (Radiología)"]},"fecha_resultado":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Resultado"}},"type":"object","required":["id_paciente"],"title":"ReporteImagenWebhook","description":"Evento de reporte de imagen finalizado emitido por M5."},"ResultadoCreatedResponse":{"properties":{"status":{"type":"string","title":"Status","default":"success","examples":["success"]},"message":{"type":"string","title":"Message","default":"Resultado vinculado correctamente a la Historia Clínica.","examples":["Resultado vinculado correctamente a la Historia Clínica."]}},"type":"object","title":"ResultadoCreatedResponse","description":"Respuesta tras registrar un resultado."},"ResultadoEstudioRequest":{"properties":{"id_orden":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Orden","examples":[4050]},"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"tipo_estudio":{"$ref":"#/components/schemas/TipoEstudio","examples":["Imagen"]},"id_profesional_firmante":{"type":"string","title":"Id Profesional Firmante","examples":["Dra. Gomez (Radiología)"]},"fecha_resultado":{"type":"string","format":"date-time","title":"Fecha Resultado","examples":["2026-04-17T11:00:00Z"]},"informe_resumen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Informe Resumen","examples":["RM de Cerebro: Sin hallazgos patológicos."]},"id_externo_estudio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id Externo Estudio","examples":["550e8400-e29b-41d4-a716-446655440000"]},"subtipo":{"anyOf":[{"$ref":"#/components/schemas/SubtipoEstudio"},{"type":"null"}],"examples":["ECOGRAFY"]},"link_imagen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Imagen","examples":["https://viewer.pacs.hospital/study/1234"]},"url_detalle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Detalle","examples":["https://api.imagenes.hospital/v1/estudios/1234/completo"]}},"type":"object","required":["id_paciente","tipo_estudio","id_profesional_firmante","fecha_resultado"],"title":"ResultadoEstudioRequest","description":"Payload enviado por M4/M5 para registrar un resultado en la HCE."},"ResultadoEstudioResumen":{"properties":{"id_resultado":{"type":"integer","title":"Id Resultado","examples":[9021]},"id_orden":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Orden","examples":[4050]},"tipo_estudio":{"type":"string","title":"Tipo Estudio","examples":["Laboratorio"]},"fecha_resultado":{"type":"string","format":"date-time","title":"Fecha Resultado","examples":["2026-04-20T10:00:00Z"]},"titulo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Titulo","examples":["Hemograma Completo"]},"resumen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resumen","examples":["Valores dentro de los rangos normales. Sin observaciones."]},"profesional_firmante":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profesional Firmante","examples":["Dr. Bioq. Fernandez"]},"subtipo":{"anyOf":[{"$ref":"#/components/schemas/SubtipoEstudio"},{"type":"null"}]},"link_imagen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Imagen"},"url_detalle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Detalle"},"analitos":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Analitos"},"resumen_analitos":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Resumen Analitos"}},"type":"object","required":["id_resultado","tipo_estudio","fecha_resultado"],"title":"ResultadoEstudioResumen","description":"Resumen de resultado para el Portal del Paciente (M8) y consumo interno HCE."},"ResultadoLaboratorioWebhook":{"properties":{"evento":{"type":"string","title":"Evento","examples":["laboratorio.resultado_listo"]},"version":{"type":"string","title":"Version","examples":["1.0"]},"id_evento":{"type":"string","title":"Id Evento","examples":["uuid"]},"fecha_ocurrencia":{"type":"string","format":"date-time","title":"Fecha Ocurrencia"},"orden":{"$ref":"#/components/schemas/LabOrdenInfo"},"paciente":{"$ref":"#/components/schemas/LabPacienteInfo"},"profesional_firmante":{"type":"string","title":"Profesional Firmante"},"resumen":{"$ref":"#/components/schemas/LabResumenInfo"},"analitos":{"items":{"$ref":"#/components/schemas/LabAnalitoInfo"},"type":"array","title":"Analitos"}},"type":"object","required":["evento","version","id_evento","fecha_ocurrencia","orden","paciente","profesional_firmante","resumen","analitos"],"title":"ResultadoLaboratorioWebhook","description":"Payload específico del webhook laboratorio.resultado_listo (M4)."},"SalaEsperaAtender":{"properties":{"id_episodio":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Episodio","description":"ID del episodio médico existente a vincular (opcional)","examples":[123]}},"type":"object","title":"SalaEsperaAtender","description":"Body opcional para atender a un paciente vinculando un episodio médico existente o abriendo uno nuevo."},"SalaEsperaCreate":{"properties":{"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"id_profesional":{"type":"integer","title":"Id Profesional","examples":[42]},"id_sede":{"type":"integer","title":"Id Sede","examples":[3]},"id_turno_m2":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Turno M2","examples":[88402]},"fecha_turno":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Turno","examples":["2026-06-19T10:00:00Z"]},"fecha_llegada":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Llegada","examples":["2026-06-21T09:45:00Z"]},"tipo_atencion":{"anyOf":[{"$ref":"#/components/schemas/TipoAtencion"},{"type":"null"}],"description":"Tipo de atención requerida","default":"consultorio","examples":["consultorio"]}},"type":"object","required":["id_paciente","id_profesional","id_sede"],"title":"SalaEsperaCreate","description":"Payload para registrar el ingreso a la sala de espera."},"SalaEsperaLlamar":{"properties":{"consultorio":{"type":"integer","minimum":1.0,"title":"Consultorio","examples":[102]}},"type":"object","required":["consultorio"],"title":"SalaEsperaLlamar","description":"Body para llamar a un paciente, asignando un consultorio físico."},"SalaEsperaPrioridad":{"properties":{"prioridad":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Prioridad","description":"Nivel de prioridad/urgencia asignado (1-5)","examples":[3]},"motivo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Motivo","description":"Motivo de la consulta (opcional)","examples":["Control post-operatorio"]},"id_medico_triage":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Medico Triage","description":"ID del médico que realiza el triage (opcional)","examples":[42]}},"type":"object","required":["prioridad"],"title":"SalaEsperaPrioridad","description":"Body para actualizar la prioridad de un paciente en sala de espera (Triage)."},"SalaEsperaSchema":{"properties":{"id_espera":{"type":"integer","title":"Id Espera"},"id_paciente":{"type":"integer","title":"Id Paciente"},"id_episodio":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Episodio"},"id_medico":{"type":"integer","title":"Id Medico"},"id_sede":{"type":"integer","title":"Id Sede"},"id_turno_m2":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Turno M2"},"fecha_llegada":{"type":"string","format":"date-time","title":"Fecha Llegada"},"fecha_turno":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Turno"},"prioridad":{"type":"integer","title":"Prioridad"},"estado":{"$ref":"#/components/schemas/EstadoSalaEspera"},"consultorio":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Consultorio"},"motivo":{"type":"string","title":"Motivo"},"tipo_atencion":{"$ref":"#/components/schemas/TipoAtencion"},"id_medico_triage":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Medico Triage"},"paciente":{"anyOf":[{"$ref":"#/components/schemas/PacienteSchema"},{"type":"null"}]}},"type":"object","required":["id_espera","id_paciente","id_medico","id_sede","fecha_llegada","prioridad","estado","motivo","tipo_atencion"],"title":"SalaEsperaSchema","description":"Representación completa de un registro en la sala de espera."},"SectorSolicitado":{"type":"string","enum":["UTI","Sala_Comun","Guardia_Observacion"],"title":"SectorSolicitado"},"SeveridadAlerta":{"type":"string","enum":["Leve","Moderada","Severa","Critica"],"title":"SeveridadAlerta","description":"Nivel de severidad de la alerta."},"SolicitudCamaCreate":{"properties":{"tipo":{"type":"string","enum":["internacion","pase"],"title":"Tipo","default":"internacion","examples":["internacion"]},"prioridad":{"type":"string","enum":["Baja","Media","Alta"],"title":"Prioridad","default":"Media","examples":["Alta"]},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector","examples":["UTI — Unidad de Terapia Intensiva"]},"motivo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Motivo","examples":["Requiere monitoreo intensivo."]}},"type":"object","title":"SolicitudCamaCreate","description":"Body para crear una solicitud de internación o pase de cama."},"SolicitudCamaListResponse":{"properties":{"solicitudes":{"items":{"$ref":"#/components/schemas/SolicitudCamaSchema"},"type":"array","title":"Solicitudes"},"cama_actual":{"anyOf":[{"$ref":"#/components/schemas/CamaActual"},{"type":"null"}]},"internado":{"type":"boolean","title":"Internado","default":false}},"type":"object","title":"SolicitudCamaListResponse","description":"Listado de solicitudes de un episodio + la cama actual del paciente."},"SolicitudCamaResolver":{"properties":{"decision":{"type":"string","enum":["aceptada","rechazada"],"title":"Decision","examples":["aceptada"]},"cama":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cama","examples":["Cama 4"]},"habitacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Habitacion","examples":["Hab 201"]},"motivo_rechazo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Motivo Rechazo","examples":["No hay camas disponibles en el sector."]}},"type":"object","required":["decision"],"title":"SolicitudCamaResolver","description":"Body para simular la respuesta de M6 sobre una solicitud pendiente."},"SolicitudCamaSchema":{"properties":{"id_solicitud":{"type":"integer","title":"Id Solicitud"},"id_paciente":{"type":"integer","title":"Id Paciente"},"id_episodio":{"type":"integer","title":"Id Episodio"},"tipo":{"type":"string","title":"Tipo"},"prioridad":{"type":"string","title":"Prioridad"},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector"},"motivo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Motivo"},"estado":{"type":"string","title":"Estado"},"cama":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cama"},"habitacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Habitacion"},"motivo_rechazo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Motivo Rechazo"},"fecha_solicitud":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Solicitud"},"fecha_resolucion":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fecha Resolucion"}},"type":"object","required":["id_solicitud","id_paciente","id_episodio","tipo","prioridad","estado"],"title":"SolicitudCamaSchema","description":"Respuesta de una solicitud de cama."},"SolicitudInternacionRequest":{"properties":{"id_paciente":{"type":"integer","title":"Id Paciente","examples":[10500]},"id_episodio":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id Episodio","description":"Episodio ambulatorio que origina la internación. M6 debe reenviarlo en el callback /internacion/ingreso para que ese mismo episodio pase a internación.","examples":[700]},"id_evolucion_origen":{"type":"integer","title":"Id Evolucion Origen","examples":[302]},"prioridad":{"$ref":"#/components/schemas/PrioridadInternacion","examples":["Alta"]},"sector_solicitado":{"$ref":"#/components/schemas/SectorSolicitado","examples":["UTI"]},"diagnostico_principal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Diagnostico Principal","examples":["Insuficiencia respiratoria aguda"]},"observaciones":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observaciones","examples":["Paciente requiere asistencia respiratoria mecánica inmediata."]}},"type":"object","required":["id_paciente","id_evolucion_origen","prioridad","sector_solicitado"],"title":"SolicitudInternacionRequest","description":"Payload enviado por HCE hacia M6 para solicitar internación."},"SubtipoEstudio":{"type":"string","enum":["ECOGRAFY","RADIOLOGY","TOMOGRAPHY","RESONANCE","MAMMOGRAPHY","DENSITOMETRY","ECODOPPLER","ENDOSCOPY"],"title":"SubtipoEstudio"},"TipoActoMedico":{"type":"string","enum":["consulta","estudio-laboratorio","estudio-imagen","procedimiento","cirugia","medicacion","descartable"],"title":"TipoActoMedico"},"TipoAntecedente":{"type":"string","enum":["Quirurgico","Familiar","Patologico","Habito"],"title":"TipoAntecedente","description":"Tipo de antecedente clínico del paciente."},"TipoAtencion":{"type":"string","enum":["consultorio","guardia","cirugia","demanda_espontanea"],"title":"TipoAtencion"},"TipoCambioPermiso":{"type":"string","enum":["revoke-access","role-change","deactivate-user"],"title":"TipoCambioPermiso"},"TipoConsideracion":{"type":"string","enum":["Alergia","Dispositivo_Implantado","Condicion_Critica","Riesgo_Infeccioso","Contraindicacion"],"title":"TipoConsideracion","description":"Tipo de consideración/alerta clínica del paciente."},"TipoEpisodio":{"type":"string","enum":["consulta-externa","internacion","guardia","cirugia"],"title":"TipoEpisodio"},"TipoEstudio":{"type":"string","enum":["Laboratorio","Imagen","Anatomia_Patologica"],"title":"TipoEstudio"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"JWT Bearer":{"type":"http","description":"JWT emitido por Módulo 10 (Core). Header: Authorization: Bearer <token>","scheme":"bearer"}}}} |