FISCALISTO / API
Cumplimiento SAT
La opinión de cumplimiento (32-D), la constancia de situación fiscal y el buzón tributario de un emisor, traídos del SAT con su e.firma, y los hallazgos que Fiscalisto encontró en sus CFDI.
Con la e.firma del emisor usted trae del SAT tres papeles que sus clientes, bancos y proveedores le piden seguido:
- La opinión de cumplimiento (artículo 32-D del CFF): positiva, negativa (con lo que el SAT dice que falta), sin obligaciones o en suspensión, con su folio y su PDF.
- La constancia de situación fiscal: el PDF del SAT de hoy, con su idCIF, sus regímenes, su código postal y su estatus en el padrón ya leídos.
- Los avisos del buzón tributario: cada uno con su asunto, si no se ha leído y qué tan urgente es (un requerimiento o una multa piden atención; un boletín no).
Y sin ir al SAT, los hallazgos que Fiscalisto encontró en las facturas del emisor (las que timbró aquí y las que trajo con las descargas del SAT): proveedores en la lista 69-B, pagos en efectivo de más de $2,000, PPD sin complemento de pago y los demás.
Solo se consulta: nunca se presenta, firma ni abre nada en el SAT. Un aviso del buzón se lee en Fiscalisto sin abrirlo en el SAT, así que no firma el acuse ni empieza los plazos.
Lo que cuesta
| Qué | En producción | En pruebas |
|---|---|---|
Pedir al SAT la opinión, la constancia o el buzón (…/refresh) | 1 timbre por consulta | Gratis |
| Ver lo que ya trajo, bajar sus PDF y leer los hallazgos | Gratis | Gratis |
Si el SAT no contesta o no deja entrar con la e.firma, contesta 502 sat_unavailable y el timbre regresa. Cada papel de cada emisor se puede pedir una vez cada 10 minutos; antes, la API contesta 429 sat_refresh_too_soon con Retry-After. Dos solicitudes a la vez entran al SAT una sola vez: la otra recibe el 429. Fiscalisto no consulta solo: estos papeles se actualizan cuando usted lo pide.
En pruebas y en producción
- En producción se entra al SAT con la e.firma que el emisor guardó con
keep_for_downloads: true, la misma de las descargas del SAT. Sin ella, o vencida, contesta400efirma_required. - En pruebas el SAT no tiene un ambiente de pruebas, así que no se le pregunta: la opinión sale positiva, la constancia con los datos del emisor y el buzón con dos avisos de ejemplo (un requerimiento sin leer y un boletín). Cada uno con su PDF de ejemplo. No necesita e.firma.
La opinión de cumplimiento
Pídala al SAT; la solicitud no lleva cuerpo.
curl -X POST https://api.fiscalisto.com/v1/issuers/iss_OufpKqnrvx9p/compliance_opinion/refresh \
-H "Authorization: Bearer $FISCALISTO_API_KEY"La respuesta dice si terminó (status: completed) o si el SAT sigue trabajando (processing, cuando tarda más de 50 segundos): en ese caso el resultado llega solo a GET /v1/issuers/{id}/compliance_opinion en uno o dos minutos. Ahí está la última que trajo:
curl https://api.fiscalisto.com/v1/issuers/iss_OufpKqnrvx9p/compliance_opinion \
-H "Authorization: Bearer $FISCALISTO_API_KEY"{
"object": "compliance_opinion",
"livemode": true,
"issuer": "iss_OufpKqnrvx9p",
"result": "negative",
"date": "2026-10-27",
"folio": "26NA1234567",
"reasons": ["No se encuentra presentada la declaración anual de 2025."],
"pdf": true,
"checked_at": "2026-10-27T09:12:00-06:00",
"last_error": null
}result es positive, negative, no_obligations o suspended (null hasta la primera consulta), y reasons lo que el SAT lista como pendiente en una negativa. El PDF, como lo da el SAT:
curl https://api.fiscalisto.com/v1/issuers/iss_OufpKqnrvx9p/compliance_opinion/pdf \
-H "Authorization: Bearer $FISCALISTO_API_KEY" -o opinion.pdfLa constancia de situación fiscal
curl -X POST https://api.fiscalisto.com/v1/issuers/iss_OufpKqnrvx9p/tax_status_certificate/refresh \
-H "Authorization: Bearer $FISCALISTO_API_KEY"GET /v1/issuers/{id}/tax_status_certificate trae lo que dice la última: issued_on, id_cif, legal_name, tax_systems (cada régimen con su clave y su nombre), zip y status (ACTIVO en el padrón). Su PDF en GET /v1/issuers/{id}/tax_status_certificate/pdf. Si el emisor cambió de régimen o de domicilio fiscal, pídala otra vez: la factura sale con los datos del emisor en Fiscalisto, no con los de la constancia.
El buzón tributario
curl -X POST https://api.fiscalisto.com/v1/issuers/iss_OufpKqnrvx9p/sat_mailbox/refresh \
-H "Authorization: Bearer $FISCALISTO_API_KEY"Los avisos quedan en GET /v1/sat_mailbox_messages, del más reciente al más antiguo y paginados; unread=true deja solo los que no se han leído en el SAT:
curl "https://api.fiscalisto.com/v1/sat_mailbox_messages?issuer=iss_OufpKqnrvx9p&unread=true" \
-H "Authorization: Bearer $FISCALISTO_API_KEY"Cada aviso trae urgency (urgent, attention o informational), kind (qué parece: requerimiento, multa, invitación…) y action_required, para que su sistema avise a quien deba contestarlo. Para leerlo completo y contestar, el emisor entra a su buzón en el SAT.
Los hallazgos
curl "https://api.fiscalisto.com/v1/sat_findings?issuer=iss_OufpKqnrvx9p&direction=received" \
-H "Authorization: Bearer $FISCALISTO_API_KEY"Uno por tipo, de lo más grave a lo menos: code (estable, como efos_definitivo o efectivo_2000), severity (critical, warning o info), title, explanation, cuántas facturas lo tienen (invoices) y la suma de sus totales (amount). Filtra por direction (issued o received) y por fecha de la factura con date_gte y date_lte (días de la Ciudad de México). Los hallazgos que alguien marcó como revisados en Fiscalisto no aparecen. No usa timbres.