---
title: "Listar facturas globales"
method: POST
path: "/tools/globalInvoices_listGlobalInvoices"
tags: ["Sales Documents"]
---

# Listar facturas globales

`POST /tools/globalInvoices_listGlobalInvoices`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/globalInvoices_listGlobalInvoices`
- Auth: HTTP bearer

Herramienta MCP: `globalInvoices_listGlobalInvoices`.

Lista facturas globales mexicanas ("facturas globales"): los documentos CFDI que agrupan muchos tiquetes de venta (tiquetes de venta) emitidos al público en general en una sola factura timbrada, usando el RFC genérico del SAT XAXX010101000. Exclusiva de México.

Úsala para recorrer las facturas globales cuando no conoces sus IDs; cada registro incluye su arreglo de tiquetes de venta agregados (`saleTickets`) y su timbre CFDI. Una factura global es un documento distinto de una factura de venta ordinaria emitida a un cliente identificado.

Solo se admite paginación: este endpoint no tiene filtro de fecha, estado ni cliente, así que para encontrar una factura global concreta recorre los resultados y revisa los campos `date` y `numberTemplate`. Con `metadata: true` la respuesta se envuelve como `{ data: [...], metadata: { total } }`, donde `total` es el número de facturas globales de la empresa; úsalo cuando el usuario pregunte cuántas hay en total. Con false o sin `metadata` se devuelve un arreglo simple.

Solo lectura.

## Request body

- object
  - `start` integer: Desplazamiento basado en cero del primer registro a devolver (0 para la primera página, 30 para la segunda). Es una posición en el conjunto de resultados, no un ID de factura global. Omítelo para empezar desde el principio.
  - `limit` integer: Número de facturas globales por petición. Máximo 30, el máximo que impone todo endpoint de listado de ingresos de Alegra (la API responde con el código de error 903 por encima). Por defecto usa el valor por defecto de la API si se omite.
  - `metadata` boolean: Si es true, la respuesta se envuelve como { data: [...], metadata: { total } }, donde `total` es el número total de facturas globales de la empresa. Si es false o se omite, se devuelve un arreglo simple.

## Response `200`

Lista de facturas globales

## Other responses

- `401`: No autorizado

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)