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

# reports__getGeneralSalesTotals

`GET /tools/reports__getGeneralSalesTotals`

Obtiene totales de ventas agrupados por periodo (día, mes o año). Retorna totales como beforeTaxes, tax, total, discount, creditNote

## 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
  - `groupBy` 'day' | 'month' | 'year', required — Agrupación temporal
  - `optionalParams` object, nullable — Filtros extra sobre los mismos documentos que entran en los totales. Envía un objeto (no un texto con JSON escapado). Todo es opcional.<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 YYYY-MM-DD (además del rango from / to)<br>• documentStatus — open, closed o applied<br>• documentNumber — número del documento<br>• documentTypes — tipos separados por coma (invoice, creditNote, 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.

## Response `200`

Totales de ventas agrupados

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