Ingredientes
Las recetas, los suministros y los productos son listas de ingredientes. Los tres usan el mismo objeto ingrediente, descrito en esta página.
- Una receta lista sus ingredientes en
ingredients. Ver Recetas. - Un suministro lista los artículos entregados en
ingredients. Ver Suministros. - Un producto es un ingrediente que guardáis una vez y referenciáis desde muchas recetas. Ver Productos.
| Tema | Sección |
|---|---|
| Ejemplo | Esquema del ingrediente |
| Campos que debéis enviar | Propiedades obligatorias |
| Campos que mejoran el resultado | Propiedades opcionales principales |
| Valores permitidos: origin, transport, production, processing, conservation, packaging, unit | Valores de los campos del ingrediente |
| Definir o referenciar un ingrediente | Tipos de ingrediente |
| Qué se devuelve por ingrediente | Campos de respuesta del ingrediente |
| Cómo se hace el matching de los nombres | Matching de ingredientes |
Esquema del ingrediente
{
"id": "tomatoes-001",
"names": [
{"language": "en", "value": "Cherry Tomatoes"},
{"language": "de", "value": "Kirschtomaten"}
],
"amount": 200,
"unit": "gram",
"origin": "Italy",
"transport": "ground",
"production": "organic",
"conservation": "fresh",
"packaging": "plastic",
"producer": "BioFarm AG"
}
Propiedades obligatorias
Propiedades opcionales principales
Para reducir la ambigüedad y minimizar las consultas manuales posteriores, recomendamos especificar ciertos atributos del ingrediente aunque técnicamente sean opcionales. Entre ellos están indicadores como transportado por avión, fresco, ultracongelado, seco, en conserva, horneado, enlatado, hervido, ecológico, con certificación Fairtrade y de acuicultura (para pescado). Aportar estos datos desde el principio evita suposiciones incorrectas y elimina la necesidad de aclaraciones sucesivas.
| Propiedad | Tipo | Valor por defecto | Descripción |
|---|---|---|---|
type | String | conceptual-ingredients | Indica si esta línea define un ingrediente o referencia uno ya guardado. Ver Tipos de ingrediente. |
loss-in-percent-of-amount | Float | - | Pérdida de alimento como porcentaje de la cantidad del ingrediente (0–100), por ejemplo al pelar, recortar o por deterioro. El impacto ambiental se calcula para la cantidad total indicada, mientras que solo la cantidad neta restante (amount × (1 − loss / 100)) cuenta para el peso y los valores nutricionales de la receta. Es preferible a ajustar el campo weight de la receta para modelar pérdidas. |
origin | String | - | Origen del ingrediente: dirección postal o país |
transport | String | - | Medio de transporte desde el origen hasta la cocina: air o ground |
production | String | - | Método de producción: standard, greenhouse, organic, fair-trade, farm, wild-caught, sustainable-fish |
processing | String | - | Nivel de procesamiento: raw. Carne/pescado: unboned, boned. Pescado: skinned, beheaded, fillet. Verduras/frutas: cut, boiled, peeled. |
conservation | String | - | Método de conservación: fresh, frozen, dried, conserved, canned, boiled-down |
packaging | String | - | Tipo de envase: none, plastic, paper, pet, tin, alu, glas, cardboard, tetra |
producer | String | - | Productor o marca del producto. Especialmente importante para productos combinados (productos con varios ingredientes). |
gtin | String | - | Global Trade Item Number (código de barras) para productos envasados |
ingredients-declaration | String | - | Lista de ingredientes tal como se declara en los alimentos envasados |
nutrient-values | Object | - | Valores nutricionales estructurados por 100g (ver Referencia) |
Valores permitidos, valores por defecto y varios valores por campo: Valores de los campos del ingrediente.
Valores de los campos del ingrediente
Los atributos siguientes describen de dónde procede un ingrediente y cómo se produce, procesa, conserva y envasa. Son opcionales, pero cada uno hace el resultado más preciso.
origin
Dónde se produjo el ingrediente. Determina los cálculos de distancia de transporte y de estacionalidad.
| Formato | Ejemplo | Descripción |
|---|---|---|
| País | "Italy" | País de producción |
| Dirección postal | "8005 Zurich, Switzerland" | Ubicación concreta para distancias de transporte precisas |
Valor por defecto: si se omite, se estima un origen representativo a partir del ingrediente y de la ubicación de la cocina.
transport
Cómo se transporta el ingrediente desde el origen hasta la cocina.
| Valor | Descripción | Impacto de CO₂ |
|---|---|---|
ground | Transporte por carretera, ferrocarril o barco | Menor |
air | Transporte aéreo | Mayor (10-50x terrestre) |
Valor por defecto: ninguno. Si se omite, el modo de transporte se estima a partir del origen y del destino.
production
El método de producción usado para cultivar o producir el ingrediente.
| Valor | Descripción |
|---|---|
standard | Agricultura/producción convencional |
greenhouse | Cultivado en invernadero calefactado |
organic | Producción ecológica certificada |
fair-trade | Certificado de comercio justo |
farm | Producción en pequeña granja |
wild-caught | Captura salvaje (pescado y marisco) |
sustainable-fish | Pesca con certificación sostenible |
processing
El nivel de procesamiento aplicado al ingrediente.
| Valor | Descripción |
|---|---|
raw | Ingrediente entero, sin procesar |
unboned | Con hueso o espinas (carne/pescado) |
boned | Sin hueso o espinas |
skinned | Sin piel |
beheaded | Sin cabeza (pescado) |
fillet | Fileteado (carne/pescado) |
cut | Cortado en trozos |
boiled | Precocinado por hervido |
peeled | Sin la capa exterior |
conservation
Cómo se conserva/almacena el ingrediente.
| Valor | Descripción | Impacto energético |
|---|---|---|
fresh | Sin conservación, vida útil corta | El más bajo |
frozen | Almacenamiento congelado | Mayor (cadena de frío) |
dried | Deshidratado | Bajo |
conserved | Conservado (sal, azúcar, etc.) | Bajo |
canned | Enlatado | Medio |
boiled-down | Reducido/concentrado | Medio |
packaging
El material de envase usado.
| Valor | Descripción |
|---|---|
none | Sin envase (a granel) |
plastic | Envase de plástico |
paper | Papel/cartón |
pet | Botellas de plástico PET |
tin | Latas de hojalata |
alu | Aluminio |
glas | Envases de vidrio |
cardboard | Cajas de cartón |
tetra | Envases Tetra Pak |
unit
La unidad de medida de la cantidad del ingrediente.
| Valor | Descripción |
|---|---|
gram | Peso en gramos |
liter | Volumen en litros |
Convertid siempre a gramos o litros:
- 1 kg = 1000 gramos
- 1 ml = 0.001 litros
- 1 oz ≈ 28.35 gramos
- 1 taza ≈ 240 ml = 0.24 litros
Los campos origin, transport, production, processing, conservation y packaging aceptan valores separados por comas cuando se aplican varios. Por ejemplo: "production": "organic, fair-trade".
Tipos de ingrediente
Cada ingrediente tiene un type. Este decide a qué se refiere el ingrediente y si al guardar la receta también se escribe el objeto que nombra ese id.
type | Se refiere a | ¿Guardar la receta escribe ese objeto? | Si el id no existe |
|---|---|---|---|
conceptual-ingredients (por defecto) | un ingrediente definido en línea | Sí: se crea, o se sobrescribe para todas las recetas que ya usan ese id | Se crea |
recipes | una receta guardada (una subreceta) | No | 612 |
products | un producto guardado | No | 612 (incl. un id que solo es un ingrediente) |
// DEFINE an ingredient, here and now (default)
{
"id": "rice-001",
"type": "conceptual-ingredients",
"names": [{"language": "en", "value": "Risotto rice"}],
"amount": 200,
"unit": "gram"
}
// REFERENCE a stored recipe (sub-recipe)
{
"id": "tomato-sauce-001",
"type": "recipes",
"amount": 150,
"unit": "gram"
}
// REFERENCE a stored product -- no name needed, just the id and how much goes in
{
"id": "carrot-puree-500g",
"type": "products",
"amount": 300,
"unit": "gram"
}
Solo conceptual-ingredients escribe: si reutilizáis un id con él, vuestros datos reemplazan lo que hubiera, para todas las recetas que usan ese id. Para un artículo que reutilizáis, guardadlo una vez como producto y referenciadlo.
Campos de respuesta del ingrediente
Ver Campos de respuesta del ingrediente.
Matching de ingredientes
La API usa fuzzy matching para identificar los ingredientes en la base de datos de Eaternity, con más de 50.000 entradas.
Cómo funciona el matching:
- Normalización del nombre: elimina caracteres especiales y normaliza la ortografía
- Búsqueda en la base de datos: busca en más de 50.000 entradas de ingredientes
- Puntuación de similitud: calcula la confianza del match (0-100%)
- Selección del mejor match: devuelve el match con mayor confianza
- Alternativa: usa una categoría genérica si no se encuentra un match cercano
Mejorar la calidad del matching:
- Usad nombres específicos: "Parmesan Cheese" en lugar de "Cheese"
- Incluid el método de preparación: "Fresh Cherry Tomatoes" en lugar de "Tomatoes"
- Indicad el corte o la forma: "Beef Sirloin Steak" en lugar de "Beef"
- Añadid la marca mediante el campo
producerpara artículos envasados