Skip to content

Roles & people · Role manual

Route agent

For the agent on the road — opening the journey, loading the vehicle, finding and registering customers, selling and taking pre-orders, delivering, collecting, and counting the vehicle at the end of the day.

5 min read

On this page

Welcome to the road. This manual follows your day in JupitaPos Route SalesPOS and points you to the guide for each job, with pictures of the real screens.

Who this manual is for

You sell from a vehicle, take pre-orders for the depot to deliver, or both. You find your own customers and register them on the spot. The stock in the vehicle is yours to account for until you close the day.

  • System role: Agent (agent).
  • What you see and what you do not: your own journey, your vehicle’s stock, your customers, your sales, deliveries and collections, and your close. Not other agents’ work, and not the approval of your own stock request.

Where you start

  • Your landing screen: Field sales → My journey.
  • What must be on: a vehicle and a supervisor assigned to you by the route manager; your position is shared only while you are on duty.
  • Working offline: yes — you sell, register customers and collect with no network; open Field sales → Sync when the signal is back.

A day at work

  1. Sign in — Sign in — and open your journey — Open your journey.
  2. Ask for the stock you need, and confirm what the store hands you — Ask for stock, approve, dispatch and confirm.
  3. At a new shop, register it where you stand — Find and register a customer.
  4. Sell from the vehicle or take a pre-order — Visit, sell and take pre-orders.
  5. Deliver confirmed pre-orders and collect what customers owe — Confirm and deliver pre-orders, Collect from a customer.
  6. Back at the depot, count the vehicle and close the day — Count the vehicle and close the day.

Guides you will use

Quick reference

I need to… Where Guide
Start the day Field sales → My journey Open your journey
Confirm what was loaded Field sales → Vehicle stock → To receive Vehicle stock
Register a new shop Field sales → My customers Register a customer
Sell Field sales → Sales on the road Sell
Collect a debt Field sales → Collections & close Collect
Send what you did offline Field sales → Sync No network

When something goes wrong

  • You cannot sell an item — it is not in your vehicle’s stock. Ask for it in a stock request, or take a pre-order.
  • Your request is still waiting — the supervisor has not decided it. You cannot approve your own.
  • No network — keep working; your sales are kept on the device and sent when you open Field sales → Sync with a signal.

Getting help

  • Your supervisor approves your stock and reviews your close.
  • The storekeeper dispatches what was approved.
  • The administrator fixes your account and your PIN.
  • The Help Center: Help & Training › Role-Based Manuals in the menu, or the ? at the top of any screen — Find help.

Manuals you can also read

  • Cashier — For the cashier at the till — opening the drawer, ringing up and taking payment, verifying mobile money and counting the drawer at the end of the shift. The till, the terminal and the point of sale; nothing else.
  • Route driver and collector — For the driver who hands over deliveries and the collector who takes payments on customers’ invoices — the vehicle, the hand-over, the money collected and the cash handed in.

What you can do

These are the permissions of the Agent role.

Area What you may do
attendance Clock in and out and take breaks at the time clock (attendance.clock)
cash Close a drawer and count cash (cash.close) ●
cash Open a cash drawer / declare a float (cash.open)
cash View drawer balances and cash reports (cash.view)
catalogue View Retail products, variants, codes and prices (catalogue.view)
customers Set a customer credit profile: limit, terms, hold (customers.credit) ●
customers View customers, their history and loyalty (customers.view)
dashboard View the dashboard (dashboard.view)
leave Request leave and see your own balance (leave.request)
notifications Receive and view own notifications (notifications.view)
payments Take payments on orders (payments.take)
payments View payments and refunds (payments.view)
reports View reports (reports.view)
route Collect payments against customers’ invoices on one’s journey (route.collections)
route Register customers and their outlets; edit the contacts of one’s own registrations (route.customers.register)
route Deliver pre-orders: what was handed over, to whom, or why not (route.deliveries)
route Open one’s own journey (an agent) (route.journeys.open)
route Share one’s position while on duty (route.locations.share)
route Take pre-orders for depot delivery on one’s journey (route.sales.presale)
route Sell from the vehicle whose stock one holds (route.sales.vehicle)
route Ask for stock for one’s own vehicle journey (route.stock.request)
sales Create orders and take sales (sales.create)
sales Refund a settled sale (sales.refund) ●
sales View orders and sales (sales.view)
shifts View shifts and rosters (shifts.view)
stock locations View stores and warehouses (stock_locations.view)
units View units of measure (units.view)