Consultar CAE

Consulta los CAE (autorizaciones de numeración) de la empresa, con su información completa.

Con soloDisponibles: true devuelve solo los vigentes (disponible == true y no vencidos). Sin ese campo, o en false, devuelve todos los CAE cargados, vencidos o agotados incluidos.

La guía correspondiente está en Pasar a producción.

Solicitud

La ruta POST /consultaCAE se agrega a la URL base del ambiente.

Enviá los headers x-api-key y x-api-secret. Cómo obtenerlos está en Credenciales.

El cuerpo es JSON (Content-Type: application/json).

Campos

Si falta un campo obligatorio, la API rechaza la solicitud.

Campo	Tipo	Obligatorio	Descripción	Ejemplo
soloDisponibles	boolean	No	Si es true, devuelve solo los CAE vigentes (disponibles y no vencidos). Si es false o no se envía, devuelve todos los CAE cargados en el sistema.	false

Respuesta 200

Listado de CAE

Si la operación sale bien, codigoError viene vacío.

Campo	Tipo	Obligatorio	Descripción	Ejemplo
descripcion	string	Sí	—	—
codigoError	string	Sí	—	—
caes	array de objetos	Sí	Ver caes.	—

Respuesta caes

Campo	Tipo	Obligatorio	Descripción	Ejemplo
tcfe	number	Sí	Tipo de CFE (código numérico DGI).	—
serie	string	Sí	Serie autorizada por este CAE.	—
desdeNumero	number	Sí	Primer número autorizado.	—
hastaNumero	number	Sí	Último número autorizado.	—
numeroAutorizacion	string	Sí	Número de autorización del CAE.	—
fechaAutorizacion	string	Sí	Formato dd/mm/aaaa.	—
fechaVencimiento	string	Sí	Formato dd/mm/aaaa.	—
caeEspecial	string	Sí	0=ninguno, 1=exonerado, 2=Literal E, 3=Monotributo, 4=Monotributo MIDES.	—
disponible	boolean	Sí	Indica si Fixed lo considera disponible para emitir.	—
ultimoUsado	number	Sí	Último número ya usado. 0 si todavía no se usó ninguno.	—
numerosDisponibles	number	Sí	Cantidad de números todavía disponibles en este CAE.	—
xml	string	Sí	XML de autorización del CAE emitido por DGI.	—

Errores

Una respuesta de error trae codigoError y descripcion. El mismo código puede significar cosas distintas según el endpoint. El índice completo está en Códigos de error.

Si fallan las credenciales o el formato del body, aplican los códigos comunes: A01 a A06, V01 y V02.

Código	Significado
E01	Empresa no encontrada

HTTP 500

Error de validación

{
  "descripcion": "Empresa no encontrada",
  "codigoError": "E01",
  "caes": []
}

Ejemplos

Ejemplo con el valor de cada campo del contrato.

{
  "soloDisponibles": false
}