Casos especiales y banderas
La realidad fiscal de las empresas es diversa. La metodología v1 maneja con dignidad casos que rompen los supuestos del flujo principal. Esta página documenta los principales casos especiales identificados durante la auditoría con datos reales y la respuesta del sistema en cada uno.
Las banderas (flags) en general
Cuando el sistema detecta un caso especial, agrega una bandera al cálculo. Las banderas son objetos persistidos junto al cálculo del Score Oficial. La UI las muestra como tarjetas accionables, ubicadas arriba o abajo del dashboard según su severidad.
| Severidad | Cómo se muestra |
|---|---|
| Máxima bloqueo | Arriba del score, bloquea continuación normal |
| Máxima | Arriba del score |
| Alta | Arriba del score |
| Informativa | En el pilar correspondiente o en contexto general |
Caso 1: empresa con pérdida fiscal del ejercicio
Cuando tu empresa tuvo pérdida en lugar de utilidad en el año evaluado, varios KPIs producen valores que pueden malinterpretarse.
Comportamiento de KPIs:
| KPI | Comportamiento |
|---|---|
| Margen Neto | Se calcula con utilidad negativa. Cae en "Crítico". |
| Margen Operativo | Igual que Margen Neto si la pérdida es operativa. |
| ROE / ROA | Se calculan con utilidad negativa. Valor negativo, cae en "Crítico". |
| Crecimiento de Ingresos | Independiente de utilidad. Se calcula normalmente. |
| Liquidez y endeudamiento | Independientes. Se calculan normalmente. |
Bandera generada (severidad: alta):
Tu empresa tuvo pérdida fiscal en [año]: $[X]. Esto afecta los indicadores de rentabilidad (Margen Neto, ROE, ROA) que aparecen bajos. Una pérdida no significa quiebra, pero es señal a vigilar.
Caso 2: empresa con patrimonio negativo
Cuando los pasivos superan los activos, el patrimonio (equity) es negativo. Eso se llama insolvencia técnica y es una situación grave: legalmente, la empresa debe al menos $X más de lo que vale.
Comportamiento de KPIs:
| KPI | Comportamiento |
|---|---|
| Deuda / Capital | Denominador negativo. Marcado como Crítico con valor "patrimonio negativo" (sin mostrar el número). |
| Endeudamiento Total | Pasa del 100%. Mostrado como > 100% con marca de Crítico. |
| ROE | Denominador negativo. Marcado como N/D con disclaimer ("ROE no aplicable: patrimonio negativo"). |
| Capital de Trabajo | Independiente. Se calcula normalmente. |
Bandera generada (severidad: máxima):
Tu empresa tiene patrimonio negativo en [año]: $[X]. Significa que tus pasivos superan tus activos. Esta es una situación delicada que requiere atención inmediata, idealmente con un contador o asesor financiero.
Caso 3: datos pendientes por sincronización asíncrona
Belvo no entrega los datos de los 5 endpoints simultáneamente. Cuando un nuevo cliente se conecta, fondflex dispara las llamadas en paralelo, pero cada endpoint completa en momentos distintos.
| Endpoint | Tiempo típico |
|---|---|
| Tax Status, Tax Compliance | Segundos o pocos minutos |
| Financial Statements, Invoices | Varios minutos a horas (depende del volumen) |
Estrategia: Loading State por Pilar
El dashboard es accesible inmediatamente. Cada pilar se renderiza independientemente:
| Estado | Renderizado |
|---|---|
| Datos completos | KPIs + scores + visualizaciones |
| Pendiente | Skeleton + "Sincronizando…" |
| Datos parciales | Lo disponible, KPIs faltantes como N/D |
Estados internos por endpoint:
| Estado | Significado |
|---|---|
pending | Llamada iniciada, sin respuesta aún |
completed_with_data | Belvo respondió con datos válidos |
completed_no_data | Belvo respondió correctamente pero no tiene info para el periodo |
Mensaje al cliente cuando Salud Financiera está sincronizando:
Sincronizando tu información financiera. Estamos descargando tus Estados Financieros del SAT vía Belvo. Esto puede tomar de varios minutos a unas horas dependiendo del volumen de información. Te avisaremos por correo cuando esté listo.
Mensaje cuando no hay datos para el año:
Aún no tenemos información para [año]. La sincronización con SAT se completó pero no encontramos declaración anual para este ejercicio. Esto puede deberse a que tu declaración aún no fue presentada o procesada por el SAT, o a que el año seleccionado es muy reciente.
Notificación cuando un pilar se completa
Cuando un endpoint asíncrono termina y el pilar pasa a completed_with_data, el sistema te envía una notificación: "Tu Salud Financiera ya está disponible." Eso cierra el bucle del onboarding y te dice cuándo regresar.
Caso 4: año sin operaciones
Algunas empresas se registraron al SAT en cierto año pero no operaron (por ejemplo, una sociedad constituida en agosto que solo aportó capital inicial).
Detección automática: cuando ingresos = costos = gastos = 0, y solo hay capital inicial.
Respuesta del sistema: el año se excluye automáticamente del scoring y de las trayectorias. Si el cliente lo selecciona explícitamente en la Vista Anual, ve:
[Año] — Empresa sin operaciones. En este año tu empresa estaba registrada ante el SAT pero no reportó actividad económica. No hay indicadores que evaluar.
Caso 5: empresa muy nueva (menos de 12 meses)
Las empresas muy jóvenes tendrán datos incompletos en casi todos los KPIs. La metodología es amable con este caso sin perder honestidad sobre las limitaciones.
Comportamiento:
- Salud Financiera: probablemente N/D entero (no hay declaración anual cerrada).
- Flujo y Cobranza: se calcula con los meses disponibles. KPIs como Volatilidad pueden quedar N/D si requieren ≥ 6 meses de datos.
- Cumplimiento Fiscal: se calcula con los meses disponibles. El KPI de Antigüedad Fiscal cae en "Crítico" automáticamente (con disclaimer informativo, no calificativo).
Bandera generada (severidad: informativa):
Tu empresa tiene [X] meses de operación formal. Esto es normal: los indicadores se vuelven más representativos después de un año fiscal completo. Por ahora, evaluamos lo disponible.
Caso 6: RFC suspendido o de baja
Si tu RFC tiene un estado distinto a ACTIVO, el sistema activa una alerta máxima.
Bandera generada (severidad: máxima_bloqueo):
ATENCIÓN: Tu RFC está en estado [SUSPENDIDO / BAJA]. Esto significa que no puedes facturar válidamente y enfrentas restricciones legales. Te recomendamos contactar a un contador inmediatamente para regularizar tu situación.
Esta bandera bloquea el flujo normal
Aparece arriba del Score Oficial, no debajo: la debes ver primero. El score se sigue calculando con la información disponible, pero queda en segundo plano visualmente.
Caso 7: opinión SAT NEGATIVA
Una opinión negativa del SAT es señal grave.
Bandera generada (severidad: alta):
Tu Opinión de Cumplimiento ante el SAT es NEGATIVA. Esto significa que tienes obligaciones fiscales pendientes que el SAT identificó.
Si el endpoint trae instrucciones específicas: El SAT indica específicamente: [taxpayer_instructions]
Caso 8: relación detectada con EFOS / EDOS
Si alguna factura emitida o recibida muestra el campo tax_fraud_status distinto a NO_TAX_FRAUD_STATUS, el sistema lo marca.
Bandera generada (severidad: alta):
Detectamos [N] facturas con clientes / proveedores que el SAT ha clasificado como EFOS (Empresas Facturando Operaciones Simuladas) o categoría relacionada. Esto puede tener implicaciones fiscales serias. Te recomendamos revisar con tu contador inmediatamente.
Detalles: lista de RFCs y facturas afectadas.
Caso 9: concentración extrema en un cliente
Cuando un solo cliente representa más del 80% de los ingresos.
Bandera generada (severidad: informativa):
El [X]% de tus ingresos viene de un solo cliente ([nombre, RFC]). Si pierdes a este cliente, tu negocio enfrenta riesgo serio. Considera estrategias de diversificación.
Caso 10: Score Oficial Global durante sincronización
Mientras alguno de los pilares esté en pending, el Score Oficial se calcula solo con los pilares completados:
Score basado en [X] de 3 pilares. El resto se está sincronizando.
Cuando todos los pilares se completan, el Score Oficial se recalcula automáticamente con los 3 pilares activos y se actualiza en el dashboard.
Tabla de banderas disponibles
| Tipo | Severidad | Dónde se muestra |
|---|---|---|
rfc_inactivo | Máxima bloqueo | Arriba del score, bloquea continuación normal |
opinion_sat_negativa | Alta | Arriba del score |
patrimonio_negativo | Máxima | Arriba del score |
relacion_efos_edos | Alta | Arriba del score |
perdida_fiscal | Alta | En el pilar Salud Financiera |
concentracion_extrema | Informativa | En el pilar Flujo y Cobranza |
empresa_nueva | Informativa | En contexto general |