InicioRecursosGuía de migración
Guía de migración

Trae tu catálogo con una importación CSV.

El camino que funciona hoy es importar tu catálogo desde un archivo CSV o Excel. Los mapeadores automáticos por sistema (Loyverse, Alegra, Siigo, World Office) están en el roadmap; por ahora exportas a CSV desde tu sistema y lo importas en Puntovivo.

30 a 90 min por sede Importación CSV / Excel Sin downtime
¿De dónde vienes?
Desde Loyverse → Puntovivo · vía CSV · tiempo estimado: 30 a 90 min
Plan en cinco pasos

Lo que toma migrar, paso por paso.

  1. 01 5 min

    Exporta tu catálogo actual

    Desde tu sistema actual, exporta el catálogo a CSV o XLSX. Debe incluir SKU o código de barras, descripción, costo, precio, IVA y stock por sede.

    • SKU único por producto
    • Precios sin IVA o con IVA marcado
    • Stock por sede en columnas separadas
    • Encoding UTF-8 (las tildes se ven bien)
  2. 02 10-30 min

    Limpia duplicados y unidades

    Puntovivo deduplica por código de barras y luego por SKU. Si vendes por peso o por unidad, deja la columna correspondiente marcada. Borra productos descontinuados antes de importar.

    • Sin filas vacías o de subtotales
    • Códigos de barras de 13 dígitos sin guión
    • Unidad de venta: unidad, kg, libra o paquete
  3. 03 2 min

    Sube el CSV a la importación

    Desde la consola, abre Ajustes → Importar. Suelta el archivo CSV con los encabezados esperados y confirma el mapeo de columnas campo por campo antes de continuar.

    • Mapa de columnas confirmado por ti
    • IVA por defecto seleccionado (0/5/19 %)
    • Sede de destino seleccionada
  4. 04 10 min

    Revisa el preview y confirma

    Antes de aplicar, verás el resumen: cuántos productos nuevos, cuántos se actualizarán, cuántos requieren tu decisión. Aprueba por lotes — no se aplica nada hasta que confirmes.

    • Conflictos resueltos uno por uno
    • Preview de balance por sede revisado
  5. 05 1 turno

    Concilia y abre caja

    Haz un conteo físico de la sede principal y compara contra el balance importado. La primera apertura de caja queda con la base que tú definas, no con el saldo importado. De ahí en adelante, el flujo es normal.

    • Conteo físico hecho en sede principal
    • Apertura con base definida por ti
    • Primera venta de prueba realizada
Compatibilidad

Mapeo de columnas por sistema (en roadmap).

Así se verá el mapeo automático cuando llegue: el asistente reconocería estas columnas sin que renombres nada. Por ahora exportas a CSV y ajustas los encabezados al formato de abajo.

SistemaArchivo esperadoSKUNombreCostoPrecioIVAStockNivel
Loyverseitems.csvBarcode → barcodeName → descripcionCost → costoPrice → precioTax → ivaStock at store X → balance.sedeXEn roadmap
Alegraproductos.csvCódigo → skuNombre → descripcionPrecio costo → costoPrecio venta → precioImpuesto → ivaInventario → balanceEn roadmap
Siigoinventario.xlsxCódigo → skuDescripción → descripcionCosto promedio → costoPrecio 1 → precioIVA → ivaSaldo → balanceEn roadmap
World Officemaestro.csvReferencia → skuDescripción → descripcionCosto → costoLista 1 → precioImpuesto → ivaExistencia → balanceEn roadmap
Formato propio

Si vienes de Excel, este es el formato.

Una hoja por sede, encabezados en la primera fila, UTF-8. Copia este ejemplo y reemplaza los datos.

catalogo.csvstock-sede-centro.csvstock-sede-norte.csv Descargar plantilla
sku,barcode,descripcion,costo,precio,iva,unidad,categoria
ARQ-12-PV,7705412000123,Arepa de queso · Pack 12,5800,9500,5,unidad,Panadería
CAF-500-TIN,7702045009982,Café tinto molido 500 g,12200,19900,5,unidad,Bebidas
BLS-M-RCY,7705781100456,Bolsa reciclable mediana,420,1200,19,unidad,Empaque
LCH-1L-LV,7702521011234,Leche larga vida 1 L,3400,5400,0,unidad,Lácteos
HRN-1K-MAZ,7705412009870,Harina de maíz blanca 1 kg,3100,4900,0,unidad,Granos
¿IVA cero? Deja la columna en 0. Para exentos usa EX.
Preguntas frecuentes

Lo que preguntan antes de empezar.

¿Cuánto demora migrar una sola sede?+
Si tu archivo viene limpio, entre 30 y 90 minutos desde la exportación hasta la primera venta de prueba. Sumar más sedes agrega 10-15 minutos por sede.
¿Tengo que parar de vender mientras migro?+
No. Recomendamos migrar en horario cerrado y dejar la primera apertura de caja al día siguiente, pero el sistema anterior puede seguir activo. Solo deja claro al equipo cuál es el de verdad.
¿Y si mi catálogo tiene 20.000 SKUs?+
El importador procesa hasta 50.000 líneas por archivo. Catálogos muy grandes los partimos por categoría y los aplicamos en lotes — el asistente lo propone solo.
¿Qué pasa con el histórico de ventas?+
El histórico de ventas no se migra: arrancas limpio en Puntovivo. Conservas tus reportes del sistema anterior como archivo. Para la mayoría de PYMES esto es lo que recomiendan los contadores.
¿Dudas con tu archivo?

¿Tu catálogo no encaja en el formato?

Si tu export tiene una estructura rara, abre un issue en GitHub con un ejemplo (sin datos sensibles) y lo revisamos en abierto.

Preguntar en GitHub Leer guía completa