Reports

Listar documentos de venta

Herramienta MCP: reports_get_general_sales_documents.

Devuelve una LISTA de documentos individuales de venta (facturas, notas crédito y notas débito) dentro de un rango de fechas, paginada.

Ejemplo de llamada JSON-RPC:

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

Úsala cuando el usuario pida el detalle documento por documento de las ventas de un periodo: qué facturas o notas se emitieron, con qué fechas, estados y valores. Para totales agregados por periodo, del tipo "¿cuánto se vendió en septiembre?", usa reports_get_general_sales_totals en su lugar.

Las fechas from y to son obligatorias y van en formato YYYY-MM-DD. La paginación start y limit son cadenas de texto: envíalas como texto (por ejemplo "0" y "10"), no como números. 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_documents

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/reports_get_general_sales_documents
  • 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").

startstring

Desplazamiento de paginación: número de registros a omitir. Por defecto "0". Envíalo como texto, no como número.

limitstring

Máximo de registros por llamada. Por defecto "10". Envíalo como texto, no como número.

Response

Lista paginada de documentos de venta del periodo

Changes

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