Factura global de tickets
La factura global de tickets ampara en un solo CFDI las ventas de Auto CFDI que tus clientes no autofacturaron. Es una factura global a nombre del público en general, como cualquier otra, que además liga cada concepto con su ticket. Con ese vínculo, Fiscalapi verifica que la factura refleje las ventas y marca los tickets como facturados, para que nadie los autofacture después.
Esta página explica cómo funciona la factura global de tickets. La referencia del endpoint, con el ejemplo en cada lenguaje y sus errores, está en Crear factura global de tickets.
Cómo funciona
La global de tickets se emite con la misma petición de cualquier factura global. Lo único propio es el campo ticketId en cada concepto, con el ID del ticket que ampara.
| Paso | Qué ocurre |
|---|---|
| 1 | Al cierre del periodo, consultas los tickets en pending de cada persona emisora. |
| 2 | Armas la factura global con un concepto por ticket y grupo de impuestos, cada uno con el ticketId de su ticket. |
| 3 | Timbras la global. Antes de cobrar el timbre, Fiscalapi reserva todos sus tickets o ninguno, y los pasa a globalizing. |
| 4 | Al guardar el CFDI, los tickets pasan a globalized con el ID de la factura en globalInvoiceId. Si el PAC rechaza el CFDI, vuelven a su estado anterior y el timbre se reembolsa. |
Un error de validación o un ticket que ya no está disponible no cobran el timbre ni dejan tickets tomados. Los estados del ticket explican cada valor de status.
Una factura global sin ticketId en sus conceptos no marca ningún ticket: siguen en pending y tus clientes los pueden autofacturar, lo que factura dos veces la misma venta. Incluye el ticketId de cada ticket que ampara la global.
Armar la factura global
Arma una global por cada combinación de persona emisora, moneda, tipo de cambio y lugar de expedición: el CFDI lleva un solo valor de cada uno, y el código postal del receptor público en general es el lugar de expedición. Una factura admite como máximo 1,500 conceptos; si tus tickets necesitan más, repártelos en varias globales sin partir un ticket entre dos.
1. Consulta los tickets pendientes
Consulta los tickets del emisor en el periodo con Listar tickets y estos filtros:
| Filtro | Valor |
|---|---|
status | pending |
personId | ID de la persona emisora. |
from y to | Primer y último día del periodo. |
details | true, para traer los conceptos con sus impuestos. |
La lista es paginada: repite la consulta con el siguiente pageNumber mientras hasNextPage sea true.
2. Arma un concepto por ticket y grupo de impuestos
Cada ticket se convierte en un concepto por cada grupo de sus conceptos con el mismo objeto de impuesto y los mismos impuestos. Fiscalapi calcula todos los impuestos de un concepto sobre la misma base, así que un ticket con productos al 16 % y al 0 % de IVA lleva dos conceptos, ambos con el mismo ticketId.
| Campo del concepto | Valor |
|---|---|
ticketId | ID del ticket. |
itemCode | 01010101 |
itemSku | Folio del ticket. |
quantity | 1 |
unitOfMeasurementCode | ACT |
description | Venta |
unitPrice | Suma de la cantidad por el valor unitario de los conceptos del grupo. |
discount | Suma de los descuentos de los conceptos del grupo. |
taxObjectCode e itemTaxes | Los del grupo, sin cambios. |
Fiscalapi compara, por cada ticket, la suma de sus conceptos en la global contra el ticket guardado: importes, descuentos e impuestos por impuesto, tipo de factor y tasa. Si no coinciden, responde 400 en el ticketId del primer concepto del ticket, sin cobrar.
3. Completa el comprobante
La global de tickets lleva el emisor por referencia (issuer.id), la persona emisora de los tickets. El receptor es el público en general y la forma de pago es la del ticket de mayor monto, según la guía de llenado de la factura global del SAT.
| Campo | Valor |
|---|---|
typeCode | I |
paymentMethodCode | PUE |
exportCode | 01 |
paymentFormCode | La forma de pago del ticket de mayor monto. |
currencyCode y exchangeRate | Los de los tickets. Con MXN, el tipo de cambio es 1. |
expeditionZipCode | El de los tickets. |
issuer.id | ID de la persona emisora de los tickets. |
recipient | RFC XAXX010101000, PUBLICO EN GENERAL, régimen 616, uso S01 y el código postal de expedición. |
globalInformation | Periodicidad, mes y año del periodo. Ver Información global. |
Sustituir una factura global de tickets
Para excluir tickets de una global ya timbrada, por ejemplo porque un cliente pidió su factura después, sustitúyela con los endpoints estándar: emite una nueva global con los tickets que se quedan y cancela la original. La guía de llenado de la factura global del SAT describe este caso: la nueva global sin la operación que se factura de forma nominativa, relacionada con la original por sustitución.
Global original (vigente) Tickets A, B y C en globalized
|
| 1. Crea la sustituta
| relatedInvoices: tipo 04 con el UUID de la original
| items[].ticketId: solo A y B
v
Global sustituta (vigente) A y B pasan a la sustituta (globalized)
C sigue en globalized en la original
|
| 2. Cancela la original
| motivo 01 y el UUID de la sustituta
v
Original en Cancelando --> el SAT confirma la cancelación
|
v
Original cancelada C vuelve a pending
Cada paso es una petición que puedes reintentar, y el estado lo dan los tickets y las facturas:
| Paso | Petición | Qué cambia |
|---|---|---|
| 1 | Crear factura global de tickets con relatedInvoices de tipo 04 y el UUID de la original, y el ticketId de los tickets que se quedan. | Al guardar la sustituta, sus tickets pasan de la original a ella. |
| 2 | Cancelar factura de la original con motivo 01 y la sustituta en replacementUuid. | La original pasa a Cancelando hasta que el SAT confirma. |
| 3 | Ninguna: Fiscalapi consulta al SAT. | Confirmada la cancelación, los tickets excluidos vuelven a pending. |
Para armar la sustituta, consulta los tickets de la original con Listar tickets y globalInvoiceId con el ID de la original. Copia de la original la serie, la persona emisora, la información global, la moneda, el tipo de cambio y el lugar de expedición, y vuelve a calcular la forma de pago con los tickets que se quedan.
Mientras la original siga vigente, sus tickets excluidos siguen en globalized y el portal no los autofactura. Cuando se confirma la cancelación de una global, cada uno de sus tickets vuelve a la global vigente más reciente que lo amparaba antes, o a pending si no hay ninguna. Por ejemplo, si cancelas la sustituta mientras la original sigue vigente, sus tickets vuelven a la original. Así, una venta nunca queda en pending mientras un CFDI vigente la ampara.
Si la original solo amparaba tickets que excluyes, no hay sustituta: cancélala con el motivo que corresponda a tu caso, sin relación. Consulta los motivos en Cancelar factura.