Ir al contenido
Facturas

FISCALISTO / API / REFERENCIA

Listar facturas

Abrir en ChatGPTAbrir en Claude
GET
/v1/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

valid, pending, canceled, rejected o processing.

Uno de"valid""pending""canceled""rejected""processing"
type?string

I, E, P, T o N.

Uno de"I""E""P""T""N"
customer?string

RFC del cliente o su id (cus_…).

payment_status?string

Facturas de ingreso por lo que deben: unpaid, partial, open (unpaid o partial) o paid.

Uno de"unpaid""partial""open""paid"
created_gte?string

Creadas desde, en ISO 8601. Un día solo (2026-10-01) cuenta desde su inicio en hora de la Ciudad de México.

created_lte?string

Creadas hasta, en ISO 8601. Un día solo (2026-10-31) incluye el día completo en hora de la Ciudad de México.

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/invoices' \  -H 'Authorization: Bearer fk_test_…'
{  "object": "list",  "data": [    {      "id": "inv_OufpKqnrvx9p0Nfbydl9jG4UNGeTYcvdrg",      "object": "invoice",      "livemode": false,      "issuer": "iss_OufpKqnrvx9p",      "branch": null,      "type": "I",      "status": "valid",      "uuid": "5F1E8C2A-3B7D-4C9E-A1B2-C3D4E5F60718",      "series": null,      "folio": "1",      "date": "2026-10-24T10:15:42",      "customer": {        "tax_id": "ICV060329BY0",        "legal_name": "INMOBILIARIA CVA",        "tax_system": "601",        "zip": "33826"      },      "use": "I04",      "payment_form": "03",      "payment_method": "PUE",      "currency": "MXN",      "exchange_rate": null,      "items": [        {          "description": "Mensualidad",          "product_key": "86121700",          "unit_key": "E48",          "unit_name": "Unidad de servicio",          "sku": "MEN-1",          "quantity": 2,          "unit_price": 2500,          "taxability": "02",          "iva": "0.16"        }      ],      "subtotal": 5000,      "discount": 0,      "taxes": {        "iva": 800,        "ieps": 0,        "iva_withheld": 0,        "isr_withheld": 0,        "local_transferred": 0,        "local_withheld": 0      },      "total": 5800,      "payment_status": "paid",      "amount_due": 0,      "amount_paid": 5800,      "related": null,      "cancellation": null,      "email": null,      "error": null,      "recurring_invoice": null,      "created_at": "2026-10-24T10:15:42-06:00",      "metadata": {}    }  ],  "has_more": false,  "url": "/v1/invoices"}

Crear una liga de alta POST

Una página en fiscalisto.com donde el dueño del emisor sube su CSD y firma el contrato con el PAC con su e.firma, sin que esos archivos ni sus contraseñas pasen por su plataforma. Mande a su cliente a url; al terminar vuelve a return_url y llega issuer.ready. Cada liga sirve para un emisor, hasta que vence.

Timbrar una factura POST

Revisa la factura con las reglas del SAT, la sella y la timbra en una sola llamada. Responde con la factura timbrada (status valid) o, si el PAC tarda, en processing (escuche invoice.stamped). Lo que puede omitir tiene el valor usual: PUE, MXN, uso G03 (S01 con régimen 616), objeto de impuesto 02, IVA 16%, cantidad 1, unidad E48.