FISCALISTO / API / REFERENCIA
Consultar las declaraciones de un emisor en el SAT
Entra al SAT con la e.firma guardada del emisor y trae las declaraciones que presentó: provisionales o definitivas (desde 2022), la anual de persona moral (desde 2019) y las del servicio anterior Declaraciones y pagos, con su PDF, su acuse y sus cifras. La primera consulta trae todos los años que el SAT conserva; las siguientes, este año y el anterior. Solo consulta: nunca presenta ni firma nada. En producción usa 1 timbre por consulta (regresa si el SAT no contesta) y se puede hacer una vez cada 10 minutos por emisor. Contesta en menos de un minuto; si queda algo por bajar (status processing), sigue solo en la siguiente hora sin otro timbre. En pruebas no se le pregunta al SAT: trae declaraciones de ejemplo al instante.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
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
issuer?stringEl emisor (iss_…). Por omisión, su único emisor.
Correcto.
application/json- response
Lo que trajo una consulta de las declaraciones del emisor en el SAT.
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 consultado.
status*stringcompleted (ya bajó todo) o processing (queda algo por bajar: sigue solo en la siguiente hora, sin otro timbre).
"completed""processing"found*integerCuántas declaraciones listó el SAT en los años consultados.
-9007199254740991 <= value <= 9007199254740991downloaded*integerCuántos archivos bajó en esta consulta.
-9007199254740991 <= value <= 9007199254740991pending*integerCuántas declaraciones quedan con archivos por bajar.
-9007199254740991 <= value <= 9007199254740991warning*|Si una parte del SAT falló (por ejemplo, la anual), lo que dijo; lo demás sí se trajo. null si todo salió.
refreshed_at*stringCuándo se consultó.
date-timenext_refresh_at*stringDesde cuándo se puede volver a consultar este emisor (10 minutos después).
date-timecurl -X POST 'https://api.fiscalisto.com/v1/sat_declarations/refresh' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{}'{ "object": "sat_declarations_refresh", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "status": "completed", "found": 10, "downloaded": 10, "pending": 0, "warning": null, "refreshed_at": "2026-10-26T09:12:00-06:00", "next_refresh_at": "2026-10-26T09:22:00-06:00"}