Importar Productos, con Recetas y Paquetes
Si tienes muchos productos para agregar, una importación CSV es más rápida que agregarlos de a uno — y si un producto está hecho de otros productos, su receta o paquete se puede configurar en el mismo archivo.
Antes de empezar
Necesitarás un archivo CSV con al menos las columnas sku y name. Todo lo demás es opcional, incluidas las columnas de receta y paquete que se explican abajo. Descarga primero la plantilla de Iraca si no tienes un archivo listo — incluye un producto simple, una receta y un paquete, ya completados como ejemplos funcionales.
Solo los propietarios y administradores del espacio de trabajo pueden importar productos.
Lo básico: una fila por producto
- Ve a Inventario → Productos
- Haz clic en Importar CSV
- Haz clic en Plantilla para descargar
products-import-template.csv - Completa tus datos, luego arrastra el archivo al área de carga (o haz clic para buscarlo) y haz clic en Importar
Iraca compara las filas con los productos existentes por SKU: un SKU que ya existe en tu catálogo se actualiza, y uno nuevo se crea (hasta el límite de productos de tu plan). Una celda en blanco en una actualización nunca borra un valor — solo significa "deja este campo como está".
Consulta la lista de columnas dentro de la app para ver el conjunto completo de columnas de producto simple (brand —marca—, código de barras, categoría, costo unitario, dimensiones, etc.). brand se exporta además de importarse, así que una exportación editada en una hoja de cálculo y vuelta a importar conserva las marcas.
Vincular un proveedor
preferred_supplier_name registra a quién le compras normalmente un producto, y se exporta además de importarse — así una exportación, editada en una hoja de cálculo y vuelta a importar, conserva sus proveedores en lugar de perderlos.
El nombre debe coincidir con un contacto que ya tengas; Iraca no creará uno desde una hoja de cálculo. Un nombre que no pueda vincular a exactamente un contacto deja el producto importado sin proveedor y lista el nombre en el resumen de la importación. Las reglas son las mismas que para insumos — consulta Importar Insumos para el detalle.
Agregar una receta
Una receta tiene un número variable de ingredientes, lo cual no encaja naturalmente en una sola fila de una hoja de cálculo. Iraca lo maneja como lo hace el software de contabilidad con una factura de varias líneas en CSV: el SKU del producto se repite en una fila por cada ingrediente.
| Columna | Significado |
|---|---|
recipe_output_quantity | Cuántas unidades terminadas produce un lote. Por defecto es 1. |
ingredient_sku | El SKU de un ingrediente — debe existir ya, ya sea antes en tu catálogo o en otra parte de este mismo archivo. |
ingredient_quantity | Obligatorio siempre que se complete ingredient_sku. |
ingredient_unit | Opcional, por defecto unit. |
Un sándwich hecho de pan y pavo:
sku,name,...,recipe_output_quantity,ingredient_sku,ingredient_quantity,ingredient_unit
SAND-01,Turkey Sandwich,...,1,BREAD-01,2,unit
SAND-01,,...,,TURKEY-01,120,gSolo la primera fila necesita los demás campos del producto (nombre, unidad de medida, etc.) — la segunda fila los deja en blanco, lo que significa "mismo producto, otro ingrediente". Repetirlos en cada fila también funciona, si te resulta más fácil de armar en tu hoja de cálculo.
El ingrediente tiene que existir en algún lugar. Ya sea que ya sea un producto en tu catálogo, o le des su propia fila en algún otro punto del mismo archivo (en cualquier orden — las filas de ingredientes de un producto terminado pueden ir antes o después de la fila del propio producto ingrediente). Iraca lee todo el archivo antes de crear nada, justamente para que el orden no importe.
Volver a importar el mismo archivo actualiza la lista de ingredientes de la receta en lugar de duplicarla — es seguro volver a ejecutarlo si estás refinando un archivo.
Agregar un paquete
Los paquetes usan el mismo patrón, con columnas component_ en lugar de ingredient_:
| Columna | Significado |
|---|---|
is_bundle | 1 para marcar el producto como paquete. |
bundle_type | kit o prepackaged. Por defecto es kit. |
component_sku | El SKU de un componente — misma regla de existencia que ingredient_sku arriba. |
component_quantity | Obligatorio siempre que se complete component_sku. |
sku,name,...,is_bundle,bundle_type,component_sku,component_quantity
KIT-01,Gift Basket,...,1,kit,BREAD-01,1
KIT-01,,...,,,TURKEY-01,2Si completas filas de component_sku pero dejas is_bundle en blanco, Iraca marca el producto como paquete automáticamente — eso se informa como una nota, no como un error, así que lo verás en los resultados, pero la importación de todas formas se completa con éxito.
Consulta Productos Compuestos y Paquetes para saber qué significan kit y prepackaged para el cumplimiento de pedidos.
Lo que la importación no hará
- No inventará un ingrediente o componente. Si un SKU no se encuentra en tu catálogo ni en el archivo, esa línea se omite y se informa como error — el resto del archivo se sigue importando.
- No anidará paquetes. Un componente que es en sí mismo un paquete se rechaza, igual que al armar un paquete manualmente.
- No dejará que un producto sea ambas cosas. Un producto no puede tener filas de
ingredient_skuy decomponent_skual mismo tiempo — elige receta o paquete para ese SKU. - No eliminará un ingrediente o componente que falte en una importación posterior. Volver a importar agrega y actualiza líneas; nunca elimina una solo porque este archivo no la menciona.
Leer los resultados
Después de la importación, Iraca muestra cuántos productos se crearon y actualizaron, cuántas recetas se crearon, y cualquier problema a nivel de fila — agrupados como errores (esa fila se omitió) y advertencias (se importó, pero vale la pena revisarla, como el cambio automático a paquete mencionado arriba).