Mapa de fuentes de datos
Toda la información que alimenta la metodología v1 viene de 5 endpoints de la API de Belvo, todos del producto "SAT — Servicio de Administración Tributaria". Esta página explica qué entrega cada uno y qué KPIs construye.
Por qué Belvo y no scraping directo del SAT
Belvo es un proveedor regulado de Open Finance en México que tiene contratos directos con el SAT a través de sus credenciales válidas. Cuando conectas tu RFC y CIEC a fondflex, esa credencial viaja cifrada a Belvo, ellos consultan al SAT por ti, y nos entregan datos estructurados. Nunca almacenamos tu CIEC en nuestros sistemas en texto plano.
Lo que NO contratamos
fondflex no contrata los productos de Belvo de Employment Data (IMSS/ISSSTE), Employment Score, ni Data Enrichment. Por eso v1 no incluye dimensiones de nómina formal IMSS, rotación de personal medida por SAT, ni datos enriquecidos de fuentes alternativas. Es decisión de scope para v1, no limitación técnica.
Los 5 endpoints
1. Tax Status — Constancia de Situación Fiscal
Qué entrega: tu Constancia de Situación Fiscal vigente, equivalente al PDF que cualquier contribuyente descarga del portal SAT. Incluye RFC, razón social, domicilio fiscal, fecha de inicio de operaciones, estado del padrón (ACTIVO / SUSPENDIDO / BAJA), capital social, actividad económica con porcentaje, regímenes fiscales activos y obligaciones fiscales registradas con sus fechas de cumplimiento.
Qué KPIs alimenta: Estado del RFC y Antigüedad Fiscal (pilar Cumplimiento Fiscal). Además, da contexto crítico para todos los demás cálculos: el régimen fiscal cambia cómo se interpretan otros KPIs, y la actividad económica es la base para la futura segmentación sectorial en v2.
Cuándo se actualiza: Belvo refresca cuando se solicita o cuando tú actualizas algo ante el SAT. Cada documento trae un campo collected_at con el timestamp real de la última sincronización.
2. Tax Compliance Status — Opinión de Cumplimiento
Qué entrega: tu Opinión de Cumplimiento de Obligaciones Fiscales — el comprobante con valor legal que se solicita típicamente para subsidios, contratos de gobierno, o cuando otra empresa pregunta si estás al corriente.
Valores posibles del campo outcome:
| Valor | Significado |
|---|---|
POSITIVE | Al corriente. Sin obligaciones pendientes. |
NEGATIVE | Con obligaciones pendientes. |
NO_OBLIGATIONS | Sin obligaciones que verificar en el periodo. |
Qué KPIs alimenta: la Opinión SAT, uno de los KPIs más visibles del producto. Una opinión positiva pesa fuerte y positivamente en el score; una negativa pesa fuerte en dirección opuesta.
Lo que NO contiene: el endpoint solo trae el estado actual, no su historia. Para construir métricas de "consistencia de cumplimiento a lo largo del tiempo", fondflex persiste cada estado en cada sincronización y mantiene su propia bitácora.
3. Tax Returns — Declaraciones de Impuestos
Qué entrega: las declaraciones que has presentado al SAT, anuales y mensuales mezcladas en una sola lista. El campo type discrimina entre yearly y monthly.
Declaración anual (yearly)
Trae aproximadamente 180 campos definidos por SAT, de los cuales para una empresa promedio típicamente vienen poblados 25-30 (el resto son secciones específicas de regímenes raros como Consolidación Fiscal o energía renovable).
Los campos críticos: ingresos nominales totales, deducciones autorizadas, pérdida o utilidad fiscal, ISR pagado, pagos provisionales, ISR a favor.
Declaración mensual (monthly)
Trae la determinación de ISR provisional + IVA mensual. Por razones estructurales del formato SAT, muchas secciones vienen vacías. Lo que sí suele venir poblado: las retenciones que tu empresa hizo a otros (servicios profesionales, retenciones por cuenta de terceros), recargos pagados cuando se presenta tarde, y la fecha exacta de presentación.
Qué KPIs alimenta:
- De anuales: Tasa Efectiva de ISR, Puntualidad de Declaración Anual, Frecuencia de Complementarias, Margen Fiscal (auxiliar).
- De mensuales: Puntualidad de Declaraciones Mensuales, Pago de Recargos.
4. Financial Statements — Estados Financieros
Qué entrega: tu Balance General y Estado de Resultados tal como aparecen en el formato oficial SAT, para cada año disponible. Belvo entrega hasta 5 años de historia en una sola llamada, lo que permite construir trayectorias multi-año sin trabajo adicional.
Balance General
Activos circulantes (caja, cuentas por cobrar, inventarios, impuestos a favor), activos no circulantes (PP&E, intangibles), pasivos circulantes (cuentas por pagar, otros acreedores, impuestos por pagar), pasivos no circulantes (deuda de largo plazo), y capital (capital social, utilidades retenidas).
Estado de Resultados
Ventas nacionales, ventas al extranjero, costo de ventas, utilidad bruta, gastos operativos, utilidad operativa, ISR pagado, utilidad o pérdida neta.
Qué KPIs alimenta: es la fuente principal del pilar Salud Financiera. Alimenta Margen Neto, Margen Bruto, Margen Operativo, Liquidez Corriente, Prueba Ácida, Capital de Trabajo, Deuda/Capital, Endeudamiento Total, ROE, ROA y Crecimiento de Ingresos.
Detalle técnico importante
Belvo usa pares de campos mutuamente excluyentes para los resultados. Si tu empresa tuvo utilidad, net_income está poblado y net_loss es null. Si tuvo pérdida, net_loss está poblado (con valor positivo) y net_income es null. El mismo patrón aplica para gross_profit/gross_loss, operating_income/operating_loss, e income_before_taxes/loss_before_taxes. La metodología v1 maneja explícitamente ambos casos.
5. Invoices — Facturas (CFDIs)
Qué entrega: la lista completa de CFDIs en los que tu empresa participa como emisor (OUTFLOW) o receptor (INFLOW). Cada CFDI incluye UUID, fecha, montos, estado (Vigente o Cancelado), datos del emisor y receptor (incluyendo régimen fiscal y estado de fraude tributario), método y forma de pago, detalle por producto/servicio, y desglose de impuestos.
Tipos de CFDI
invoice_type | Qué representa |
|---|---|
Ingreso | Venta o ingreso |
Egreso | Nota de crédito o descuento |
Pago | Comprobante de cobro a una factura previa |
Nómina | Pago a empleados |
Traslado | Movimiento de mercancía sin transferencia de propiedad |
Qué KPIs alimenta: es la fuente principal del pilar Flujo y Cobranza. Alimenta DSO, Concentración de Clientes, Tasa de Cancelación, Mix de Cobro (PUE vs PPD), Tasa de Cobro Real, Volatilidad de Ingresos Mensuales, y Crecimiento de Cartera. También permite inferir tu perfil real de IVA (16%, 0%, Exento o mixto) y detectar relaciones potenciales con listas EFOS/EDOS.
Las facturas son la categoría más voluminosa
Una empresa activa típicamente tiene cientos o miles de facturas por año. Los cálculos siempre filtran por status (excluyen Canceladas para revenue), discriminan por invoice_type (no sumar Ingresos con Pagos) y agrupan por receiver_id (para concentración).
Tabla resumen
| Endpoint Belvo | Pilar principal | KPIs que alimenta |
|---|---|---|
| Tax Status | Cumplimiento Fiscal | Estado del RFC, Antigüedad fiscal. Contexto de régimen e industria. |
| Tax Compliance | Cumplimiento Fiscal | Opinión SAT |
| Tax Returns Yearly | Cumplimiento Fiscal + Salud Financiera (auxiliar) | Tasa Efectiva ISR, Puntualidad Anual, Complementarias, Margen Fiscal |
| Tax Returns Monthly | Cumplimiento Fiscal | Puntualidad Mensual, Pago de Recargos |
| Financial Statements | Salud Financiera | Márgenes (Neto, Bruto, Operativo), Liquidez, Prueba Ácida, Capital de Trabajo, Deuda/Capital, Endeudamiento, ROE, ROA, Crecimiento |
| Invoices | Flujo y Cobranza | DSO, Concentración, Tasa de Cancelación, Mix PUE/PPD, Cobro Real, Volatilidad, Crecimiento de Cartera |