Buscar y consultar facturas emitidas

La API de Facturear incluye endpoints para consultar el historial de facturas emitidas. Podés filtrar por CUIT emisor, receptor, tipo de comprobante, número o estado, y obtener los detalles completos incluyendo la respuesta de ARCA con el CAE y el PDF.

Desde el dashboard

En Facturas, pestaña Emitidas, ves todo lo que emitiste, de la más nueva a la más vieja, en el modo de tu cuenta (Producción o Testing) y del CUIT elegido en el selector de CUIT de arriba. Cada fila muestra el tipo y número de comprobante, el receptor, la descripción, la fecha y el importe, con un punto de color según el estado. Tocá la fila para abrir la factura.

Buscador: busca por CUIT, comprobante, tipo o receptor.
Filtros Avanzados: Comprobante (número), Tipo de Comprobante (facturas, notas de crédito y notas de débito A, B y C), Receptor (DNI, CUIT o nombre) y Estado (Exitoso o Error). El filtro CUIT aparece solo si tenés más de un CUIT y arriba está elegido Todos los CUITs.
Con error: las facturas que ARCA rechazó llevan esa etiqueta. Tocala para ver el motivo que devolvió ARCA.
Anulada: las facturas anuladas con una nota de crédito muestran el importe tachado.

Listar facturas

GET /api/invoices

Lista las facturas de tu cuenta, de la más nueva a la más vieja. Con la key de producción ves las facturas de producción; con la de testing, las de homologación.

curl "https://www.facture.ar/api/invoices" \
  -H "x-api-key: tu_api_key"

Con filtros

curl "https://www.facture.ar/api/invoices?cuit=20123456789&tipo=6&status=success&limit=50" \
  -H "x-api-key: tu_api_key"

Parámetros de búsqueda disponibles

Parámetro	Tipo	Descripción	Ejemplo
`cuit`	string	CUIT emisor (o parte de él)	`20123456789`
`receptor`	string	Documento del receptor (CUIT, CUIL o DNI, con o sin guiones) o parte de su nombre	`20-12345678-9`, `Acme`
`tipo`	integer	Código de ARCA del tipo de comprobante	`1` (A), `6` (B), `11` (C)
`comprobante`	string	Número de comprobante (se toman solo los dígitos)	`145`
`status`	string	Estado de la factura	`success`, `error`, `processing`
`search`	string	Busca en CUIT emisor, número de comprobante, código de tipo de comprobante y descripción	`consultoría`
`page`	integer	Página (desde `1`)	`1`
`limit`	integer	Resultados por página (default `10`, máx. `100`)	`50`

Todos los filtros se combinan: si mandás varios, la factura tiene que cumplir con todos.

Buscar por receptor

receptor encuentra las facturas emitidas a un cliente. Si le pasás un número de documento, busca por el DocNro exacto de la factura: 20-12345678-9, 20.123.456.789 y 20123456789 dan lo mismo. Si le pasás texto, busca por el nombre del cliente (clientName) sin distinguir mayúsculas, así que solo encuentra las facturas que emitiste con ese campo.

curl "https://www.facture.ar/api/invoices?receptor=20-12345678-9&tipo=6" \
  -H "x-api-key: tu_api_key"

El listado no tiene filtro por fecha ni por punto de venta. Para un período, recorré las páginas y filtrá por createdAt (la lista ya viene ordenada por fecha de creación), y por ptoVta si lo necesitás.

Respuesta de listado

Cada factura trae sus datos en Facturear, el pedido enviado a ARCA (feCAEReq) y la respuesta de ARCA (feCabResp), donde está el CAE:

{
  "invoices": [
    {
      "id": "cmg1a2b3e0002xyz",
      "cuitId": "cmg0a1b2c0000abc",
      "environment": "production",
      "amount": 121000,
      "voucherNumber": 145,
      "ptoVta": 1,
      "invoiceType": 6,
      "status": "success",
      "description": "Servicio de mantenimiento",
      "errorMessage": null,
      "feCAEReq": { "FeCAEReq": { "FeCabReq": { "CbteTipo": 6, "PtoVta": 1 }, "FeDetReq": { "FECAEDetRequest": [ { "DocTipo": 96, "DocNro": 30111222 } ] } } },
      "feCabResp": { "FeCabResp": { "Resultado": "A" }, "FeDetResp": { "FECAEDetResponse": [ { "Resultado": "A", "CAE": "76123456789012", "CAEFchVto": "20260925" } ] } },
      "createdAt": "2026-09-15T13:30:00.000Z",
      "updatedAt": "2026-09-15T13:30:05.000Z",
      "cuit": { "number": "20123456789" }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "totalCount": 145,
    "totalPages": 3,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

Consultar una factura específica

GET /api/invoices/

curl "https://www.facture.ar/api/invoices/cmg1a2b3e0002xyz" \
  -H "x-api-key: tu_api_key"

Devuelve la factura con los mismos campos que el listado, o 404 si no existe o no es tuya. O por número de comprobante:

curl "https://www.facture.ar/api/invoices?cuit=20123456789&tipo=6&comprobante=145" \
  -H "x-api-key: tu_api_key"

Si emitís con varios puntos de venta, el mismo número puede repetirse: revisá ptoVta en el resultado.

Obtener el PDF de una factura

curl "https://www.facture.ar/api/invoices/cmg1a2b3e0002xyz/pdf?download=true" \
  -H "x-api-key: tu_api_key" \
  --output factura.pdf

O como URL de descarga (sin download=true):

curl "https://www.facture.ar/api/invoices/cmg1a2b3e0002xyz/pdf" \
  -H "x-api-key: tu_api_key"

{
  "download_url": "https://...",
  "invoice_id": "cmg1a2b3e0002xyz",
  "invoice_number": "0001-00000145",
  "environment": "production"
}

También podés obtener la respuesta de ARCA en XML con GET /api/invoices/{id}/xml. Ver Descarga masiva de PDFs.

Filtrar por estado

Las facturas pueden tener estos estados:

Estado	Descripción
`success`	Factura emitida exitosamente con CAE
`error`	Hubo un error al emitir (por ejemplo, ARCA la rechazó). El motivo está en `errorMessage`
`processing`	Se está pidiendo el CAE a ARCA

Las facturas en error también se listan con GET /api/invoices/pending (misma paginación), y GET /api/invoices/stats devuelve el resumen: totalInvoices, successInvoices, errorInvoices, totalAmount (de las exitosas), pendingJobs (en cola) y environment (el entorno de tu API Key, del que salen todos los números).

Exportar facturas a CSV

Facturear no tiene un endpoint de exportación a CSV. Podés armarlo recorriendo GET /api/invoices página por página y escribiendo los campos que necesites (voucherNumber, ptoVta, invoiceType, amount, createdAt, etc.).

Ejemplo: buscar las facturas de un mes

async function facturasDelMes(miCuit, mes, anio) {
  const desde = new Date(anio, mes - 1, 1);
  const hasta = new Date(anio, mes, 1);
  const resultado = [];

  for (let page = 1; ; page++) {
    const params = new URLSearchParams({ cuit: miCuit, status: 'success', page, limit: 100 });
    const response = await fetch(`https://www.facture.ar/api/invoices?${params}`, {
      headers: { 'x-api-key': apiKey }
    });
    const { invoices, pagination } = await response.json();

    for (const factura of invoices) {
      const creada = new Date(factura.createdAt);
      if (creada >= desde && creada < hasta) resultado.push(factura);
    }

    const ultima = invoices[invoices.length - 1];
    if (!pagination.hasNextPage || (ultima && new Date(ultima.createdAt) < desde)) break;
  }

  console.log(`Facturas del mes: ${resultado.length}`);
  return resultado;
}

Recursos relacionados

Seguí estos pasos directamente en Facturear

Ir al dashboard de Facturear y consultar tus facturas emitidas.

Inicio

Con IA

Configuración

Funcionalidades

Cómo facturar

Integraciones

Cómo buscar y consultar facturas emitidas en Facturear

Buscar y consultar facturas emitidas

Desde el dashboard

Listar facturas

GET /api/invoices

Con filtros

Parámetros de búsqueda disponibles

Buscar por receptor

Respuesta de listado

Consultar una factura específica

GET /api/invoices/

Obtener el PDF de una factura

Filtrar por estado

Exportar facturas a CSV

Ejemplo: buscar las facturas de un mes

Recursos relacionados

Seguí estos pasos directamente en Facturear

​Buscar y consultar facturas emitidas

​Desde el dashboard

​Listar facturas

​GET /api/invoices

​Con filtros

​Parámetros de búsqueda disponibles

​Buscar por receptor

​Respuesta de listado

​Consultar una factura específica

​GET /api/invoices/

​Obtener el PDF de una factura

​Filtrar por estado

​Exportar facturas a CSV

​Ejemplo: buscar las facturas de un mes

​Recursos relacionados

Seguí estos pasos directamente en Facturear

Buscar y consultar facturas emitidas

Desde el dashboard

Listar facturas

GET /api/invoices

Con filtros

Parámetros de búsqueda disponibles

Buscar por receptor

Respuesta de listado

Consultar una factura específica

GET /api/invoices/

Obtener el PDF de una factura

Filtrar por estado

Exportar facturas a CSV

Ejemplo: buscar las facturas de un mes

Recursos relacionados