Ir al contenido
Declaraciones del SAT

FISCALISTO / API / REFERENCIA

Ver una declaración del SAT

GET
/v1/sat_declarations/{id}

Una declaración presentada al SAT, con sus cifras en summary y si ya están su PDF y su acuse.

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

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

Parámetros de la ruta

id*string

El id del objeto.

Cuerpo de la respuesta

Correcto.

application/json
  1. response

Una declaración que el emisor presentó ante el SAT (provisional o definitiva, anual o del servicio anterior Declaraciones y pagos), con sus cifras y sus archivos.

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

object*string

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

issuer*string

El emisor que la presentó.

source*string

monthly (provisional o definitiva, desde 2022), annual (la anual de persona moral) o dyp (el servicio anterior Declaraciones y pagos, 2021 y antes).

Uno de"monthly""annual""dyp"
year*integer

El ejercicio.

Rango-9007199254740991 <= value <= 9007199254740991
month*|

El mes (1 a 12), o null en la anual y otros periodos.

period*string

El periodo como lo nombra el SAT: «Enero», «Del Ejercicio»…

type*string

normal o complementary (complementaria).

Uno de"normal""complementary"
complementary_type*|

El tipo de complementaria como lo dice el SAT («Modificación de obligaciones»…), o null.

operation_number*string

El número de operación que le dio el SAT.

payment_line*|

La línea de captura, si hubo algo a pagar.

filed_on*|

Cuándo se presentó (AAAA-MM-DD).

profit_coefficient*|

El coeficiente de utilidad que aplicó (ISR de personas morales), o null.

isr_due*|

El ISR a cargo, según el acuse.

vat_due*|

El IVA a cargo, según el acuse.

total_due*|

El total a pagar, según el acuse.

sections*array<>

Las cifras de la declaración por impuesto (tax), cada una con su texto como lo imprime el SAT (label) y su valor. Vacío en las de Declaraciones y pagos (su PDF trae dos columnas que no se leen con certeza) o si el PDF aún no llega.

receipt*|

Lo que dice el acuse: cada concepto con su cantidad a cargo y a pagar, el total, la línea de captura y su vigencia. null si el acuse aún no llega.

summary*

Las mismas cifras con nombres fijos, por obligación (ISR, IVA, cada retención), para leerlas igual cada mes sin conocer el formato del SAT. Una cifra que no viene en la declaración o no se pudo leer es null, nunca 0. En Declaraciones y pagos solo trae lo del acuse.

files*

Qué archivos ya tiene: pdf (GET …/pdf), receipt (GET …/receipt) y financial_statements (GET …/financial_statements, solo en la anual de persona moral).

files_error*|

Por qué falta un archivo, como lo dijo el SAT (por ejemplo «No se puede generar el archivo»). Se vuelve a pedir en la siguiente consulta.

created_at*|

Cuándo se trajo por primera vez.

updated_at*|

Cuándo cambió por última vez.

curl -X GET 'https://api.fiscalisto.com/v1/sat_declarations/string' \  -H 'Authorization: Bearer fk_test_…'
{  "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"}