Child pages
  • Food Traceability
Skip to end of metadata
Go to start of metadata

Our platform provides for transparent remote monitoring of food (beverages, milk, processed food etc) supplied from source, through the various processing stages, to actual shipment. Farmer's Hive Food Traceability module provides this solution.

We will refer to all the content being traced simple as "food". 

Table of Contents

1.0 Create a shipping order

We start by creating a shipping order. A shipping order refers to be monitored through out the supply chain. To do this first navigate to Supply Management module:

Click on Add Shipment on the top right

This pops a dialog window and the user is expected to provide details about the shipping order. If the actual shipping date is not yet known, you are expected to use the default date of DD-MM-YYYY

After you click Add, your screen should look like this:

1.1 Shipping Status

We currently have the following status levels for your shipping order:

Loading: All the activities that occur between raw material sourcing, to loading on a shipping container. These activities are represented as Blocks. 

Transit: When order has left source (origin) port. The Container button allows you to identify and describe the shipping container, and also monitor the temperature and humidity condition of the food being shipped. Blocks and More Info action buttons are not available. 

Completed: Order has been cleared, and no longer being monitored.

2.0 Shipment Actions

2.1 Edit

The Edit button is used to make changes to the shipping order. 


You have to provide the actual Shipping Date in order to change the Status from LOADING to TRANSIT

 2.2 Blocks

Each value added action carried out on the shipping order (such as packaging, labeling, logistics etc) is represented by a block. A block is valid only when supporting documentation are provided. These documents are to be uploaded when the block is being created. When a block is in progress, the user can not add another block. 


Blocks must be sequential; the start date of a block must come after the end date of the preceding block

2.2.1 Add Block

To add a block, click the Add Block button on the top left of the Block home page. 

Again, a dialog box pops up. Complete the form and attach relevant document. Again, if the End Date is not known, you are to use DD-MM-YYYY. If the information about a block is intended for the end user (consumer who be using the QR code), you should make sure the Show To Customer box is checked. 

Block End Date

If the end date of a block is unknown (DD-MM-YYYY), it is deemed that the block is still in progress and the system will not permit the addition of another block. The blocks are intended to be sequential, so you must terminate a block (by providing the end date) before  proceeding to the next block.

Your screen should look like this

2.2.2 Edit

If there are multiple documents for a particular block or you intend to delete an already uploaded document, use the Edit action button for the block in question to achieve this. You can also make changes to the block information as shown below:

2.2.3 Document

Click this button to download document(s) associated with the block in question.

2.2.4 Remove

Use this action button to delete a block.

2.3 More Info

This action allows the user to provide more information that are particular to the shipping order. To do this, click the Add Info button on the top right of More Info home page

Complete the dialog window form and submit

Your screen should look like this

2.3.1 Actions

Edit: use the Edit button to change either the CategoryDescription, Date or Show To Customer information. You can also delete already uploaded documents, or upload additional documents.

Document: select this to download uploaded support documentation for each category.

Remove: delete this information with this button.

2.4 Container

When you update the status of the shipping order to Transit, you get the Container button. 

This navigates to the Container home page where you specify the number of containers for the shipment. Each container will have one of our sensor nodes deployed to monitor the temperature and humidity of the food being shipped.

2.4.1 Add Container

Click the Add Container button on the top left and provide container details and select the corresponding sensor node under device menu drop-down.

When you click add, your screen should look like this:

2.4.2 Edit Container

Use this action button to change the container name or description.

container device

You can not change the container device once you add a container. To do this, you have delete the container and repeat the Add Container step in 2.4.1 above

2.4.3 Delete Container

Use the Remove button to delete a container

2.5 Insights

This shows the dashboard of the shipping order. It consists of three gadgets: measurement, supply blocks and Addition Notes

2.5.1 Measurement

This gadget displays in a tabular format and line chart, the data from our sensor nodes. from each container

2.5.2 Supply Blocks

All blocks in the shipping order are displayed in this gadget. It can be exported to a .csv sheet using the download button

2.5.3 Additional Notes

Similar to supply blocks above. Shows all custom variables for this shipment. 


Both Blocks, More Info and Container home pages have shortcuts that navigate either to the dashboard of the shipping order or back to Food Traceability home page

3.0 Completed Shipping Order

When the order has been received, and is no longer being monitored, you should change the shipping status to Completed. This implies that the shipment is no longer being tracked or monitored. The action buttons available changes as you no longer have access to Blocks and More Info buttons as shown below:

3.1 Actions

QR Code: When this button is selected, a QR code is generated for the shipping order and downloads to your device or computer.

Report: This generates the report that the end user will see when they scan the QR code. The information from Blocks and More Info that you intend to show to customer (when you checked Show To Customer) are contained in this report.

4.0 Delete Shipping Order

Click the Remove action button to delete a shipping order

  • No labels