Ir al contenido
Eventos

FISCALISTO / API / REFERENCIA

recurring_invoice.failed

Abrir en ChatGPTAbrir en Claude

Una factura recurrente no pudo timbrar su periodo (sin timbres, el cliente se borró del catálogo, el SAT la rechazó…). data.object es la factura recurrente, con el motivo en last_error. Se intenta de nuevo cada día a su hora; llega una vez hasta que vuelva a timbrar. Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).

Cuerpo de la solicitud

application/json
  1. body

Algo que pasó en su cuenta: el objeto completo como quedó. Se manda a sus webhooks firmado (Standard Webhooks).

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

object*string

Qué tipo de objeto es («invoice», «customer»…).

type*string

Qué pasó: invoice.stamped, invoice.failed, invoice.canceled, invoice.cancellation_pending, invoice.cancellation_rejected, invoice.paid, invoice.partially_paid, retention.stamped, retention.failed, retention.canceled, invoice_batch.completed, customer_data_request.completed, sat_download.completed, sat_download.failed, sat_declaration.created, sat_declaration.updated, ticket.invoiced, ticket.included_in_global, recurring_invoice.failed, quote.viewed, quote.accepted, quote.changes_requested, quote.rejected, issuer.ready, balance.low o test_clock.ready.

api_version*string

Versión de la API con que se armó el objeto.

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

created_at*string

Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).

Formatodate-time
data*

Lo que cambió, en data.object: el comprobante (o el lote) completo, como lo contesta su GET.

Cuerpo de la respuesta

Conteste 2xx en menos de 15 segundos; si no, se reintenta durante un día.

Así llega a su webhook

{  "id": "evt_0PKhIdhYuAGwzmMQYfkc",  "object": "event",  "type": "recurring_invoice.failed",  "api_version": "2026-10-24",  "livemode": false,  "created_at": "2026-10-24T10:15:42-06:00",  "data": {    "object": {      "id": "rin_OufpKqnrvx9p7Hq2mZr1XyT5uBcW8sKdLx",      "object": "recurring_invoice",      "livemode": false,      "issuer": "iss_OufpKqnrvx9p",      "name": "Renta oficina 3",      "status": "active",      "schedule": {        "frequency": "monthly",        "interval": 1,        "day_of_month": 1,        "hour": 7,        "time_zone": "America/Mexico_City"      },      "next_invoice_on": "2026-11-01",      "last_invoiced_on": "2026-10-01",      "last_invoice": "inv_OufpKqnrvx9p6hW1yQbT3mZr8sKdLx0VeN",      "last_error": {        "message": "La cuenta no tiene timbres de producción. Compre un paquete y se intentará de nuevo mañana."      },      "send_email": true,      "catch_up": "all",      "customer": {        "tax_id": "ICV060329BY0",        "legal_name": "INMOBILIARIA CVA"      },      "currency": "MXN",      "items": [        {          "description": "Renta de oficina de {mes} {año}",          "product_key": "80131500",          "quantity": 1,          "unit_key": "E48",          "unit_price": 15000        }      ],      "total": 17400,      "created_at": "2026-09-28T11:02:14-06:00"    }  }}

ticket.included_in_global Webhook

Un ticket que nadie facturó entró en la factura global del periodo. data.object es el ticket, con la factura global en global_invoice. Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).

quote.viewed Webhook

El cliente abrió por primera vez la liga de una cotización enviada. data.object es la cotización. Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).