Ir al contenido
Declaraciones del SAT

FISCALISTO / API / REFERENCIA

Listar declaraciones del SAT

Abrir en ChatGPTAbrir en Claude
GET
/v1/sat_declarations

Las declaraciones que trajeron sus consultas, del ejercicio y mes más recientes a los más antiguos (la anual antes de los meses de su año). No usa timbres.

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de consulta

limit?integer

Cuántos por página, de 1 a 100. Por omisión 10.

Rango1 <= value <= 100
Por omisión10
starting_after?string

El id del último de la página anterior, para la siguiente.

issuer?string

El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo.

year?integer

Solo las de un ejercicio, como 2025.

source?string

monthly (provisionales o definitivas), annual (la anual) o dyp (Declaraciones y pagos).

Uno de"monthly""annual""dyp"
month?integer

Solo las de un mes (1 a 12).

type?string

normal o complementary (complementarias).

Uno de"normal""complementary"

Cuerpo de la respuesta

Correcto.

application/json
  1. response
object*string

Qué tipo de objeto es («invoice», «customer»…).

data*array<>

Los objetos de esta página.

has_more*boolean

true si hay más: pida la siguiente con starting_after igual al id del último.

url*string

La ruta de esta lista.

curl -X GET 'https://api.fiscalisto.com/v1/sat_declarations' \  -H 'Authorization: Bearer fk_test_…'
{  "object": "list",  "data": [    {      "id": "dcl_OufpKqnrvx9p1F",      "object": "sat_declaration",      "livemode": false,      "issuer": "iss_OufpKqnrvx9p",      "source": "monthly",      "year": 2026,      "month": 9,      "period": "Septiembre",      "type": "normal",      "complementary_type": null,      "operation_number": "92026090000001",      "payment_line": "0426TEST2026090001",      "filed_on": "2026-10-15",      "profit_coefficient": 0.0219,      "isr_due": 7718.53,      "vat_due": 16520,      "total_due": 24238.53,      "sections": [        {          "tax": "ISR personas morales",          "fields": [            {              "label": "INGRESOS NOMINALES DEL PERIODO",              "value": 292500            },            {              "label": "COEFICIENTE DE UTILIDAD",              "value": 0.0219            },            {              "label": "IMPUESTO A CARGO",              "value": 7718.53            }          ]        }      ],      "receipt": {        "concepts": [          {            "concept": "ISR personas morales",            "due": 7718.53,            "amount_due": 7718.53,            "amount_to_pay": 7718.53          },          {            "concept": "IVA personas morales",            "due": 16520,            "amount_due": 16520,            "amount_to_pay": 16520          }        ],        "total": 24238.53,        "payment_line": "0426TEST2026090001",        "valid_until": null      },      "summary": {        "obligations": [          {            "obligation": "isr",            "name": "ISR personas morales",            "read": true,            "amount_due": 7718.53,            "amount_to_pay": 7718.53,            "figures": {              "income": 292500,              "invoiced_income": 292500,              "income_ytd": 2632500,              "deductions": null,              "profit_coefficient": 0.0219,              "taxable_profit": 57651.75,              "losses_applied": 0,              "tax_base": 57651.75,              "tax_caused": 17295.53,              "prior_payments": 9577,              "withheld": 0,              "surcharges": null,              "inflation": null,              "paid_before": null,              "due": 7718.53,              "in_favor": null,              "to_pay": 7718.53            }          },          {            "obligation": "vat",            "name": "IVA personas morales",            "read": false,            "amount_due": 16520,            "amount_to_pay": 16520,            "figures": {              "taxable_16": null,              "taxable_0": null,              "exempt": null,              "charged": null,              "paid_16": null,              "creditable": null,              "withheld": null,              "balance_applied": null,              "surcharges": null,              "inflation": null,              "paid_before": null,              "due": null,              "in_favor": null,              "to_pay": null            }          }        ],        "total_to_pay": 24238.53      },      "files": {        "pdf": true,        "receipt": true,        "financial_statements": false      },      "files_error": null,      "created_at": "2026-10-26T09:12:00-06:00",      "updated_at": "2026-10-26T09:12:04-06:00"    }  ],  "has_more": false,  "url": "/v1/sat_declarations"}

Consultar las declaraciones de un emisor en el SAT POST

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.

Ver el año mes por mes GET

Cada mes del ejercicio con sus obligaciones: presentada (con sus declaraciones), falta (venció y no la encontramos) o por presentar, con el día en que vence (el 17 del mes siguiente, o el día hábil siguiente, más los días por el sexto dígito del RFC). Se arma con lo que trajeron sus consultas; no usa timbres.