Errores frecuentes de Factumel API y cómo resolverlos
Qué hacer ante 401, 403, 404, 409, 413, 415, 422, 429, errores de certificado, CAE y timeouts de DGI sin duplicar comprobantes.
Diagnóstico de respuestas HTTP
Un error HTTP es una pista, no una instrucción para volver a emitir inmediatamente. El detalle puede incluir un código y campos problemáticos.
- 401: clave inválida, vencida o revocada. Revisá ambiente y encabezado Bearer.
- 403: falta un scope o intentaste una función deshabilitada, como one-shot en producción.
- 404: el recurso no existe o no corresponde al tenant, empresa o ambiente de la clave.
- 409: conflicto de datos o estado. Antes de intentar otra emisión consultá el comprobante existente.
- 413: payload supera el límite permitido.
- 415: Content-Type incorrecto; JSON debe enviarse como application/json.
- 422: el payload o una condición fiscal no cumple las validaciones.
- 429: cuota por clave excedida; respetá Retry-After.
Si falla DGI o la red
Conservá el externalId y consultá el CFE existente. Un timeout puede ocurrir después de que DGI reciba la transmisión; repetir a ciegas puede crear consecuencias fiscales no deseadas.
Revisá el estado del sobre, los logs seguros del sistema y la preparación fiscal. No incluyas secretos, certificados ni XML de clientes reales en tickets públicos de soporte.
Problemas de configuración fiscal
Si aparecen errores de firma o CAE, confirmá vencimientos, correspondencia entre RUT y certificado, rango disponible, tipo de comprobante y formato XSD. Para homologación seguí el procedimiento oficial de DGI.