Lotes
FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
Hasta 1,000 facturas de ingreso de un emisor, timbradas en segundo plano. Se revisan todas antes de empezar: si una no pasa, no se timbra ninguna. Responde 202; escuche invoice_batch.completed o consulte el lote.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
Idempotency-Key*stringUno nuevo por comprobante (8 a 255 caracteres; su id de pedido sirve). Si la respuesta se pierde, repita la solicitud con el mismo valor: contesta lo mismo y nunca se timbra dos veces.
8 <= length <= 255application/jsonissuer?stringEmisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse.
^iss_name?stringNombre del lote, para usted.
length <= 120invoices*array<>Las facturas, como el cuerpo de POST /v1/invoices, con reference opcional.
1 <= items <= 1000Correcto. Repetir la solicitud con la misma Idempotency-Key contesta lo mismo, con el mismo status y el encabezado idempotent-replayed: true.
application/jsonUn lote de hasta 1,000 facturas timbradas en segundo plano.
id*stringIdentificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
object*stringQué tipo de objeto es («invoice», «customer»…).
issuer*stringEl emisor (iss_…).
name*stringNombre del lote, para usted.
status*stringprocessing: timbrando. completed: ya no queda ninguna por timbrar.
"processing""completed"total*integerCuántas facturas tiene el lote.
-9007199254740991 <= value <= 9007199254740991stamped*integerCuántas se timbraron.
-9007199254740991 <= value <= 9007199254740991failed*integerCuántas no se timbraron (quedan con su motivo).
-9007199254740991 <= value <= 9007199254740991processing?integerCuántas siguen en proceso.
-9007199254740991 <= value <= 9007199254740991created_at*|Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).
completed_at*|Cuándo terminó.
invoices?array<>Cada factura del lote (no viene en listas ni en eventos).
curl -X POST 'https://api.fiscalisto.com/v1/invoice_batches' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: pedido-A-1042' \ -H 'Content-Type: application/json' \ -d '{ "name": "Cuotas de octubre", "invoices": [ { "reference": "depto-101", "customer": "cus_OufpKqnrvx9p1", "payment_form": "03", "items": [ { "product": "prd_OufpKqnrvx9p1" } ] }, { "reference": "depto-102", "customer": { "tax_id": "ICV060329BY0", "legal_name": "INMOBILIARIA CVA", "tax_system": "601", "zip": "33826", "email": "pagos@cva.example" }, "payment_form": "03", "items": [ { "description": "Cuota de mantenimiento", "product_key": "80131500", "unit_price": 1500 } ] } ]}'{ "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." } ]}