Admin Routes and Transport - hmislk/hmis GitHub Wiki

Routes and Transport

Overview

Routes are named delivery or collection circuits used by collecting centres and pharmacy distribution networks. Assigning a route to a collecting centre or user defines which delivery path they belong to, enabling route-based filtering of orders, dispatches, and collections.

When to Use

  • Setting up named routes for collecting centres (e.g. "Northern Route", "City Circuit")
  • Assigning users to routes so they can work on specific delivery runs
  • Bulk-uploading route assignments from a spreadsheet

Navigating to Route Management

  1. Click Administration → Manage Institutions
  2. Select Routes from the management index

Required privilege: AdminInstitutions

Creating a New Route

  1. Navigate to the route management screen (or the Add New Route page)
  2. Fill in:
Field Description
Name The name of the route (e.g. "Northern Circuit", "Morning Run")
Institution The institution this route belongs to — type to search (required)
Description Optional description of the route's coverage area or purpose
  1. Click Save

Managing Existing Routes

From the routes management screen (Manage Routes page), you can:

  • View all routes in a list
  • Edit route details
  • Delete a route

Bulk Upload

Routes can be bulk-uploaded from a spreadsheet using the Route Upload page in the institutions management index.

Assigning Users to Routes

Once routes are created, users can be assigned to them via the user management area. See User Routes for instructions.

Assigning Routes to Collecting Centres

When editing a collecting centre, the Route field (on the Basic Details tab) links the centre to a named route. See Collecting Centres for details.

Related Features