> ## Documentation Index
> Fetch the complete documentation index at: https://docs.facture.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo buscar y consultar facturas emitidas en Facturear

> Cómo buscar, filtrar y consultar facturas electrónicas emitidas a través de la API de Facturear: filtros por CUIT emisor, receptor, tipo, estado y número de comprobante.

# 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](/es/guides/nota-credito-debito#anular-una-factura-completa) 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.

```bash theme={null}
curl "https://www.facture.ar/api/invoices" \
  -H "x-api-key: tu_api_key"
```

### Con filtros

```bash theme={null}
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.

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

<Note>
  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.
</Note>

***

## 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:

```json theme={null}
{
  "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/{id}

```bash theme={null}
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:

```bash theme={null}
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

```bash theme={null}
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`):

```bash theme={null}
curl "https://www.facture.ar/api/invoices/cmg1a2b3e0002xyz/pdf" \
  -H "x-api-key: tu_api_key"
```

```json theme={null}
{
  "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](/es/guides/descarga-pdf-masiva).

***

## 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

```javascript theme={null}
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

* [Primera factura con Facturear](/es/guides/primera-factura)
* [Descarga masiva de PDFs](/es/guides/descarga-pdf-masiva)
* [Nota de crédito y débito](/es/guides/nota-credito-debito)
* [API Keys y autenticación](/es/guides/api-keys)

***

<Card title="Seguí estos pasos directamente en Facturear" icon="arrow-right" href="https://facture.ar">
  Ir al dashboard de Facturear y consultar tus facturas emitidas.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.