Entrar
Documentacion › Guias por caso de uso
8 roles cubiertos

Guias paso a paso por caso de uso

Identifica tu rol, sigue los pasos y resuelve. Cada guia dice: para que sirve, como hacerlo y que logras con eso.

Total: 8 perfiles 22 guias paso a paso Actualizado: hoy

Elige tu rol

Dueno de empresa

Persona moral o fisica con actividad empresarial que quiere ver el status fiscal de su negocio.

Frecuencia: Mensual 3 guias

Contador / Despacho contable

Llevas la contabilidad de varios clientes y quieres automatizar lo que antes hacias a mano en el portal del SAT.

Frecuencia: Diario en cierre 4 guias

Auditor / Dictaminador fiscal

Haces auditorias fiscales o financieras. Necesitas evidencia documental de todo.

Frecuencia: Por auditoria 3 guias

Abogado fiscal / Litigante

Defiendes contribuyentes ante el SAT o en juicios fiscales. Necesitas datos en tiempo real.

Frecuencia: Por caso 2 guias

Desarrollador / Ingeniero de software

Vas a escribir codigo que llama al API o quieres integrarlo a un producto.

Frecuencia: Continuo 4 guias

Gestor de cobranza / Call center

Llamas a clientes morosos y necesitas saber rapidamente su situacion fiscal antes de cada gestion.

Frecuencia: Diaria 2 guias

Recursos Humanos / Nominas

Gestionas empleados, nominas y necesitas validar datos fiscales para timbrar recibos de nomina.

Frecuencia: Quincenal 2 guias

Compliance officer / PLD

Cumplimiento normativo: PLD, KYC, proveedores, terceros relacionados.

Frecuencia: Mensual 2 guias
Rol 1 de 8

Dueno de empresa

Persona moral o fisica con actividad empresarial que quiere ver el status fiscal de su negocio.

Frecuencia recomendada: Mensual
1

Como saber si mis declaraciones estan al corriente

Para que

Verificar que el SAT tiene registradas tus declaraciones mensuales y anuales.

    Pasos
  1. Llama a GET /api/v1/usuario/datos-fiscales con tu RFC
  2. Confirma regimen fiscal y domicilio registrado
  3. Llama a GET /api/v1/declaraciones?rfc=XAXX010101000&anio=2026
  4. Por cada mes verifica estado=presentada
Sirve para

Tranquilidad de saber que no tienes multas del SAT.

2

Como consultar mi opinion de cumplimiento 32D

Para que

Obtener el documento que el SAT te da cuando estas al corriente.

    Pasos
  1. Llama a GET /api/v1/usuario/opinion-32d?rfc=XAXX010101000
  2. Lee la respuesta: positiva, negativa o insumos_insuficientes
  3. Si es positiva, ya puedes presentarla a quien te la pida
  4. Si es negativa, el API te dice el motivo exacto
Sirve para

Licitaciones, alta de proveedores, comprobar buena fe fiscal.

3

Como descargar todas mis facturas del mes

Para que

Conciliacion contable, auditoria, declaracion anual.

    Pasos
  1. Llama a POST /api/v1/factura/descarga-masiva con tu RFC, mes y tipo (emitidas/recibidas)
  2. Guarda el paquete_id que te devuelve
  3. Consulta el estado con GET /api/v1/factura/descarga-masiva/{paquete_id}/estado
  4. Cuando estado=completo, descarga el ZIP con el archivo final
Sirve para

Pasarle a tu contador todos los CFDIs del mes en un solo paquete.

Rol 2 de 8

Contador / Despacho contable

Llevas la contabilidad de varios clientes y quieres automatizar lo que antes hacias a mano en el portal del SAT.

Frecuencia recomendada: Diario en cierre
1

Como procesar 50 clientes en lote sin morir en el intento

Para que

Hacer la misma consulta para muchos clientes sin ir uno por uno.

    Pasos
  1. Prepara un archivo con los RFCs de tus clientes (uno por linea)
  2. Llama a POST /api/v1/lote/datos-fiscales con el array de RFCs
  3. El API procesa en paralelo y devuelve un resultado por RFC
  4. Filtra los que dieron error (cfdi_codigo != 1) y reintenta solo esos
Sirve para

El cierre mensual: 50 clientes x 5 consultas = 250 requests en 5 minutos.

2

Como verificar opinion 32D antes de la declaracion anual

Para que

En marzo/abril, validar que todo este en orden antes de presentar la declaracion anual.

    Pasos
  1. Por cada cliente llama a GET /api/v1/usuario/opinion-32d?rfc=XAXX...
  2. Agrupa los que dan positiva: listos para presentar
  3. Los que dan negativa, abre ticket: "tienes X creditos fiscales pendientes"
  4. Una vez resueltos, vuelve a llamar al endpoint para confirmar
Sirve para

Evitar declaraciones con informacion incompleta que generan multas.

3

Como obtener la CSF (Constancia de Situacion Fiscal) actualizada

Para que

Para tramites bancarios, licitaciones, alta de proveedores.

    Pasos
  1. Llama a GET /api/v1/usuario/csf?rfc=XAXX010101000&formato=pdf
  2. Recibes el PDF oficial del SAT, listo para imprimir o enviar
  3. Verifica que la fecha de emision sea menor a 3 meses
Sirve para

Cualquier tramite que pida "constancia de situacion fiscal vigente".

4

Como cancelar un CFDI emitido por error

Para que

Corregir un CFDI mal timbrado sin esperar al mes siguiente.

    Pasos
  1. Identifica el UUID de la factura a cancelar
  2. Llama a POST /api/v1/factura/cancelar con motivo 02 (devolucion)
  3. Si hay sustitucion, agrega el UUID de la nueva
  4. Guarda el acuse del SAT que devuelve el API
Sirve para

Corregir errores de monto, cliente o concepto sin penalizacion.

Rol 3 de 8

Auditor / Dictaminador fiscal

Haces auditorias fiscales o financieras. Necesitas evidencia documental de todo.

Frecuencia recomendada: Por auditoria
1

Como obtener evidencia de operaciones con un proveedor

Para que

Validar que las facturas que un cliente dice tener recibidas realmente existen en el SAT.

    Pasos
  1. Pide el RFC del proveedor a tu cliente
  2. Llama a GET /api/v1/factura/recibidas?rfc_cliente=XAXX...&rfc_proveedor=ABCD...&periodo=2026-Q2
  3. Recibes el listado oficial de CFDIs segun el SAT
  4. Compara contra lo que tu cliente tiene registrado. Las diferencias son evidencia
Sirve para

Detectar facturas "fantasma" o no declaradas.

2

Como validar que un proveedor no esta en EFOS

Para que

Antes de aceptar una factura, confirmar que el proveedor no es facturero.

    Pasos
  1. Llama a GET /api/v1/efos-consultar?rfc=ABCD010101000
  2. Si devuelve definitivo: NO le compres, no tiene validez
  3. Si devuelve presunto: en juicio, mejor abstenerte
  4. Si devuelve no_encontrado: opera con tranquilidad
Sirve para

Proteger a tu cliente de comprar facturas falsas (delito fiscal grave).

3

Como descargar toda la evidencia fiscal de un ejercicio

Para que

Papeles de trabajo para dictamen fiscal o auditoria.

    Pasos
  1. Llama a POST /api/v1/factura/descarga-masiva con RFC, anio y tipo=todas
  2. Espera a que el paquete se procese (puede tardar varios minutos)
  3. Descarga con GET /api/v1/factura/descarga-masiva/{paquete_id}/descargar
  4. El ZIP incluye XML + PDF + acuses de cancelacion
Sirve para

Dictamen fiscal, revisiones del SAT, auditorias financieras.

Rol 4 de 8

Abogado fiscal / Litigante

Defiendes contribuyentes ante el SAT o en juicios fiscales. Necesitas datos en tiempo real.

Frecuencia recomendada: Por caso
1

Como armar un expediente de defensa con datos del SAT

Para que

Construir pruebas solidas para un juicio de nulidad o recurso de revocacion.

    Pasos
  1. Llama a GET /api/v1/usuario/datos-fiscales del contribuyente
  2. Captura regimen, domicilio y representante legal al momento del acto
  3. Descarga la CSF con GET /api/v1/usuario/csf
  4. Guarda opinion 32D historica para acreditar buena fe
Sirve para

Demostrar que la situacion fiscal del cliente al momento X era la correcta.

2

Como acreditar domicilio fiscal actualizado

Para que

Cuando el SAT te niegas un tramite por "domicilio no localizado".

    Pasos
  1. Llama a GET /api/v1/usuario/datos-fiscales?rfc=XAXX...
  2. Captura la respuesta completa (incluye direccion registrada)
  3. Compara con la direccion que tu cliente dice tener
  4. Si hay diferencia, solicita actualizacion de domicilio via API
Sirve para

Tener evidencia para impugnar actos del SAT por errores de domicilio.

Rol 5 de 8

Desarrollador / Ingeniero de software

Vas a escribir codigo que llama al API o quieres integrarlo a un producto.

Frecuencia recomendada: Continuo
1

Como hacer la primera llamada en menos de 5 minutos

Para que

Confirmar que tu entorno esta bien configurado antes de escribir mas codigo.

    Pasos
  1. Obten tu API key (sat_xxx) - te la da tu equipo
  2. Elige tu lenguaje: cURL, Python, Node.js, PHP, Go, Java, C#
  3. Copia el ejemplo de /docs/ejemplos/{lenguaje}
  4. Reemplaza la API key y ejecuta
Sirve para

Empezar rapido sin leer 50 paginas de documentacion.

2

Como manejar errores de forma robusta

Para que

Evitar loops infinitos de reintentos y errores que gastan saldo.

    Pasos
  1. SIEMPRE revisa cfdi_codigo en la respuesta, no solo el HTTP status
  2. Si cfdi_codigo != 1, lee cfdi_texto y cfdi_descripcion
  3. Errores 5000-5099: transitorios, reintenta con backoff exponencial
  4. Errores 4000-4099: definitivos, NO reintentes - corrige la peticion
Sirve para

Produccion estable que no se rompe ante errores transitorios.

3

Como optimizar el consumo de creditos

Para que

Maximizar el ROI de los creditos comprados.

    Pasos
  1. Cachea respuestas que no cambian seguido (datos fiscales: 24h es OK)
  2. Usa /lote/* para N consultas en 1 request
  3. Usa /descarga-masiva (3 creditos) en vez de N individuales
  4. Monitorea tu saldo y alerta al cliente cuando baje de N
Sirve para

Reducir hasta 80% el costo operacional de tu integracion.

4

Como implementar webhooks para recibir eventos

Para que

Saber en tiempo real cuando algo cambia (nuevo CFDI, declaracion, etc).

    Pasos
  1. Configura tu endpoint receptor con HTTPS
  2. Valida la firma del webhook (X-Signature) con tu secret
  3. Responde 200 OK en menos de 5 segundos
  4. Implementa idempotencia con el header X-Idempotency-Key
Sirve para

Evitar polling constante y reaccionar al instante a eventos.

Rol 6 de 8

Gestor de cobranza / Call center

Llamas a clientes morosos y necesitas saber rapidamente su situacion fiscal antes de cada gestion.

Frecuencia recomendada: Diaria
1

Como evaluar capacidad de pago antes de una gestion

Para que

Saber si el cliente tiene fondos o esta quebrado antes de llamar.

    Pasos
  1. Llama a GET /api/v1/usuario/opinion-32d?rfc=XAXX...
  2. Si es positiva: probablemente puede pagar
  3. Si es negativa: tiene problemas fiscales serios
  4. Revisa historial: GET /api/v1/transacciones?rfc=XAXX...&ultimos=3meses
Sirve para

Priorizar a quien tiene capacidad real de pago.

2

Como detectar cambio de domicilio del deudor

Para que

Cuando se te "pierde" un cliente, saber si cambio de direccion.

    Pasos
  1. Llama a GET /api/v1/usuario/datos-fiscales?rfc=XAXX...
  2. Captura el domicilio fiscal registrado
  3. Compara con el domicilio que tenias en tu CRM
  4. Si cambio, actualiza tu registro y reagenda la visita
Sirve para

No perder gestionables por domicilios desactualizados.

Rol 7 de 8

Recursos Humanos / Nominas

Gestionas empleados, nominas y necesitas validar datos fiscales para timbrar recibos de nomina.

Frecuencia recomendada: Quincenal
1

Como validar RFCs de empleados al alta

Para que

Asegurarte que el RFC capturado en tu sistema de nominas existe y esta vigente.

    Pasos
  1. Cuando capturas un nuevo empleado, llama a GET /api/v1/usuario/datos-fiscales?rfc=ABCD...
  2. Si el RFC existe: guarda el nombre oficial del SAT
  3. Si NO existe: el empleado capturo mal su RFC, no podras timbrar nomina
  4. Antes del primer timbrado de nomina, re-valida
Sirve para

Evitar cancelaciones masivas de recibos de nomina por RFCs mal capturados.

2

Como identificar empleados con problemas fiscales

Para que

Para alertar a tu cliente (patron) sobre empleados con opinion 32D negativa.

    Pasos
  1. En tu cierre quincenal, llama a /api/v1/lote/opinion-32d con todos los RFCs
  2. Identifica empleados con opinion negativa
  3. No es responsabilidad del patron, pero al saberlo puedes orientar
Sirve para

Evitar nominas a empleados con problemas que generen observaciones del SAT al patron.

Rol 8 de 8

Compliance officer / PLD

Cumplimiento normativo: PLD, KYC, proveedores, terceros relacionados.

Frecuencia recomendada: Mensual
1

Como validar proveedores contra listas negras (PLD)

Para que

Cumplir con la Ley Antilavado evitando relacionarte con EFOS o sancionados.

    Pasos
  1. Para cada proveedor nuevo, llama a GET /api/v1/efos-consultar?rfc=ABCD...
  2. Tambien GET /api/v1/efos-consultar?rfc=ABCD...&lista=69b para la lista 69-B
  3. Si el RFC aparece en cualquier lista: NO le compres, documenta la decision
  4. Re-valida mensualmente (las listas se actualizan)
Sirve para

Cumplir con PLD y evitar sanciones por operar con factureros.

2

Como auditar opinion 32D de clientes activos

Para que

Para due diligence continuo en clientes con lineas de credito grandes.

    Pasos
  1. Por cada cliente con linea > 1M MXN, llama a GET /api/v1/usuario/opinion-32d mensualmente
  2. Si pasa de positiva a negativa: alerta al comite de credito
  3. Documenta cada consulta con su fecha y resultado
Sirve para

Evitar perdidas por clientes que caen en incumplimiento fiscal.

Resumen rapido por rol

Rol Frecuencia Guias Endpoints principales
Dueno de empresa Mensual 3 datos-fiscales, opinion-32d, descarga-masiva
Contador / Despacho contable Diario en cierre 4 opinion-32d, lote/*, declaraciones, factura/cancelar
Auditor / Dictaminador fiscal Por auditoria 3 factura/recibidas, efos-consultar, descarga-masiva
Abogado fiscal / Litigante Por caso 2 datos-fiscales, csf, opinion-32d (historico)
Desarrollador / Ingeniero de software Continuo 4 todos + /health, /docs/openapi-spec
Gestor de cobranza / Call center Diaria 2 opinion-32d, datos-fiscales, transacciones
Recursos Humanos / Nominas Quincenal 2 datos-fiscales, lote/opinion-32d, factura/*
Compliance officer / PLD Mensual 2 efos-consultar, opinion-32d (lote), datos-fiscales
?

No encuentras tu caso de uso?

Cuentame que necesitas hacer y te ayudo a armar la guia paso a paso en menos de 48h.

Pedir guia personalizada