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

# Connections

## Connections

The **Connection Page** shows information about the companies and farmers in the supply chain. You can find it in the main menu. The page has two tabs: one for companies and one for farmers. It also has a map view that shows where these actors are located and how they are connected.

<Steps>
  <Step title="Connections - Company">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/wjGzbgtjG1kPLjtz/images/img/connection-list.png?fit=max&auto=format&n=wjGzbgtjG1kPLjtz&q=85&s=3b20d18432b30e002f6aba301f9250bb" alt="connection" width="1505" height="851" data-path="images/img/connection-list.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/wjGzbgtjG1kPLjtz/images/img/connection-list-b.png?fit=max&auto=format&n=wjGzbgtjG1kPLjtz&q=85&s=452c1ca2808cd0203c3bd0c2e381a783" alt="Hero Dark" width="1504" height="851" data-path="images/img/connection-list-b.png" />

    * The company connection list includes columns for Company Name, Company Type, Connection Relation, and Connection Status.
    * The "Add Connection" button allows you to create new connections.
  </Step>

  <Step title="Connections - Farmers">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/wjGzbgtjG1kPLjtz/images/img/connection-list.png?fit=max&auto=format&n=wjGzbgtjG1kPLjtz&q=85&s=3b20d18432b30e002f6aba301f9250bb" alt="connection" width="1505" height="851" data-path="images/img/connection-list.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/wjGzbgtjG1kPLjtz/images/img/connection-list-b.png?fit=max&auto=format&n=wjGzbgtjG1kPLjtz&q=85&s=452c1ca2808cd0203c3bd0c2e381a783" alt="Hero Dark" width="1504" height="851" data-path="images/img/connection-list-b.png" />

    * The connection list for farmers includes columns for Farmer Name, Farmer Type, Connection Relation, and Connection Status.
    * This provides a comprehensive overview of the farmers' network and connection details.
    * The "Add Connection" button allows you to create new connections.
  </Step>

  <Step title="Connections - Map report">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/wjGzbgtjG1kPLjtz/images/img/connections.png?fit=max&auto=format&n=wjGzbgtjG1kPLjtz&q=85&s=1516082ea0a14118a4fc6d5ea4d8c1c7" alt="connection" width="1505" height="850" data-path="images/img/connections.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/wjGzbgtjG1kPLjtz/images/img/connections-b.png?fit=max&auto=format&n=wjGzbgtjG1kPLjtz&q=85&s=132b0f2ce78a4e3504490671d66f185f" alt="Hero Dark" width="1504" height="850" data-path="images/img/connections-b.png" />

    * The map view shows the connections on a map.
    * It works by showing where farmers and companies are located and how they are connected.
    * This helps you see the spread of connections and understand the supply chain.
  </Step>

  <Step title="Manage farmers">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/wjGzbgtjG1kPLjtz/images/img/managefarmer.png?fit=max&auto=format&n=wjGzbgtjG1kPLjtz&q=85&s=e004646f7cbb90e3d5640a84906f2474" alt="connection" width="1504" height="850" data-path="images/img/managefarmer.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/wjGzbgtjG1kPLjtz/images/img/managefarmer-b.png?fit=max&auto=format&n=wjGzbgtjG1kPLjtz&q=85&s=7e3daae1d74fd54e556c2e221e5881c7" alt="Hero Dark" width="1505" height="850" data-path="images/img/managefarmer-b.png" />

    * You can add farmers to the system by uploading an Excel file with their details.
    * This method makes it quicker to enter data, saving time and effort.
    * It simplifies the process of adding new farmers to the system, making it easier to get started.
  </Step>

  <Step title="Add connection">
    <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=43d9553f84821920fdf44dcf50bc731a" alt="connection" width="1505" height="850" data-path="images/img/receive stock.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock-b.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=8b37fb19502b400c504673078f141edf" alt="Hero Dark" width="1504" height="850" data-path="images/img/receive stock-b.png" />

    Connections can be added to the system as a company using three methods: **Add Single Farmer**, where individual farmer details like name, contact, and location are manually entered; **Add Multiple Farmers (Excel)** for bulk uploads by preparing and uploading an Excel file with farmer data; and **Add Connection as a Company**, which links the connection to a company, reflecting organizational relationships effectively.

    ## Single Farmer

    Add a connection by providing **Basic Details**, including buyer information, and entering **Address/Contact** details. Finally, map the connection by linking the farmer to the company, either by adding a single farmer manually.

    <Steps>
      <Step title="Basic details">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=43d9553f84821920fdf44dcf50bc731a" alt="connection" width="1505" height="850" data-path="images/img/receive stock.png" />

        <img className="hidden dark:block" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock-b.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=8b37fb19502b400c504673078f141edf" alt="Hero Dark" width="1504" height="850" data-path="images/img/receive stock-b.png" />

        The first step, **Basic Details**, involves entering essential information about the farmer, including their **First Name**, **Last Name**, **Farmer Type**, and an **Identification Number**. This ensures accurate identification and categorization of the farmer within the system.
      </Step>

      <Step title="Address/Contact">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%202nd%20step.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=944bd1297acab367e33fb5990b710648" alt="connection" width="1505" height="850" data-path="images/img/receive stock 2nd step.png" />

        <img className="hidden dark:block" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%202nd%20step-b.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=d3befd4510130d74686e569e737e1723" alt="Hero Dark" width="1504" height="850" data-path="images/img/receive stock 2nd step-b.png" />

        The second step, **Address/Contact**, involves adding the supplier's address and contact information. This includes entering the **Street Name**, **Country**, **Province**, **City/Village**, and **Postal Code** under the address section. In the contact information section, provide the **Email**, **Country Code**, and **Contact Number** to ensure accurate communication details.
      </Step>

      <Step title="Map Connection">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%20sum.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=f790c93b08504d63277c21a2c32e4337" alt="connection" width="1505" height="850" data-path="images/img/receive stock sum.png" />

        <img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/fairfood/images/receive%20stock%20sum-b.png" alt="Hero Dark" />

        The third step, **Map Connection**, allows mapping the farmer to the company. This step establishes the connection by specifying that products purchased from a particular farmer or supplier are supplied to the corresponding company. After verifying the details, you can finalize the connection by clicking the **Add Connection** button.
      </Step>
    </Steps>
  </Step>

  <Step title="Add connection">
    ## Multiple Farmers (Excel)

    We can add multiple farmers to the system by uploading an Excel file. First, the system validates the uploaded file. Users have two options: they can download a preformatted Excel template from the system, add the data to it, and upload it, or directly upload an existing Excel file. The system then checks the file for mandatory fields and validates all values. After verifying and linking each row and column, the farmer data is successfully added to the system.

    <Steps>
      <Step title="Upload/Create Template">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=43d9553f84821920fdf44dcf50bc731a" alt="connection" width="1505" height="850" data-path="images/img/receive stock.png" />

        <img className="hidden dark:block" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock-b.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=8b37fb19502b400c504673078f141edf" alt="Hero Dark" width="1504" height="850" data-path="images/img/receive stock-b.png" />

        In the first step, you upload or create an Excel template to add multiple farmers by either selecting a pre-defined template, creating a new one, or uploading an existing file for customization.
      </Step>

      <Step title="Link Fields">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%202nd%20step.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=944bd1297acab367e33fb5990b710648" alt="connection" width="1505" height="850" data-path="images/img/receive stock 2nd step.png" />

        <img className="hidden dark:block" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%202nd%20step-b.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=d3befd4510130d74686e569e737e1723" alt="Hero Dark" width="1504" height="850" data-path="images/img/receive stock 2nd step-b.png" />

        In the second step, the uploaded Excel file is validated. The system checks the file for mandatory fields and verifies that all the data provided is accurate and formatted correctly. You can review the data displayed in the interface to ensure everything aligns with the required structure. Errors, if any, will be highlighted for correction. Once the data passes validation, it is prepared for the final submission.
      </Step>

      <Step title="Verification">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%20sum.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=f790c93b08504d63277c21a2c32e4337" alt="connection" width="1505" height="850" data-path="images/img/receive stock sum.png" />

        <img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/fairfood/images/receive%20stock%20sum-b.png" alt="Hero Dark" />

        Verification ensures that the uploaded Excel file contains all mandatory fields, validates the accuracy of the data, and highlights any errors for correction before proceeding.
      </Step>

      <Step title="Receive summarry">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%20sum.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=f790c93b08504d63277c21a2c32e4337" alt="connection" width="1505" height="850" data-path="images/img/receive stock sum.png" />

        <img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/fairfood/images/receive%20stock%20sum-b.png" alt="Hero Dark" />

        The final step, **Summary**, provides an overview of the processed data. It displays the total entries, successfully added records, and any errors or skipped entries with reasons. This step allows you to review and confirm the data before finalizing, ensuring accuracy and completeness.
      </Step>
    </Steps>
  </Step>

  <Step title="Add connection as company">
    <Steps>
      <Step title="Basic details">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=43d9553f84821920fdf44dcf50bc731a" alt="connection" width="1505" height="850" data-path="images/img/receive stock.png" />

        <img className="hidden dark:block" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock-b.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=8b37fb19502b400c504673078f141edf" alt="Hero Dark" width="1504" height="850" data-path="images/img/receive stock-b.png" />

        The first step, **Basic Details**, involves selecting the connection type (Supplier or Buyer) and entering essential information such as name, type, and registration number before proceeding.
      </Step>

      <Step title="Address/Contact">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%202nd%20step.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=944bd1297acab367e33fb5990b710648" alt="connection" width="1505" height="850" data-path="images/img/receive stock 2nd step.png" />

        <img className="hidden dark:block" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%202nd%20step-b.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=d3befd4510130d74686e569e737e1723" alt="Hero Dark" width="1504" height="850" data-path="images/img/receive stock 2nd step-b.png" />

        The second step involves collecting address and contact details. It requires the user to provide their street name, country, province, city or village, and postal code for the address. For contact information, the user needs to fill in their first name, last name, email, country code, and phone number.
      </Step>

      <Step title="Map Connection">
        <img className="block dark:hidden" src="https://mintcdn.com/fairfood/w0DXdsPUb4_0JsCf/images/img/receive%20stock%20sum.png?fit=max&auto=format&n=w0DXdsPUb4_0JsCf&q=85&s=f790c93b08504d63277c21a2c32e4337" alt="connection" width="1505" height="850" data-path="images/img/receive stock sum.png" />

        <img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/fairfood/images/receive%20stock%20sum-b.png" alt="Hero Dark" />

        The third step, "Map Connection," allows you to map a new company to your network. By clicking on "Invite Connection," an invitation will be sent to the selected organization, inviting them to participate in your supply chain. This step helps establish a connection with the organization, enabling collaboration within the network.
      </Step>
    </Steps>
  </Step>
</Steps>
