Table of Contents

Set Up API Configuration

You can set up how the data will be imported from and exported to FoodChain ID.

In addition to the general settings, you can update the default APIs to customize the data to import or export.

Set up the item configuration

These are the APIs used to import ingredient, packaging and finished good data from FoodChain ID.

  1. Choose the icon, enter FoodChain ID Connector Setup, and then choose the related link.

  2. On the FoodChain ID Connector Setup page, select one of the following:

    • Integration > Ingredient
    • Integration > Packaging
    • Integration > Finished Good

  3. On the API Configuration Card page, populate the following fields:

    Field Description
    Use FoodChain ID Code As Item No.

    Turn the toggle on to use the FoodChain ID code as the item number.

    If the toggle is off, the item number will be generated by Business Central.
    Item Template Code

    If applicable, select an item template to fill in fields on the Item Card page for the imported items.

    If a field is mapped to a FoodChain ID field, the FoodChain ID value will take precedence over the template value.

    The template is only applied the first time the item is created.
    Create Item Specification Turn the toggle on to import the FoodChain ID item specifications when creating or processing the item.

  4. If applicable, in the API Body FastTab, update the API.

    The default API pulls in approved items that have been changed within the last two days.

    You can update the API as needed, for example, to add custom fields, or to change the status or date range of the records to import.

    If you import custom fields from FoodChainID, you will need to map those fields to Business Central fields.

    Tip

    If you created an advanced search in FoodChain ID, you can select the Code button from the Search screen, and copy the code into the API Body FastTab in Business Central. This will allow you to import the data listed in FoodChain ID's advanced search.

    You can restore the default API body by selecting Load Default API Body.

Set up the recipe configuration

These are the APIs used to import recipe data from FoodChain ID. The recipes create the production BOMs in Business Central.

The first time a recipe is imported, a new production BOM will be created. The BOM will not be certified to allow users to review the recipe.

  1. Choose the icon, enter FoodChain ID Connector Setup, and then choose the related link.

  2. On the FoodChain ID Connector Setup page, select one of the following:

    • Integration > Finished Good Recipe
    • Integration > Recipe

  3. On the API Configuration Card page, populate the following fields:

    Field Description
    Use FoodChain ID Code As Production BOM No.

    Turn the toggle on to use the FoodChain ID code as the production BOM number.

    If the toggle is off, the BOM number will be generated by Business Central.
    Production BOM Version Nos.

    Select the number series to use when creating production BOM versions.

    If the toggle is off, you need to manually define the version number series on each production BOM.
    Replace Existing BOM if New

    Turn on the toggle to replace an existing production BOM with the new one from FoodChain ID if the BOM status is New and the FoodChain ID date is more recent than the last modified date in Business Central.

    If the toggle is off or the BOM is certified, a new production BOM version will be created.
    BOM Version Starting Date Source Select the starting date to use when a new production BOM version is created.
    BOM Line Quantity Source Select the FoodChain ID quantity source to use when creating production BOM lines for ingredients.
    Use % Composition As Quantity

    Turn the toggle on use the percentage composition as the quantity when creating non-packaging production BOM lines on recipes.

    In FoodChain ID, recipe quantities are defined per 100 grams. If this field is enabled, the quantities will be divided by 100.

    This does not apply to production BOMs created for finished goods.

  4. If applicable, in the API Body FastTab, update the API.

    The default API pulls in approved recipes that have been changed within the last two days.

    You can update the API as needed, for example, to add custom fields, or to change the status or date range of the records to import.

    If you import custom fields from FoodChainID, you will need to map those fields to Business Central fields.

    Tip

    If you created an advanced search in FoodChain ID, you can select the Code button from the Search screen, and copy the code into the API Body FastTab in Business Central. This will allow you to import the data listed in FoodChain ID's advanced search.

    You can restore the default API body by selecting Load Default API Body.

Set up the item cost configuration

This is the API used to export cost from the Item Card page to FoodChain ID.

  1. Choose the icon, enter FoodChain ID Connector Setup, and then choose the related link.

  2. On the FoodChain ID Connector Setup page, select Integration > Item Cost.

  3. On the API configuration Card page, populate the following fields:

    Field Description
    Send Zero Costs

    Turn the toggle on to send items with zero costs to FoodChain ID.

  4. If applicable, in the API Body FastTab, update the API.

    Tip

    You can restore the default API body by selecting Load Default API Body.

See also

Set Up FoodChain ID Connector
Map Fields