Ir al contenido
Lotes

FISCALISTO / API / REFERENCIA

Listar lotes

GET
/v1/invoice_batches

Los lotes de facturas, los más recientes primero, con cuántas se timbraron y cuántas fallaron.

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.

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/invoice_batches' \  -H 'Authorization: Bearer fk_test_…'
{  "object": "list",  "data": [    {      "id": "bat_OufpKqnrvx9p4hMdcoapAo5aaGJEme7mXj",      "object": "invoice_batch",      "livemode": false,      "issuer": "iss_OufpKqnrvx9p",      "name": "Cuotas de octubre",      "status": "completed",      "total": 2,      "stamped": 1,      "failed": 1,      "created_at": "2026-10-24T10:15:42-06:00",      "completed_at": "2026-10-24T10:15:42-06:00",      "processing": 0,      "invoices": [        {          "index": 0,          "reference": "depto-101",          "status": "valid",          "invoice": "inv_OufpKqnrvx9p0mn7VjQ6JlfipKAkHWstOK",          "uuid": "DB494B07-D6DE-4F70-8ED0-C8B864FF8717",          "total": 1740,          "error": null        },        {          "index": 1,          "reference": "depto-102",          "status": "failed",          "invoice": null,          "uuid": null,          "total": 1740,          "error": "El SAT no reconoce el nombre del cliente. Escríbalo exactamente como en su constancia de situación fiscal, en mayúsculas y sin «S.A. de C.V.» ni otro régimen de capital."        }      ]    }  ],  "has_more": false,  "url": "/v1/invoice_batches"}