Zoosial
docs
InicioDatos SAT
Volver al sitio Volver al Dashboard
Zoosial
Buscar en docs...
⌘K
APIs

Datos SAT

Los datos fiscales de tus clientes desde el SAT, en JSON y por API: opinión de cumplimiento, constancia, declaraciones, descarga masiva de CFDI, listas negras y cotejo contra bancos y tickets. Para despachos contables y apps de contabilidad.

Referencia completa (cuerpos, respuestas y errores): /llms.txt, sección «Datos SAT». Panel listo para usar: /app/datos-sat.

Sin credenciales

Datos públicos o que tú ya tienes. Incluidos en cualquier plan; sin plan, 50 consultas gratis al día.

POST
/sat/lists/check
Hasta 1,000 RFC contra las listas negras: 69-B (facturas falsas), 69-B Bis y art. 69 (no localizados, créditos firmes).
POST
/sat/cfdi/status/batch
Si cada CFDI sigue vigente o se canceló, hasta 100 por llamada.
POST
/sat/cfdi/parse
XML de CFDI 3.3/4.0 a JSON, con complementos de pago y recibos de nómina 1.2 (percepciones, deducciones, ISR retenido, subsidio, empleado).
POST
/sat/opinion/public
Opinión de cumplimiento 32-D pública (si el contribuyente la hizo pública).

Con la e.firma de tu cliente

La e.firma (.cer, .key y contraseña) viaja en cada llamada y se usa solo en memoria: no se guarda en bases de datos, archivos ni registros. Antes de la primera llamada se acepta la cláusula 21 con POST /sat/terms/accept.

POST
/sat/review
Revisión completa en una llamada: 32-D, constancia, listas y declaraciones de dos años cruzadas mes por mes, con semáforo (rojo, ámbar, verde).
GET
/sat/reviews
Las revisiones guardadas de tu cuenta (resumen, sin PDF ni e.firma). DELETE /sat/reviews/:rfc la quita.
POST
/sat/opinion
Opinión de cumplimiento 32-D completa, con PDF.
POST
/sat/constancia
Constancia de situación fiscal: PDF y sus datos leídos (padrón, domicilio, regímenes, obligaciones).
POST
/sat/declarations
Declaraciones presentadas de un ejercicio, con acuses en PDF si los pides.
POST
/sat/download/query
Descarga masiva de CFDI emitidos o recibidos (XML o metadata); luego /sat/download/verify y /sat/download/package.

Contabilidad y cotejo

Estas rutas calculan y no guardan nada: tú persistes el resultado.

POST
/sat/reconcile
Empata movimientos (banco o tickets) contra CFDI: 1 a 1, varias facturas, parcialidades y complementos de pago. Devuelve sugerencias para que la persona confirme.
POST
/sat/payments/check
Facturas PPD sin complemento de pago y complementos repetidos o que no cuadran.
POST
/sat/accounts/suggest
Cuenta contable sugerida por concepto.
POST
/sat/accounting/parse
Contabilidad electrónica (Anexo 24: catálogo, balanza, pólizas, auxiliares) a JSON; /sat/accounting/build hace el XML.
POST
/sat/declarations/parse
Acuses de declaración en PDF a datos (periodo, conceptos, a cargo, a favor, fuera de plazo).

Qué hace y qué no

Zoosial entrega los datos del SAT y los coteja. La captura (fotos, PDF de bancos) y la contabilidad (pólizas, cálculo de nómina, depreciación) son de tu app.

Función¿Lo hace?Cómo
Gastos con fotos de ticketsCotejo síTu app lee la foto (OCR) y manda fecha, monto y RFC del comercio a /sat/reconcile con sentido:'egresos'. Te dice si ese gasto ya tiene factura.
Estados de cuenta del bancoCotejo síTu app convierte el estado de cuenta en movimientos y /sat/reconcile los empata contra tus facturas. No hay lector de PDF de bancos.
Recibos de nóminaSíLectura de los CFDI de nómina con /sat/cfdi/parse. Calcular la nómina o timbrar recibos no.
Depreciación de activosNoEs un cálculo de tu contabilidad. Las facturas de compra las tienes con la descarga masiva.
Buzón tributario, declaraciones, avisos, cancelacionesNoNunca. Zoosial solo consulta: no abre el buzón ni presenta, firma o cancela nada ante el SAT, y lo bloquea técnicamente.

Receta: ¿este ticket ya tiene factura?

bash
curl https://zoosial.com/sat/reconcile \
  -H "Authorization: Bearer $SC_API_KEY" -H "Content-Type: application/json" \
  -d '{ "sentido": "egresos",
        "movimientos": [{ "id": "ticket-881", "fecha": "2026-10-14", "monto": 1160, "rfc": "AAA010101AAA" }],
        "cfdis": [ …CFDI recibidos, salida de /sat/cfdi/parse… ] }'

Si resultados[0].sugerencias viene vacío, ese gasto todavía no tiene factura: pídela al comercio.

Precio

Las consultas con e.firma se cobran por cliente (RFC) al mes, en bloques de 10, más IVA: 10 RFC $200, 20 $300, 50 $600, 100 $999. Volver a consultar el mismo RFC en el mes no cuenta otra vez. Todo lo que no usa e.firma va incluido.

En esta página
Sin credenciales Con la e.firma de tu cliente Contabilidad y cotejo Qué hace y qué no Receta: ¿este ticket ya tiene factura? Precio
¿Tienes dudas?
Nuestro equipo responde en menos de 2h
Contactar soporte