Reports

Consultar ventas con descuento

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:

{
  "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.

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

Request body

dateFromstring required

Fecha inicial del periodo, en formato YYYY-MM-DD.

dateTostring required

Fecha final del periodo, en formato YYYY-MM-DD.

customerIdstring

Filtra por ID de un cliente específico. Omítelo para incluir todos los clientes.

limitinteger

Máximo de documentos con descuento a devolver, ordenados por monto de descuento. Por defecto 20, máximo 100.

Response

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

Changes

No recorded changes to this operation across all 1 revision of this API.