Factura global de tickets

Los tickets de Auto CFDI que tus clientes no facturan van a una factura global que emites con Crear factura, la misma petición de cualquier factura global. Lo único propio es el campo ticketId en cada concepto: con él, Fiscalapi verifica que el concepto refleje el ticket y lo marca como facturado en 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 en pending del emisor en el periodo con Listar tickets y details=true, que trae los conceptos con sus impuestos.

La lista es paginada: repite la consulta con el siguiente pageNumber mientras hasNextPage sea true.

GET /api/v4/tickets?status=pending&personId=<id>&from=2026-10-01&to=2026-10-31&details=true&pageNumber=1&pageSize=50

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.

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.

Crear factura global de tickets

curl --location 'https://test.fiscalapi.com/api/v4/invoices' \
--header 'X-TENANT-KEY: <tenant_key>' \
--header 'X-TIME-ZONE: America/Mexico_City' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api_key>' \
--data-raw '{
  "versionCode": "4.0",
  "series": "G",
  "date": "2026-11-01T10:00:00",
  "paymentFormCode": "01",
  "paymentMethodCode": "PUE",
  "currencyCode": "MXN",
  "exchangeRate": 1,
  "typeCode": "I",
  "expeditionZipCode": "42501",
  "exportCode": "01",
  "globalInformation": {
    "periodicityCode": "04",
    "monthCode": "10",
    "year": 2026
  },
  "issuer": { "id": "<person_id>" },
  "recipient": {
    "tin": "XAXX010101000",
    "legalName": "PUBLICO EN GENERAL",
    "zipCode": "42501",
    "taxRegimeCode": "616",
    "cfdiUseCode": "S01"
  },
  "items": [
    {
      "ticketId": "<ticket_id>",
      "itemCode": "01010101",
      "itemSku": "F-1002",
      "quantity": 1,
      "unitOfMeasurementCode": "ACT",
      "description": "Venta",
      "unitPrice": 100.000000,
      "discount": 0,
      "taxObjectCode": "02",
      "itemTaxes": [
        { "taxCode": "002", "taxTypeCode": "Tasa", "taxRate": "0.160000", "taxFlagCode": "T" }
      ]
    },
    {
      "ticketId": "<ticket_id>",
      "itemCode": "01010101",
      "itemSku": "F-1002",
      "quantity": 1,
      "unitOfMeasurementCode": "ACT",
      "description": "Venta",
      "unitPrice": 50.000000,
      "discount": 0,
      "taxObjectCode": "02",
      "itemTaxes": [
        { "taxCode": "002", "taxTypeCode": "Tasa", "taxRate": "0.000000", "taxFlagCode": "T" }
      ]
    }
  ]
}'

{
    "data": {
        "unavailableTickets": [
            { "ticketId": "9f8e7d6c-1b2a-4c3d-8e9f-0a1b2c3d4e5f", "status": "invoiced" }
        ]
    },
    "succeeded": false,
    "message": "Sorry, it's not me, it's you.",
    "details": "Uno o más tickets ya no están disponibles para la factura global (solo entra un ticket en estado pending): 'data.unavailableTickets' dice cuáles y su estado. No se cobró el timbre ni quedó tomado ningún ticket.",
    "httpStatusCode": 409
}

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. POST /api/v4/invoices
            |     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. DELETE /api/v4/invoices
            |     id de 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:

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.