FISCALISTO / API / REFERENCIA
Revisar el buzón tributario en el SAT
Lee los avisos del buzón tributario del emisor ahora, con su e.firma guardada; nunca abre notificaciones (abrirlas firma el acuse y corren los plazos). 1 timbre en producción, una vez cada 10 minutos. En pruebas deja dos avisos de ejemplo.
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 <= 255Correcto.
application/json- response
Una consulta al SAT de un documento del emisor: si ya terminó y dónde leerlo.
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.
document*stringQué se consultó.
"compliance_opinion""tax_status_certificate""sat_mailbox"status*stringcompleted (ya está en url) o processing (el SAT tarda; llega a url en unos minutos).
"completed""processing"refreshed_at*|Cuándo se pidió.
next_refresh_at*|Desde cuándo se puede pedir otra vez.
url*stringDónde leer lo que trajo.
curl -X POST 'https://api.fiscalisto.com/v1/issuers/string/sat_mailbox/refresh' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21'{ "object": "sat_refresh", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "document": "compliance_opinion", "status": "completed", "refreshed_at": "2026-10-27T09:12:00-06:00", "next_refresh_at": "2026-10-27T09:22:00-06:00", "url": "/v1/issuers/iss_OufpKqnrvx9p/compliance_opinion"}