Declaraciones del SAT

Con la e.firma del emisor usted trae del SAT todas las declaraciones que presentó: las provisionales o definitivas de cada mes (desde 2022), la anual de persona moral (desde 2019) y las del servicio anterior Declaraciones y pagos (2021 y antes). Cada una llega con su PDF, su acuse, el número de operación, la línea de captura y sus cifras por impuesto, incluido el coeficiente de utilidad que aplicó. Sirve para revisar lo que ya se pagó, armar la contabilidad o calcular el siguiente pago provisional con el coeficiente del SAT.

Solo se consulta: nunca se presenta, firma ni cambia nada en el SAT.

Lo que cuestaCopiar enlace a esta sección

Si el SAT no contesta o no deja entrar con la e.firma, el timbre regresa. Cada emisor se puede consultar una vez cada 10 minutos (cada consulta es una entrada al SAT con su e.firma); antes, la API contesta 429 sat_refresh_too_soon con Retry-After. Fiscalisto no consulta solo: las declaraciones se actualizan cuando usted lo pide.

En pruebas y en producciónCopiar enlace a esta secció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.
• En pruebas el SAT no tiene un ambiente de pruebas, así que no se le pregunta: la consulta trae al instante las declaraciones de ejemplo de este año (hasta el mes pasado) y la anual del año anterior, con su PDF y su acuse. No necesita e.firma.

Consultar al SATCopiar enlace a esta sección

curl https://api.fiscalisto.com/v1/sat_declarations/refresh \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "issuer": "iss_OufpKqnrvx9p" }'

La primera consulta trae todos los años que el SAT conserva; las siguientes, este año y el anterior, y vuelven a pedir los archivos que el SAT no pudo dar. La respuesta dice cuántas encontró (found) y cuántos archivos bajó (downloaded):

{
  "object": "sat_declarations_refresh",
  "livemode": true,
  "issuer": "iss_OufpKqnrvx9p",
  "status": "completed",
  "found": 58,
  "downloaded": 112,
  "pending": 0,
  "warning": null,
  "refreshed_at": "2026-10-26T09:12:00-06:00",
  "next_refresh_at": "2026-10-26T09:22:00-06:00"
}

La consulta contesta en menos de un minuto. Un RFC con muchos años puede no alcanzar a bajar todo: entonces llega status: "processing" con lo que falta en pending, y lo demás se baja solo en la siguiente hora, sin otro timbre. Si una parte del SAT falló (por ejemplo, la anual) y lo demás sí llegó, warning trae lo que dijo el SAT.

Listar las declaracionesCopiar enlace a esta sección

curl -G https://api.fiscalisto.com/v1/sat_declarations \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -d issuer=iss_OufpKqnrvx9p \
  -d year=2026

Salen del ejercicio y mes más recientes a los más antiguos, la anual antes de los meses de su año. Filtre por year, month (1 a 12), type (normal o complementary) y source: monthly, annual o dyp. Cada declaración trae:

• period, type (normal o complementary), operation_number, filed_on y payment_line.
• isr_due, vat_due y total_due, del acuse, y profit_coefficient en el ISR de personas morales.
• sections: cada impuesto con sus renglones como los imprime el SAT (label y value). En las de Declaraciones y pagos va vacío: su PDF trae dos columnas que no se leen con certeza, así que use el PDF.
• summary: las mismas cifras con nombres fijos, por obligación (ver abajo).
• receipt: los conceptos del acuse con lo que quedó a cargo y a pagar.
• files: qué archivos ya tiene, y en files_error por qué falta alguno, como lo dijo el SAT.

Las cifras con nombres fijosCopiar enlace a esta sección

El SAT cambia el formato y los nombres de sus renglones de un año a otro, y repite algunos («CANTIDAD A CARGO» sale varias veces). summary los lee por usted: cada obligación de la declaración con sus cifras bajo nombres que no cambian, para comparar un mes con otro o con sus facturas sin conocer el formato del SAT.

{
  "obligations": [
    {
      "obligation": "vat",
      "name": "Impuesto al Valor Agregado. Personas morales",
      "read": true,
      "amount_due": 186287,
      "amount_to_pay": 186287,
      "figures": {
        "taxable_16": 13622057,
        "charged": 2179529,
        "creditable": 1993242,
        "withheld": 0,
        "balance_applied": 0,
        "due": 186287,
        "in_favor": null,
        "to_pay": 186287
      }
    }
  ],
  "total_to_pay": 186287
}

Todas traen surcharges (recargos), inflation (actualización), paid_before (lo pagado antes, en una complementaria), due, in_favor y to_pay. Una cifra que la declaración no trae o que no se pudo leer es null, nunca 0. Si una obligación solo viene en el acuse (read: false), trae sus montos amount_due y amount_to_pay y sus cifras en null; así llegan siempre las de Declaraciones y pagos.

El año mes por mesCopiar enlace a esta sección

GET /v1/sat_declarations/calendar?year=2026 arma el ejercicio con lo que trajeron sus consultas: cada mes con sus obligaciones y si están presentadas (filed, con sus declaraciones), si faltan (missing: el plazo venció y no la encontramos) o si aún no vencen (due), con el día en que vencen en due_on. En persona moral trae también la anual (month: null). No usa timbres.

curl -G https://api.fiscalisto.com/v1/sat_declarations/calendar \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -d issuer=iss_OufpKqnrvx9p \
  -d year=2026

{
  "object": "sat_declaration_calendar",
  "livemode": true,
  "issuer": "iss_OufpKqnrvx9p",
  "year": 2026,
  "missing": 1,
  "months": [
    {
      "month": 8,
      "due_on": "2026-09-18",
      "obligations": [
        { "obligation": "isr", "status": "filed", "declarations": ["dcl_OufpKqnrvx9p1E"] },
        { "obligation": "vat", "status": "filed", "declarations": ["dcl_OufpKqnrvx9p1E"] },
        { "obligation": "isr_salaries", "status": "missing", "declarations": [] }
      ]
    }
  ]
}

El SAT no dice qué obligaciones tiene un RFC, así que se deducen de lo que presenta: ISR e IVA cada mes desde el primero que presentó, y una retención si la presentó en 2 de los 3 meses anteriores, o antes y después del mes. Una retención que el emisor dejó de presentar (ya no tiene empleados) deja de pedirse a los dos meses. La opinión de cumplimiento del SAT es la que manda; use missing para avisarle a su cliente, no como dictamen.

WebhooksCopiar enlace a esta sección

Cada consulta avisa a sus webhooks:

• sat_declaration.created cuando encuentra una declaración nueva. Sus archivos y cifras pueden llegar un momento después.
• sat_declaration.updated cuando llega su PDF, su acuse, los estados financieros o sus cifras.

En ambos, data.object es la declaración como queda.

Descargar el PDF y el acuseCopiar enlace a esta sección

curl https://api.fiscalisto.com/v1/sat_declarations/dcl_OufpKqnrvx9p1F/pdf \
  -H "Authorization: Bearer $FISCALISTO_API_KEY" \
  -o declaracion.pdf

El acuse está en GET /v1/sat_declarations/{id}/receipt y, en la anual de persona moral, el Excel de estados financieros en GET /v1/sat_declarations/{id}/financial_statements. Un archivo que el SAT aún no da contesta 404 con su motivo; se vuelve a pedir en la siguiente consulta.