Listar tickets de venta

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.

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 (0 = primera página, 30 = segunda con limit 30). Es una posición en el resultado, no un ID de ticket.

integer
1 to 30

Tickets por página, de 1 a 30 (por defecto 30, el máximo de la API).

string
^\d{4}-\d{2}-\d{2}$

Fecha de emisión exacta, YYYY-MM-DD.

string
^\d{4}-\d{2}-\d{2}$

Fecha de emisión estrictamente posterior a este día (exclusiva), YYYY-MM-DD.

string
^\d{4}-\d{2}-\d{2}$

Fecha de emisión en este día o después (inclusiva). Úsala con date_beforeOrNow para un periodo. YYYY-MM-DD.

string
^\d{4}-\d{2}-\d{2}$

Fecha de emisión estrictamente anterior a este día (exclusiva), YYYY-MM-DD.

string
^\d{4}-\d{2}-\d{2}$

Fecha de emisión en este día o antes (inclusiva), YYYY-MM-DD.

string
^\d{4}-\d{2}-\d{2}$

Fecha de vencimiento exacta (en tickets suele ser igual a la de emisión), YYYY-MM-DD.

string
^(open|closed|draft|void)(,(open|closed|draft|void))*$

Estado, separado por comas para combinar: open (emitido con saldo pendiente), closed (pagado), draft (borrador), void (anulado). Omítelo para todos.

string

RFC del cliente, coincidencia parcial (por ejemplo XAXX010101000, el RFC genérico del público en general). Es la forma de filtrar por cliente.

string

Nombre del cliente, coincidencia parcial ("Público" coincide con "Público en general").

string

Folio impreso (prefijo + número), coincidencia parcial, por ejemplo "TV-15" o "15".

string

Prefijo de numeración exacto; separado por comas para combinar, por ejemplo "TV,TK".

string

ID interno de moneda de Alegra (no el código ISO), separado por comas para combinar. Solo útil en empresas multimoneda.

string

Búsqueda de texto libre en nombre del cliente o folio a la vez (como el buscador de Alegra). Los campos los define globalFilterFields.

string
enum

Campos en los que busca globalFilter (por defecto ambos). Solo se usa junto con globalFilter.

Allowed:
string
enum

Campo de orden. Por defecto: date, de la más reciente a la más antigua. No admite ordenar por folio ni por RFC.

Allowed:
string
enum

Dirección del orden. Por defecto DESC.

Allowed:
boolean
Defaults to false

Si es false (por defecto), cada ticket es una proyección ligera. true solo cuando el usuario pida el documento completo (ítems, impuestos, pagos, direcciones).

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