Flujo completo de integracion

Este recorrido muestra el orden recomendado para integrar Agenda Medica sin adivinar dependencias entre endpoints.

1. Obtener un token

Solicite un token de service principal mediante Client Credentials y los scopes necesarios. El tenant y la empresa se derivan del token; no envie identificadores de organizacion en headers propios.

2. Preparar referencias

Antes de reservar, consulte los datos que alimentan los filtros:

1. Consulte tipos de cita para obtener el serviceId.
2. Opcionalmente consulte sedes, medicos y especialidades.
3. Para cancelaciones, consulte los motivos permitidos.

3. Buscar o crear el paciente

Use Pacientes > Buscar con tipo y numero de documento. Si no existe una coincidencia exacta, registre el paciente y conserve su patientId.

4. Consultar disponibilidad

Use Agenda Medica > Disponibilidad > Consultar opciones con serviceId, rango de fechas y filtros opcionales. Cada opcion retorna un optionToken temporal ligado al tenant.

5. Reservar la cita

Envie patientId, serviceId, optionToken y tipo de visita. Incluya un Idempotency-Key nuevo para el intento de reserva y conserve el X-Correlation-Id de la respuesta.

6. Consultar y gestionar

Liste las citas del paciente o consulte el detalle por identificador. Para reprogramar, obtenga primero un nuevo optionToken. Para cancelar, consulte antes un motivo de cancelacion valido.

Token -> Referencias -> Paciente -> Disponibilidad -> Reserva -> Consulta -> Reprogramacion/Cancelacion

Reintentos

Reutilice la misma clave de idempotencia solamente para repetir exactamente la misma solicitud. Un payload diferente requiere una clave nueva.