> ## Documentation Index
> Fetch the complete documentation index at: https://lineacontinua.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Add, edit, and delete ICBF ingredient records in SATN

> Learn when to add custom ingredients to SATN, how to fill in each required and optional field, and how to safely edit or delete existing entries.

The ICBF table covers most common Colombian food ingredients, but you may occasionally need to add a proprietary formulation, a specialty import, or a novel ingredient that does not appear in the official database. SATN lets you create, edit, and delete ingredient records directly from the web interface. Any changes you make are immediately available when building product recipes.

## When to add a custom ingredient

Consider adding a new ingredient when:

* A raw material you use is not found by searching the ICBF table by name or synonym.
* You have a more recent or supplier-specific nutritional analysis (e.g., from a Certificate of Analysis) that differs from the published ICBF value.
* You work with a compound ingredient (such as a flavoring blend) and have its complete nutritional profile.

<Warning>
  Editing an existing ingredient changes its values for every product that already uses it. If you need different values for one specific product, create a new ingredient record with a distinct name rather than modifying the shared record.
</Warning>

## Adding a new ingredient

<Steps>
  <Step title="Open the create form">
    In the main menu, go to **Ingredientes → Tabla ICBF**, then click **Agregar ingrediente** in the top-right corner of the page.
  </Step>

  <Step title="Enter the food name">
    Fill in the **Nombre del alimento** field. This name must be unique across the entire database — SATN will reject the form if a record with the same name already exists. Use a descriptive name that you and your team will recognize when building recipes.
  </Step>

  <Step title="Set the category">
    Choose a **Categoría** from the dropdown. Assigning the correct food group lets you and your colleagues find the ingredient quickly when filtering the table.
  </Step>

  <Step title="Enter energy and proximate values">
    Fill in the core macronutrients. These fields drive the primary nutritional label:

    * **Energía (kcal)** and **Energía (kJ)** — caloric value per 100 g
    * **Proteína** — total protein (g/100 g)
    * **Lípidos** — total fat (g/100 g)
    * **Carbohidratos totales** and **Carbohidratos disponibles** (g/100 g)
    * **Fibra dietaria** (g/100 g)
    * **Humedad** and **Cenizas** (g/100 g)
  </Step>

  <Step title="Enter fatty acid and sugar detail">
    Provide the fat breakdown and sugar content if known:

    * **Grasa saturada**, **monoinsaturada**, **poliinsaturada**, and **trans** (g/100 g)
    * **Colesterol** (mg/100 g)
    * **Azúcares disponibles** (g/100 g)

    <Note>
      Trans fat and sugar values are used by SATN to determine whether warning seals apply. If you leave these blank, they are treated as zero and the seal thresholds will be evaluated accordingly.
    </Note>
  </Step>

  <Step title="Enter micronutrients">
    Fill in mineral and vitamin values that are relevant to your label. All micronutrient fields are optional, but complete data produces a more accurate and compliant nutritional table:

    * Minerals: calcio, hierro, sodio, fósforo, yodo, zinc, magnesio, potasio
    * Vitamins: tiamina, riboflavina, niacina, folatos, vitamina B12, vitamina C, vitamina A, vitamina D
  </Step>

  <Step title="Set the sugar type">
    Select the **Tipo de azúcar**:

    * **Azúcares naturalmente presentes** — sugars inherent to the food (e.g., lactose in milk, fructose in fruit).
    * **Azúcares añadidos** — sugars added during processing (e.g., sucrose, corn syrup).

    This classification affects how sugars are labeled under Colombian regulations.
  </Step>

  <Step title="Set the sweetener flag">
    If this ingredient is a non-caloric or low-caloric sweetener (e.g., stevia, aspartame, sucralose), toggle **Es edulcorante** to **Sí**. Any product that contains a sweetener-flagged ingredient will automatically receive the sweetener warning seal in its report.
  </Step>

  <Step title="Enter portion metadata">
    Optionally fill in **Parte analizada** (which part of the food the values refer to) and **Parte comestible** (edible yield percentage as purchased). These fields provide traceability context but do not affect the core nutritional calculations.
  </Step>

  <Step title="Save the ingredient">
    Click **Guardar**. SATN validates all required fields and the uniqueness of the name before saving. If validation passes, the new ingredient appears immediately in the table and is available for use in product recipes.
  </Step>
</Steps>

## Required vs. optional fields

| Field                        | Required                   |
| ---------------------------- | -------------------------- |
| Nombre del alimento          | Yes                        |
| Categoría                    | Yes                        |
| All other nutritional fields | No (treated as 0 if blank) |

<Tip>
  Even if you only have partial data, save the ingredient with what you know. You can always return to complete missing values later.
</Tip>

## Editing an existing ingredient

Navigate to **Ingredientes → Tabla ICBF**, find the ingredient you want to change, and click the **Editar** (pencil) icon in that row. The edit form is identical to the create form. Make your changes and click **Actualizar** to save.

## Deleting an ingredient

Click the **Eliminar** (trash) icon in the ingredient's row, then confirm the deletion in the dialog that appears.

<Warning>
  Deleting an ingredient does not automatically remove it from product recipes that already use it. Review and update any affected products after a deletion to ensure their nutritional calculations remain accurate.
</Warning>