📌 Introducción
Si otro sistema de tu empresa necesita enterarse de los cambios en tus documentos (por ejemplo, el sistema de logística cuando se crea una guía de despacho), Ramaflex puede avisarle automáticamente por webhook.
Está en Configuración › Notificaciones a sistemas externos, con dos pestañas: Destinos e Historial de entregas.
🎯 ¿Para qué sirve?
Ramaflex envía un aviso firmado a una dirección (URL) cada vez que se crea, edita, elimina o emite un documento de los tipos que elijas. El aviso sale tanto si el documento se hizo en Ramaflex como en el ERP de escritorio.
🔐 Permiso requerido: Notificaciones a sistemas externos › Configurar notificaciones a sist. externos (NTF001). El sistema que recibe los avisos debe tener una URL https lista para recibirlos y validar la firma. Esta configuración la hace normalmente el equipo de TI o el proveedor del otro sistema. |
🛠️ Paso a paso
1️⃣ Crea un destino
En la pestaña Destinos, presiona Nuevo destino. Completa Nombre (por ejemplo, Logística) y URL.
2️⃣ Elige los documentos y los eventos
En Tipos de documento, marca los documentos que le interesan a ese sistema, agrupados en Ventas, Abastecimiento y Existencias. En Eventos, marca Creado, Editado, Eliminado y/o Emitido al SII. Emitido al SII solo aplica a documentos electrónicos.
3️⃣ Guarda el destino
Presiona Crear destino.
4️⃣ Guarda el secreto
Ramaflex muestra el secreto del destino. Guárdalo de inmediato: no se vuelve a mostrar. El sistema receptor lo usa para validar la firma HMAC-SHA256 que llega en el header X-Ramaflex-Signature de cada aviso. Cópialo con Copiar secreto y presiona Ya lo guardé.
5️⃣ Administra los destinos
Cada destino muestra sus documentos y eventos, su Estado y su Última entrega. Desde sus botones puedes:
Enviar prueba: manda un aviso de prueba y muestra la respuesta del destino.
Editar: cambia el nombre, la URL, los documentos o los eventos.
Pausar / Reanudar: deja de enviar avisos sin borrar el destino.
Regenerar secreto: crea un secreto nuevo. El anterior deja de servir de inmediato, así que debes actualizarlo en el sistema receptor.
Eliminar: el destino deja de recibir notificaciones; su historial de entregas se conserva.
Si un destino falla varias veces seguidas, queda Pausado por fallas y deja de recibir avisos hasta que lo reanudes.
6️⃣ Revisa el historial de entregas
En la pestaña Historial de entregas ves cada aviso enviado: fecha, evento, documento, destino, Resultado (Entregado, Reintentando, Fallido, Pendiente) y el último intento. Puedes filtrar por destino, tipo de documento, evento, resultado, fechas o folio.
Detalle muestra el contenido enviado y cada intento.
Reenviar vuelve a mandar un aviso; también puedes marcar varios y reenviarlos juntos.
7️⃣ Ejemplo completo: Comercializadora Tecno
El sistema de despacho de la empresa necesita saber cuándo hay ventas nuevas. TI crea el destino Logística Tecno con la URL https://logistica.tecno.cl/ramaflex/notificaciones, marca NV, GDV y FAV y los eventos Creado y Emitido al SII, y guarda el secreto en el sistema de despacho. Con Enviar prueba confirma que el destino responde.
➡️ ¿Qué ocurre después?
Desde entonces, cada nota de venta o guía creada y cada factura emitida genera un aviso. En el historial se ve, por ejemplo, que la FAV 125 (Emitido al SII) y la GDV 10 (Creado) se entregaron al primer intento. Un aviso de la NV 15 quedó Fallido porque el sistema de despacho estaba caído; cuando volvió, TI lo reenvió con Reenviar. |
💡 Recomendaciones
|





