Consultar CFE recibidos

Consulta los CFEs recibidos (comprobantes de compra) emitidos por otras empresas hacia la empresa, dentro de un rango de fechas, opcionalmente filtrados por el RUT del emisor/proveedor.

fechaDesde y fechaHasta son formato dd/mm/aaaa, inclusive. El rango entre ambos no puede superar los 31 días.

Por default, solo consulta lo que Fixed ya tiene guardado. Con consultarNuevos: true se fuerza además una consulta en vivo a DGI por CFEs nuevos en ese rango (igual que el botón “Consultar en DGI nuevos CFEs recibidos” de la web) — puede demorar bastante más, y depende de que el mail con el comprobante ya le haya llegado a Fixed para poder guardarlo (DGI solo informa metadatos, no el XML). Si esa consulta falla por cualquier motivo, la respuesta igual incluye los datos ya guardados, con una advertencia en descripcion.

La guía correspondiente está en CFE recibidos.

Solicitud

La ruta POST /consultarCFERecibidos 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
rut	string	No	RUT del emisor/proveedor a filtrar (opcional). Si no se envía, devuelve todos los CFEs recibidos en el rango de fechas.	219314970014
fechaDesde	string	Sí	Fecha desde (inclusive), formato dd/mm/aaaa. El rango entre fechaDesde y fechaHasta no puede superar los 31 días.	01/06/2026
fechaHasta	string	Sí	Fecha hasta (inclusive), formato dd/mm/aaaa. El rango entre fechaDesde y fechaHasta no puede superar los 31 días.	30/06/2026
consultarNuevos	boolean	No	Si es true, antes de responder Fixed consulta a DGI en vivo por CFEs nuevos en el rango indicado (mismo mecanismo que el botón “Consultar en DGI nuevos CFEs recibidos” de la web). Importante: DGI solo informa metadatos del comprobante, no el XML — un CFE recién reportado por DGI solo se guarda si el mail con el XML adjunto ya le llegó a Fixed. Si ese mail no llegó todavía, no va a aparecer en el resultado por más que se use este parámetro. Puede demorar bastante más que una consulta normal. Si falla (sin firma electrónica vigente, timeout, o error de DGI), igual se devuelven los datos ya guardados en Fixed, con una advertencia en descripcion. Opcional, default false.	false

Respuesta 200

Listado de CFEs recibidos en el rango de fechas

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

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

Respuesta cfesRecibidos

Campo	Tipo	Obligatorio	Descripción	Ejemplo
idCFE	string	Sí	Id interno del CFE recibido en Fixed.	—
emisorNombre	string	Sí	Nombre del emisor/proveedor.	—
rutEmisor	string	Sí	RUT del emisor/proveedor.	—
tipo	string	Sí	Tipo de documento recibido. Valores: compra, recibo, remito, resguardo.	—
tcfe	number	Sí	Tipo de CFE (código numérico DGI).	—
numero	number	Sí	—	—
serie	string	Sí	—	—
comprobante	string	Sí	—	—
fechaComprobante	number	Sí	Fecha del comprobante, timestamp en milisegundos (epoch).	—
moneda	string	Sí	—	—
total	number	Sí	—	—
formaPago	string	Sí	Valores: contado, credito.	—
estado	string	Sí	Estado de la respuesta ante DGI. Valores: aceptado, rechazado, sinRespuesta.	—
anulado	boolean	Sí	—	—
xml	string	Sí	XML del comprobante.	—

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
E02	El rango entre fechaDesde y fechaHasta supera los 31 días
E03	fechaDesde es mayor a fechaHasta
E04	Formato de fecha inválido, debe ser dd/mm/aaaa

HTTP 500

Error de validación (ver codigoError)

{
  "descripcion": "El rango entre fechaDesde y fechaHasta no puede superar los 31 días.",
  "codigoError": "E02",
  "cfesRecibidos": []
}

Ejemplos

Ejemplo con el valor de cada campo del contrato.

{
  "rut": "219314970014",
  "fechaDesde": "01/06/2026",
  "fechaHasta": "30/06/2026",
  "consultarNuevos": false
}