Idempotencia en API de facturación electrónica: cómo prevenir CFE duplicados
Las integraciones deben estar preparadas para solicitudes repetidas, errores de red y respuestas tardías. Los identificadores externos y consultas de estado ayudan a evitar crear comprobantes de una venta más de una vez.
Cuándo usar esta guía y qué preparar
Las integraciones deben estar preparadas para solicitudes repetidas, errores de red y respuestas tardías. Los identificadores externos y consultas de estado ayudan a evitar crear comprobantes de una venta más de una vez.
Antes de modificar datos fiscales, identificá la empresa emisora, el ambiente de trabajo y el rol con el que ingresaste. Los procesos de DGI pueden requerir autorizaciones externas a Factumel.
Procedimiento paso a paso
Seguí este recorrido en el panel y verificá cada resultado antes de avanzar.
- Asigná un identificador de negocio estable a cada operación de venta.
- Conservá ese identificador junto con los resultados de cada solicitud a la API.
- Antes de reintentar tras un timeout, consultá si la operación ya existe.
- Procesá webhooks y respuestas de forma idempotente para no duplicar efectos.
- Registrá logs técnicos sin exponer secretos ni datos sensibles.
Errores frecuentes y controles importantes
Usá esta lista de verificación para reducir errores operativos y evitar diferencias entre lo registrado en Factumel y la situación fiscal efectiva.
- Un timeout de HTTP no significa que el documento no se creó.
- No cambies el identificador de la misma operación durante cada reintento.
- Nunca bases la deduplicación únicamente en el importe de la factura.
Preguntas habituales
¿Basta con reintentar el POST? No, consultá primero el estado del documento.
¿El webhook puede llegar más de una vez? Diseñá siempre el procesamiento para admitir duplicados y reintentos.