Importar/Exportar productos desde Excel

Cuando tienes decenas o cientos de productos que dar de alta o actualizar, cargar un archivo Excel es más rápido que crearlos uno por uno desde el formulario. Puedes exportar tu catálogo completo como punto de partida, editarlo y volver a subirlo: el sistema reconoce cada producto por su identificador y actualiza en lugar de duplicar.

Cómo llegar

1. En el menú de navegación lateral, entra a Productos.
2. En la barra superior de la tabla, junto al botón Agregar Producto, están los botones Exportar e Importar.

Exportar productos

Pulsa Exportar para descargar un archivo Excel con todo tu catálogo: productos simples, variables con sus variaciones y combos, tanto activos como inactivos, con precios, costos, impuestos, categorías, atributos y stock.

Usa este archivo como plantilla: copia una fila, modifícala y súbela con Importar para crear el producto nuevo, o edita directamente los datos de un producto existente y vuelve a importarlo para actualizarlo.

Preparar el archivo Excel

Encabezados requeridos

La primera fila debe tener exactamente estos encabezados, en este orden:

ID Único	ID Padre	Tipo	SKU	Nombre	Descripción	Es Servicio	Es Virtual	Stock	Unidad de Medida	Atributos	Categorías	Precio Base	Moneda del Costo	Fecha Vigencia Costo	Precio Mayorista	Precio Venta	Moneda	Tipo de Precio	Porcentaje Impuesto	Peso	Ancho	Alto	Profundidad	Activo	Items Combo

Al final van, siempre en la exportación y opcionales en la importación, las columnas Imágenes, Costo Bruto, Costo Operativo, Insumos e Insumos de Opciones, en ese orden. Un archivo que no las trae se importa igual y no toca esos datos.

Los encabezados no se pueden alterar

Deben coincidir exactamente con los nombres de arriba, en el mismo orden, sin mayúsculas ni espacios de más. Usa el archivo exportado como plantilla para no equivocarte.

Campos obligatorios

• Nombre: el nombre del producto. Las variaciones no lo llevan: heredan el del producto padre.
• Tipo: uno de SIMPLE, VARIABLE, VARIATION o COMBO.

Campos recomendados

• SKU: uno o varios códigos separados por punto y coma (SKU001;SKU002).
• Precio Base: el costo del producto (ejemplo: 25.50).
• Moneda del Costo: la moneda del costo (USD, VES, EUR…), que puede ser distinta a la moneda de venta. Si se deja vacía, se asume la misma moneda del precio de venta. Alimenta el Reporte del Artículo 177 del ISLR.
• Fecha Vigencia Costo: en formato DD-MM-AAAA. Si se deja vacía, se usa la fecha actual, y determina la tasa de cambio con la que se valoriza el costo.
• Moneda: la moneda de venta (USD, EUR, MXN…).
• Stock: la cantidad en inventario. Si se deja vacía, el inventario existente no se toca.

Tipos de producto

SIMPLE

Un producto estándar sin variaciones.

Tipo: SIMPLE
Nombre: Camiseta Básica
SKU: CAM-001
Precio Venta: 19.99
Moneda: USD
Stock: 50

VARIABLE

Un producto padre con variaciones (por ejemplo, tallas y colores de una misma camiseta). Después de crear el producto VARIABLE, las variaciones van en filas separadas.

ID Único: PROD-002
Tipo: VARIABLE
Nombre: Camiseta con Variaciones

VARIATION

Una variación de un producto VARIABLE. Hereda el nombre del padre, así que la columna Nombre queda vacía.

ID Único: VAR-001
ID Padre: PROD-002
Tipo: VARIATION
SKU: CAM-002-RED-M
Precio Venta: 24.99
Stock: 20

El campo ID Padre lleva el ID Único del producto VARIABLE al que pertenece.

COMBO

Un conjunto de productos que se venden juntos y no lleva existencia propia: la mueven los productos que lo componen.

ID Único: COMBO-001
Tipo: COMBO
Nombre: Combo Desayuno
Items Combo: SKU001:2|SKU002:1|SKU003:1
Precio Venta: 15.99

El formato de Items Combo es SKU1:cantidad1|SKU2:cantidad2|SKU3:cantidad3.

Un combo no puede tener a la vez variaciones

Un producto no puede ser combo y variable al mismo tiempo.

Valores especiales

Sí/No

Para Es Servicio, Es Virtual y Activo: escribe S, Y, YES, SI, 1 o TRUE para Sí. Cualquier otro valor, o dejarlo vacío, se toma como No.

Unidad de Medida

Escribe uno de estos códigos (no distingue mayúsculas de minúsculas). Si lo dejas vacío, el producto queda sin unidad de medida.

Tipo	Códigos válidos
Generales	U (Unidades), UI (Unidades Internacionales), RL (Rollo), PR (Par), pza / pz (Pieza), blt (Bulto), pack (Paquete), box (Caja)
Peso	mg, mcg, ng, gr (Gramos), kg (Kilogramos), ton (Toneladas), oz (Onzas), lb (Libras)
Longitud	mm, cm, mt (Metros), km, in (Pulgadas), ft (Pies), yd (Yardas), mi (Millas)
Área	mm2, cm2, mt2, km2, in2, ft2, yd2, mi2, ac (Acres), ha (Hectáreas)
Volumen	ml (Mililitros), l (Litros), gal (Galones), pt (Pintas), qt (Cuartos), mm3, cm3, mt3, km3, in3, ft3, yd3, mi3
Tiempo	seg (Segundos), min (Minutos), hr (Horas), dia (Días), sem (Semanas), mes (Meses), anio (Años)
Otros	mEq (Miliequivalentes), mmol (Milimoles), µmol (Micromoles)

Un servicio cobrado por tiempo (consultoría, alquiler) puede usar hr, dia o mes.

Categorías

Se organizan en jerarquías con >, y varias a la vez separadas por |. Una categoría que no existe se crea automáticamente.

• Categoría simple: Ropa
• Con subcategoría: Ropa > Camisetas
• Varias: Ropa > Camisetas|Ropa > Pantalones|Accesorios

Atributos

Definen tanto características fijas del producto (Color, Talla) como grupos dinámicos que el cliente elige al facturar, con recargos, descuentos o límites de selección.

Formato general: Grupo [modificadores]: valor1;valor2|Grupo2: valor3

Atributos estáticos (variaciones y características fijas):

• Color: Rojo;Azul;Verde
• Talla: S;M;L|Color: Rojo;Azul
• Con texto libre: Color: custom-Personalizado (el prefijo custom- deja que el cliente escriba el valor al facturar).

Grupos dinámicos, con modificadores entre corchetes:

• [dynamic]: marca el grupo como dinámico.
• [dynamic, required] o [dynamic, min=1]: obliga a elegir al menos una opción al facturar.
• [dynamic, min=1, max=3]: rango de selección mínimo y máximo.
• [dynamic, max=2]: máximo de opciones a elegir, mínimo 0.
• [dynamic, internal]: grupo de uso interno, no visible en catálogo público.

Recargos y descuentos, entre paréntesis (+Monto MONEDA) o (-Monto MONEDA). Sin moneda indicada, se asume la moneda base del producto o USD:

• Doble queso (+1.50 USD) o Extra tocineta (+2.00)
• Sin salsa (-0.50 USD)
• Sin costo: Papas fritas;Ensalada

Ejemplo completo:

Tipo: SIMPLE
Nombre: Hamburguesa Especial
Precio Venta: 8.50
Moneda: USD
Atributos: Acompañante [dynamic, required, max=1]: Papas fritas;Aros de cebolla;Ensalada|Extras [dynamic, min=0, max=3]: Doble queso (+1.50 USD);Extra tocineta (+2.00 USD);Huevo (+1.00 USD)|Salsas [dynamic, max=2]: BBQ;Ajo;Mostaza miel

Si un grupo o un atributo no existe en el catálogo, se crea automáticamente con la configuración indicada. Si ya existe, se actualizan sus reglas y sus recargos según el archivo.

Precios

• Precio Base: lo que te cuesta adquirir el producto.
• Precio Mayorista: precio para ventas al por mayor.
• Precio Venta: precio de venta al público.

Normalmente el Precio Base es menor que el Precio Mayorista, y este menor que el Precio Venta.

Tipo de Precio: UNIT (por unidad) o VOLUME (por volumen). Sin especificar, se usa UNIT.

Impuestos

Porcentaje Impuesto: por ejemplo 16.00 para 16 %. Sin especificar, el producto no lleva impuesto.

Insumos

Las dos últimas columnas configuran los insumos del inventario: la materia prima que se descuenta cada vez que se vende el producto o una opción.

Columna Insumos, los insumos del producto de la fila:

Formato: Nombre [modo]: producto1;producto2|Nombre2 [modo]: producto3

• Modo fijo: [fija=0.15] descuenta siempre esa cantidad por unidad vendida.
• Modo variable: [variable, min=1, max=6] la cantidad la escribe el vendedor al facturar, entre el mínimo y el máximo. Sin min, el mínimo es 0; sin max, no hay máximo.
• La cantidad es por unidad vendida y en la unidad de medida del producto insumo. Admite punto o coma decimal y hasta 4 decimales (0,09 o 0.09).
• Los insumos se separan con | y los productos de un mismo insumo, con ;.
• Con un solo producto, el Nombre es opcional. Con dos o más, es obligatorio: es lo que ve el vendedor al elegir cuál usar.
• También se aceptan fixed en lugar de fija.

Columna Insumos de Opciones, los insumos de las opciones de grupos dinámicos que tiene el producto:

Formato: Grupo: Opción {insumos}|Grupo: Otra opción {insumos}, con los insumos de cada opción escritos entre llaves igual que en la columna Insumos.

• La opción debe estar en la columna Atributos de esa misma fila o ya asignada al producto, y su grupo debe ser dinámico.
• Una opción es de toda la cuenta, no de un producto: si la escribes en varias filas, debe decir lo mismo en todas. Si difiere, esa opción no se guarda y cada fila donde aparece muestra el error.
• Al exportar, cada opción se escribe una sola vez, en la primera fila que la tiene.

Cómo se identifica cada producto insumo, en este orden:

1. Por su ID Único: el de un producto que ya existe, o el que le pusiste a otra fila del mismo archivo, aunque esa fila esté más abajo.
2. Por cualquiera de sus SKU.
3. Por su Nombre exacto, sin importar mayúsculas, acentos, signos ni espacios: Café Molido 250gr. y cafe molido 250 gr son el mismo producto. Si dos productos se llaman igual, la fila da error y te pide usar el SKU o el ID Único.

Un producto que no puede ser insumo (un servicio, un producto virtual, un combo, un producto con variaciones o uno que a su vez consume insumos) se omite con un aviso, sin tumbar la fila. Si al omitirlo el insumo se queda sin productos, la fila da error.

Ejemplos:

Nombre: Cambio de aceite
Es Servicio: S
Insumos: Aceite [variable, min=4, max=6]: ACE-15W40;ACE-20W50|Filtro [variable, min=0, max=1]: FILTRO-01

Nombre: Hamburguesa
Es Virtual: S
Atributos: Extras [dynamic, max=2]: Tocineta (+1.50 USD)
Insumos: Pan [fija=1]: PAN-01;Pan brioche|[fija=0.15]: CARNE-01
Insumos de Opciones: Extras: Tocineta {[fija=0.09]: TOC-01}

Celda vacía o con contenido. Una celda vacía no toca los insumos que ya tiene el producto o la opción. Una celda con contenido deja al producto (o a cada opción nombrada) exactamente con los insumos que dice: los que no aparecen se quitan. Para quitar todos los insumos, hazlo desde la ficha del producto o de la opción.

Orden de la importación. No importa el orden de las filas: el sistema crea primero los productos sin insumos, después los que consumen insumos y al final los combos, así que los productos insumo ya existen cuando se configuran. Un combo no puede llevar insumos: esa fila se rechaza sin crear nada.

Si los insumos fallan. Una fila con los insumos mal escritos no se importa y el error dice qué parte falló. Si el producto se guardó pero sus insumos no (por ejemplo, un producto insumo que no existe), el producto queda guardado y la fila aparece entre los errores con el motivo; corrige la celda y vuelve a importar el archivo, que no duplica nada. El nombre de un insumo no puede llevar |, [, ], { ni }.

Copia exacta de un catálogo

Exportar el catálogo de una cuenta e importar ese mismo archivo en otra cuenta vacía deja una copia idéntica: productos, variaciones, combos, atributos, precios, existencias e insumos. Los productos insumo que no tienen SKU se exportan con su ID Único, que la importación reconoce porque viaja en el mismo archivo.

Actualizar productos existentes

Para actualizar un producto, usa su mismo ID Único, completa los campos que quieres cambiar y deja vacíos los que no. Si no especificas Stock, el inventario existente se mantiene sin cambios.

El sistema busca el producto en este orden: primero por ID Único, luego por cualquiera de los SKU indicados, y si no lo encuentra por ninguno de esos y el producto no tiene SKU, por su Nombre exacto cuando es de tipo SIMPLE o VARIABLE. Si lo encuentra, lo actualiza; si no, lo crea.

Los combos no se emparejan por nombre

Un producto COMBO sin SKU no se busca por nombre: si lo vuelves a importar sin ID Único ni SKU, se crea de nuevo en lugar de actualizarse.

IDs temporales

Al crear en la misma importación un producto VARIABLE junto con sus variaciones, puedes usar un identificador temporal a tu elección en ID Único y referenciarlo desde ID Padre: el sistema lo convierte al identificador real y las variaciones quedan correctamente vinculadas.

Fila 1:
ID Único: temp-camiseta-padre
Tipo: VARIABLE
Nombre: Camiseta Estilo A

Fila 2:
ID Único: VAR-001
ID Padre: temp-camiseta-padre
Tipo: VARIATION

Proceso de importación

1. Prepara tu archivo Excel con el formato correcto.
2. En Productos, pulsa Importar.
3. Selecciona tu archivo.
4. El sistema procesa el archivo en segundo plano y, al terminar, muestra un resumen con el total de filas procesadas, los productos creados, los actualizados y los errores, si los hay.

El resumen incluye la lista de productos creados y actualizados, y los errores con el número de fila y el motivo.

Hay un límite de productos por archivo

El límite depende de si tu cuenta tiene un plan activo o está en prueba. Si tu archivo lo supera, se procesan los primeros productos hasta el límite y el resto queda fuera; divide la carga en varios archivos.

Ejemplos

Producto simple completo

ID Único: PROD-001
Tipo: SIMPLE
Nombre: Laptop HP 15
SKU: LAP-HP15-001
Descripción: Laptop HP 15 pulgadas, 8GB RAM, 256GB SSD
Es Servicio: N
Es Virtual: N
Stock: 10
Unidad de Medida: U
Categorías: Electrónica > Computadoras
Precio Base: 480.00
Moneda del Costo: USD
Fecha Vigencia Costo: 09-02-2026
Precio Mayorista: 550.00
Precio Venta: 649.99
Moneda: USD
Tipo de Precio: UNIT
Porcentaje Impuesto: 16.00
Peso: 2.5
Ancho: 38
Alto: 25
Profundidad: 2.5
Activo: S

Producto variable con variaciones

Fila 1, producto padre:

ID Único: CAM-001
Tipo: VARIABLE
Nombre: Camiseta Premium
Categorías: Ropa > Camisetas
Atributos: Color: Rojo;Azul;Verde|Talla: S;M;L;XL
Moneda: USD
Precio Base: 29.99
Activo: S

Fila 2, variación:

ID Único: VAR-001
ID Padre: CAM-001
Tipo: VARIATION
SKU: CAM-001-RED-M
Atributos: Color: Rojo|Talla: M
Precio Base: 29.99
Stock: 15

Solución de problemas

"Encabezados inválidos" Los encabezados no coinciden exactamente con los requeridos. Verifica que la primera fila tenga los encabezados exactos, sin espacios de más, en el orden correcto. Usa el archivo exportado como plantilla.

"Tipo de producto inválido" El valor de la columna Tipo no es SIMPLE, VARIABLE, VARIATION o COMBO. Verifica que esté en mayúsculas y sin espacios adicionales.

"VARIATION requiere ID Padre" Falta el producto padre. La columna ID Padre debe contener el ID Único del producto VARIABLE. Si el padre está en la misma importación, puedes usar un ID temporal.

"Formato numérico inválido" Un campo numérico (precio, stock, dimensiones) trae texto o un formato incorrecto. Usa números decimales con punto (25.50, no 25,50) y no incluyas símbolos de moneda; si no lo vas a usar, déjalo vacío.

"Moneda no encontrada" El código de moneda no existe en el sistema. Usa códigos ISO de 3 letras en mayúsculas (USD, EUR, MXN).

Consejos generales:

• Usa el archivo exportado como plantilla: es la forma más segura de mantener el formato correcto.
• Prueba primero con un archivo pequeño, de 5 a 10 productos, antes de importar cientos.
• Revisa siempre el resumen de importación para detectar errores.

---

Relacionado: Productos · Importar productos con IA · Precios