Consultar todas las prestaciones
La consulta de una cita y los webhooks de citas incluyen la colecciónservices. Cada elemento representa una línea de la cita: una misma prestación puede aparecer varias veces, con distintos identificadores de línea.
El código de confirmación identifica la cita y es independiente de estos códigos.
Si la cita no tiene prestaciones,
services es [].
Los códigos sin valor (code, externalcode y randomcode) se representan siempre como null.
Ejemplo del campo data.services de un webhook:
Recibir cambios mediante webhook
En Administración → Centro → Integraciones, configure una integración de citas suscrita al evento de actualización. También recibe los cambios realizados directamente en las líneas de prestaciones, sin tener que guardar de nuevo la cabecera de la cita. El mensaje contiene la lista completa resultante. El receptor debe sustituir su asociación anterior por esa lista; una lista vacía significa que se han eliminado todas las prestaciones. Los guardados internos de una misma operación se agrupan y una transacción revertida no deja un aviso entregable. Las suscripciones y los campos anteriores siguen funcionando. Se conserva el mecanismo de entrega y reintentos existente.Modificar una cita mediante API
Una integración autorizada puede cambiar la duración y sustituir la lista de prestaciones de una cita existente, conservando su identificador y su código de confirmación. UtilicePUT /es/api/v1/booking-apikey/appointment-update/{code} con el código de confirmación de la cita y la cabecera X-API-Key. También se admite POST. La clave necesita el permiso explícito booking:appointments:write o booking:*; las claves antiguas sin permisos definidos no tienen acceso a esta operación.
Envíe al menos
duration o services. Omitir un campo mantiene su valor actual; services: [] elimina todas las prestaciones. Cuando se envía una lista, se eliminan las líneas existentes que no figuren en ella. Para conservarlas, envíe sus identificadores y prestaciones. Una prestación puede repetirse en líneas distintas; un identificador de línea no puede repetirse.
null, números entre comillas y campos adicionales se rechazan. Los precios y cantidades no se editan mediante esta operación; Nubidoc calcula los importes según sus reglas. Cambiar prestaciones no ajusta automáticamente la duración: indique duration cuando proceda.
La respuesta de éxito es HTTP 200 con success: true y data, que contiene los datos de la cita, incluidos duration, time_end y la lista completa services. Repetir los mismos valores e identificadores no genera otro aviso. Si repite líneas sin identificador, se crearán nuevas identidades de línea; reutilice los identificadores de la respuesta anterior.
La operación comprueba los permisos de la clave, que los datos pertenecen al mismo cliente y que el intervalo completo cabe en la disponibilidad del profesional. Solo admite citas futuras solicitadas o programadas con paciente. Conserva paciente, fecha, hora de inicio, profesional y centro. Las citas facturadas con factura emitida, los cobros protegidos y los cambios de prestaciones en citas vinculadas a bonos se rechazan sin aplicar parcialmente los cambios.