Importar un CAE

Esta ruta importa un CAE desde un archivo XML autorizado por DGI y crea la libreta asociada para la empresa indicada por el header x-emisor.

Lectura rápida

Método	Endpoint	Content-Type
POST	/v2/cae/importar	multipart/form-data

POST https://api-test.facturaelectronica.com.uy/v2/cae/importar
Authorization: Bearer ACCESS_TOKEN
x-emisor: 219999830019
Content-Type: multipart/form-data

Headers requeridos

Header	Tipo o valor esperado	Requerido	Descripción
Authorization	Bearer ACCESS_TOKEN	Sí	Bearer token obtenido en Autenticación.
x-emisor	String o Int64	Sí	RUT de la empresa para la que se importa el CAE.
Content-Type	multipart/form-data	Sí	Tipo de contenido requerido para enviar el archivo y los demás campos.

Body form-data

Campo	Requerido	Descripción	Tipo
archivo	Sí	XML del CAE emitido por DGI. Tamaño máximo: 1 MB.	File
sucursal_cod	Condicional	Código DGI de la sucursal activa donde se crea la libreta. Es obligatorio si la empresa tiene más de una sucursal activa.	Text

Ejemplo en Postman

Campo	Tipo	Valor
archivo	File	CAE.xml
sucursal_cod	Text	6

Respuesta exitosa

La API responde 200 OK cuando importa el CAE y crea la libreta asociada.

{
  "Success": ["CAE importado correctamente"],
  "Data": {
    "cae": {
      "tipo_comprobante": 101,
      "documento_tipo": {
        "codigo": 101,
        "nombre": "e-Ticket"
      },
      "serie": "A",
      "desde": 1,
      "hasta": 500,
      "activo": true,
      "numero_autorizacion": 123456789,
      "fecha_autorizacion": "2026-06-25T00:00:00",
      "fecha_vencimiento": "2028-06-25T00:00:00",
      "tipo_autorizacion": "E",
      "causal_cae_esp": null,
      "vigente": true
    },
    "libreta": {
      "sucursal_cod": 6,
      "sucursal_nombre": "Casa Central",
      "desde": 1,
      "hasta": 500,
      "actual": 1,
      "activa": true,
      "disponible": true
    },
    "estado_uso": "CAE importado con libreta activa para emitir"
  }
}

Validaciones

• El archivo debe existir, no estar vacío y no superar 1 MB.
• El XML debe validar contra CAE.xsd.
• El valor RucE del XML debe coincidir con el emisor autorizado por x-emisor.
• TA debe ser E.
• TCFE debe existir como tipo de documento.
• HNro debe ser mayor o igual que DNro.
• NA no debe haber sido importado previamente.
• El rango no debe superponerse con una numeración existente para la misma empresa, tipo y serie.
• El CAE no debe estar vencido.
• sucursal_cod es obligatorio cuando la empresa tiene múltiples sucursales activas.

Errores comunes

Archivo faltante

[
  {
    "Tipo": "Error",
    "TipoCodigo": 3,
    "Detalle": {
      "Parametro": "archivo",
      "Errores": ["El archivo CAE XML es requerido."],
      "Data": null
    }
  }
]

Múltiples sucursales activas sin sucursal_cod

[
  {
    "Tipo": "Error",
    "TipoCodigo": 3,
    "Detalle": {
      "Parametro": "sucursal_cod",
      "Errores": [
        "Debe informar sucursal_cod porque la empresa tiene múltiples sucursales activas."
      ],
      "Data": [
        {
          "codigo": 6,
          "nombre": "Casa Central"
        },
        {
          "codigo": 7,
          "nombre": "Sucursal Centro"
        }
      ]
    }
  }
]

CAE duplicado o rango superpuesto

[
  {
    "Tipo": "Error",
    "TipoCodigo": 3,
    "Detalle": {
      "Parametro": "cae",
      "Errores": [
        "El rango del CAE se superpone con una numeración existente para la empresa, tipo y serie."
      ],
      "Data": null
    }
  }
]