---
title: "Consultar ventas con descuento"
method: POST
path: "/tools/reports_get_sales_by_discount"
tags: ["Reports"]
---

# Consultar ventas con descuento

`POST /tools/reports_get_sales_by_discount`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/reports_get_sales_by_discount`
- Auth: HTTP bearer

Herramienta MCP: `reports_get_sales_by_discount`.

Devuelve las ventas de documentos a los que se les aplicó un descuento en un periodo, ordenados por monto de descuento (de mayor a menor), junto con los totales `totalDocuments` y `totalDiscount`. Opcionalmente filtra por cliente. Usa `limit` para acotar cuántos documentos se listan (por defecto 20, máximo 100).

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_sales_by_discount",
    "arguments": { "dateFrom": "2026-09-01", "dateTo": "2026-09-30" }
  }
}
```

Úsala cuando el usuario pregunte qué ventas tuvieron descuento en un periodo, cuánto se perdió en descuentos o qué facturas con descuento tiene un cliente.

Las fechas `dateFrom` y `dateTo` son obligatorias y van en formato YYYY-MM-DD. Si la respuesta indica `truncated` en true, la API tiene más documentos con descuento que el `limit` solicitado: sugiere al usuario aumentar `limit` o acortar el rango de fechas.

Solo lectura.

## Request body

- object
  - `dateFrom` string, required: Fecha inicial del periodo, en formato YYYY-MM-DD.
  - `dateTo` string, required: Fecha final del periodo, en formato YYYY-MM-DD.
  - `customerId` string: Filtra por ID de un cliente específico. Omítelo para incluir todos los clientes.
  - `limit` integer: Máximo de documentos con descuento a devolver, ordenados por monto de descuento. Por defecto 20, máximo 100.

## Response `200`

Documentos con descuento ordenados por monto de descuento, con sus totales

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)