Reports

Totalizar ventas por periodo

Herramienta MCP: reports_get_general_sales_totals.

Devuelve los totales de ventas agregados y AGRUPADOS POR PERIODO DE TIEMPO (día, mes o año): para cada periodo muestra los montos de ventas (beforeTaxes, tax, total, discount, creditNote).

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_get_general_sales_totals",
    "arguments": { "from": "2026-09-01", "to": "2026-09-30", "groupBy": "month" }
  }
}

Úsala cuando el usuario pregunte por cuánto se vendió en un periodo, por dia, mes o año: "¿cuántas ventas hubo en septiembre?", "¿cuál fue el total facturado por mes este año?". Para el detalle documento por documento usa reports_get_general_sales_documents en su lugar.

Las fechas from y to son obligatorias y van en formato YYYY-MM-DD. Elige la granularidad de groupBy según el nivel de detalle de la consulta del usuario. Los filtros adicionales van dentro de optionalParams, que debe enviarse como objeto JSON, nunca como cadena de texto.

Solo lectura.

post/tools/reports_get_general_sales_totals

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/reports_get_general_sales_totals
  • Auth
    HTTP bearer

Request body

fromstring required

Fecha inicial del rango, en formato YYYY-MM-DD. Calcúlala a partir de la consulta del usuario (por ejemplo, "enero de 2024" → "2024-01-01").

tostring required

Fecha final del rango, en formato YYYY-MM-DD. Calcúlala a partir de la consulta del usuario (por ejemplo, "enero de 2024" → "2024-01-31").

groupBy'day' | 'month' | 'year'

Agrupación por periodo de tiempo: day para diario, month para mensual, year para anual. Por defecto day. Elígela según el nivel de detalle de la consulta del usuario.

Response

Totales de ventas agregados por periodo de tiempo

Changes

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