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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
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").

string
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").

string
enum
Defaults to day

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.

Allowed:
optionalParams
object

Filtros opcionales. CRÍTICO: este parámetro debe ser un objeto JSON, NUNCA una cadena de texto; no lo envíes como texto. Envíalo como objeto: {"documentStatus": "open"}. Ejemplos: {"documentTypes": "invoice"} para "facturas"; {"documentStatus": "open"} para documentos abiertos o cerrados.

Responses

401

No autorizado (token de Alegra inválido o expirado).

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json