Cómo funcionan los Webhooks en Siku

Un webhook permite que una aplicación envíe datos automáticamente a otra en tiempo real, sin necesidad de realizar consultas manuales. Es utilizado para facilitar la integración entre sistemas, permitiendo recibir actualizaciones instantáneas sobre eventos relevantes.

Creación de Webhooks en Siku

1. El usuario debe tener el acceso al permiso de Integraciones - Webhooks
2. Ir al menú superior y seleccionar Integraciones.
3. Dentro de Integraciones, ingresar a la pestaña Catálogo de webhooks
4. Hacer clic en el botón Nuevo webhook.

Requisitos para configurar un webhook

Evento

Corresponde al evento del sistema que activará el envío de información.

URL

Es la dirección del servicio externo donde se enviará la información.

Tipo de operación

Define el método HTTP con el cual se enviará la información:

• GET - Obtener datos
• POST - Enviar datos
• PIJT - Actualizar datos
• DELETE - Eliminar datos
• PATCH - Actualizar parcialmente

Máximos Intentos

Cantidad de veces que el sistema intentará reenviar la información si ocurre un error de comunicación.
Valor recomendado: 10

Token

Campo opcional utilizado para enviar un valor de seguridad o autenticación.

Tipo de Autenticación

Permite definir si el webhook requiere autenticación:

• OAuth 2.0
• Token
• X-Token
• Custom Header

Filtros

Permite limitar cuándo se ejecutará el webhook según condiciones específicas.

Cuerpo del Request

Aquí se define la estructura de los datos que se enviarán.
Generalmente se utiliza formato JSON.

Tipo de objeto respuesta

Define el formato esperado de respuesta del servidor externo.

Inactivo

Si se marca esta opción, el webhook queda registrado, pero no ejecutará envíos.

Eventos para los cuales se disparan Webhooks en Siku

Expediente:

• Actualizar
• Insertar ficha básica
• Insertar Pop-Up

Cita:

• Reprogramar
• Insertar
• Borrar
• Marcar como asistida / no asistida
• Actualizar en directorio
• Insertar en directorio
• Borrar en directorio
• Insertar en sincronización
• Editar en sincronización
• Borrar en sincronización

Facturación:

• Nueva
• Anular abono
• Agregar abono
• Cotización
• Compra nueva

Gastos:

• Compra electrónica

Cómo reencolar un documento de integración

¿Qué es reencolar un documento?

La opción Reencolar permite volver a enviar un documento de facturación al proceso de integración cuando un comprobante quedó pendiente, en cola o fallido.

Pasos para reencolar un documento de facturación

1. Ingresar al módulo de Integraciones
   Diríjase al módulo INTEGRACIONES dentro del sistema.
2. Ubicar el documento en el módulo de facturación
   Dentro del dashboard, en la sección Módulo de facturación, seleccione la categoría donde se encuentra el documento:

• En cola
• Fallidas

1. Abrir el documento requerido
   Seleccione el documento correspondiente para consultar su detalle.
2. Hacer clic en Reencolar
   Presione la opción REENCOLAR para que el sistema vuelva a procesar el envío del documento.

Recomendación importante

Antes de reencolar, se recomienda revisar el estado del documento para validar si el motivo del fallo ya fue corregido.

El sistema mostrará una advertencia indicando que el reenvío podría generar documentos duplicados en el sistema externo. Si la acción es confirmada, el documento se enviará nuevamente de forma inmediata y el estado se actualizará automáticamente en pantalla.

Cómo buscar documentos en el detalle de facturas de integración

La vista DETALLE DE FACTURAS incluye nuevas opciones para mejorar la búsqueda y navegación de información.

Selector de fechas flexible

Se incorporó un selector de fechas que permite elegir:

• Rangos predefinidos como HOY, AYER, ÚLTIMA SEMANA o ÚLTIMO MES.
• Cualquier rango de fechas personalizado.

Paginación de resultados

Los resultados se muestran utilizando paginación.

Es posible seleccionar la cantidad de registros a visualizar por página:

• 10 registros
• 20 registros
• 50 registros
• 100 registros

La pantalla también muestra:

• Contador de registros totales
• Navegación entre páginas

Búsqueda avanzada

La búsqueda por NÚMERO DE DOCUMENTO y NOMBRE DE PACIENTE O CLIENTE se realiza sobre todos los registros dentro del período seleccionado, no únicamente sobre la página visible.

Además, la búsqueda por nombre funciona correctamente con o sin tildes.

Ejemplo:
Buscar JOSE también mostrará resultados con JOSÉ.

Aplicación de filtros

Los filtros ya no se aplican automáticamente al escribir.

Para ejecutar una búsqueda se debe utilizar el botón BUSCAR.

Para eliminar los criterios aplicados se debe utilizar el botón LIMPIAR FILTRO.

Este comportamiento sigue el mismo funcionamiento del módulo BÚSQUEDA DE PACIENTES dentro del sistema.