Ir al contenido
Facturas recurrentes

FISCALISTO / API / REFERENCIA

Listar facturas recurrentes

Abrir en ChatGPTAbrir en Claude
GET
/v1/recurring_invoices

Las más recientes primero.

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de consulta

limit?integer

Cuántos por página, de 1 a 100. Por omisión 10.

Rango1 <= value <= 100
Por omisión10
starting_after?string

El id del último de la página anterior, para la siguiente.

issuer?string

El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo.

status?string

active o paused.

Uno de"active""paused"

Cuerpo de la respuesta

Correcto.

application/json
  1. response
object*string

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

data*array<>

Los objetos de esta página.

has_more*boolean

true si hay más: pida la siguiente con starting_after igual al id del último.

url*string

La ruta de esta lista.

curl -X GET 'https://api.fiscalisto.com/v1/recurring_invoices' \  -H 'Authorization: Bearer fk_test_…'
{  "object": "list",  "data": [    {      "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": null,      "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"    }  ],  "has_more": false,  "url": "/v1/recurring_invoices"}

Traer pedidos pagados POST

Los pedidos pagados desde una fecha (hasta 31 días, 200 a la vez) que no llegaron por webhook: la tienda se conectó después o estuvo caída. Un pedido que ya es ticket no se repite.

Crear una factura recurrente POST

Una factura que el emisor timbra solo en cada fecha (cada interval meses en day_of_month, o cada interval semanas o días), a la hora que elija, con los timbres de su cuenta, y la manda al cliente si send_email. Cada una es una factura normal (invoice.stamped, con recurring_invoice) y nunca se timbra dos veces el mismo periodo. invoice es el cuerpo de POST /v1/invoices: se revisa ahora, con las mismas reglas.