🏠 Bienvenido al Centro de Ayuda
Aquí encontrarás toda la información necesaria para usar el sistema de importación y comparación de datos.
1. Primero importa tus datos usando la opción "Importar"
2. Luego ve a "Comparar" para analizar los períodos
3. Si tienes dudas, revisa las secciones de ayuda
📊 Importar Datos
Guía paso a paso para importar archivos CSV o Excel a tu base de datos.
📌 Pasos para importar
📋 Columnas requeridas
Tu archivo debe contener las siguientes columnas:
| Columna | Descripción | Ejemplo |
|---|---|---|
| fecha | Fecha del registro | 2024-01-15 |
| ruc | RUC del contribuyente | 1234567890 |
| raz_social | Razón Social | EMPRESA S.A. |
| monto5 | Monto con IVA 5% | 1000.00 |
| iva5 | IVA 5% | 50.00 |
| monto10 | Monto con IVA 10% | 2000.00 |
| iva10 | IVA 10% | 200.00 |
| exentas | Monto exento | 500.00 |
| retenciones | Retenciones | 100.00 |
- Usa CSV para una importación más rápida y sin errores
- Los números pueden tener separación de miles (ej: 1,000.50)
- La tabla se crea automáticamente si no existe
- Los duplicados se permiten (no se eliminan automáticamente)
📈 Comparar Períodos
Analiza y compara dos períodos de tiempo para identificar diferencias.
🎯 ¿Qué hace el comparador?
- Compara dos períodos de tiempo independientes
- Muestra la diferencia de montos entre períodos
- Identifica RUCs nuevos o que desaparecieron
- Calcula porcentajes de cambio
📌 Pasos para comparar
📊 Interpretación de resultados
| Indicador | Significado |
|---|---|
| 🔄 Ambos | RUC presente en ambos períodos |
| ⬆️ Nuevo | RUC que aparece solo en el Período 2 |
| ⬇️ Desapareció | RUC que estaba solo en el Período 1 |
| ▲ Diferencia positiva | Aumento en el monto (verde) |
| ▼ Diferencia negativa | Disminución en el monto (rojo) |
Período 1: 01/01/2025 - 31/12/2025
Período 2: 01/01/2026 - 31/12/2026
El sistema te mostrará cada RUC con su variación entre 2025 y 2026.
📋 Formato de Archivos
Estructura correcta que deben tener tus archivos para una importación exitosa.
📄 Formato CSV (Recomendado)
Ejemplo de archivo CSV:
📊 Formatos numéricos aceptados
| Formato | Ejemplo | Resultado |
|---|---|---|
| Con punto decimal | 1000.50 | 1000.50 |
| Con coma decimal | 1000,50 | 1000.50 |
| Con separación de miles | 1,000.50 | 1000.50 |
| Con símbolo $ | $1,000.50 | 1000.50 |
| Números enteros | 1000 | 1000.00 |
- Archivos .xls (Excel 97-2003) - Solo se acepta .xlsx
- Archivos con formato PDF, TXT u otros
- Columnas con nombres diferentes a los requeridos
⚠️ Solución de Errores
Problemas comunes y cómo resolverlos.
🔴 Error: "str_getcsv(): the $escape parameter"
Versión de PHP 8.1+ que requiere el parámetro $escape explícitamente.
Actualiza el código usando la versión corregida del importador.
🔴 Error: "No se encontró la columna"
Las columnas de tu archivo no coinciden con las esperadas.
- Verifica que tu archivo tenga todas las columnas requeridas
- Los nombres deben ser: fecha, ruc, raz_social, monto5, iva5, monto10, iva10, exentas, retenciones
- No importa el orden de las columnas, solo los nombres
🔴 Error: "Commands out of sync"
Problema con resultados de consultas previas no liberados.
Usa $result->free() después de cada consulta o usa la versión corregida del código.
🔴 Error: "No se pudo abrir el archivo XLSX"
El archivo puede estar corrupto o no es un Excel válido.
- Guarda el archivo como CSV (recomendado)
- O vuelve a guardar el Excel como .xlsx
- Verifica que el archivo no esté dañado
🔴 Error: "No se insertó ningún registro"
El archivo no tiene datos válidos o el formato es incorrecto.
- Verifica que el archivo tenga al menos 2 filas (encabezados + datos)
- Comprueba que todos los RUCs estén completos
- Asegúrate de que los números sean válidos
❓ Preguntas Frecuentes
Respuestas a las dudas más comunes.
❓ ¿Qué pasa si subo un archivo con duplicados?
El sistema permite duplicados. Todos los registros se insertarán sin verificar si ya existen.
❓ ¿Puedo importar archivos .xls (Excel antiguo)?
No, solo se aceptan .xlsx y .csv. Te recomendamos guardar tus archivos como CSV.
❓ ¿Qué hago si mi archivo tiene miles de filas?
El sistema puede manejar archivos grandes. El proceso puede tardar unos segundos, pero funciona correctamente.
❓ ¿Cómo actualizo datos existentes?
Marca la opción "Limpiar tabla" antes de importar para borrar los datos anteriores y luego insertar los nuevos.
❓ ¿Qué significa la variación en el comparador?
Es el porcentaje de cambio entre el Período 1 y el Período 2. Ej: +50% significa que aumentó un 50%.
❓ ¿Puedo comparar períodos de diferentes años?
¡Sí! Puedes comparar cualquier rango de fechas, incluso de años diferentes.
📧 Contacto
¿Necesitas ayuda adicional? Contáctanos.
soporte@tusistema.com
Si tienes sugerencias para mejorar el sistema, escríbenos.
Si encuentras un error, por favor reportalo con la mayor cantidad de detalles posible.