Eventos

Los eventos de webhook se envían a tu servidor cuando ocurren acciones en la plataforma. Cada evento contiene una estructura común y un payload específico según el tipo de evento.

Campos Comunes

CampoTipoDescripción

transaction_idstringIdentificador único de la transacción

event_idstringIdentificador único del evento, útil para verificar idempotencia (duplicados)

event_typestringTipo de evento (ver lista abajo)

timestampstringTimestamp ISO 8601 del evento

dataobjectPayload específico del evento

Tipos de EHR Composition

encounter_outpatientConsulta médica ambulatoria

medication_requestPrescripción de medicamentos

service_requestPrescripción de servicios (laboratorio, imágenes, procedimientos, tratamientos, derivaciones)

device_requestPrescripción de dispositivos médicos

observationObservación clínica (signos vitales, antropometría, etc.)

Campos del Author

CampoTipoDescripción

author_typestringTipo de autor (ej: practitioner)

lastnamestringApellido del profesional

firstnamestringNombre del profesional

person_sexstringSexo del profesional

date_of_birthstringFecha de nacimiento del profesional

person_id_typestringTipo de documento del profesional

person_id_numberstringNúmero de documento del profesional

tinstringNúmero de identificación tributaria

Headers HTTP

POST /webhook
Authorization: Bearer tu-token-aqui
X-Webhook-Event: medication_request.created
X-Webhook-Signature: firma-hmac
Content-Type: application/json
User-Agent: Quralo-Webhooks/1.0

Categorías de Eventos

• Consultas médicas - Nueva consulta médica registrada
• Prescripción de medicamentos - Nueva receta electrónica generada
• Prescripción de Servicios - Nueva prescripción de servicio generada
• Prescripción de Dispositivos - Nueva prescripción de dispositivo generada