Importar y exportar

Qué es

El modal Importar / Exportar ingredientes te permite cargar tu propio catálogo de ingredientes personalizados desde un archivo (en lote, sin crearlos uno a uno) o descargarlo para tenerlo fuera de la aplicación.

Ruta de acceso

Desde el catálogo de ingredientes, pulsa el botón Importar / Exportar de la cabecera. El modal tiene dos pestañas: Importar y Exportar.

Importar

Empieza con la plantilla

Si aún no tienes un archivo, pulsa Descargar plantilla CSV (en el aviso "¿No sabes por dónde empezar? Descarga la plantilla con ejemplos y edítala."). Se descarga plantilla-ingredientes-areacacao.csv, ya con la cabecera correcta y dos filas de ejemplo (un praliné de avellana y una cobertura negra 70%) que puedes editar o borrar.

La plantilla incluye estas 23 columnas (todas opcionales salvo name):

name, category, subcategory, brand, supplier, customCode, pricePerKg, baseUnit, densityGPerMl, weightPerUnitG, water, fat, saturatedFat, carbs, sugars, protein, fiber, salt, kcalPer100g, cocoaButterFat, totalCocoa, allergens, notes

¿Cómo preparar el CSV?

El modal incluye un desplegable ¿Cómo preparar el CSV? con las reglas. En detalle:

• Solo name es obligatorio. Deja en blanco las columnas que no tengas.
• Los valores nutricionales son por 100 g (igual que en la ficha).
• Separador decimal: se acepta punto o coma (18.50 o 18,50, formato español incluido). Si usas coma como decimal, el punto se interpreta como separador de miles (1.234,56 se lee como mil doscientos treinta y cuatro con cincuenta y seis).
• allergens: lista de códigos separados por ;. Los códigos válidos son los 14 oficiales de la UE: gluten, crustaceans, eggs, fish, peanuts, soy, milk, nuts, celery, mustard, sesame, sulphites, lupin, molluscs. Cualquier código fuera de esta lista se ignora. Ver Alérgenos UE-14.
• Los micronutrientes (vitaminas, minerales, colesterol, cafeína) no se cargan por CSV: se rellenan en la ficha del ingrediente. (Si los necesitas en un archivo, usa el formato JSON, que sí los conserva.)

Cargar los datos

Tienes tres formas de aportar el contenido:

• Arrastrar y soltar un archivo en la zona "Arrastra un archivo CSV o JSON aquí".
• Pulsar Seleccionar archivo y elegir un .csv o .json de tu equipo.
• Desplegar O pegar texto manualmente y pegar el contenido directamente.

La aplicación detecta el formato automáticamente (si el texto empieza por { o [ lo trata como JSON; si no, como CSV) y lo muestra en el selector Formato detectado, que puedes corregir a mano si hiciera falta.

Elige el modo

El selector Modo decide cómo se aplica la importación. El emparejamiento con tus ingredientes existentes se hace por nombre (sin distinguir mayúsculas/minúsculas):

Previsualiza y confirma

Qué se importa de cada fila

Se reconocen estos campos: name (obligatorio), category, subcategory, brand, supplier, customCode, pricePerKg, baseUnit (por defecto g), densityGPerMl, weightPerUnitG, los 11 macros (water, fat, saturatedFat, carbs, sugars, protein, fiber, salt, kcalPer100g, cocoaButterFat, totalCocoa), allergens y notes. Las cabeceras no distinguen mayúsculas y se aceptan algunos alias (customCode/custom_code, baseUnit/base_unit/unit). Cualquier columna que no esté en la lista se ignora sin error.

Errores que verás:

• Una fila sin nombre se salta y se reporta como "Fila N: Falta nombre".
• Un archivo mal formado se rechaza entero: "CSV vacío o sin filas", "JSON inválido: …" o "JSON: no se encontró array 'ingredients'".

Exportar

En la pestaña Exportar ("Descarga tu catálogo personalizado. El formato JSON preserva estructuras complejas (macros, allergens); CSV es ideal para edición en Excel/Sheets.") tienes dos opciones de descarga directa. Solo se exportan tus ingredientes activos (los eliminados no se incluyen).

Exportar como JSON

"Formato completo para backup o migración a otra instancia." Descarga la ficha completa de cada ingrediente tal como está guardada, incluyendo lo que el CSV no representa: micronutrientes (que viven dentro de macros), nombres alternativos y campos personalizados. Es el formato recomendado para copia de seguridad. La estructura es:

{
  "version": 1,
  "exportedAt": "2026-06-01T…Z",
  "count": 12,
  "ingredients": [
    { "id": "ci_…", "name": "…", "macros": { "fat": 42, "vitaminE": 5 }, "allergens": ["nuts"], "altNames": [], "customFields": {} }
  ]
}

Cada objeto de ingredients es la ficha completa del ingrediente (aquí abreviada).

Exportar como CSV

"Tabla plana para abrir en Excel/Sheets/Numbers." Descarga una tabla plana (archivo custom-ingredients-AAAA-MM-DD.csv) ideal para revisar o editar en una hoja de cálculo. El CSV incluye los macros pero no los micronutrientes (para eso, usa JSON).

Columnas del CSV

El despliegue Columnas CSV del modal lista las 24 columnas del archivo exportado, en este orden:

id, name, category, subcategory, brand, supplier, customCode, pricePerKg, baseUnit, densityGPerMl, weightPerUnitG, water, fat, saturatedFat, carbs, sugars, protein, fiber, salt, kcalPer100g, cocoaButterFat, totalCocoa, allergens, notes

La columna allergens es una lista separada por punto y coma (por ejemplo gluten;milk). La única diferencia con la plantilla de importación es la columna id (presente al exportar, ignorada al importar).

Notas y límites

• Round-trip por nombre. Exportar y volver a importar funciona: el emparejamiento es por nombre, así que la columna id del CSV exportado no es necesaria al reimportar.
• CSV vs JSON. Usa CSV para edición rápida en hoja de cálculo (macros, sin micros); usa JSON para copia de seguridad: es el único formato que incluye los micronutrientes. Al reimportar, el JSON conserva macros y micros, pero no los nombres alternativos ni los campos personalizados.
• Tamaño. No hay un tope de filas, pero la petición está limitada a ~5 MB. Para catálogos muy grandes, divide el archivo en varias importaciones.
• Privacidad. Todo opera sobre tu catálogo de cuenta; ni la importación ni la exportación tocan el catálogo público.

Siguientes pasos