Farmer Delivery Phone Application (beta testing version) 

A sub-system has been added to the KK ICO System specifically to make the recording of Farmer-Delivery data by staff in the collection sheds easier.
Please review the following document for guidence on how to use this system. It is a simple phone application with only a few screens

The current version of this Phone App works with connection to the internet, so phones must be on the network for it to function correctly.

App Installation

The application can be downloaded from: 

https://www.orixa.co.uk/downloads/KKFUDeliver.apk

Note: Once the App is downloaded onto the phone, the phone will usually run and install it automatically. The user on the phone will be asked to "OK" at various stages, and should click "Yes/OK" at each step. The exact steps vary from phone to phone, so they are not shown here.
If the App is not installed automatically, navigate to the phone's "Download" folder, find the KKFUDliver.apk file and run/install it. This may occur with phones which are more tightly set up for App installation. In this case it may be necessary to say "yes" to the installation of "third party Apps."

App Use

FarmerDelivery Log In Screen  

Log in Screen

Users enter their own name, as it is recorded in the database, and their password. 

KKFU IT staff will have to create User and Passwords for all users expected to use the system. The Log In process has been developed in this way to ensure that hackers cannot access the KKSys.

Only users who have been personally set up by the IT staff will be able to log-in.

FarmerDelivery Farmer Data Screen  

Pick Farmer Screen

When the user opens the App this screen will be blank, as no farmer has yet been picked. 

The user should:

  1. Touch the top area of the screen, a list of Co-ops will open. The user should pick their Co-op.
    Once the Co-op is selected, click the second section of the screen, a list of Zones will open. The user should pick their Zone.
  2. Once the Co-op and Zone are selected the user can lick on the third area of the screen to view the list of active Farmers in the selected Zone. The user should pick the farmer who they want to view data for.
    Once the farmer is selected, other data (such as Phone number etc.) will also be listed.

Farmer Delivery Menu  

Activating the App menu

Once the user has selected a Zone and Farmer, the Menu button (shown at 1., in the image) will become active. Click on this button to see the list of actions.

  1. Menu button.
  2. Date-editor, click on this to select a start date.
  3. Click on "Farmer Deliveries" to see only deliveries from the selected farmer, starting from the selected Start Date.
  4. Click on "Zone Deliveries to see deliveries from all farmers of the selected Zone.
  5. Click on Add Delivery to add a new delivery record for the selected farmer.

 

FarmerDelivery List Deliveries Screen  

List Farmer Deliveries Screen

  1. If the user clicks "View Deliveries" from the previous step, this screen will open.
  2. All Deliveries for the farmer will be listed, in reverse date order. The Date of the delivery (starting with the year, then month, then day) will be shown, followed by the quantity of cocoa delivered, in Bags.
  3. At the top of the screen the total bags delivered for the selected date-range will be shown.

 

To view full details of any order, simply click on it, and you will navigate to the "View Delivery" screen.

FarmerDelivery View Delivery Screen  

The View Delivery Screen

If the user has clicked "Add Delivery" from the Pick Farmer screen, they will come to this screen, but a new delivery will have been added.

If the user has clicked on any prior delivery from the List Deliveries screen, the user will view the details of the selected delivery.

The user can go back to the "Pick Farmer" or "List Deliveries" screen at any time, just by clicking on the appropriate heading on the screen.

  1. View Delivery screen, with Date, Kilos, and other values linked to the delivery.
    Note that the "UnitCost" of the cocoa will update automatically from KKSys once a "current cocoa price" has been added.
  2. Details of the delivery. Note that for all past deliveries this data cannot be edited by the user. The user can only edit newly added deliveries.
  3. "Post" button, to update data. This is only activated for new deliveries. 

 

For newly added Deliveries, the "Post" button will be activated. The user can click on this to upload any new Delivery onto the KKSys Cloud.