Importar Productos desde CSV
Si tienes datos de productos en una hoja de cálculo, puedes importarlos directamente a Koru.Farm. El proceso de importación te guía a través de la carga, verificación e importación de tus datos.
Cuándo Usar Importación CSV
La importación CSV es útil cuando:
- Migras desde otro sistema de inventario
- Tienes una hoja de cálculo existente con datos de productos
- Añades una gran cantidad de productos a la vez
Requisitos de Formato CSV
Tu archivo CSV debe incluir estas columnas:
| Columna | Obligatoria | Descripción |
|---|---|---|
name | Sí ✱ | Nombre del producto |
category | Sí ✱ | Categoría del producto (debe coincidir con categorías del sistema) |
unit | Sí ✱ | Unidad de medida (debe coincidir con unidades del sistema) |
sku | No | Código de producto (opcional pero recomendado) |
Importante: Los valores de categoría y unidad deben coincidir exactamente con lo configurado en Configuración → Valores Predeterminados. Valores no reconocidos causarán errores de importación.
Ejemplo de Archivo CSV
name,category,unit,sku
Semillas de Tomate Roma,Seeds & Plants,Kilogram (kg),TOM-001
Fertilizante NPK 15-15-15,Fertilizers,Kilogram (kg),FERT-001
Fungicida de Cobre,Chemicals,Liter (L),CHEM-001
Guantes de Cosecha,Tools & Supplies,Piece (pcs),TOOL-001Proceso de Importación
La importación sigue 4 pasos:
Paso 1: Subir CSV
- Ve a Recursos → Inventario
- Haz clic en el botón Importar CSV
- Descarga la plantilla para ver el formato requerido
- Arrastra y suelta tu archivo CSV o haz clic para buscar
Paso 2: Verificar Columnas
El sistema muestra cómo se mapean las columnas de tu CSV a los campos de producto.
- Verifica que cada columna esté correctamente mapeada
- Corrige cualquier columna no reconocida
- Los campos obligatorios deben estar presentes
Paso 3: Comparar Datos
Revisa los productos que se importarán:
- Ve cuántos productos se crearán
- Verifica si hay errores de validación
- Revisa la coincidencia de categoría y unidad
Paso 4: Importar
Confirma la importación para añadir todos los productos a tu catálogo.
- Los productos se crean inmediatamente
- Verás un resumen de los artículos importados
- Cualquier error se reporta para revisión
Instrucciones de Importación
Sigue estas pautas para importaciones exitosas:
- Cada fila representa un producto de inventario
- Nombre, categoría y unidad son campos obligatorios
- SKU es opcional pero recomendado para organización
- Los nombres de productos deben ser descriptivos y únicos
- La categoría debe coincidir con una de tus categorías de inventario configuradas
- La unidad debe coincidir con una de tus unidades de inventario configuradas
Solución de Problemas
Categoría No Reconocida
Si una categoría muestra un error:
- Verifica la ortografía exacta en Configuración → Valores Predeterminados
- Asegúrate de que tu CSV use el mismo nombre de categoría
- Los nombres de categoría distinguen mayúsculas de minúsculas
Unidad No Reconocida
Si una unidad muestra un error:
- Verifica las unidades disponibles en Configuración → Valores Predeterminados
- Usa el formato exacto incluyendo símbolo (ej. “Kilogram (kg)”)
- Los nombres de unidad deben coincidir exactamente
Productos Duplicados
El sistema te advertirá si:
- Ya existe un producto con el mismo nombre
- Un código SKU ya está en uso
Puedes elegir omitir duplicados o actualizar productos existentes.
Consejo: Descarga la plantilla primero para ver el formato exacto requerido. Esto previene la mayoría de errores de importación.
Después de la Importación
Una vez importados los productos, puedes:
- Verlos en la Lista de Productos
- Editar productos individuales para añadir marca y notas
- Empezar a usarlos en actividades
Próximos Pasos
- Ver Productos — Ver tus productos importados
- Editar y Eliminar — Actualizar detalles de productos
- Añadir Producto — Añadir productos adicionales manualmente