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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
≥ 0

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.

integer
1 to 30

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.

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.

Responses

401

No autorizado

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