Manage grievances#

This guide is for users — GRM officers, supervisors, and intake staff who receive, investigate, and resolve complaints in OpenSPP.

What you will do#

Log a complaint, assign it to a team, investigate, record a decision, and close the ticket. Optionally escalate to case management when a complaint requires longer-term support.

Before you start#

You need one of these roles:

Role

What you can do

GRM Officer

Create and manage tickets assigned to you

GRM Supervisor

Review, approve, and reassign tickets

Field Officer

Submit tickets during field visits

If you cannot see the Helpdesk menu, contact your administrator to assign you a GRM role.

Initial setup (case managers only)#

A GRM manager or an admin must complete this configuration before your team can receive complaints. If this has already been done, skip to Step 1.

Categories and subcategories

Go to Helpdesk > Configuration > Categories. Create the complaint categories your organization uses (for example, Eligibility, Payment, Benefits). Add subcategories under each.

Channels

Go to Helpdesk > Configuration > Channels. Define how complaints come in — Walk-in, Phone Call, Email, Portal. These record the intake method on each ticket.

Teams

Go to Helpdesk > Configuration > Teams. Create teams of handlers. Assign a manager, members, and optionally the geographic areas each team covers.

GRM configuration menu showing categories, channels, teams, and SLA options

Steps#

Step 1. Log the complaint#

  1. As Admin, GRM or Field officer, Go to Helpdesk > Tickets and click New.

  2. Fill in the ticket form:

Field

What to enter

Subject

A short description of the complaint

Category

What the complaint is about

Subcategory

More specific classification

Channel

How it was received (Walk-in, Phone, Email, Portal)

Registrant

Search and link to the affected person or household

Description

Full details of the complaint

  1. Click Save. The ticket is now in the New stage.

New ticket form showing subject, category, channel, and registrant fields

Step 2. Assign the ticket#

  1. On the ticket, select the Team responsible for this complaint.

  2. Assign a specific Handler (GRM officer) from the team.

  3. The assigned officer receives a notification.

Ticket form showing team and handler assignment fields

Tip

If CEL routing rules are configured, the team may be assigned automatically based on the ticket's category or the registrant's area.

Step 3. Investigate and move through stages#

The standard ticket workflow is:

New → In Progress → Resolved → Closed
  1. Move the ticket to In Progress when you begin working on it.

  2. Use the chatter at the bottom of the ticket to record notes, attach documents, and communicate internally.

  3. If the complaint involves a program or payment, check the linked program and entitlement details in the Resolution tabs.

Ticket kanban board showing tickets grouped by stage

Step 4. Record the decision#

When the investigation is complete:

  1. Set the Decision field on the ticket:

Decision

When to use

Upheld

The complaint is valid and the beneficiary is right

Partially upheld

The complaint is valid in part

Rejected

The complaint is not valid

Withdrawn

The beneficiary withdrew the complaint

Redirected

The complaint was transferred to another officer

Referred

The complaint was sent to another body

  1. Add a Resolution note explaining the outcome.

  2. Move the ticket to Resolved by clicking Resolve.

Step 5. Escalate to case management (optional)#

Use this step when the complaint reveals a need for longer-term support (for example, a vulnerable household needs follow-up assistance). If no escalation is needed, skip to Step 6.

  1. On the ticket, click Escalate to Case.

  2. In the wizard, choose or confirm the case type and assigned case worker.

  3. Click Escalate. A linked case is created automatically.

  4. The ticket and case remain linked — navigate between them using the smart button at the top of each record.

Escalate button and escalation wizard dialog

Ticket form showing the linked case smart button

Step 6. Close the ticket#

  1. The ticket is automatically marked Done when clicking resolve.

  2. The ticket becomes read-only and the outcome is recorded for reporting.

Are you stuck?#

The Helpdesk menu is missing.

  • The module may not be installed, or you do not have a GRM role.

  • Ask your administrator to check your user role. You need at least GRM Viewer.

The ticket is not routing to the right team.

  • Automatic routing requires CEL routing rules to be configured.

  • If you are assigning manually, make sure the team is set up in Configuration > Teams with the correct areas and members.

The Escalate button is missing.

  • This button only appears when the Case Management module (spp_case_base) is installed.

  • Ask your administrator to install Case Management.

I cannot change the ticket's stage.

  • Some stage transitions are restricted by role.

  • Check with your GRM manager — certain stages require manager approval before advancing.