📥 Importar desde Excel y JSON
La sección Importaciones te permite cargar datos masivamente en TPVReady sin tener que crearlos uno a uno. Es la herramienta clave cuando migras de otro programa, cuando heredas un Excel con miles de productos, o cuando la gestoría te pasa un fichero con clientes nuevos.
TPVReady ofrece dos tipos de importación:
- Importación Excel — para clientes y productos, con un wizard visual de mapeo de columnas.
- Importación JSON estricta — para facturas históricas que vienen de otro programa, con auditoría previa.
🚪 Cómo se accede
Menú lateral → Configuración → Importar.
Verás dos tarjetas principales: Clientes / Productos (Excel) y Facturas históricas (JSON).
📊 Importar Clientes o Productos desde Excel
El wizard de mapeo en 4 pasos
Click en la tarjeta correspondiente. Se abre un wizard con 4 pasos:
Paso 1 — Subir Excel
Arrastra el fichero Excel (.xlsx o .xls). TPVReady analiza:
- Cuántas columnas tiene.
- Cuántas filas de datos.
- Muestra un preview de las primeras filas para que confirmes que es lo que esperabas.
Paso 2 — Mapear columnas
Aquí está la magia. TPVReady te muestra:
- En la izquierda: las columnas de tu Excel (tal como vienen, con sus nombres).
- En la derecha: los campos destino que reconoce en TPVReady (CIF, Nombre, Email, EAN, Código, Familia…).
Para cada columna de tu Excel, asignas a qué campo destino corresponde. TPVReady sugiere automáticamente los mapeos obvios (si tu columna se llama "Email" la mapea a Email, etc.).
Las plantillas guardadas te permiten reutilizar el mismo mapeo en futuras importaciones: si el Excel viene siempre del mismo formato (proveedor recurrente, exportación de otro programa), guardas el mapeo una vez y los siguientes son automáticos.
Paso 3 — Validar
TPVReady valida tu Excel con el mapeo definido:
- CIFs duplicados o mal formados.
- Códigos repetidos.
- Campos obligatorios vacíos.
- Tipos de dato incorrectos (texto donde se espera número, etc.).
Te muestra una lista de errores que tienes que corregir, y avisos que solo te alertan.
Paso 4 — Previsualizar e importar
Última pantalla antes del punto de no retorno. Te muestra:
- Cuántos registros se van a crear (nuevos).
- Cuántos se van a actualizar (existentes, identificados por CIF o código).
- Cuántos se van a omitir (por errores no corregibles).
Pulsas Importar y el sistema procesa todo. Al terminar, te muestra el resumen real.
Configuración extra para productos
En la importación de productos puedes elegir:
- Tarifa destino — a qué tarifa asignar los precios del Excel.
- Almacén — para los stocks iniciales del Excel.
Plantillas guardadas
Después de mapear, puedes guardar tu mapeo como plantilla con un nombre. La próxima vez que importes un Excel parecido, eliges la plantilla y se aplican los mapeos automáticamente. Muy útil para imports recurrentes.
📚 Importar facturas históricas (JSON)
Esta es la opción para migrar facturas antiguas desde otro programa. Funciona en dos pasos estrictos: primero auditar, después importar.
Por qué un flujo estricto
Las facturas son documentos contables que no se pueden duplicar ni perder. Por eso este flujo es más conservador: te muestra todos los problemas antes de tocar nada y solo importa lo que tú apruebes.
El JSON debe contener
Para cada factura:
- numero_completo — número de la factura (debe tener dígitos válidos).
- fecha.
- cif del cliente.
- lineas — array con producto, cantidad, precio, IVA.
- totales — base imponible, IVA, total.
- tipo —
normalorectificativa.
Las facturas se importan en la serie reservada HIST (histórico), separada de tu numeración actual para no chocar.
Paso 1 — Auditar
Subes el JSON. TPVReady lo analiza y te muestra problemas detectados, categorizados:
| Problema | Severidad | Solución |
|---|---|---|
| 🔢 Número de factura inválido | ⛔ Bloqueante | Hay que corregir el JSON. |
| 🔁 Números duplicados en el JSON | ⛔ Bloqueante | Dejar uno solo. |
| ℹ️ Ya existen en BD | Aviso | Se omitirán al importar. |
| 🆔 CIFs malformados | 🤖 Auto-resoluble | Se limpiarán automáticamente. |
| 👤 Clientes no encontrados | 🤖 Auto-resoluble | Se crearán con referencia HIST-XXXX. |
| 📦 Productos no encontrados | 🤖 Auto-resoluble | Se crearán en la familia HISTÓRICOS con el precio de la 1ª línea. |
| 💰 Totales que no cuadran | 🤖 Auto-resoluble | Se recalculan desde las líneas. |
Los bloqueantes tienes que corregirlos en tu JSON antes de continuar. Los auto-resolubles los arregla el sistema solo, pero los puedes revisar.
Paso 2 — Importar
Una vez la auditoría está limpia (sin bloqueantes), pulsas Importar. TPVReady crea:
- Clientes nuevos que faltaban (con referencia
HIST-XXXX). - Productos nuevos que faltaban (en familia "HISTÓRICOS").
- Facturas completas en la serie
HIST.
Al terminar, un resumen: N clientes creados, M productos creados, K facturas importadas.
💡 Buenas prácticas
- Antes de importar, haz una copia de seguridad de tu cuenta (o úsalo en una cuenta de pruebas primero si es la primera vez).
- Para Excel, limpia el fichero antes: elimina filas vacías, asegúrate de que las columnas obligatorias tienen valor, mira que los CIFs sean correctos.
- Guarda plantillas de mapeo la primera vez que importas un formato. Te ahorrarás tiempo en imports posteriores.
- Para facturas históricas, lee CUIDADOSAMENTE el resultado de auditoría antes de importar. Una vez creadas, las facturas históricas tienen efectos contables como las normales.
- No mezcles años. Importa un año a la vez si tienes muchas facturas. Si algo va mal, es más fácil rectificar un periodo limitado.
❓ Preguntas frecuentes
¿Puedo importar varios Excel a la vez? Uno por uno por ahora. Procesa la ejecución antes de subir el siguiente.
¿Y si me equivoco al importar?
- Clientes/productos: los creados se pueden desactivar masivamente, pero borrarlos uno a uno es engorroso si son muchos.
- Facturas históricas: al estar en la serie
HIST, puedes eliminarlas con cuidado o anularlas. Pero piénsatelo dos veces antes de importar — la auditoría está para evitar errores.
¿Qué pasa con productos sin precio en el Excel? Se crean con precio 0. Tendrás que ajustarlos después (desde el producto o desde Tarifas).
¿Cómo importo proveedores? Actualmente Excel solo soporta clientes y productos. Para proveedores, dálos de alta manualmente.
¿La importación afecta a la facturación recurrente? No. Las facturas históricas importadas son históricas: contables y trazables, pero no generan recibos nuevos ni se envían a Verifactu.
¿Echas algo en falta? Escríbenos a soporte@extremanet.com.