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.

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.

Adding a new ingredient

1. 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.

2. 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.

3. 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.

4. 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)
5. 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)

   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.

6. 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
7. 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.

8. 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.

9. 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.

10. 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.

Required vs. optional fields

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

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

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.

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.