Importar Insumos desde CSV
Si tienes una lista existente de insumos — materiales de empaque, productos de limpieza, ingredientes crudos — puedes traerlos a Iraca todos de una vez usando un archivo CSV en lugar de agregarlos uno por uno.
Antes de empezar
Necesitarás un archivo CSV con al menos dos columnas: sku y name. Todo lo demás es opcional. Si no tienes un archivo listo, descarga primero la plantilla de Iraca (ver abajo).
Solo los propietarios y administradores del espacio de trabajo pueden importar insumos.
Descargar la plantilla
La forma más fácil de empezar es con la plantilla de Iraca, que incluye todas las columnas admitidas con una fila de ejemplo ya completada.
- Ve a Compras → Insumos
- Haz clic en Importar CSV
- En el diálogo, haz clic en Plantilla para descargar
supplies-import-template.csv - Ábrelo en Excel, Google Sheets o cualquier aplicación de hojas de cálculo y completa tus datos
Columnas admitidas
| Columna | Obligatoria | Descripción |
|---|---|---|
sku | Sí | Un código único para el artículo de insumo |
name | Sí | El nombre del insumo |
brand | No | La marca o el fabricante, si importa cuál compras |
barcode | No | Número UPC o código de barras |
unit_of_measure | No | Cómo se mide el artículo — por ejemplo, box, roll, unit. Por defecto es unit |
unit_cost | No | Costo por unidad en la moneda de tu espacio de trabajo |
notes | No | Cualquier nota interna |
preferred_supplier_name | No | El nombre del contacto de proveedor al que sueles comprarlo. Debe coincidir con un contacto que ya tengas — ver más abajo |
is_active | No | 1 o true para marcar como activo, 0 o false para marcar como inactivo. Por defecto está activo |
low_stock_notifications_enabled | No | 1 o true para activar alertas de stock bajo. Por defecto está desactivado |
Consejos:
- Los nombres de las columnas deben coincidir exactamente (minúsculas, guiones bajos)
- Las columnas adicionales en tu archivo se ignoran
- El tamaño máximo de archivo es 5 MB
Vincular un proveedor
preferred_supplier_name registra a quién le compras normalmente un artículo. Viaja como nombre, no como ID, para que un archivo exportado de un espacio de trabajo siga significando algo en otro.
El nombre debe coincidir con un contacto que ya tengas. Iraca no crea un contacto a partir de un nombre en una hoja de cálculo: un contacto se usa para órdenes de compra, solicitudes de cotización, facturas de proveedor y recordatorios de pago, así que un error de escritura metería un proveedor fantasma en todos ellos.
Cuando un nombre no se puede vincular, la fila se importa igual — solo se descarta el vínculo con el proveedor, y el nombre aparece en el resumen de la importación para que lo corrijas. Hay dos casos:
- Ningún contacto con ese nombre. Crea el contacto y vuelve a importar, o asigna el proveedor al artículo después.
- Más de un contacto con ese nombre. Iraca elige el que esté registrado como proveedor si solo uno lo está; si tienes dos proveedores con nombres idénticos, no adivinará entre ellos.
Las mayúsculas y los espacios alrededor no importan — acme supply co coincide con Acme Supply Co.
Dejar la columna en blanco en una actualización no toca el proveedor existente. Para quitar el vínculo, borra el campo en el artículo.
Ejecutar la importación
- Ve a Compras → Insumos
- Haz clic en Importar CSV
- Arrastra tu archivo al área de carga, o haz clic para buscarlo
- Haz clic en Importar
Iraca procesa tu archivo y muestra un resumen cuando termina — cuántos insumos se crearon, cuántos se actualizaron y cualquier fila con problemas.
Cómo maneja Iraca los insumos existentes
Iraca hace coincidir las filas por SKU dentro de tu espacio de trabajo:
- SKU nuevo — se crea un nuevo insumo
- SKU existente — el insumo se actualiza con los nuevos valores de tu archivo
- SKU eliminado previamente — el insumo se restaura y se actualiza
Esto significa que puedes volver a importar de forma segura una versión actualizada de tu archivo sin crear duplicados.
Corregir errores
Si alguna fila no se pudo importar, Iraca las lista con un número de fila, SKU y una descripción del problema. Problemas comunes:
- Faltan columnas obligatorias — a tu archivo le falta
skuoname - Discrepancia en el número de columnas — una fila tiene más o menos columnas que el encabezado
- Valor inválido — por ejemplo,
unit_costcontiene texto en lugar de un número
Corrige las filas afectadas en tu archivo e impórtalo de nuevo. Las filas que ya se importaron correctamente no se duplicarán.
Límites del plan
Tu plan incluye un número máximo de registros de productos e insumos combinados. Si una importación excediera ese límite, Iraca se detiene en esa fila y la marca como error. Los registros existentes no se ven afectados.
Para aumentar tu límite, mejora tu plan en Facturación.
Exportar tus insumos
Para descargar un CSV con todos tus insumos actuales — para respaldo o para editar en lote — haz clic en Exportar CSV en la página de Insumos. El archivo usa el mismo formato de columnas que la plantilla de importación.