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.

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
Defaults to 0

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

string
Defaults to 10

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

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