πŸ“‹ Complete Workflow Examples

Step-by-Step Real-World Scenarios

Scenario 1: Complete Test Order Workflow

John orders a pregnancy test for his Nguni cow

Context

Farmer: John Dlamini (Barberton, Mpumalanga)

Animal: CATTLE-045 (3-year-old Nguni cow)

Need: Pregnancy test to confirm suspected pregnancy

Complete Process Timeline

Day 1: Farmer Orders Test

  1. John logs into FarmSure
  2. Navigates to Testing
  3. Selects Pregnancy Test - Bovine (R 450.00)
  4. Clicks "Order This Test"
  5. Fills in:
    • Animal: CATTLE-045
    • Preferred Collection: Nov 15, 2025
    • Instructions: "Please call before arriving"
  6. Adds to cart and proceeds to checkout
  7. Pays via EFT/Bank Transfer
  8. Order created: TEST-2025-0012

Day 1 (Afternoon): Admin Schedules Collection

  1. Admin sees new test order notification
  2. Reviews payment confirmation
  3. Schedules collection for Nov 15, 09:00
  4. Assigns collector: Sarah Khumalo
  5. System sends SMS to John with appointment details

Day 7: Sample Collection

  1. Sarah calls John at 08:45
  2. Arrives at farm at 09:00
  3. Verifies animal (CATTLE-045)
  4. Collects 5ml blood sample via venipuncture
  5. Labels tube: S-2025-0012
  6. Stores in cool box
  7. Returns to office and marks as "Collected"
  8. Courier delivers to lab at 14:00

Day 9: Lab Processing

  1. Lab receives sample
  2. Dr. Piet Nkosi performs ELISA test for PAG
  3. Results: POSITIVE (PAG: 2.45 ng/mL)
  4. Uploads to system:
    • Result: Positive - Pregnant
    • Estimated conception: Aug 10, 2025
    • Expected calving: May 19, 2026
    • Current gestation: 14 weeks

Day 9 (Afternoon): Admin Approves Results

  1. Admin reviews results
  2. Verifies all data is complete
  3. Clicks "Approve & Publish"
  4. System generates PDF certificate
  5. John receives email notification

Day 9 (Evening): Farmer Views Results

  1. John receives notification email and SMS
  2. Logs into FarmSure
  3. Goes to Testing β†’ My Tests
  4. Sees TEST-2025-0012 marked "Completed" (green)
  5. Clicks "View Results"
  6. Downloads PDF certificate
  7. Now has official proof cow is pregnant!

Timeline Summary

Date Time Event Actor
Nov 08 10:30 Test ordered and paid Farmer
Nov 08 14:00 Collection scheduled Admin
Nov 15 09:15 Sample collected Collector
Nov 15 14:00 Sample received at lab Lab
Nov 17 10:00 Test performed Lab
Nov 17 11:30 Results uploaded Lab
Nov 17 14:00 Results approved Admin
Nov 17 15:00 Results viewed Farmer
βœ… Total Time: 9 days from order to result
βœ… Cost: R 450.00
βœ… Outcome: Pregnancy confirmed with official certificate

Scenario 2: Selling an Animal

Maria sells a Brahman bull on the marketplace

Context

Seller: Maria van Wyk

Animal: BRAHMAN-012 (2-year-old bull, 520 kg)

Price: R 18,500

Step-by-Step Process

Step 1: Create Listing

  1. Maria goes to Marketplace β†’ My Listings
  2. Clicks + New Listing
  3. Selects animal: BRAHMAN-012
  4. Sets price: R 18,500
  5. Writes description highlighting qualities
  6. Uploads 3 photos
  7. Creates listing - now visible to all buyers

Step 2: Buyer Discovers & Purchases

  1. Thabo Mahlangu browses marketplace
  2. Filters: Cattle β†’ Brahman β†’ R 15,000-20,000
  3. Finds BRAHMAN-012
  4. Reviews photos and details
  5. Adds to cart
  6. Proceeds to checkout
  7. Pays via EFT/Bank Transfer
  8. Order created: MKT-2025-0005

Step 3: Admin Processes Payment

  1. Admin verifies buyer's payment received
  2. Goes to Marketplace Workflow
  3. Clicks "Pay Seller" for MKT-2025-0005
  4. Makes EFT payment to Maria's bank account
  5. Status: Seller Paid
  6. Maria receives payment confirmation

Step 4: Admin Transfers Animal

  1. Admin clicks "Transfer" for MKT-2025-0005
  2. Reviews transfer details
  3. Confirms transfer
  4. System automatically:
    • Changes animal owner to Thabo
    • Moves animal to Thabo's farm
    • Deactivates marketplace listing
    • Creates transfer history
  5. Both parties receive confirmation emails

Financial Summary

Party Transaction Amount
Buyer (Thabo) Paid via EFT -R 18,500
Seller (Maria) Received via EFT +R 18,500

Scenario 3: Purchasing an Animal

Sipho buys a Nguni cow from the marketplace

Context

Buyer: Sipho Nkosi

Animal: NGUNI-045 (Nguni cow for breeding)

Price: R 12,000

Payment: EFT/Bank Transfer

Complete Purchase Process

Step 1: Browse & Select

  1. Sipho logs into FarmSure
  2. Goes to Marketplace
  3. Filters: Cattle β†’ Nguni β†’ Female β†’ R 10,000-15,000
  4. Finds NGUNI-045 - R 12,000
  5. Reviews photos, description, test certificates
  6. Clicks "Add to Cart"

Step 2: Checkout

  1. Reviews cart
  2. Selects destination farm: "North Pasture Farm"
  3. Clicks "Proceed to Checkout"
  4. Admin verifies animal availability
  5. Payment method shown: EFT/Bank Transfer

Step 3: Make Payment

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ BANK TRANSFER DETAILS β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Bank: FNB β”‚ β”‚ Account: 62XXXXXXXX β”‚ β”‚ Reference: MKT-2025-0008 β”‚ β”‚ Amount: R 12,000.00 β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
  1. Sipho logs into online banking
  2. Makes EFT payment with exact reference
  3. Takes screenshot of confirmation
  4. Returns to FarmSure
  5. Uploads proof of payment

Step 4: Admin Verifies & Processes

  1. Admin receives payment notification
  2. Reviews proof of payment
  3. Checks bank statement
  4. Confirms payment received
  5. Pays seller (John Dlamini)
  6. Transfers animal to Sipho's farm
  7. Order complete!
βœ… Result: Sipho now owns NGUNI-045 on his North Pasture Farm
βœ… Time: 1-3 days from order to completion
βœ… Payment: Secure bank transfer with admin verification

Scenario 4: Processing Marketplace Payments (Admin)

Admin processes 5 marketplace orders at various stages

Daily Workflow Overview

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ MARKETPLACE ORDERS - ACTION REQUIRED β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Step 1: Pending Buyer Payment (2 orders) β”‚ β”‚ Step 2: Verify Buyer Payment (3 orders) β”‚ β”‚ Step 3: Pay Seller (2 orders) β”‚ β”‚ Step 4: Transfer Animals (1 order) β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Processing Each Stage

Stage 2: Verify Buyer Payments

Order MKT-2025-0013: Bank Transfer with Proof

  1. Click "View Details"
  2. Click "View Proof of Payment"
  3. Verify screenshot shows:
    • Amount: R 12,000 βœ“
    • Reference: MKT-2025-0013 βœ“
    • Date: Today βœ“
  4. Check bank statement - transaction matched βœ“
  5. Click "Confirm Payment"
  6. Status: Buyer Paid
  7. Moves to Step 3

Stage 3: Pay Sellers

Order MKT-2025-0015: Pay via EFT

  1. Click "Pay Seller"
  2. Seller: Maria van Wyk
  3. Amount: R 18,500
  4. Seller banking details on file
  5. Make bank transfer externally
  6. Record payment reference in system
  7. Click "Record Payment Made"
  8. Seller receives confirmation email
  9. Moves to Step 4

Stage 4: Transfer Animals

Order MKT-2025-0017: 2 animals to transfer

  1. Click "Transfer"
  2. Verify: Buyer paid βœ“, Seller paid βœ“
  3. Animals: NGUNI-045, NGUNI-046
  4. From: Springbok Valley β†’ To: Highland Farm
  5. Click "Confirm Transfer"
  6. System transfers both animals
  7. Both parties emailed
  8. Status: Transferred βœ“

End of Day Summary

  • βœ… Verified Payments: 3 orders
  • βœ… Sellers Paid: 2 orders
  • βœ… Animals Transferred: 1 order (2 animals)

Scenario 5: Bank Statement Reconciliation

Admin imports and reconciles 24 hours of bank transactions

Complete Reconciliation Process

Step 1: Export from Bank

  1. Admin logs into FNB Business Banking
  2. Navigates to Statements
  3. Selects account: 62XXXXXXXX
  4. Date range: Nov 10-11, 2025
  5. Format: CSV
  6. Downloads: FNB-Statement-20251111.csv

Step 2: Upload to FarmSure

  1. Goes to Financial Dashboard
  2. Clicks Bank Import
  3. Selects bank: FNB
  4. Uploads CSV file
  5. Sets date range
  6. Clicks "Upload & Process"

Step 3: Review Import Preview

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ IMPORT PREVIEW - 24 Transactions Found β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Date β”‚ Description β”‚ Referenceβ”‚ Amount β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ 11-10 β”‚ EFT Credit J DLAMINI β”‚TEST-0012 β”‚ R 450 β”‚ β”‚ 11-10 β”‚ EFT Credit M VAN WYK β”‚MKT-0008 β”‚ R10,000β”‚ β”‚ 11-10 β”‚ EFT Credit T MAHLANGUβ”‚MKT-0009 β”‚ R15,000β”‚ β”‚ 11-11 β”‚ EFT Credit S NKOSI β”‚TEST-0015 β”‚ R 850 β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ Ready to import: 24 transactions [Confirm Import]
  1. Reviews data
  2. Clicks "Confirm Import"

Step 4: Automatic Matching

Processing... ━━━━━━━━━━━━━━━━━━━━━━ 100% Results: βœ… Auto-Matched: 18 transactions 🟑 Possible Matches: 3 transactions ❌ No Match: 3 transactions

Step 5: Manual Reconciliation

For unmatched transactions:

  1. System suggests possible matches
  2. Admin reviews and confirms
  3. Links payments to orders
  4. Marks bank fees and other transactions
  5. All transactions accounted for

Final Reconciliation Status

  • βœ… Total Transactions: 24
  • βœ… Matched: 21 (87.5%)
  • βœ… Reconciled: 24 (100%)
  • βœ… Test Payments: 12 orders (R 8,450)
  • βœ… Marketplace: 9 orders (R 127,500)
  • βœ… All accounts balanced
Impact: 12 test orders and 9 marketplace orders automatically moved forward in their workflows. Farmers received instant payment confirmations.

Scenario 6: Batch Animal Registration

Farmer registers 50 sheep from auction using CSV import

Quick Batch Process

Step 1: Prepare Spreadsheet

  1. Download CSV template from FarmSure
  2. Open in Excel/Google Sheets
  3. Fill in data for 50 sheep:
reference_code,species,breed,sex,date_of_birth,weight,tag_number,farm_name DORPER-2025-001,Sheep,Dorper,Female,2023-04-15,62,ZA-D-001,Main Farm DORPER-2025-002,Sheep,Dorper,Female,2023-04-18,59,ZA-D-002,Main Farm DORPER-2025-003,Sheep,Dorper,Male,2023-04-20,68,ZA-D-003,Main Farm ... (47 more rows)
  1. Save as: sheep-batch-nov2025.csv

Step 2: Import

  1. Goes to Animals β†’ Batch Import
  2. Uploads CSV file
  3. System validates data
  4. Confirms import
  5. Success: "50 animals imported successfully!"
βœ… Time Saved: 15 minutes vs. 2+ hours for manual entry
βœ… Accuracy: Reduced errors with template format
βœ… Result: All 50 sheep now in system with complete records

Scenario 7: Lab Result Upload Process

Lab processes 5 different test types in one day

Daily Lab Workflow

Morning: Receive Samples

Lab receives 5 samples:

  • S-2025-0045: Pregnancy test (cattle)
  • S-2025-0046: Brucellosis (sheep)
  • S-2025-0047: TB test (cattle)
  • S-2025-0048: Blood panel (goat)
  • S-2025-0049: DNA profile (cattle)

Processing: Each Test Type

Sample 1: Pregnancy Test

  1. Performs ELISA test
  2. Result: Positive (PAG: 2.8 ng/mL)
  3. Uploads: Result, conception date, calving date
  4. Submits to admin

Sample 2: Brucellosis

  1. Performs Rose Bengal Test
  2. Result: Negative
  3. Uploads: Test type, antibody levels, interpretation
  4. Submits to admin

Sample 3: Tuberculosis

  1. Performs IGRA test
  2. Result: Negative (INF-Ξ³: 0.05 IU/mL)
  3. Uploads: Result valid for 12 months
  4. Submits to admin

Sample 4: Blood Panel

  1. Runs complete hematology & chemistry
  2. All 15 parameters normal
  3. Uploads: Complete panel with reference ranges
  4. Submits to admin

Sample 5: DNA Profile

  1. DNA extraction and PCR amplification
  2. 15 genetic markers analyzed
  3. Uploads: Marker data, profile hash, parentage results
  4. Attaches data file
  5. Submits to admin

End of Day Summary

  • βœ… All 5 results uploaded
  • βœ… Admin notified for review
  • βœ… Samples properly stored
  • βœ… Quality control passed

Workflow Summary

Workflow Actors Duration Key Steps
Test Order Farmer→Admin→Lab→Admin→Farmer 7-10 days Order→Pay→Schedule→Collect→Test→Approve→View
Sell Animal Farmer→Buyer→Admin 1-3 days List→Purchase→Verify→Pay Seller→Transfer
Buy Animal Buyer→Admin→Seller 1-3 days Browse→Cart→Pay→Verify→Transfer→Receive
Payment Processing Admin 30 min/order View→Verify→Pay→Transfer
Bank Reconciliation Admin 30-60 min Export→Upload→Auto-Match→Manual→Complete
Batch Registration Farmer 15 min Prepare→Upload→Validate→Import
Lab Results Lab→Admin 2-5 days Receive→Test→Upload→Admin Approves
← Back to Simple Guide All Guides Farmer Guide