Plexaris
Back to dashboard

Help and manual

Step by step guides for every screen. Search by keyword or scroll to find what you need.

Farmer sign-up (PDF)SPEAQ ID guide (PDF)

Register a farmer

Add a new farmer to your hub so they can have plots, harvests and deliveries. When to use this: - A farmer joins the programme for the first time. - You meet a farmer in the field who is not yet in the app. Steps: 1. Open Farmers from the menu. 2. Tap New farmer. 3. Fill in Full name exactly as the farmer says it. 4. Fill in Phone (E.164): start with + and the country code, for example +256700000000. 5. Choose the language the farmer prefers. 6. Optional: fill in the personal data fields (NIN, date of birth, address, next of kin). They are stored encrypted and can also be added later. 7. Tap Register farmer. After registration, run the onboarding wizard to connect the farmer to SPEAQ ID (see Onboard a farmer). Who can register a farmer: - Staff with the create permission: Owner, Country Admin, Hub Manager, Head Fellow and Fellow. Farmers can also start themselves: - A new farmer can send their own application through the public hub sign-up link; a fellow then reviews it and creates the record (see Apply to join as a farmer).

Correct a farmer's details

Change a farmer's details after registration. Where: 1. Open Farmers, tap the farmer, then tap Personal data under the name. 2. The detail page shows phone, language, status and the personal data section (NIN, date of birth, address, next of kin). Who can edit: - Personal data is edited by senior staff (Head Fellow and up); Fellows fill it in at registration. - All personal fields are stored encrypted. If the farmer's phone number changed, update it here so SMS confirmations keep arriving.

Locate a farmer in the Farmers list. Steps: 1. Open Farmers from the menu. 2. The list shows the farmers in your hub (Kayunga). 3. Scroll to the name, or use your browser search on the page. 4. Tap the farmer to open them. Filters: - Demo and test farmers are hidden by default. When some exist, a "Show demo/test (N)" link appears; tap it to reveal them, and "Hide demo/test" to hide them again. - The onboarding chips show only Linked, Not onboarded, or No phone (USSD) farmers, or all of them. Troubleshoot: - The farmer is not in the list: they may belong to another hub, are not registered yet, or are hidden as a demo/test entry (tap Show demo/test).

Why the name and phone must be exact

The farmer's name and phone are printed on every receipt and are part of the EUDR proof, so they must be correct. When to use this: - Before you save a new farmer. - When you are tempted to guess a spelling. Steps: 1. Read the name back to the farmer before saving. 2. Confirm the phone number by calling or messaging it once. Edge cases: - ID document available: use the spelling exactly as on the document. Troubleshoot: - Wrong name found later: correct it early; receipts already signed keep their old value.

The farmer detail page

Every farmer has a detail page with their information. How to reach it: 1. Open Farmers and tap a farmer (this opens the plots page). 2. Tap Personal data under the name. What it shows: phone, language, status, onboarding state, the personal data section and a link to the plots. Staff with the right permission can edit the personal data here.

Your personal data on the farmer page

Each farmer has a personal data section: national ID (NIN), date of birth, address and next of kin. What to know: - All these fields are stored encrypted. - They are optional, and filled in together with your Fellow team. - On the staff farmer page, only senior staff (Head Fellow and up) can edit them after registration. - If you are signed in as the farmer, you can also view and edit your own personal data on My profile (see Edit your own profile and personal data). - The NIN is checked so the same person is never registered twice. See My data and privacy for your rights over this data.

Your farm dashboard (My farm)

When you sign in as a farmer, you land on My farm: your home screen with one card for each part of your farm. When to use this: - You just signed in and want to find a screen. - You are not sure where something lives. Steps: 1. Open My farm (it is your home screen after signing in). 2. Tap a card to open that screen: - Crops: your plantings and what is growing. - Harvest: what you harvested and delivered. - Plots: your plots and land titles. - Marketplace: your listings and orders. - Market prices: current crop prices and your own. - Money: income, costs and what you owe. - Fertilizer: fertilizer loans and what is due. - Biomass: biomass you delivered to the hub. - Points: your loyalty points balance. - Advice: crop advice for your farm. - My profile: your name, phone and language. - Privacy: your data and who has seen it. 3. Use the bottom bar to go back to Dashboard or open Privacy from any screen. Troubleshoot: - You see "not linked" instead of the cards: your account is not yet linked to a farmer profile, ask your field fellow to link you with SPEAQ ID.

Apply to join as a farmer

You can ask to join Plexaris Agri yourself, from your own phone, even before you meet a fellow. When to use this: - You are a farmer who is not in the programme yet. - Someone shared the hub sign-up link with you. Steps: 1. Open the sign-up link for your hub, for example agri.plexaris.ai/en/farmer-apply/kayunga. 2. Fill in Full name. 3. Fill in Phone number with the country code, for example +256701234567. 4. Optional: fill in Village, Main crop and Estimated land size (ha). 5. Tap Submit application. 6. You see "Application received": a fellow from your hub will contact you. What happens next: - Your application waits as pending until a fellow reviews it. - The fellow approves it, creates your farmer record, then helps you link your SPEAQ ID (see Onboard a farmer). Good to know: - Only Full name and Phone number are required; the rest is optional. - No login is needed to apply. - Your name and phone are stored encrypted from the moment you apply.

Edit your own profile and personal data

As a signed-in farmer you can view and change your own details on My profile. When to use this: - Your phone number changed. - You want to set your language, or fill in your personal data. Steps (your basic profile): 1. Open My profile from My farm. 2. Change Full name, Phone (E.164) or Language. 3. Tap Save profile; you see "Profile saved." Steps (your personal data): 1. On the same page, open the personal data card. 2. Fill in or change NIN (national ID), Date of birth, Address, Next of kin (name) and Next of kin phone (E.164). 3. Tap Save personal data; you see "Saved". Good to know: - All of these fields are stored encrypted. - The personal data fields are optional; clear a field and save to remove it. - You only edit your own profile; you cannot see or change another farmer's data. Troubleshoot: - A NIN error: check the national ID, it must be 8 to 20 letters and digits. - "already in use": the same NIN cannot belong to two farmers, check the number.

Add and edit your crops yourself

On Crops (My plantings) you record what you planted, on which plot, and when you expect to harvest. When to use this: - You planted a crop on one of your plots. - You need to correct a planting you saved. Steps (add a planting): 1. Open Crops from My farm. 2. Tap Register planting. 3. Choose the Plot. 4. Choose the Crop. 5. Optional: enter Amount planted and a Unit (kg, seedlings or bags). 6. Enter the Planting date (today or earlier, not in the future). 7. Enter the Season length (weeks), between 1 and 104; the Expected harvest date fills in for you. 8. Choose the Seed type (Organic, Non-organic or Unknown). 9. Optional: enter the Seed supplier and upload a Purchase receipt (photo or PDF, max 5 MB). 10. Tap Save planting; you see "Planting saved." Steps (edit a planting): 1. Find the planting in the list and tap Edit. 2. Change the fields and tap Save planting. Edge cases: - You have no plots yet: you see "You have no plots yet. Ask your field fellow to add one." A fellow registers your plots. - A planting stays on its plot: you cannot move it to another plot, and a receipt can only be added when you first save. Troubleshoot: - "Check the planting fields and try again": a required field is empty or out of range, read the red note under each field. - "Enter a season length between 1 and 104 weeks": use a whole number of weeks in that range.

Onboard a farmer (wizard)

The onboarding wizard guides a Fellow through connecting a farmer to SPEAQ ID. Steps (Fellow): 1. Open the farmer's detail page and tap Start onboarding. 2. Answer: does the farmer have a smartphone? 3. YES: follow the three steps (install the SPEAQ ID app on the FARMER'S phone, let the farmer create their identity there, then start linking). 4. NO: confirm no smartphone; the farmer is marked for USSD until they get a phone. The farmers list has filters to work through everyone systematically.

Link a farmer with SPEAQ ID (QR or code)

Linking connects the farmer's own SPEAQ identity to their record. Steps: 1. From the wizard, tap Start linking (QR / code). 2. The farmer scans the QR code with their SPEAQ ID app, or types the 6-digit code in SPEAQ ID under Login, Enter code. 3. The farmer taps approve on THEIR phone. 4. The app confirms the link. Important: the farmer's keys stay on the farmer's phone. Plexaris staff never enter, see or store them.

Farmer without a smartphone

A farmer without a smartphone is not left out. What happens: - The Fellow marks no smartphone in the onboarding wizard. - The farmer's USSD profile is activated: they can use a basic phone once the USSD service is live and their number is registered. - This is temporary, not a second-class account: when the farmer gets a smartphone, the Fellow taps Undo and runs the normal SPEAQ onboarding. The goal stays the same for everyone: your own identity on your own phone.

Linking gives a farmer their own secure identity on their own phone, so they can sign in and see their own farm. Head Fellows and Hub Managers do this from the farmer's page. Who can do this: - A Hub Manager or Head Fellow (create and update rights), or a fellow with the onboard permission. You can only onboard farmers in your own hub. Steps: 1. Open the farmer's detail page and tap Start onboarding. 2. At "Does the farmer have a smartphone?", tap Yes, has a smartphone. 3. On the next screen, help the farmer install the SPEAQ ID app at app.speaq.id on THEIR phone and create their identity there. 4. Tap Start linking (QR / code). 5. The farmer scans the QR code, or types the 6-digit code, in their SPEAQ ID app and taps approve on their own phone. 6. You see "Farmer bound. They can now sign in." Linking is done. Good to know: - The farmer's keys stay on the farmer's phone. Plexaris staff never enter, see or store them. - The farmer signs out and back in once, so their own access takes effect. If something does not work, see SPEAQ linking: special cases and fixes.

What to do when linking a farmer's SPEAQ ID does not go straight through. The farmer has no SPEAQ ID yet: - Normal. The farmer creates one on their own phone during onboarding (install the app at app.speaq.id). No extra step. The farmer has no smartphone: 1. At the smartphone question, tap No smartphone. 2. Tap Confirm: no smartphone. 3. The farmer is marked for USSD until they get a phone. This is temporary, not a lesser account. The farmer already has an account: - The Start onboarding button does not show, and the link page says the farmer is already linked. Nothing to do. An error appears while linking: - "This SPEAQ ID is already linked to another account": the identity is already used elsewhere, use a different SPEAQ ID or tap Skip for now. - "We could not read your SPEAQ ID. Please contact support.": contact support. - "Something went wrong. Please try again.": ask the farmer to approve again from their SPEAQ ID app, then repeat the linking step. The farmer got a smartphone later: 1. Open onboarding for that farmer. 2. Tap Undo (farmer now has a smartphone). 3. Run the normal linking steps (see Link a farmer's SPEAQ ID).

Register a plot

Add a plot (a field) under a farmer. When to use this: - A farmer has a field that is not yet in the app. Steps: 1. Open the farmer. 2. Open Plots and start a new plot. 3. Either capture the GPS boundary (best, see Capture a plot boundary with GPS), or type the Area (ha) by hand. 4. Tap Register plot. Edge cases: - One farmer with several fields: register each field as its own plot. Troubleshoot: - "Enter the area, or add a GPS boundary of at least 3 points": you left both empty, add one of the two.

Capture a plot boundary with GPS

Walk the edge of the field and let the phone record each corner, so the app can calculate the area and keep the EUDR proof. When to use this: - Registering a new plot in the field. - Re-mapping a plot whose boundary was wrong. Steps: 1. Stand on the first corner of the field. 2. Tap Capture GPS point and wait until the point is recorded. 3. Walk to the next corner and tap Capture GPS point again. 4. Continue around the whole field, in order. 5. Capture at least 3 corners; the map preview shows the shape. 6. Tap Register plot. Edge cases: - Big field: capture every corner where the boundary changes direction. - Phone has no GPS or you are at a desk: type Latitude and Longitude by hand instead. Troubleshoot: - "Add at least 3 points to see the boundary": you have fewer than 3 points, capture more corners. - The point is far off: stand still a few seconds so the GPS settles, then capture again.

Fix a wrong GPS point

Remove a bad corner and capture it again. When to use this: - A point landed in the wrong place. - You walked the corners in the wrong order. Steps: 1. Find the wrong point in the list under the map. 2. Tap Remove next to it. 3. Stand on the correct corner and tap Capture GPS point. Edge cases: - Many points wrong: remove them all and walk the field again from the first corner. Troubleshoot: - The shape looks crossed: a corner is out of order, remove it and capture in walking order.

How the plot area is calculated

When you capture a GPS boundary, the app calculates the Area (ha) for you from the corners. When to use this: - You wonder why the area field filled itself. - You want to enter the area without GPS. Steps: 1. Capture at least 3 GPS corners; the area is computed automatically. 2. Or, with no boundary, type the Area (ha) yourself in decimal hectares (up to 4 decimals, e.g. 1.2500). Edge cases: - Both a boundary and a typed area: the GPS boundary is the source of truth. Troubleshoot: - "Enter the area as a number with up to 4 decimals (e.g. 1.2500)": use a dot, not a comma, and at most 4 decimals.

Bring plastic to the hub

The hub collects plastic bottles and turns them into useful boundary posts. Steps at the hub: 1. Bring your collected plastic (PET or HDPE bottles). 2. The Fellow weighs it and records the Plastic intake with the weight in kg and the plastic type. 3. The intake can be recorded for you as a farmer, or for the community. The plastic is melted into marker posts in Plexaris Agri colours.

What are marker posts

Marker posts are boundary stakes made at the hub from recycled plastic. What to know: - Each post has a unique QR code. - Posts are produced in batches at the hub from the collected plastic. - Fellows place them on plot corners to mark the official boundary. The posts make your plot boundary visible in the field AND digital in the app.

Place markers on a plot

Fellows place marker posts to map a plot boundary. Steps (Fellow): 1. Open Place marker. 2. Choose the Post (scan its QR code) and the Plot. 3. Stand at the corner: the GPS latitude, longitude and accuracy are captured. 4. Repeat for each corner, in order, walking around the plot. From 3 or more markers the app can close the boundary into a polygon.

From markers to a plot boundary

When enough markers are placed, the plot gets an official digital boundary. What happens: 1. The markers, in their placed order, form a polygon around the plot. 2. The app computes the boundary and the area from the polygon. 3. A signed boundary credential is created: proof of where the plot is. This boundary is used for EUDR evidence and for satellite checks of the plot.

Record a harvest

Write down what was harvested from a plot. When to use this: - A farmer harvests a crop from a plot. Steps: 1. Open the farmer, then the plot. 2. Open the harvest form. 3. Choose the Crop. 4. Enter Harvested (kg) as a number with up to 2 decimals, e.g. 450.00. 5. Enter the Season, e.g. 2026_season1. 6. Choose the Harvest date. 7. Add Notes if useful, then tap Add harvest. Edge cases: - Weigh first: put the crop on the scale before you type the number, do not guess. - Farmer signed in: you can record your own harvest from the Harvest screen on My farm; the steps are the same. Troubleshoot: - "Choose a crop": the Crop field is empty. - "Enter the weight as a number with up to 2 decimals (e.g. 450.00)": use a dot and at most 2 decimals.

Correct a harvest

A saved harvest cannot be edited or deleted in the app; harvest records are permanent for the audit trail. When to use this: - You realise a harvest was saved with the wrong weight or crop. Steps: 1. Do not add a second harvest to cancel the wrong one, that would double the totals. 2. Report the wrong harvest to your supervisor or hub admin so it can be handled correctly. 3. Weigh and check before saving the next harvest so it does not happen again. Edge cases: - A real extra harvest: if it truly is a separate weighing, record it as a new harvest (see Record more than one crop). Troubleshoot: - You cannot find an edit or delete button: that is expected, harvests are append-only, report the error instead.

See past harvests

Review the harvests already recorded for a plot. Steps: 1. Open the farmer, then the plot. 2. The harvest list shows each harvest with its crop, weight and date. Troubleshoot: - A harvest is missing: it may have been recorded on a different plot, check the right plot.

Record more than one crop

A plot can grow several crops; record each one separately. When to use this: - A plot has both coffee and bananas, for example. Steps: 1. Record the first crop as a harvest (see Record a harvest). 2. Add another harvest on the same plot and choose the other Crop. Edge cases: - Same crop, two weighings: record two harvest lines, one per weighing. Troubleshoot: - "Choose a valid crop": pick the crop from the list, do not leave it blank.

Register an input

Record something that was used on a plot, such as seed, fertilizer, labour or water. When to use this: - Any time inputs are applied to a field. Steps: 1. Open the plot. 2. Tap Register input. 3. Choose the Type. 4. Check the Date applied (it defaults to today). 5. Optionally enter Quantity and Unit. 6. Optionally enter Cost (UGX). 7. Add Notes if useful, then tap Save input. Edge cases: - See When to fill in the cost for the cost field. Troubleshoot: - "Plot not found": go back and open the plot again. - The button is grey: a required field is empty or it is still saving.

Record seed

Log seed that was planted on a plot. Steps: 1. Open the plot and tap Register input. 2. Choose Type: Seed. 3. Set the Date applied. 4. Optionally enter Quantity with Unit kg. 5. Tap Save input. Troubleshoot: - No exact quantity: leave Quantity empty rather than guessing.

Record fertilizer

Log fertilizer used on a plot. Hub fertilizer given on credit has its own type. When to use this: - Fertilizer was applied to the field. Steps: 1. Open the plot and tap Register input. 2. Choose Type: Fertilizer (hub loan) for fertilizer issued by the hub on credit, or Manual / other for fertilizer the farmer bought. 3. Set the Date applied and optionally Quantity in kg. 4. Tap Save input. Edge cases: - Hub allocation: the debt itself is recorded at the hub (see Issue fertilizer at the hub); this input records that it was applied. Troubleshoot: - Not sure which type: hub loan means the hub gave it on credit; manual means the farmer got it elsewhere.

Record labour

Log work done on a plot. Steps: 1. Open the plot and tap Register input. 2. Choose Type: Labour. 3. Set the Date applied. 4. Optionally enter Quantity with Unit hours. 5. Tap Save input. Edge cases: - Several days of work: record the total hours, or one input per work day. Troubleshoot: - Wrong unit: for labour choose Unit hours.

Record water and crop protection

Log irrigation water or crop protection such as pesticide. When to use this: - The field was watered. - A pesticide or other crop protection was applied. Steps: 1. Open the plot and tap Register input. 2. Choose Type: Water for irrigation, or Pesticide for crop protection. 3. Set the Date applied. 4. Optionally enter Quantity (Unit liters for water). 5. Tap Save input. Edge cases: - Other protection product: use Manual / other and describe it in Notes. Troubleshoot: - Wrong unit: water is usually liters, choose the matching Unit.

When to fill in the cost

Cost (UGX) is optional. Only fill it in when money was actually spent. When to use this: - You are deciding whether to type a cost. Steps: 1. Money was spent: type the amount in Cost (UGX). 2. No money was spent: leave Cost empty. Edge cases: - Free or hub-provided input: leave Cost empty, do not type 0. Troubleshoot: - "Cost must be zero or more": you typed a negative number, remove the minus sign or clear the field.

Fertilizer on loan and repayment

The hub can give fertilizer on loan against your future deliveries. How it works: 1. The hub records a fertilizer allocation to you. 2. You repay through your deliveries: a part of each payout goes to the outstanding loan, per the settlement terms. 3. Open My cashflow to see your Outstanding debt go down. Ask the Fellow what settlement term applies to you before taking the loan.

Record biomass intake at the hub

At the hub, record biomass a farmer brings in. The app signs the receipt. When to use this: - A farmer delivers biomass (husks, pulp and similar) to the hub. Steps: 1. Open Biomass intake at the hub. 2. Choose the Farmer (only farmers in this hub appear). 3. Enter Weight (kg) with up to 2 decimals, e.g. 120.00. 4. Choose the Type. 5. Set the Delivery date. 6. Add Quality notes if needed. 7. Tap Record intake; the Record hash and seal confirm it is saved. Edge cases: - See Why a farmer is not in the dropdown if the farmer is missing. Troubleshoot: - "Choose a farmer" or "Choose a type": a required choice is empty. - "Enter the weight as a number with up to 2 decimals (e.g. 120.00)": use a dot and at most 2 decimals.

Issue fertilizer at the hub

Record fertilizer the hub gives a farmer on credit, with the debt in UGX. When to use this: - The hub hands out fertilizer the farmer will pay back later. Steps: 1. Open Fertilizer allocation at the hub. 2. Choose the Farmer. 3. Enter the number of Bags. 4. Enter Total weight (kg), up to 2 decimals. 5. Enter the Debt (UGX). 6. Set the Issue date. 7. Tap Issue allocation; it is saved as outstanding with a signed receipt. Edge cases: - Applied fertilizer without a hub debt: use the plot input instead (see Record fertilizer). Troubleshoot: - "Enter the number of bags (1 or more)": Bags must be a whole number, at least 1. - "Enter the debt as a number with up to 2 decimals (e.g. 450000.00)": use a dot and at most 2 decimals.

Record a crop delivery at the hub

Record a crop a farmer delivers to the hub, with optional quality details. When to use this: - A farmer delivers a harvested crop to the hub for sale. Steps: 1. Open Crop delivery at the hub. 2. Choose the Farmer. 3. Optionally choose the Plot the crop came from. 4. Choose the Crop. 5. Enter Weight (kg), up to 2 decimals. 6. Optionally enter Moisture (%), Quality grade and Price per kg (UGX). 7. Set the Delivery date and tap Record delivery. Edge cases: - Price entered: the total is weight times price, calculated for you. - Plot unknown: leave Plot as No plot. Troubleshoot: - "Choose a valid plot for this farmer": the chosen plot is not this farmer’s, pick one of their plots or No plot. - "Choose a crop": the Crop field is empty.

What the receipt seal means

Every hub receipt is signed by the system. The seal badge shows whether the signature is valid. When to use this: - You see a coloured badge on a receipt and want to know what it means. Steps: 1. Green (valid): the receipt is signed and unchanged, the proof is good. 2. Grey (unsigned): the receipt has no signature yet. 3. Red (invalid): the signed data does not match, report it. Edge cases: - Older receipts from before signing may show grey; that is expected. Troubleshoot: - A receipt turned red: do not edit it, tell your supervisor, the record may have been tampered with. - Never edit a saved receipt; the seal is the proof.

See and verify past receipts

Each hub page lists the most recent receipts with their seal badge. Steps: 1. Open the hub page (Biomass, Fertilizer or Crop delivery). 2. Below the form, the last 20 receipts for this hub are listed. 3. Check the seal badge on each one (see What the receipt seal means). Troubleshoot: - A receipt is missing from the list: only the last 20 show, older ones are still stored.

Deliver napier grass

Napier grass is a second income stream on marginal land. Steps at the hub: 1. Bring your napier grass to the hub. 2. The Fellow records a Napier delivery with your name, the weight in kg and the delivery date. 3. You see DELIVERY RECORDED as confirmation. The delivery is signed in the system and counts towards the hub's biochar production.

What the hub does with biomass

The hub converts collected biomass into biochar. What to know: - Biochar is produced in recorded batches (input weight, output weight, production date). - Biochar locks carbon into a stable form and improves soil. - Each batch is the basis for carbon credits. As a farmer you contribute through your biomass and napier deliveries; the hub handles the production.

Carbon credits

Biochar production creates carbon credits over time. How it works: 1. Each biochar batch is recorded in the carbon credit ledger with its CO2 equivalent. 2. Entries start as pending and become certified when a recognised standard approves them. 3. Certified credits can generate income for the programme and, per the programme rules, for contributing farmers. Ask your Fellow about the current rules for farmer participation.

Browse the marketplace

See what other farmers are selling and at what price. When to use this: - You want to buy a crop, or check demand before listing your own. Steps: 1. Open Marketplace from the menu. 2. Each listing shows quantity, price per kg in UGX, the total and the seller. 3. Tap a listing to see details and the closing deadline. Prices here are real asking prices from sellers on the platform.

Sell a crop (new listing)

Put a harvest up for sale on the marketplace. Where: - Signed-in farmers open Marketplace from My farm; staff use the Marketplace menu. Steps: 1. Open Marketplace and tap New listing. 2. Choose the crop and fill in the quantity in kg. 3. Fill in your price per kg in UGX. 4. Set a deadline if you want the listing to close on a date. 5. Submit. Your listing is now visible to buyers. Tip: check the Crop prices screen first so your price matches the market.

Buying and order status

When a buyer accepts a listing it becomes an order. The order moves through these statuses: - Listed: still for sale. - Accepted: buyer committed, money is reserved in escrow. - Delivering: the crop is on the way. - Received: the buyer confirmed delivery, the seller gets paid. Open Orders from the menu to follow your own orders. Every step also sends an SMS confirmation when a phone number is on record.

Group buying

Buyers can bundle demand to buy together at better terms. How it works: 1. Open Groups from the menu. 2. A group has a coordinator, a crop, a minimum volume and a closing date. 3. Join the group with your quantity. 4. When the minimum volume is reached before the closing date, the group order goes ahead. The coordinator can be a Fellow or a farmer.

Group selling

Farmers can bundle their harvests to sell one bigger lot together. How it works: 1. Open Groups and choose a selling group for your crop, or ask your Fellow to start one. 2. Commit your quantity in kg before the closing date. 3. When the group reaches its minimum volume, the lot is listed and sold as one. 4. The proceeds are split by each farmer's contributed quantity. Group selling helps small volumes reach bigger buyers.

Escrow and getting paid

The platform protects both sides of a sale with escrow. How it works: - When a buyer accepts a listing, the money is reserved (escrow) before delivery starts. - The seller delivers. When the buyer confirms receipt, the money is released and paid out to the seller. - If nothing happens for too long, an automatic time-out protects the money. - If there is a problem, raise a dispute: the money stays frozen until it is resolved. You get an SMS when a payment is made to you.

Track a delivery

Every delivery is tracked with checkpoints so everyone can see where the crop is. Steps for the person transporting: 1. Open the order and the shipment. 2. At pickup: tap Capture GPS, then Mark pickup. 3. At handover: capture GPS again and mark the handover. Each checkpoint stores time and location. The buyer and seller can both see the progress on the order page.

Confirm you received the crop

The buyer must confirm receipt so the seller gets paid. Steps: 1. Open the order when the crop arrives. 2. Check quantity and quality against what you bought. 3. Tap the confirm delivery button. After you confirm, the escrow money is released to the seller and the order becomes Received. Only confirm when you are satisfied: if something is wrong, raise a dispute instead.

Riders and dispatch

Riders transport crops between farmers, hubs and buyers. What to know: - A rider is assigned to a shipment by the hub (smart dispatch picks the best match). - Riders see their own deliveries on the rider screen after logging in with SPEAQ ID. - The rider marks pickup and handover with GPS checkpoints. Farmers do not need to arrange transport themselves for marketplace orders.

Delivery did not arrive

What to do when a delivery is late or missing. Steps: 1. Open the order and check the tracking checkpoints. 2. If the crop stopped moving or never arrived, raise a dispute on the order. 3. Your money stays frozen in escrow while the dispute is open: nobody can take it. There is also an automatic time-out: an order that stays inactive too long is closed safely without losing the escrow money.

Raise a dispute

Use a dispute when something is wrong with an order. When to use this: - Price disagreement, quality problem, or wrong weight or quantity. Steps: 1. Open the order with the problem. 2. Tap Raise a dispute. 3. Choose the reason and add details (up to 500 characters). 4. Submit dispute. The escrow money is frozen immediately: it cannot be paid out while the dispute is open.

What happens with my dispute

After you submit a dispute, the support team reviews it. What happens: 1. Support looks at the order, the tracking and both sides of the story. 2. The dispute can be escalated, or referred to legal support (HAKI) for serious cases. 3. You receive an SMS when your dispute is resolved. Keep your evidence: photos, weights and dates help the review.

Dispute outcomes

A dispute ends in one of two ways. - In favour of the seller: the escrow money is released and paid to the seller, the order is completed. - In favour of the buyer: the escrow money is refunded to the buyer. The decision is recorded and signed in the system, and both sides can see the outcome on the order. An SMS confirmation is sent when a phone number is on record.

My cashflow

See your money in and out at a glance. Steps: 1. Open My cashflow from the menu. 2. The top shows Income, Expenses, Outstanding debt and Net. 3. Below is the list of recent transactions with date, type and detail. The numbers come from your real recorded deliveries, sales and repayments on the platform.

Your credit score

Your platform history builds a credit score that can help you get inputs and loans. What counts: - Regular deliveries and sales. - Repaying fertilizer or input loans on time. - A registered plot with a boundary. The score is calculated from your own data only. Ask your Fellow to walk through your score and what would improve it.

Earn loyalty points

You earn points automatically for participating. You get points for: - Biomass deliveries to the hub. - Plot markers placed on your plots. - Other hub activities as they are enabled. There is nothing to claim or register: points are awarded automatically when the activity is recorded at the hub.

Check your points balance

See how many points you have and where they came from. Steps: 1. Open Your loyalty points from the menu. 2. The top shows your Points balance. 3. The table shows Date, Earned for, Points and the running Balance. If a delivery is missing from the list, ask your Fellow to check the hub record.

Spend your points

Points can be exchanged for items from the hub catalogue. How it works: 1. Ask at the hub (or open the redemption screen) for what is available. 2. Choose an item; the points are deducted from your balance. 3. Collect the item at the hub. During the pilot the catalogue can be small and some redemption options may not be open yet. Your earned points stay safe in your balance.

Check crop prices

See live crop prices based on real sales on the platform. Steps: 1. Open Crop prices from the menu (no login needed). 2. Each crop shows the current price per kg in UGX, the range and the trend. Good to know: - Prices come from real marketplace transactions, never hidden. - A crop only shows a price when there is enough market data; others say awaiting enough market data.

The hub price board

Every hub can show a public price board on a screen at the veranda. What to know: - The board shows live AgroLink market prices and hub status. - It needs no login and refreshes itself. - Anyone passing the hub can read it: price transparency is the strongest protection against being underpaid. Ask at your hub where the board is displayed.

Farming advice in the app

The app gives agronomy tips for your crops and season. How to use it: 1. Open the advisory or ask the in-app assistant a question (see Find help). 2. Advice is based on your crop, the season and good agricultural practice. Important: advice is general guidance. For a serious problem on your field, ask your Fellow to visit and look at it.

Pair a new fellow device

Link a new fellow's phone to the system using the SPEAQ identity handshake, so the fellow can sign their work. When to use this: - A new field fellow joins and needs to be added. - A fellow gets a new phone. Steps: 1. Open Pair a new fellow in the fellows admin. 2. Choose the Candidate (a person already SPEAQ-bound, with no fellow record yet). 3. Choose the Hub and the Role. 4. Ask the candidate to approve the handshake on their phone (scan the QR with their SPEAQ app). 5. Wait until the pairing confirms; the fellow record is created. Edge cases: - The candidate list is empty: the person must first sign in and bind their SPEAQ identity. Troubleshoot: - "The approving device is not this candidate": the wrong phone approved, the chosen candidate must approve on their own device. - "This device is already a fellow": that device is paired already, pick a different candidate.

Submit a fellow audit

Record a quality audit of a fellow's field work. When to use this: - You checked a fellow's work and want to record the result. Steps: 1. Open Fellow audits and start a new audit. 2. Choose the Fellow. 3. Set the Audit date (not in the future). 4. Enter the Sample size (how many records you checked). 5. Enter the Score (0-100). 6. Write the Findings. 7. Tap Submit audit; it is signed and stored. Edge cases: - Audit signed: the result is sealed, so check the numbers before you submit. Troubleshoot: - "Score must be 0 to 100": the Score is out of range. - "Audit date cannot be in the future": pick today or an earlier date.

How the fellow score works

A fellow's quality score is the rolling average of their recent audit and peer-review scores. When to use this: - You want to understand the score shown on a fellow. Steps: 1. Submit audits and peer reviews over time (see Submit a fellow audit and Give a peer review). 2. The fellow page shows the rolling average of the last 90 days. 3. A trend arrow shows whether the score is going up, down or staying stable. Edge cases: - New fellow with no reviews yet: the score stays empty until the first review. Troubleshoot: - The score looks low: open the fellow to read the recent findings behind it.

Give a peer review

One fellow rates another fellow's work from 1 to 5. You cannot review yourself. When to use this: - You observed another fellow's work and want to record feedback. Steps: 1. Open the fellow you are reviewing. 2. In the peer review form, choose the Score (1-5). 3. Add Notes. 4. Optionally Link to a visit. 5. Tap Submit. Edge cases: - No self-review: you cannot submit a review of your own fellow record. Troubleshoot: - The form will not submit for yourself: that is by design, ask another fellow to review you.

What EUDR is

European buyers must prove crops are deforestation-free (EUDR). The platform assembles that proof for you. The evidence chain: 1. Plot boundary: marker posts placed around the plot form a signed digital boundary (see From markers to a plot boundary). 2. Land tenure: a credential records on what basis the farmer uses the land (see Prove your land rights). 3. Satellite checks: the plot is checked against deforestation maps automatically. 4. The hub generates a due diligence statement (DDS) from this evidence for the export buyer. A complete plot record is the farmer's ticket to export prices.

Putting an EUDR evidence file together

An EUDR file for a farmer brings together the plot boundary and the signed delivery receipts. When to use this: - A buyer asks for proof for a delivery. - You prepare a farmer for the first sale. Steps: 1. Make sure the farmer name and phone are correct (see Why the name and phone must be exact). 2. Make sure each plot has a GPS boundary. 3. Record each hub delivery so it gets a signed receipt. 4. Check that the receipts show a green seal (see What the receipt seal means). Edge cases: - Several plots: each delivering plot needs its own boundary. Troubleshoot: - A receipt is grey or red: it is unsigned or invalid, it cannot be used as proof, record or report it correctly.

Prove your land rights (tenure)

A land tenure credential records on what basis you use your land. What to know: - Types include formal title, customary use, cooperative register, local authority declaration and attestation. - A formal title needs a document (photo or scan, uploaded by the Fellow). - Document-free types need an attestor who vouches. Steps (with your Fellow): 1. Open the plot page, choose the tenure type. 2. Upload the document or record the attestor. 3. The credential is signed and linked to your plot boundary.

Attest legality (EUDR Art. 9)

Before a plot can get a due diligence statement (DDS), someone must attest that the crop was produced in line with the laws of the country of production. This is the EUDR Art. 9 legality step, and it covers eight areas of law. Who does this: - A Fellow or compliance officer with the tenure permission, on the plot page. - The person who signs is accountable for what the attestation says. The eight categories: 1. Land use rights 2. Environmental protection 3. Forest management rules 4. Third-party rights 5. Labour rights 6. Human rights 7. FPIC (free, prior, informed consent) 8. Tax, anti-corruption and customs Steps: 1. Open the plot page and tap Attest legality (EUDR Art. 9). 2. Leave Attestor DID blank to attest as yourself, or enter another attestor's DID. 3. For each of the eight categories choose a status: pending, compliant or not_applicable. 4. In the note next to each category, write the real evidence reference (for example a permit number, a land document, a labour record or a community consent record). 5. Tap Sign attestation. The credential is signed and linked to the plot. What makes it valid, not just filled in: - Mark compliant only when you actually hold the basis for it, and name that evidence in the note. A compliant with no evidence is not proof. - Leave a category pending until it has really been checked. Pending is the honest default and claims nothing. - Use not_applicable only when the category genuinely does not apply, and say why in the note. Good to know: - The DDS cannot be generated until a valid legality credential exists (the app blocks it and shows no_legality). - The attestation is signed, shown on the certificate and on the public verify page, and cannot be changed after signing. To correct it, sign a new one. - The app records and signs your attestation, it does not judge the law itself. The final legal check is done by your compliance or legal reviewer before a real shipment.

Verified supplier status

Buyers want to know a seller is real and reliable. What to know: - Your supplier verification is derived from your own record: registered farmer, plots with boundaries, delivery history. - A verifier at the hub can issue the verification on your plots page. - The status is signed and visible with your listings. Keep your record complete: it is your business card to bigger buyers.

Due diligence statement (export)

Export buyers in Europe need proof that crops are deforestation-free (EUDR). What the platform does: 1. Your plot boundary, tenure credential and satellite checks are assembled as evidence. 2. The hub generates a due diligence statement (DDS) from that evidence. 3. The buyer uses the DDS for the export. As a farmer you mainly need a complete plot: boundary markers placed and tenure recorded.

Use the app without a smartphone (USSD)

Farmers without a smartphone can use a basic phone. How it works: 1. Your Fellow marks your profile for USSD during onboarding. 2. Make sure your phone number is registered (ask your Fellow). 3. When the USSD service is live, you dial the short code on any phone. 4. The menu gives you your cashflow, market prices and loyalty points as text. USSD needs no internet and works on every phone.

SMS confirmations

The platform sends you an SMS for important events, so you always have proof. You get an SMS when: - A payment is made to you. - Your order is confirmed. - Your delivery is confirmed. - Your dispute is resolved. The SMS mentions the crop and never asks for codes or money. If a message asks you to send money, it is NOT from Plexaris: report it to your Fellow.

No phone number on record

Without a registered phone number you receive no SMS and cannot use USSD. What to do: 1. Tell your Fellow your current phone number. 2. The Fellow updates it on your farmer record. 3. From then on you receive payment and order confirmations by SMS. Your number is stored encrypted and is never shared.

My data and privacy

You have rights over your own data. Steps: 1. Open My data and privacy. 2. Download my data: get everything Plexaris Agri holds about you as a file. 3. Request deletion: ask for your data to be deleted, with an optional reason. Every request is reviewed by a person and you can follow its status (Pending, In review, and onward). Deletion is reviewed, not automatic, because some records (like signed deliveries) have legal retention.

Why a farmer is not in the dropdown

At the hub, the farmer list only shows farmers that belong to this hub. If a farmer is missing, it is not an error. When to use this: - You cannot find a farmer when recording a hub intake or delivery. Steps: 1. Check the farmer is registered in this hub (Kayunga). 2. If they belong to another hub, they will not appear here. 3. If they are new, register them first (see Register a farmer), then return to the hub form. Edge cases: - Just registered: refresh the page so the new farmer appears in the list. Troubleshoot: - Still missing after registering: confirm the farmer was saved in the Farmers list.

Why the save button stays grey

A save or submit button is grey when a required field is empty or the app is still saving. When to use this: - The button does not respond when you tap it. Steps: 1. Check every required field is filled in. 2. Wait a moment if it is already saving. 3. For pairing and audits, the button only turns on once the required choices are made (for example a candidate and a hub, or a fellow and a score). Edge cases: - Slow network: the button may stay grey a little longer while saving. Troubleshoot: - Still grey: a hidden required field may be empty, scroll up and check the whole form.

Fixing a red field or number error

A field turns red with a message when a number or date is not in the form the app expects. When to use this: - You see a red field after tapping save. Steps: 1. Read the red message under the field. 2. For weights, use a dot and at most 2 decimals (e.g. 450.00), not a comma. 3. For area, use up to 4 decimals (e.g. 1.2500). 4. For dates, pick a real date that is not in the future where the form says so. Edge cases: - Phone keyboard adds a comma: replace it with a dot. Troubleshoot: - The message stays after fixing: clear the field and type the value again from scratch.

Fixing "Plot not found"

This message means the plot you were working on could not be found, usually because the page is stale. When to use this: - You see "Plot not found" when saving an input or delivery. Steps: 1. Go back to the farmer. 2. Open the plot again from the list. 3. Try the action once more on the freshly opened plot. Edge cases: - Plot was archived: a removed plot will not be found, use a current plot. Troubleshoot: - It keeps happening: refresh the page fully, then reopen the farmer and plot.

Change the language

The app is available in English, Oluganda and Kiswahili. When to use this: - You prefer another language. - You hand the phone to a farmer who reads another language. Steps: 1. Tap the globe icon in the top bar. 2. Choose English, Oluganda or Kiswahili. 3. The page reloads in that language. Edge cases: - Your choice is remembered on this device. Troubleshoot: - Some words stay in English: a few labels are not translated yet, the rest of the screen still works.

Switch light or dark display

You can use the app in a light or a dark display. When to use this: - The screen is hard to read in bright sun or at night. Steps: 1. Tap the sun or moon icon in the top bar. 2. The display switches between light and dark. Edge cases: - Your choice is remembered on this device. Troubleshoot: - It went back to dark: dark is the default, tap the icon again to choose light.

Sign out

Signing out ends your session on this device. When to use this: - You finish work on a shared phone. - You hand the phone to someone else. Steps: 1. Tap the sign out icon in the top bar. 2. You return to the login screen. Edge cases: - Shared device: always sign out so the next person uses their own identity. Troubleshoot: - No sign out icon: you may already be signed out, the icon only shows when you are signed in.

Working without a network

When the phone has no connection, a banner tells you that you are offline. When to use this: - You are in a field with weak or no signal. Steps: 1. Read the offline banner: saving is paused until the connection returns. 2. Finish reading and preparing what you can. 3. When the signal returns, save the record. Edge cases: - Long time offline: keep the page open so you do not lose what you typed. Troubleshoot: - Saving does nothing offline: that is expected, wait for the signal and try again.

Using this help center

Two ways to get help inside the app, plus printable guides. 1. The manual (this help): open Help from the menu, use the search box to filter the sections. 2. The assistant: ask your question in the chat on the help page, in your own language. The assistant answers from this manual: short steps, exact button names. It does not know your personal records; for live data it points you to the right screen. 3. Printable guides: at the top of this page, two download buttons open PDF guides (each in English, Luganda and Swahili): the Farmer sign-up guide and the SPEAQ ID guide. Use them to print or share offline. Still stuck? Ask your Fellow or the hub team.