Webhooks

Mantenga sus sistemas externos sincronizados sin necesidad de consultar la API. Los Webhooks permiten que CifraHQ envie una notificacion a cualquier endpoint HTTP en el momento en que algo ocurre - una factura se registra, se crea un cliente, se registra un pago. Su sistema receptor obtiene los datos inmediatamente, sin exportacion manual ni trabajo programado requerido.

Donde encontrarlo

Vaya a Configuracion > Sistema > Webhooks.

Como crear un webhook

1. Haga clic en Nuevo.
2. Ingrese un Nombre - una etiqueta para su propia referencia (p. ej., Sincronizacion de Pedidos Shopify o Feed de Facturas ERP).
3. Ingrese la URL - el endpoint en su servidor que recibira la solicitud POST.
4. Opcionalmente ingrese Encabezados (uno por linea, p. ej., Authorization: Bearer mi-token) para satisfacer cualquier requisito de autenticacion que imponga su endpoint.
5. Opcionalmente agregue una Descripcion para documentar para que es este webhook.
6. Guarde.

CifraHQ comenzara inmediatamente a enviar solicitudes HTTP POST con un payload JSON a su URL cada vez que ocurra un evento coincidente.

Editar un webhook

Haga clic en el nombre del webhook en la lista para abrir el dialogo de edicion y actualizar cualquier campo.

Eliminar webhooks

Seleccione uno o mas webhooks y haga clic en Eliminar.

Consejos

• Use el campo Encabezados para pasar un secreto compartido, token Bearer o clave de API para que su endpoint pueda verificar que las solicitudes provienen de CifraHQ y no de una fuente desconocida.
• Los webhooks son especificos del tenant - cada cuenta de empresa tiene su propia lista de webhooks, para que pueda configurar diferentes integraciones por tenant sin que interfieran entre si.
• Su endpoint receptor debe devolver un estado HTTP 2xx para confirmar la recepcion. CifraHQ registra los fallos de entrega para que pueda diagnosticar problemas de conectividad sin buscar en registros del servidor.

Relacionado: API de CifraHQ · Flujos de Trabajo · Registros del Sistema · Facturas · Facturas de Proveedor