FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
Un CFDI que trajo una descarga del SAT, con sus importes y su estado ante el SAT.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
Correcto.
application/jsonUna factura que el SAT tiene del emisor, emitida o recibida, traída con una descarga.
id*stringIdentificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
object*stringQué tipo de objeto es («invoice», «customer»…).
issuer*stringEl emisor de su cuenta (iss_…) a quien pertenece esta factura.
uuid*stringEl folio fiscal (UUID del timbre).
direction*stringreceived (se la hicieron al emisor) o issued (la emitió).
"received""issued"type*|Tipo de comprobante (TipoDeComprobante): I ingreso, E egreso, P pago, T traslado, N nómina.
date*stringLa fecha del comprobante (Fecha), en la hora local con que se emitió.
series*|Serie (Serie), o null.
folio*|Folio (Folio), o null.
issued_by*Quien la emitió (Emisor).
issued_to*A quien se la emitieron (Receptor).
currency*|Moneda (Moneda): MXN, USD…
exchange_rate*|Tipo de cambio (TipoCambio), o null en pesos.
payment_method*|Método de pago (MetodoPago): PUE o PPD.
payment_form*|Forma de pago (FormaPago), clave de c_FormaPago.
use*|Uso del CFDI (UsoCFDI).
subtotal*|Subtotal (SubTotal).
total*|Total (Total).
taxes*Impuestos del comprobante: trasladados (iva, ieps), retenidos (iva_withheld, isr_withheld, ieps_withheld) y locales.
sat_status*|Su estado en el SAT cuando se revisó: active (vigente) o canceled. null si aún no se revisa.
sat_download*|La descarga (sdl_…) que la trajo, o null.
downloaded_at*|Cuándo llegó.
curl -X GET 'https://api.fiscalisto.com/v1/sat_invoices/string' \ -H 'Authorization: Bearer fk_test_…'{ "id": "sat_OufpKqnrvx9p1F", "object": "sat_invoice", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "uuid": "9B2D4E61-7C3A-4F18-8E5D-0A6B9C1D2E3F", "direction": "received", "type": "I", "date": "2026-09-12T11:04:00", "series": "A", "folio": "4821", "issued_by": { "tax_id": "XIA190128J61", "legal_name": "XENON INDUSTRIAL ARTICLES" }, "issued_to": { "tax_id": "TOL190312KT4", "legal_name": "TOLPI" }, "currency": "MXN", "exchange_rate": null, "payment_method": "PUE", "payment_form": "03", "use": "G03", "subtotal": 18400, "total": 21344, "taxes": { "iva": 2944, "ieps": 0, "iva_withheld": 0, "isr_withheld": 0, "ieps_withheld": 0, "local_transferred": 0, "local_withheld": 0 }, "sat_status": "active", "sat_download": "sdl_OufpKqnrvx9p3n8vQd2LkW7mZr1XyT5uBc", "downloaded_at": "2026-10-24T10:27:40-06:00"}