Códigos de error

Cada respuesta de error trae un codigoError corto además de una descripcion en texto libre. Un mismo código puede significar cosas distintas según el endpoint (por ejemplo E02 es “moneda incorrecta” en /ventaCrear pero “empresa no encontrada” en otros) — siempre hay que interpretarlo junto con el endpoint que lo devolvió, no de forma aislada.

En una respuesta exitosa, codigoError viene vacío.

Comunes a cualquier endpoint

A01 en Comunes a cualquier endpoint

Faltan las credenciales (x-api-key / x-api-secret)

A02 en Comunes a cualquier endpoint

x-api-key inválida o inactiva

A03 en Comunes a cualquier endpoint

x-api-secret inválido

A04 en Comunes a cualquier endpoint

Error interno validando credenciales

A05 en Comunes a cualquier endpoint

La API pública está desactivada temporalmente

A06 en Comunes a cualquier endpoint

El plan de la empresa no incluye acceso a la API

V01 en Comunes a cualquier endpoint

El body enviado no cumple con el formato esperado (tipo de dato incorrecto, campo obligatorio faltante, o campo no reconocido)

V02 en Comunes a cualquier endpoint

Error inesperado no capturado por el endpoint

POST /ventaCrear

E02 en /ventaCrear

Moneda incorrecta

E03 en /ventaCrear

Empresa no encontrada

E04 en /ventaCrear

Sin firma electrónica vigente

E05 en /ventaCrear

Sin CAE disponible

E08 en /ventaCrear

Formato de fecha inválido, debe ser dd/mm/aaaa

E15 en /ventaCrear

totalAPagar no coincide con el total calculado (ver “Cómo calcula Fixed el total” en POST /ventaCrear)

E18 en /ventaCrear

Datos de cliente inválidos para el tipo de documento indicado

E19 en /ventaCrear

Venta > 5000 UI sin documento, domicilio, localidad o departamento del cliente (DGI los exige)

E20 en /ventaCrear

formaDePago inválida

E21 en /ventaCrear

cotizacion inválida (debe ser mayor a 0)

E22 en /ventaCrear

Ya hay una emisión en curso con esa idempotencyKey

E23 en /ventaCrear

Esa idempotencyKey ya fue usada con datos distintos

E24 en /ventaCrear

descripcion supera 80 caracteres o descripcionLarga supera 500

E25 en /ventaCrear

observaciones supera los 500 caracteres

E26 en /ventaCrear

cantidad (mayor a 0, hasta 3 decimales), precioUnitario (mayor a 0, hasta 2 decimales) o descuentoMonto (0 o más, hasta 2 decimales) inválido en una línea

X01 en /ventaCrear

Local inválido

X02 en /ventaCrear

Tasa de IVA no habilitada en la empresa, o descuento mayor al importe de la línea

X03 en /ventaCrear

Error inesperado generando la factura

X04 en /ventaCrear

Error inesperado

X05 en /ventaCrear

Error inesperado generando la venta

POST /ventaDevolucionTotalCrear

E03 en /ventaDevolucionTotalCrear

Empresa no encontrada

E04 en /ventaDevolucionTotalCrear

Sin firma electrónica vigente

E05 en /ventaDevolucionTotalCrear

Sin CAE disponible

E08 en /ventaDevolucionTotalCrear

Formato de fecha inválido, debe ser dd/mm/aaaa

E10 en /ventaDevolucionTotalCrear

Venta original no encontrada

E11 en /ventaDevolucionTotalCrear

La venta original fue rechazada por DGI, no se puede emitir una NC sobre ella

E17 en /ventaDevolucionTotalCrear

totalADevolver no coincide con el total de la factura original

E21 en /ventaDevolucionTotalCrear

cotizacion inválida (debe ser mayor a 0)

E22 en /ventaDevolucionTotalCrear

Ya hay una emisión en curso con esa idempotencyKey

E23 en /ventaDevolucionTotalCrear

Esa idempotencyKey ya fue usada con datos distintos

E25 en /ventaDevolucionTotalCrear

adenda supera los 500 caracteres

X03 en /ventaDevolucionTotalCrear

Error inesperado generando la nota de crédito

X04 en /ventaDevolucionTotalCrear

Error inesperado

X05 en /ventaDevolucionTotalCrear

Error inesperado generando la devolución

X06 en /ventaDevolucionTotalCrear

Error inesperado obteniendo la venta original

POST /ventaConsulta y POST /imprimirCFE

C03 en /ventaConsulta y /imprimirCFE

Empresa no encontrada

C08 en /ventaConsulta y /imprimirCFE

El idCFE no existe para la empresa

POST /consultaFacturacionDia

E02 en /consultaFacturacionDia

Empresa no encontrada

E08 en /consultaFacturacionDia

Formato de fecha inválido, debe ser dd/mm/aaaa

POST /obtenerProximoNumero

E01 en /obtenerProximoNumero

Empresa no encontrada

E02 en /obtenerProximoNumero

No existe un CAE disponible para ese tipo de comprobante

E04 en /obtenerProximoNumero

tipoDocumento inválido

POST /consultarCFERecibidos

E01 en /consultarCFERecibidos

Empresa no encontrada

E02 en /consultarCFERecibidos

El rango entre fechaDesde y fechaHasta supera los 31 días

E03 en /consultarCFERecibidos

fechaDesde es mayor a fechaHasta

E04 en /consultarCFERecibidos

Formato de fecha inválido, debe ser dd/mm/aaaa

POST /consultarRUTDGI

E01 en /consultarRUTDGI

Empresa no encontrada

E02 en /consultarRUTDGI

Sin firma electrónica vigente

E03 en /consultarRUTDGI

RUT no encontrado en DGI

E04 en /consultarRUTDGI

Se superó el límite de 20 consultas por minuto. La API responde HTTP 429

POST /consultaCAE

E01 en /consultaCAE

Empresa no encontrada

POST /clienteMostrar, POST /localesListado, POST /serviciosRubrosListado

E02 en /clienteMostrar, /localesListado, /serviciosRubrosListado

Empresa no encontrada

POST /serviciosRubrosAgregarEditar

E01 en /serviciosRubrosAgregarEditar

accion inválida (debe ser "agregar" o "editar")

E02 en /serviciosRubrosAgregarEditar

Empresa no encontrada