Webhooks
Un webhook avisa a otro sistema (tu ERP, tu tienda en línea, tu contabilidad) cada vez que pasa algo en el facturador; por ejemplo, cuando emites una factura. El sistema envía los datos del comprobante a la dirección que indiques. Lo configura quien administra ese otro sistema.
1. Revisa tus webhooks
Haz clic en Configuración y más en el menú lateral, luego en Configuraciones Globales y, en la sección Avanzado, elige Webhooks:
- Nuevo: Crea un webhook (paso 2).
- Suscripciones y Entregas: Tus webhooks y el historial de avisos enviados (paso 3).
- URL de destino: A dónde se envía el aviso.
- Eventos: Qué avisa; por ejemplo, Documento de venta emitido.
- Estado: Activo o pausado.
- Fallos consecutivos: Cuántos avisos seguidos no llegaron.
- Pausar, Editar y Eliminar. Al eliminar un webhook se borra también su historial de entregas.
2. Crea un webhook
Pulsa Nuevo:
-
Nombre: Por ejemplo,
ERP contable. -
URL de destino: La dirección que te da el otro sistema; por ejemplo,
https://erp.comercialandina.example/webhooks/facturador. Usa una dirección https. -
Eventos a escuchar: Marca al menos uno:
Evento Cuándo avisa Documento de venta emitido Al emitir una factura, boleta o nota. Documento aceptado por SUNAT (CDR) Cuando SUNAT lo acepta. Documento observado por SUNAT Cuando SUNAT lo acepta con observaciones. Documento rechazado por SUNAT Cuando SUNAT lo rechaza. Documento anulado (baja aceptada) Cuando SUNAT acepta su anulación. Compra registrada Al registrar una compra. -
Pulsa Guardar. El sistema muestra el Secreto del webhook: pulsa Copiar y entrégaselo a quien administra el otro sistema, para que compruebe que los avisos vienen de ti. Se muestra una sola vez.
3. Revisa las entregas
En la pestaña Entregas ves cada aviso con su Fecha, Evento, Estado (Exitoso, Pendiente o Fallido), Intentos y Código HTTP. Con Ver detalle ves los datos enviados y el error, y con Reenviar lo envías otra vez.
Si el otro sistema no responde, el sistema reintenta el aviso hasta 6 veces: al momento, al minuto, a los 10 minutos, a la hora, a las 6 horas y a las 24 horas. Si un webhook acumula 10 avisos fallidos seguidos, se pausa solo: revisa el otro sistema y vuelve a activarlo.
Nota
Los datos que se envían y cómo validar el secreto están en la documentación para desarrolladores.