FISCALISTO / API / REFERENCIA
Adelantar el reloj de prueba
Mueve el reloj hasta frozen_time haciendo, día por día, lo que habría pasado: timbra las facturas recurrentes de cada periodo, vence las cotizaciones y hace las facturas globales de tickets, con sus eventos. Contesta cuando terminó, con lo que hizo en advanced, y llega test_clock.ready. Hasta 25 comprobantes por solicitud: si se detiene antes, stopped_early y otra llamada sigue. Los CFDI se timbran con la fecha real (el SAT solo acepta la de hoy); el periodo, los vencimientos y los eventos siguen al reloj.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
Idempotency-Key?stringOpcional (los SDK la mandan solos). Si la respuesta se pierde, repita la solicitud con el mismo valor durante 24 horas: contesta lo mismo, con idempotent-replayed: true, y no lo hace dos veces (ni crea, ni manda correos, ni cobra).
1 <= length <= 255application/json- body
frozen_time*stringA dónde adelantarlo: después de la hora actual del reloj. Lo que toca en el camino se hace día por día.
Correcto.
application/json- response
El reloj de prueba de un emisor de pruebas: su «hoy», que solo avanza cuando usted lo adelanta, haciendo día por día lo que toca.
id*stringclk_ y la clave del emisor.
object*stringQué tipo de objeto es («invoice», «customer»…).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
issuer*stringEl emisor de pruebas que vive en esta hora.
frozen_time*stringLa hora del reloj: el «hoy» del emisor para sus facturas recurrentes, cotizaciones, cuentas por cobrar y tickets.
date-timestatus*stringadvancing mientras una solicitud lo adelanta; ready en cualquier otro momento.
"ready""advancing"created_at*|Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).
advanced?Al adelantarlo: lo que se hizo en el camino.
stopped_early?booleantrue si se detuvo antes de requested_time porque ya timbró 25 comprobantes en esta solicitud: adelántelo otra vez para seguir.
requested_time?stringA dónde se pidió adelantarlo (con stopped_early).
date-timedeleted?booleanSiempre true.
curl -X POST 'https://api.fiscalisto.com/v1/issuers/string/test_clock/advance' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "frozen_time": "2026-12-01T09:00:00-06:00"}'{ "id": "clk_0q1Vmmw52sbD", "object": "test_clock", "livemode": false, "issuer": "iss_0q1Vmmw52sbD", "frozen_time": "2026-12-01T09:00:00-06:00", "status": "ready", "created_at": "2026-10-25T09:40:00-06:00", "advanced": { "recurring_invoices": 2, "quotes_expired": 1, "global_invoices": 1 }}