Changelog

Historial de cambios del Motor de Agendamiento API. Esta API solo funciona en su última versión.

[1.6.3] - 2026

POST /api/booking/schedule: Mensajes de error descriptivos y específicos
- Invalid Parameters ahora indica qué parámetro falta o es inválido
- Option not Available diferencia entre slot no disponible y slot tomado por otro paciente
- Type attention not valid muestra las opciones disponibles
- Mensajes en español traducidos a inglés para consistencia

Nuevo campo error_code en todas las respuestas de error de la API
- Código programático para facilitar integración (ej: SLOT_NOT_AVAILABLE, INVALID_PARAMS)
- Backward compatible: el campo error sigue existiendo con el mensaje legible
- Catálogo completo documentado en OpenAPI y docs markdown

POST /api/booking/schedule: Ya no se expone el número de línea interno en errores de excepción

POST /api/booking/schedule: Soporte para tipos de documento de Perú
- Nuevos tipos: DNI (Documento Nacional de Identidad), RUC (Registro Único de Contribuyentes), PTP (Permiso Temporal de Permanencia)
- Ampliado max de 2 a 3 caracteres para soportar códigos de 3 letras

Historial de cambios del Portal de Agendamiento API (/api/portal/booking).

GET /api/portal/booking/insurers: Nuevo endpoint para consultar aseguradoras
- Parámetro public_offer para filtrar aseguradoras disponibles en canales de autogestión
- Requiere módulo de aseguradoras activo en la empresa
Filtro por aseguradora en endpoints existentes: Nuevo parámetro insurer_id
- GET /specialties: Filtrar especialidades por aseguradora
- GET /specialties/by-place: Filtrar especialidades por aseguradora
- GET /services: Filtrar servicios por aseguradora
- GET /professionals: Filtrar profesionales por aseguradora
- GET /procedures: Filtrar prestaciones por aseguradora
- GET /availability: Filtrar disponibilidad por aseguradora
POST /api/portal/booking/patient: Sincronización automática con sistemas externos
- Al crear/actualizar paciente, se sincroniza con HIS/ERP si está configurado
- Sincronización no bloqueante: si falla el sistema externo, el paciente se crea igual
- Compatible con integraciones Osigu, Servinte360 y futuras

GET /api/booking/appointment/list/date: Respuesta mejorada con estructura anidada
- Información del paciente agrupada en objeto patient (identifier_value, name, phone, phone2, email)
- Información de la cita agrupada en objeto schedule (start_time, end_time, service, place, professional, insurer)

POST /api/booking/appointment/update/state: Nuevo endpoint para modificación de estados de citas
- Permite cambiar el estado de una cita existente
- Requiere: tenant, appointment_id, state
- Estados disponibles: confirmada, cancelada, atendida, no_asistio
GET /api/booking/appointment/list/date: Nuevo endpoint para consulta de citas por fecha
- Permite consultar todas las citas de una fecha específica
- Parámetros: tenant, date (YYYY-MM-DD)
- Filtros opcionales: place, professional, service

GET /api/booking/places: Nuevo parámetro insurer
- Permite filtrar sedes por aseguradora
GET /api/booking/places: Nuevo parámetro available_slots
- Define el mínimo de cupos disponibles al buscar con search_disponibility=true
- Valor por defecto: 5
GET /api/booking/professional/types_attention: Nuevo parámetro insurer
- Permite filtrar tipos de atención por aseguradora
GET /api/booking/dates/available: Nuevo parámetro available_slots
- Consistencia con el parámetro de places

Versión inicial documentada del Motor de Agendamiento API.

GET /api/booking/insurers: Consultar aseguradoras disponibles
GET /api/booking/services: Consultar servicios ofertados
GET /api/booking/places: Consultar sedes por servicio
GET /api/booking/professionals: Consultar profesionales por sede y servicio
GET /api/booking/professional/types_attention: Consultar tipos de atención
GET /api/booking/availability: Consultar disponibilidad de citas

Esta API opera siempre en su última versión. No hay soporte para versiones anteriores.
Los cambios son retrocompatibles a menos que se indique lo contrario.
Para soporte técnico, contacte al equipo de COCO Tecnologías.