Record a collection
A purchase from a farmer is recorded as a Collection - also called a lot. It’s the atom that everything downstream is built from.
In the field (the normal way)
Section titled “In the field (the normal way)”The Field App captures it at the point of collection, in this order: choose the farmer, then the payment method, then the weight and the rest of the delivery. Once the farmer or the payment method is chosen it stays fixed. To change either one, start the collection again. Offline is fine - it syncs later.
This is where it should happen. The farmer is present, the scale is there, and the purchase is attached to a real farmer record rather than a name written down and typed in later.
After a purchase is saved, the app stays on the same collection, ready for the next farmer. Tap Close under Review & save to leave it and go back to the list of collections.
Scanning a farmer ID card
Section titled “Scanning a farmer ID card”Where the organisation has QR scanning switched on, Android phones show a QR button next to the farmer field. Tap it and scan the farmer’s ID card to pick the farmer. The scan only looks in the farmer list on the phone, which can be limited to the farmers of the location chosen when the collection was started (for example its district). If the card’s farmer is not in that list, a message shows the scanned code and says the farmer is not in the list: check the location of the collection, or pick the farmer by hand.
Weighing
Section titled “Weighing”You type two things at most:
- Weight - what the scale reads. Where a Bluetooth scale is set up, the icon beside the field reads it in for you.
- Tare - the weight of the sack or container, where the organisation weighs with one. Some organisations subtract it automatically and do not show it.
Everything below those is worked out for you and cannot be typed into: the net Total Weight, the sack count, the price per unit and the amount to pay.
Charges (transport and similar)
Section titled “Charges (transport and similar)”Where the organisation pays charges on top of the price, such as transport per kg, the payment card shows one box per charge for the product being bought. The box may already hold a rate: the organisation’s usual rate for that station or product, or, where the organisation has turned it on, the rate this supplier was charged last time (shown as This supplier’s last rate). Change it if today’s rate is different, or clear it for none. The card then shows the goods amount, each charge and the Total to pay. The price stays the price of the goods; the payment is goods plus charges.
Buyers on WhatsApp are asked the same thing after the price (“Transport per kg? Type the amount, or 0”), with the supplier’s last rate or the usual rate offered. The Charges tab under Collections → Analytics totals each charge by station and by supplier. The lot page shows the charges on each collection and in the totals, and the payment page lists them.
Set up the charges
Section titled “Set up the charges”Charges are set in the dashboard, in Settings:
- Settings → Lots, section Purchase charges;
- Settings → Field App → Payment;
- Bots → Settings, under Buying in the bot (platform superusers).
All three show the same list, shared by the field app, WhatsApp buying and the reports, so a change saved in one shows in the others. Each row is one rule:
- Name: what the buyer and the reports see. Open Other languages to give it in Spanish, French, Portuguese, Swahili, Kinyarwanda or Indonesian.
- Type key: a short lowercase key such as
transport. Rules with the same key are one charge in the reports, so one transport rule per station all usetransport. Click a suggested key under the box to reuse it. - Add to payment or Deduct from payment, and Per kg or Flat amount.
- Default rate: the usual rate, in the organisation’s currency. Leave it empty for none.
- Products: the products the rule is for, searched by code or name. Leave it empty for all products.
- Buyer can edit the rate, Required, and Start from the supplier’s last rate.
Use the arrows to reorder, the copy button to duplicate a rule (for another station, then pick its products), and the bin to delete. Click Save.
Order matters: for each type key, the first rule that covers the product is the one used. Saving is refused when a product is in two rules with the same type key (the message names the products), or when a rule for all products comes before rules of its type that list products. A rule for all products placed after them is allowed, and is flagged: it covers every other product.
Phones get the change the next time they open the workspace while online. WhatsApp buying picks it up within about a minute.
In the dashboard
Section titled “In the dashboard”- Open Collections, under Traceability and Production.
- Click Create lot.
- Fill in the form and save.
A supplier’s collections also appear on its own Collections tab. The filter bar there starts closed; open Filters to change season or other filters.
To look up existing collections by lot label, collection ID, or a pasted list, see Find a collection.
Where the rest lives
Section titled “Where the rest lives”- Payments - Traceability → Payments → Payment Transactions. See Pay a farmer.
- Charts, the collection activity map, operator totals, facility totals and the season view - Collections → Analytics. See Collection analytics.