Feny2026-08-18 - base v1
- Se añadieron lecturas limitadas de catálogo, especialistas y disponibilidad.
- Se añadió la creación idempotente de reservas de invitados con referencias pbr_ opacas.
- Se documentó la reserva v1 de un servicio; la reserva compuesta sigue disponible en el widget firmado y el flujo propio.
- Se añadió gestión versionada de cancelación y reprogramación según las reglas del negocio.
- Se añadieron entrega webhook firmada, evidencias de reintento, controles de pausa/repetición y validación estricta de destino.
Política de compatibilidad
Rutas v1 estables
Los campos y códigos de error v1 existentes no cambian de propósito de forma silenciosa.
Cambios aditivos
Pueden aparecer nuevos campos opcionales. Los consumidores deben ignorar los campos desconocidos.
Cambios incompatibles
Antes de eliminar un comportamiento se requiere una versión nueva o una retirada documentada.
Política de retirada
- Un cambio incompatible se publica en una ruta versionada o recibe un aviso público que identifica la ruta o campo, la migración y la fecha de retirada.
- La fecha de retirada y el periodo de soporte se publican con el aviso. Esta documentación no inventa un plazo fijo ni un SLA.
- Usa la última versión documentada, ignora campos aditivos desconocidos y revisa este registro antes de cambiar una integración de producción.