Agriculture and Outgrowers

Agriculture and Outgrowers is for farms, estates, cooperatives and produce buyers. It has two halves that you can use together or on their own. Own farms tracks your farms and plots and each crop season on them: the work done, the labour and inputs it cost, the harvest and what each kilogram really cost you. Outgrowers handles the smallholders who sell to you: you register them, weigh in their deliveries at the collection centre, give them seed and fertiliser on credit, and pay them monthly with the credit taken back. It is in the Agriculture group of the sidebar: Farms and plots, Crop seasons, Growers, Deliveries, Inputs on credit, Produce prices and Grower payouts.

Agriculture and Outgrowers is a marketplace module. The owner switches it on under Settings → Marketplace (search for Agriculture). It needs the Contacts and Purchases apps. With Inventory on, harvests and deliveries go into stock; with Marketing and an SMS provider set up, growers get a text receipt for each delivery.

Note: agriculture.view shows the Agriculture pages. agriculture.manage adds farms, seasons, growers, prices, inputs on credit and payouts. agriculture.collect is for clerks at the weighbridge: together with agriculture.view it lets them weigh in deliveries without being able to change prices, growers or payouts. Set permissions under Settings → Roles.

Part 1: Your own farms

Add a farm and its plots

  1. In the menu, open Agriculture → Farms and plots.
  2. Click New farm (marker 1). The Plots column (marker 2) counts the plots on each farm.
Farms list with the New farm button and the Plots column marked
Farms list with the New farm button and the Plots column marked
  1. Pick the Company, type the Name (for example "Kiambu estate"), the Location and the Size (acres), add any Notes and click Create.
  2. Click Edit on the farm to open it. Under the farm details (marker 1 is the size), the Plots table lists its plots with their acres, soil and the crop Growing now (marker 3).
  3. Click Add a plot (marker 2).
Farm page with Size (acres), the Add a plot button and the Growing now column marked
Farm page with Size (acres), the Add a plot button and the Growing now column marked
  1. Type the plot Name (marker 1), for example "Block A", its Size (acres) (marker 2) and the Soil (marker 3), for example "Red volcanic". Click Create.
Add a plot window with Name, Size (acres) and Soil marked
Add a plot window with Name, Size (acres) and Soil marked

Use Edit or Delete on a plot's row to change or remove it.

Start a crop season

A crop season is one crop on one plot, from planting to the last harvest. Each gets a number such as SN-2026-0001.

  1. In the menu, open Agriculture → Crop seasons.
  2. Click New season (marker 1). The list shows each season's plot, planting date, Harvested (kg), Cost per kg (marker 2) and Status (marker 3).
Crop seasons list with New season, the Cost per kg column and a Planned status marked
Crop seasons list with New season, the Cost per kg column and a Planned status marked
  1. Fill in the form and click Submit. The season opens.
New season window with Plot, Planted on, Expected yield (kg) and Harvest goes into stock as marked
New season window with Plot, Planted on, Expected yield (kg) and Harvest goes into stock as marked
Field What to enter
Plot Required (marker 1). Farm and plot, for example "Kiambu estate · Block A". Cannot be changed later.
Crop Required. For example Maize, Tea, Avocado, Beans.
Variety Optional, for example H614, Hass or Rosecoco.
Area (acres) The area under this crop. Leave empty to use the plot's size. Used for the yield per acre.
Planted on Optional (marker 2). Leave empty if you have not planted yet; the season is then Planned until you record planting work.
Expected harvest Optional. The date you expect to harvest.
Expected yield (kg) Optional (marker 3). Used to show what share of the expected yield you harvested.
Harvest goes into stock as Optional (marker 4). A product such as "Dry maize (90 kg bag)". With Inventory on, each harvest is received into stock at the season's cost per kilogram so far.
Notes Anything else.

Season statuses

Status What it means
Planned Created without a planting date. Recording Planting work makes it Growing.
Growing Planted. Record work as it happens.
Harvesting At least one harvest recorded. You can keep recording work and harvests.
Closed Locked with Close season. No more work or harvests can be recorded.

Record work and inputs

Record every job done on the season, with the labour paid and any inputs used, so the season's cost is complete.

  1. Open the season (click Edit on its row) and click Actions (marker 2 below), or use ⋮ on the row in the list.
Crop season page with the cost summary, the Actions button and the Work and inputs tab marked
Crop season page with the cost summary, the Actions button and the Work and inputs tab marked
  1. Click Record work (marker 1).
Season Actions menu with Record work, Record harvest and Close season marked
Season Actions menu with Record work, Record harvest and Close season marked
  1. Set the Date and pick the Work (marker 1): Land preparation, Planting, Fertiliser, Spraying, Weeding, Irrigation, Pruning or Other. Add a Description, for example "First weeding, 8 casuals x 3 days".
  2. Enter the Labour cost (marker 2) paid for the job.
  3. If an input was used, pick it under Input used (marker 3) and enter the Quantity, for example 24 bags of CAN fertiliser.
  4. Leave Input cost (leave 0 to use stock cost) (marker 4) at 0 to let NaliSuite cost the input, or type what it really cost.
  5. Click Submit.
Record work window with Work, Labour cost, Input used and Input cost marked
Record work window with Work, Labour cost, Input used and Input cost marked

How the input is costed:

Record a harvest

  1. On the season, click Actions → Record harvest (marker 2 in the actions screenshot).
  2. Set the Date, the Weight (kg) (marker 1), the Grade (marker 2), for example "Grade 1" or "Class 1", and any Notes. Click Submit.
Record harvest window with Weight (kg) and Grade marked
Record harvest window with Weight (kg) and Grade marked

The season becomes Harvesting. When the season has a Harvest goes into stock as product with stock tracking and Inventory is on, the harvest is received into the main store at the season's cost per kilogram so far.

Read the season's results

The line under the season's title (marker 1 in the season screenshot) sums it up, for example "Cost 57,500.00 (labour 22,900.00, inputs 34,600.00) · harvested 2,350.0 kg (15% of expected) · 24.47 per kg · 293.8 kg per acre":

The tabs below (marker 3) list every job under Work and inputs (date, work, input and quantity, labour, inputs) and every harvest under Harvests (date, kg, grade, notes).

Close a season

When the last harvest is in, click Actions → Close season (marker 3 in the actions screenshot) and confirm. The season becomes Closed and nothing more can be recorded on it. The plot's Growing now column clears, ready for the next season.

Part 2: Outgrowers

How outgrower buying works

  1. Register each grower. They get a number such as OG-00001 and become a supplier in your contacts.
  2. Set produce prices per kilogram for each produce and grade.
  3. Weigh in each delivery at the collection centre. It is priced from the list and the grower is texted a receipt.
  4. Give inputs on credit when a grower takes seed, fertiliser or a cash advance.
  5. Prepare a payout for a period. It adds up each grower's unpaid deliveries and takes back inputs still owed.
  6. Approve the payout. Each grower gets a supplier bill for what they are owed, and you download a Payment file for a bulk M-Pesa or bank payment.

Register growers

  1. In the menu, open Agriculture → Growers.
  2. Click Register a grower (marker 1). The list shows each grower's number, name and payout phone, centre, kg this month (marker 2) and Inputs owed (marker 3).
Growers list with Register a grower, kg this month and Inputs owed marked
Growers list with Register a grower, kg this month and Inputs owed marked
  1. Pick an Existing contact (marker 1), or leave it empty and type the Name and Phone (marker 2) of someone new. The phone becomes their payout phone.
  2. Add the National ID, the Collection centre (marker 3) where they deliver, the Crop and the Acres.
  3. Click Submit. You see "… registered as OG-00006".
Register a grower window with Existing contact, Phone and Collection centre marked
Register a grower window with Existing contact, Phone and Collection centre marked

A new grower is created as a supplier contact. An existing contact is marked as a supplier too, so the payout bills can be raised to them. A contact can only be registered once.

To change a grower's Collection centre, Crop, Acres, Payout phone (M-Pesa) or switch them off with Active, click ⋮ → Edit on their row. Inactive growers cannot deliver.

Set produce prices

  1. In the menu, open Agriculture → Produce prices.
  2. Click New price (marker 1).
  3. Pick the Produce (a product, for example "Green leaf tea"), type the Grade (marker 2) or leave it empty for a price that applies to every grade, type the Price per kg and the date it applies From (marker 3). Click Create.
Produce prices list with New price, the Grade column and the From column marked
Produce prices list with New price, the Grade column and the From column marked

When you weigh in a delivery, NaliSuite uses the latest price that started on or before the delivery date for that produce and grade; a price for the exact grade wins over an "Any grade" price. To change the price from next month, add a new price with the new From date rather than editing the old one, so earlier deliveries keep their price.

Tip: Only produce with at least one price can be picked when weighing in. Add the produce in Sales → Products first if it is not there.

Weigh in a delivery

  1. In the menu, open Agriculture → Deliveries.
  2. Click Weigh in a delivery (marker 1). The list shows each receipt with the grower, produce and grade, kg, price, Amount (marker 2), centre and the Payout it was paid in (marker 3), or "Not yet". The kg and amount columns are totalled at the bottom.
Deliveries list with Weigh in a delivery, the Amount column and the Payout column marked
Deliveries list with Weigh in a delivery, the Amount column and the Payout column marked
  1. Search for the Grower (marker 1) by name or number, pick the Produce (marker 2) and type the Grade if you grade it.
  2. Type the Weight (kg) (marker 3), check the Date and type the Collection centre (marker 4).
  3. Click Submit. You see the receipt number and amount, for example "CL-2026-000025: 2,208.00".
Weigh in a delivery window with Grower, Produce, Weight (kg) and Collection centre marked
Weigh in a delivery window with Grower, Produce, Weight (kg) and Collection centre marked

What happens:

Use the filters for one Centre, Not yet in a payout or Today (for the day's tally at a centre).

Give inputs on credit

  1. On Agriculture → Growers, click ⋮ on the grower's row, then Give inputs on credit (marker 1).
Grower row actions open with Give inputs on credit and Statement marked
Grower row actions open with Give inputs on credit and Statement marked
  1. Set the Date, describe What was given (marker 1), for example "2 bags CAN fertiliser", and the Amount (marker 2) in money. Click Submit.
Give inputs on credit window with What was given and Amount marked
Give inputs on credit window with What was given and Amount marked

You see "Recorded; it will be recovered from the next payouts". The amount shows in the grower's Inputs owed.

To see everything given on credit, open Agriculture → Inputs on credit. It shows each item with the Amount, what has been Recovered (marker 1) and what is Still owed (marker 2). The Still owed filter is on when the page opens; remove it to see items fully recovered.

Inputs on credit list with the Recovered and Still owed columns marked
Inputs on credit list with the Recovered and Still owed columns marked

Note: Give inputs on credit records the debt only. It does not take the fertiliser out of stock or pay out cash. Issue stock or record the cash payment as you normally do.

Pay growers

  1. In the menu, open Agriculture → Grower payouts. Each payout shows its period, the number of growers, what was Delivered, what was Deducted (marker 2), what is To pay and its status (marker 3).
  2. Click Prepare a payout (marker 1).
Grower payouts list with Prepare a payout, the Deducted column and a Draft status marked
Grower payouts list with Prepare a payout, the Deducted column and a Draft status marked
  1. Set From (marker 1) and To (marker 2). They start on last month. Click Submit.
Prepare a payout window with From and To marked
Prepare a payout window with From and To marked

NaliSuite gathers every delivery in that period not already in a payout and makes one line per grower: the kilograms, the amount delivered, the inputs to recover (everything still owed, oldest first, but never more than the grower earned) and the amount to pay. The payout opens as a Draft, numbered for example GP-2026-0002. If nothing is unpaid, you see "No unpaid deliveries between … and …". 4. Check the Growers table. The line under the title (marker 1) gives the totals. 5. Click Actions:

Draft payout with the totals line and the Actions menu showing Approve, Payment file (CSV) and Discard draft marked
Draft payout with the totals line and the Actions menu showing Approve, Payment file (CSV) and Discard draft marked

After approval, the Growers table shows the Inputs recovered (marker 1) and the Bill each grower got (marker 2). A grower whose inputs used up all they earned gets no bill; the rest of their debt waits for the next payout.

Approved payout with the Inputs recovered and Bill columns marked
Approved payout with the Inputs recovered and Bill columns marked

Tip: Pay the bills from Purchases → Vendor bills after you upload the payment file, so your books show the growers as paid.

  1. On Agriculture → Growers, click ⋮ → Statement (marker 2 in the grower actions screenshot).
  2. Set From and To (they start on this month) and click Submit.

The Grower statement PDF lists the grower's deliveries in the period (date, receipt, produce, grade, kg, price, amount and the payout it was paid in), the inputs on credit given (with what was recovered), the approved payouts (delivered, deducted, paid) and the inputs still owed. Print it for the grower or send it by WhatsApp.

Agriculture settings

  1. In the menu, open Settings → Preferences.
  2. Click the Agriculture tab.
  3. Switch Text growers a receipt for every delivery (marker 1) on or off and click Save preferences. It is on by default; texts need SMS set up in Marketing.
Preferences on the Agriculture tab with the text receipts switch marked
Preferences on the Agriculture tab with the text receipts switch marked

What growers see in the customer portal

Growers who sign in to your customer portal see My deliveries (when the Customer portal app is on and they are a registered grower). The top box (marker 1) shows their grower number, centre and any inputs on credit still to be recovered. Deliveries (marker 2) lists each delivery with the date and receipt, produce, kg, amount and In payout or Not yet. Payouts (marker 3) lists their approved payouts with what was delivered, deducted and Paid to you.

Portal My deliveries page with the grower box, the deliveries table and the payouts table marked
Portal My deliveries page with the grower box, the deliveries table and the payouts table marked

Common questions

Why is a produce missing from Weigh in a delivery? Only produce with at least one price under Produce prices is listed. Add a price first.

A grower's payout is zero. Why? Their inputs on credit were more than they earned in the period. All they earned went to the debt; the rest is taken from later payouts.

Can I change a delivery after weighing it in? No. Deliveries are receipts and have no edit button. If a weight was too high, record the difference as an input on credit so it comes off the next payout; if it was too low, weigh in the missing kilograms as a new delivery.

Can I pay growers every two weeks? Yes. Prepare a payout for any period, for example the 1st to the 15th. Each delivery is only ever in one payout.

Do I need Inventory? No. Without Inventory, seasons and deliveries still track kilograms and money; nothing goes into stock.

Can my own farm's harvest and outgrower deliveries go into the same stock item? Yes. Use the same product for Harvest goes into stock as and in Produce prices.