Herramienta MCP: saleTickets_listSaleTickets.
Lista tickets de venta mexicanos. Un ticket de venta es una venta de mostrador, normalmente al público en general (RFC genérico XAXX010101000): en Alegra es un documento de venta cuya numeración tiene documentType "saleTicket". No se timbra ante el SAT por sí solo: se reporta después agrupado en una factura global, o se convierte uno a uno en una factura CFDI cuando un cliente pide su propia factura. Exclusiva de México.
Úsala para encontrar tickets cuando no conoces su ID, o para reportar por periodo, estado, folio o cliente (por RFC con client_identification, por nombre con client_name; globalFilter busca a la vez en nombre y folio). Paginada: hasta 30 por página con limit y desplazamiento con start. Orden por defecto: fecha de emisión, de la más reciente a la más antigua. Devuelve solo tickets de venta, nunca facturas ordinarias. Usa saleTickets_getSaleTicket cuando ya tienes el ID y saleTickets_listForGlobalInvoice cuando la pregunta es qué tickets faltan por agrupar en una factura global.
La respuesta es { metadata: { total }, data: [...] }, donde total es el número de tickets que cumplen los filtros en todas las páginas. Por defecto cada registro es una proyección ligera (ID, fechas, estado, folio, cliente, totales, paymentMethod, indicadores editable/voidable/deletable y la factura global o factura en la que terminó); envía detail: true solo cuando el usuario pida el documento completo.
Solo lectura.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401No autorizado