Dataico
troubleshootingActualizado 9 de octubre de 2026

Error API: Números de Factura Inválidos

Detalle (RESPONSE)

"error": "El número para este documento '1' es inválido. Tiene que ser el siguiente número '3' para su numeración"

Los números del mensaje van sin prefijo: '1' es el número que enviaste y '3' el siguiente consecutivo de la numeración.

Explicación del Error

Este error solo aparece cuando la factura se envía con numbering.flexible en false. En ese modo, el número debe ser exactamente el siguiente de la numeración a la que va dirigida la solicitud.

En el ejemplo anterior, el último consecutivo usado fue el 2, así que el siguiente número válido es el 3. Intentar usar el 1 genera el error.

Por defecto numbering.flexible es true. En ese modo no hace falta enviar el siguiente consecutivo: basta con que el número esté dentro del rango de la resolución y no exista todavía.

Pasos para Solucionar el Error

  1. Lee el mensaje de error del response: indica exactamente cuál es el siguiente consecutivo válido.
  2. Reenvía la solicitud utilizando el consecutivo indicado en el response.
  3. Si tu integración no necesita controlar el consecutivo de forma estricta, puedes dejar numbering.flexible en true (o no enviarlo).
  4. Si tienes dudas sobre la secuencia de numeración, verifica en Dataico:
    • Ve a Ventas > Facturas y selecciona la opción Numeraciones.
    • Haz clic en el ícono de edición (lápiz) de la numeración a donde va dirigida la solicitud.
    • Verifica el consecutivo más reciente y confirma que el consecutivo sugerido por la API sea el siguiente en la secuencia.

Recursos Adicionales

¿Este artículo te fue útil?