ALalegra
Sales Documents

Listar facturas globales

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.

post/tools/globalInvoices_listGlobalInvoices

Request

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

Request body

startinteger

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.

limitinteger

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.

metadataboolean

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

Lista de facturas globales

Changes

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