V20260401_2330

Panel de Control

Vista general del sistema TaxFlow

-- Contribuyentes
-- Modulos activos
9 Pasos del pipeline
18 Hojas CONSOLIDADO

Acceso rapido

▶

Ejecutar Pipeline

Lanza los 9 pasos del procesamiento fiscal para un contribuyente y periodo
⚙

Modulos de Procesamiento

FLUJO, DEVENGO, Extractor, Metadata, Nomina y mas
☷

Configurar Reportes

Agrega, quita o reordena columnas en los reportes sin tocar codigo
✎

Documentacion

Arquitectura, manuales y contexto tecnico del proyecto

Modulos del sistema

Pipeline de Procesamiento

Los 9 pasos para generar reportes fiscales de un contribuyente

1

Seleccionar contribuyente

Elegir RFC del catalogo de contribuyentes.yaml

Manual contribuyentes.yaml
Pendiente
2

Definir periodo

Establecer anio y mes a procesar (YYYY-MM)

Manual config.py
Pendiente
3

Verificar datos en disco

Validar existencia de XMLs, metadata y estructura de carpetas

Automatico config_manager.py
Pendiente
4

Actualizar metadata SAT

Descargar y fusionar metadata de UUID del SAT (estatus vigente/cancelado)

Automatico actualizar_metadata.py FIEL requerida
Pendiente
5

Validar cobertura CFDI

Verificar completitud de CFDIs y clasificar estatus por UUID

Automatico recolector_cfdi.py
Pendiente
6

Extraer XMLs a CSVs

Ejecutar cfdi_39.exe para descomponer XMLs en 11 CSVs estructurados

Automatico extractor_cpp.py C++
Pendiente
7

Generar CONSOLIDADO

Procesar PUE + PPD + NoObjeto y generar Excel de 18 hojas con matrices fiscales

Automatico flujo_impuestos.py Core
Pendiente
8

Revisar reportes

Abrir y verificar los archivos Excel generados en REP/

Manual Visor de reportes
Pendiente
9

Guardar estado

Registrar resultado de la ejecucion y actualizar estado del contribuyente

Automatico rfc_estado.md
Pendiente
10

Conciliacion

Comparar CONSOLIDADO contra un archivo externo (MisKuentas, ERP, etc.)

Opcional Excel de diferencias
Pendiente
Log de ejecucion 
Esperando ejecucion...

Importar Archivos

Carga un ZIP con XMLs y Metadata desde tu equipo. El sistema distribuye los archivos automáticamente.

Seleccionar contribuyente y archivo

Modulos de Procesamiento

Componentes del motor TaxFlow y su estado

FLUJO

Core

Motor mensual de flujo de efectivo. Procesa CFDIs por metodo de pago (PUE y PPD) y genera el CONSOLIDADO de 18 hojas con matrices fiscales.

Entrada 11 CSVs extraidos de XMLs
Salida CONSOLIDADO.xlsx (18 hojas)
Procesadores PUE, PPD, NoObjeto
Wrapper flujo_impuestos.py
Ubicacion src/flujo/

DEVENGO

Core

Motor anual de base devengada. Reporte integral por fecha de emision (no de pago). Incluye BASES_ISR, IVA/IEPS y retenciones con checkpoints de recuperacion.

Entrada CSVs + reportes FLUJO mensuales
Salida DEVENGO_anual.xlsx
Lookups 11 tablas de referencia
Wrapper devengo.py
Ubicacion src/devengo/

Extractor C++

Infraestructura

Ejecutable compilado que parsea XMLs de CFDI y genera 11 CSVs estructurados. Incluye _comprobante, _emisor, _receptor, _concepto, traslados, retenciones, pagos y ledger.

Entrada XMLs CFDI (carpeta de contribuyente)
Salida 11 archivos CSV criticos
Ejecutable cfdi_39.exe
Wrapper extractor_cpp.py
Ubicacion src/extractor/

Metadata SAT

Datos

Pipeline de 6 pasos para gestionar metadata de CFDIs del SAT. Consolida, detecta faltantes, verifica estatus, aplica actualizaciones y mide cobertura.

Entrada CSVs del portal SAT + FIEL
Salida _TODOMETADATA.csv actualizado
Sub-pasos meta_01 a meta_06
Wrapper actualizar_metadata.py
Ubicacion src/metadata/

Nomina

Especializado

Procesamiento de CFDIs de nomina. Genera CSVs tipo "melted" con desglose de percepciones y deducciones por empleado y periodo.

Entrada XMLs de nomina
Salida Reportes de nomina
Adaptador nomina_02c_adapter.py
Runner nomina_03_run_wsl.py
Ubicacion src/nomina/

Descargas SAT

Datos

Descarga masiva de metadata y CFDIs directamente del portal del SAT usando autenticacion FIEL (certificados .cer/.key).

Entrada FIEL (.cer, .key, password)
Salida XMLs descargados + metadata CSVs
Script Descargas.py
Seguridad FIEL nunca se almacena en GUI
Ubicacion src/sat/

Catalogos compartidos (_Comunes/)

Archivo Contenido Uso
_UsoCFDI.csvCodigos de uso de CFDIClasificar facturas
_RegimenFiscal.csvRegimenes fiscalesIdentificar regimen (601, 611, etc.)
_LimitesLISR.csvTablas de ISRCalculo de impuesto progresivo
_Cat_NoObjeto_ClaveProdServ.csvProductos no objeto de IVASeparar bienes sin IVA
_Cat_NoObjeto_RfcEmisor.csvRFCs emisores exentosGobierno/institucional
c_ClaveProdServ.csvCatalogo de productos SATMapear codigos a descripciones
TC.csvTipos de cambio por fechaConversion MO a MXN

Configuracion

Administra contribuyentes, rutas de archivos y parametros del sistema

Archivos comunes del sistema

Rutas a catalogos SAT y recursos compartidos por todos los contribuyentes

...
...
...

Contribuyentes

Configuracion de Reportes

Personaliza columnas, orden y visibilidad de los reportes generados

CONSOLIDADO

18 hojas

Reporte principal con matrices fiscales. IVA, IEPS, locales (traslados y retenciones) desglosados por PUE y PPD.

Hojas incluidas:

  1. RESUMEN — Totales por tipo de impuesto
  2. 01_IVA_Trasladado_AMBOS
  3. 02_IEPS_Trasladado_AMBOS
  4. 03_ImpLocales_Trasladados_AMBOS
  5. 04_IVA_Retenido_AMBOS
  6. 05_ISR_Retenido_AMBOS
  7. 06_RetLocales_AMBOS
  8. Matrices por regimen fiscal
  9. Matrices por producto
  10. Matrices por emisor

Reporte Lineal

71 columnas

Reporte aplanado: 1 fila por CFDI con todos los datos. UUID, fechas, participantes, impuestos, clasificaciones, monedas.

Categorias de columnas:

  • Identificadores — UUID, UUID_Pago, fechas, estatus
  • Participantes — RFC y nombre de emisor/receptor
  • Impuestos — ImpuestoSAT, TipoFactor, Base_MXN, Tasa, Importe
  • Monedas — MonedaCFDI, TipoCambio, Importe_MO
  • Clasificacion — Emitido/Recibido, NetoFiscal, Origen

DEVENGO

Anual

Reporte integral anual por base devengada (fecha de emision). Incluye BASES_ISR, secciones de IVA/IEPS y retenciones.

Secciones:

  • BASES_ISR — Base devengada por emision
  • IVA/IEPS — Importado de reportes FLUJO mensuales
  • Retenciones — ISR, IVA por regimen
  • Matrices — Por uso CFDI, regimen, producto

Configurador de columnas

El configurador interactivo permitira agregar, quitar y reordenar columnas de cada hoja de reporte mediante drag-and-drop. Los perfiles de configuracion se guardaran por contribuyente y se aplicaran automaticamente al generar reportes.

☷

Configurador disponible en Fase 3

Requiere backend FastAPI + base de datos SQLite

Documentacion

Arquitectura, manuales y documentos tecnicos del proyecto

Selecciona un documento

Haz click en un documento de la lista para verlo aqui.

Asistente IA

Chat con LLM sobre el proyecto TaxFlow — datos, procesos, configuracion

Verificando proveedores...
La IA cargara los CSVs y reportes del contribuyente/periodo seleccionado
⚛

Asistente IA de TaxFlow

Pregunta sobre contribuyentes, procesos, estructura de datos, configuracion de reportes, o cualquier aspecto del sistema.

Enter para enviar — Shift+Enter para nueva linea

Configuracion de proveedores

Anthropic (Claude)

export ANTHROPIC_API_KEY=sk-ant-...

Modelos: Claude Sonnet 4.6, Haiku 4.5, Opus 4.6

OpenAI

export OPENAI_API_KEY=sk-...

Modelos: GPT-4o, GPT-4o Mini, o3-mini

Ollama (Local)

ollama serve

Modelos locales: llama3, mistral, codellama, etc. Sin API key.

OpenAI-Compatible

export CUSTOM_API_URL=http://... export CUSTOM_API_KEY=...

LM Studio, vLLM, text-generation-webui, etc.