CFDI timbrado
Se timbró un CFDI en tu cuenta. Útil para guardar el UUID en tu ERP o disparar el siguiente paso de tu proceso.
Tu sistema se entera cuando pasa algo con tus CFDI.
Cuando se timbra o se cancela un CFDI, o cuando se registra un pago, Factura Digital envía un aviso firmado a la URL de tu sistema. Si tu servidor no responde, el aviso se reintenta. Viene incluido con la API v5: pagas folios, no la API.
Así llegan los avisos a tu sistema
Ejemplo ilustrativo: cada aviso es una petición a la URL que registres, con el tipo de evento y el CFDI al que se refiere.
Avisos recibidos
Ejemplo ilustrativorecibidoreintentoejemplo
Contenido del aviso
ejemplo- Evento
- CFDI timbrado
- UUID del CFDI
- 71E5C0A8-4D2F-4B19-…
- Firma
- En el encabezado de la petición
El formato completo de cada aviso está en la documentación. docs.facturadigital.com.mx
Eventos que recibes
Los momentos del ciclo del CFDI que le importan a tu sistema.
CFDI cancelado
Se canceló un CFDI. Tu sistema actualiza el estatus sin que alguien lo capture a mano.
Pago registrado
Se registró un pago de una factura. Útil para marcarla como cobrada en tu sistema.
Del evento a tu sistema
Registras la URL de tu sistema una vez. Después, cada aviso llega cuando ocurre el evento.
- paso 01
Registras la URL de tu sistema
una sola vez
- paso 02
Ocurre el evento
timbrado, cancelación o pago
- paso 03
Enviamos un aviso firmado
a tu URL
- paso 04
Si no hay respuesta, reintentamos
Verifica la firma de cada aviso antes de procesarlo: así sabes que viene de Factura Digital. Como un aviso puede reintentarse, prepara tu sistema para recibir el mismo aviso más de una vez.
Qué incluyen los webhooks
Lo necesario para que tu sistema confíe en cada aviso y no pierda ninguno.
Peticiones firmadas
Cada aviso va firmado. Tu sistema verifica la firma y descarta lo que no venga de Factura Digital.
Reintentos
Si tu servidor está caído o responde con error, el aviso se vuelve a enviar.
Sin consultar a cada rato
Tu sistema no tiene que preguntarle a la API cada cierto tiempo si hubo cambios: el aviso llega cuando ocurre el evento.
Cualquier lenguaje
Recibes una petición en la URL que tú elijas y la procesas con el lenguaje y el servidor que ya usas.
Preguntas frecuentes
¿Tienes otra duda sobre la integración?
¿Qué eventos puedo recibir?
Avisos cuando se timbra un CFDI, cuando se cancela un CFDI y cuando se registra un pago.
¿Cómo sé que el aviso viene de Factura Digital?
Cada aviso va firmado. Tu sistema verifica la firma antes de procesarlo y descarta lo que no coincida. La documentación explica cómo hacer la verificación.
¿Qué pasa si mi servidor no responde?
El aviso se reintenta. Conviene que tu sistema responda rápido, procese el aviso después y esté preparado para recibir el mismo aviso más de una vez.
¿Necesito webhooks para usar la API?
No. Al timbrar por la API, la respuesta ya trae el UUID, el XML y la liga al PDF. Los webhooks sirven para enterarte de lo que pasa después o fuera de tu sistema, como una cancelación o un pago registrado.
¿Tienen costo extra?
No. Los webhooks son parte de la API v5, que viene incluida: pagas folios, no la API.
¿Me ayudan a configurarlos?
Sí. Escríbenos por WhatsApp al +52 81 2044 5452 y te atiende una persona del equipo.
Conecta tu sistema con la API v5.
Crea tu cuenta con 10 folios de regalo, sin tarjeta. La API, el sandbox y los webhooks vienen incluidos: pagas folios.