Entrar
Documentacion › Endpoints
📡

Endpoints del API

33 endpoints organizados en 6 categorias. 1 ya implementados, 32 pendientes.

33
Endpoints
6
Categorias
1
Implementados
7
Lenguajes
👤

Usuario

Datos del usuario y de los RFCs

POST 1 credito Listo

Datos fiscales

/api/v1/usuario/datos-fiscales

Consulta los datos fiscales registrados ante el SAT para un RFC específico. Incluye régimen fiscal, domicilio y fecha de inicio de operaciones.
🔐

Vault

Gestión de credenciales (CIEC y e.firma)

POST 0 creditos Pronto

Registrar RFC en vault

/api/v1/vault/rfc-registrar

Asocia un RFC al API key actual. Requerido antes de poder usar las consultas del SAT. Costo: 0 (configuración).
POST 0 creditos Pronto

Guardar credenciales RFC (CIEC)

/api/v1/vault/rfc-guardar

Cifra y almacena la contraseña CIEC del RFC. Se encripta con AES-256-GCM usando una clave derivada del API key.
POST 0 creditos Pronto

Eliminar credenciales RFC

/api/v1/vault/rfc-eliminar

Borra la CIEC asociada al RFC. No se puede deshacer.
POST 0 creditos Pronto

Estado del RFC en vault

/api/v1/vault/rfc-estado

Consulta si el RFC tiene CIEC y/o e.firma registrados.
POST 0 creditos Pronto

Registrar e.firma (.cer)

/api/v1/vault/firma-registrar

Sube el archivo .cer (certificado) de la e.firma del SAT. Se valida el certificado antes de almacenar.
POST 0 creditos Pronto

Guardar clave privada (.key)

/api/v1/vault/firma-guardar

Almacena la clave privada de la e.firma (.key) cifrada con AES-256-GCM. Se borra después de 1 hora por seguridad.
POST 0 creditos Pronto

Eliminar e.firma

/api/v1/vault/firma-eliminar

Borra el .cer y .key del RFC.
POST 0 creditos Pronto

Estado de la e.firma

/api/v1/vault/firma-estado

Consulta si la e.firma del RFC está vigente y cuándo expira.
🏛️

SAT

Consultas oficiales al SAT

POST 1 credito Pronto

Opinión de cumplimiento (CIEC)

/api/v1/sat/opinion-cumplimiento

Consulta la opinión de cumplimiento de obligaciones fiscales usando CIEC. Retorna positiva/negativa con detalle.
POST 1 credito Pronto

Opinión de cumplimiento (e.firma)

/api/v1/sat/opinion-cumplimiento-fiel

Variante de opinión de cumplimiento usando e.firma en lugar de CIEC. Útil cuando se necesita firma autógrafa digital.
POST 1 credito Pronto

Opinión de cumplimiento IMSS

/api/v1/sat/opinion-cumplimiento-imss

Consulta la opinión de cumplimiento de obligaciones ante el IMSS (Instituto Mexicano del Seguro Social).
POST 0 creditos Pronto

Opinión de cumplimiento (pública)

/api/v1/sat/opinion-cumplimiento-publica

Consulta sin credenciales, retorna solo la opinión pública del RFC. No requiere CIEC ni e.firma.
POST 1 credito Pronto

Validar PDF de opinión

/api/v1/sat/opinion-cumplimiento-validar-pdf

Recibe un PDF de opinión de cumplimiento y valida su firma y autenticidad ante el SAT.
POST 1 credito Pronto

Constancia de situación fiscal (CIEC)

/api/v1/sat/constancia-situacion-fiscal

Descarga la constancia de situación fiscal del RFC con todos los datos actualizados.
POST 1 credito Pronto

Constancia de situación fiscal (e.firma)

/api/v1/sat/constancia-situacion-fiscal-fiel

Variante de constancia de situación fiscal usando e.firma. Recomendado para empresas con volumen alto.
POST 1 credito Pronto

Comunicados del SAT

/api/v1/sat/comunicados

Lista los comunicados oficiales del SAT para un RFC en un rango de fechas.
POST 1 credito Pronto

Notificaciones del SAT

/api/v1/sat/notificaciones

Lista las notificaciones electrónicas pendientes del RFC en el buzón tributario.
POST 1 credito Pronto

Información fiscal (CIEC)

/api/v1/sat/informacion-fiscal

Consulta la información fiscal detallada del RFC con CIEC.
POST 1 credito Pronto

Información fiscal (e.firma)

/api/v1/sat/informacion-fiscal-fiel

Variante con e.firma de la consulta de información fiscal.
POST 1 credito Pronto

Facturas recibidas (CIEC)

/api/v1/sat/facturas

Lista las facturas recibidas por el RFC en un periodo.
POST 1 credito Pronto

Facturas recibidas (e.firma)

/api/v1/sat/facturas-fiel

Variante con e.firma de la consulta de facturas recibidas.
POST 1 credito Pronto

Retenciones del SAT

/api/v1/sat/retenciones

Lista las retenciones registradas ante el SAT para el RFC.
POST 1 credito Pronto

Declaraciones presentadas (CIEC)

/api/v1/sat/declaraciones

Lista las declaraciones mensuales/anuales presentadas por el RFC.
POST 1 credito Pronto

Declaraciones presentadas (e.firma)

/api/v1/sat/declaraciones-fiel

Variante con e.firma de la consulta de declaraciones.
POST 1 credito Pronto

Solicitar descarga de metadata

/api/v1/sat/descarga-metadata

Solicita al SAT la metadata de CFDI emitidos/recibidos en un periodo. Retorna un ID de solicitud que se usa en /descarga/verificar.
POST 1 credito Pronto

Solicitar descarga de retenciones

/api/v1/sat/descarga-metadata-retencion

Variante de descarga de metadata enfocada en retenciones.
⚠️

EFOS

Listados negros del SAT (EFOS y EDOS)

POST 1 credito Pronto

Consultar listado EFOS

/api/v1/efos/consultar

Consulta si un RFC aparece en el listado de Empresas que Facturan Operaciones Simuladas (EFOS) o EDOS. Costo: 0 (consulta pública del SAT).
🏢

REPSE

Registro de Prestadores de Servicios Especializados

POST 1 credito Pronto

Consultar REPSE

/api/v1/repse/consultar

Consulta si un RFC está registrado en el REPSE (Registro de Prestadores de Servicios Especializados).
📦

Descarga

Descarga masiva de CFDI

POST 3 creditos Pronto

Solicitar descarga masiva

/api/v1/descarga/solicitar

Inicia una solicitud de descarga masiva de CFDI al SAT. Retorna un ID de solicitud. Costo: 3 créditos (incluye todo el paquete).
POST 0 creditos Pronto

Verificar estado de descarga

/api/v1/descarga/verificar

Consulta el estado de una solicitud de descarga masiva. Cuando está TERMINADA, se puede obtener el paquete con /descarga/paquete.
POST 0 creditos Pronto

Descargar paquete masivo

/api/v1/descarga/paquete

Descarga el archivo ZIP con todos los CFDI de la solicitud. Costo: 0 (ya cobrado al solicitar).
POST 1 credito Pronto

Consultar CFDI específico

/api/v1/descarga/consulta-cfdi

Consulta un CFDI específico por UUID sin necesidad de descarga masiva. Costo: 1 crédito.