Facturas recurrentes

Una factura recurrente se timbra sola en cada fecha, con los timbres de su cuenta, y se le manda al cliente si así lo pide. Usted no necesita un cron ni guardar en qué mes va: Fiscalisto timbra cada periodo una sola vez, aunque su servidor reintente o esté caído.

Crear unaCopiar enlace a esta sección

curl https://api.fiscalisto.com/v1/recurring_invoices \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Renta oficina 3",
    "schedule": { "frequency": "monthly", "day_of_month": 1, "hour": 7 },
    "invoice": {
      "customer": {
        "tax_id": "ICV060329BY0",
        "legal_name": "INMOBILIARIA CVA",
        "tax_system": "601",
        "zip": "33826",
        "email": "pagos@cva.example"
      },
      "payment_form": "03",
      "items": [
        {
          "description": "Renta de oficina de {mes} {año}",
          "product_key": "80131500",
          "unit_price": 15000
        }
      ]
    }
  }'

invoice es el mismo cuerpo de POST /v1/invoices, sin issuer, folio, date, global ni metadata: cada factura toma el folio siguiente y la fecha del día en que se timbra. Se revisa al crearla con las mismas reglas, así que un RFC mal escrito o una clave que no existe se rechazan ahora y no el día que toca timbrar. También puede usar un cliente de su catálogo ("customer": "cus_…") o productos ("product": "prd_…"): cada factura toma los datos que el cliente tenga en ese momento.

Contesta 201 con la factura recurrente (rin_…), su siguiente fecha en next_invoice_on y el total de cada factura con los precios de hoy.

Cada cuántoCopiar enlace a esta sección

day_of_month va del 1 al 28, o "last". start_date (AAAA-MM-DD) es la primera factura; si no la manda, es el próximo day_of_month (mensual) o hoy (semanal y diaria). hour (0 a 23, por omisión 7) es la hora en que se timbra, en time_zone (por omisión America/Mexico_City; también America/Cancun, America/Mazatlan, America/Hermosillo, America/Tijuana y America/Ciudad_Juarez).

Textos que cambian cada mesCopiar enlace a esta sección

En description escriba {mes}, {mes anterior}, {mes siguiente}, {año}, {año anterior}, {año siguiente} o {periodo} y cada factura los llena con su fecha: Renta de oficina de {mes} {año} sale como Renta de oficina de noviembre 2026. {periodo} sigue la frecuencia: el mes completo en una mensual (1 al 30 de noviembre), la semana en una semanal (2 al 8 de noviembre) y todos sus meses en una de varios meses (1 de noviembre al 31 de diciembre). La factura recurrente los guarda tal cual en items.

Lo que timbraCopiar enlace a esta sección

Cada factura es una factura normal: llega invoice.stamped a sus webhooks, aparece en GET /v1/invoices y trae recurring_invoice con el id de la recurrente que la timbró. last_invoice y last_invoiced_on dicen cuál fue la última.

Si un periodo no se puede timbrar (se acabaron los timbres, el cliente se borró del catálogo, el SAT la rechazó), la recurrente guarda el motivo en last_error, llega recurring_invoice.failed una vez, y lo intenta de nuevo cada día a su hora hasta que salga. Con catch_up: "all" (por omisión) timbra después cada periodo que quedó pendiente, cada uno con su mes; con "latest", solo el más reciente.

Cambiarla, pausarla o timbrar yaCopiar enlace a esta sección

# Pausar (active: true la reanuda desde hoy, sin timbrar lo que pasó en pausa)
curl https://api.fiscalisto.com/v1/recurring_invoices/rin_OufpKqnrvx9p7Hq2mZr1XyT5uBcW8sKdLx \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "active": false }'

• POST /v1/recurring_invoices/{id} cambia solo lo que mande: name, schedule, send_email, catch_up, active o invoice (la factura completa desde la siguiente vez). schedule.start_date mueve la siguiente fecha.
• POST /v1/recurring_invoices/{id}/skip salta la siguiente fecha sin timbrar.
• POST /v1/recurring_invoices/{id}/run timbra ya el periodo que toca, sin esperar su hora; contesta la factura. Si aún no toca, 409 recurring_not_due. Si su hora llega mientras tanto no se timbra dos veces: es el mismo periodo.
• DELETE /v1/recurring_invoices/{id} la borra; las facturas que timbró se quedan.

LímitesCopiar enlace a esta sección

Un emisor tiene hasta 5,000 facturas recurrentes activas en producción y 25 en pruebas (las pausadas no cuentan). En pruebas se timbran con el PAC de pruebas, como las demás.