---
title: "reports__getGeneralSalesDocuments"
method: GET
path: "/tools/reports__getGeneralSalesDocuments"
tags: ["Reports"]
---

# reports__getGeneralSalesDocuments

`GET /tools/reports__getGeneralSalesDocuments`

Obtiene una lista de documentos de venta individuales (facturas, notas crédito, notas débito) para un rango de fechas

## Request body

- object
  - `from` string, date, required — Fecha inicio en formato YYYY-MM-DD
  - `to` string, date, required — Fecha fin en formato YYYY-MM-DD
  - `start` string, required — Offset de paginación
  - `limit` string, required — Cantidad de registros devueltos por llamada (tamaño de página). Por defecto 10.
  - `optionalParams` object, nullable — Filtros extra sobre los documentos. Envía un objeto (no un texto con JSON escapado). Todo es opcional; puedes combinar varios.<br>• warehouseId — ID de la bodega de despacho<br>• customerId — ID del cliente<br>• documentName — texto del nombre o descripción del documento<br>• date — un solo día en formato YYYY-MM-DD (el rango principal sigue siendo from / to)<br>• documentStatus — estado: open, closed o applied<br>• documentNumber — número del documento a buscar<br>• documentTypes — tipos separados por coma, por ejemplo invoice, creditNote o incomeDebitNote
    - `warehouseId` string — Filtrar por ID de bodega de despacho.
    - `customerId` string — Filtrar por ID de cliente.
    - `documentName` string — Filtro por nombre o descripción del documento (no usar para vendedor, ítem ni cliente).
    - `date` string, date — Una sola fecha YYYY-MM-DD; para rangos usar from y to.
    - `documentStatus` 'closed' | 'open' | 'applied' — Estado del documento (open, closed, applied).
    - `documentNumber` string — Número de documento a filtrar.
    - `documentTypes` string — Tipos separados por coma; valores válidos invoice, creditNote, incomeDebitNote (ej. invoice,creditNote).

## Response `200`

Lista de documentos de venta

## Other responses

- `401` — No autorizado

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/revisions/cd52d3f68f1b/schema)