Workflows and statuses
The fixed steps of each kind of compensation case, who records each step, what a record needs before a case can open, and what every status means. The step and status tables on this page are read from the running system, so they always match it.
From property to payment
- ProjectOfficer creates it and sets its boundary
- PropertyCaptured in the field, registered, imported or drafted from the map scan
- ClaimantFound by NIN or registered, then linked and checked
- CompleteGaps filled, conflicts decided, spatial flags fixed or accepted
- CaseOfficer opens one or more: cash or 30% land, each with a scope
- StepsValuer, Finance and Officer record each step
A field survey is optional: the office can assign one at any time, for example to verify a property, and an approved survey still marks the property as Surveyed.
Rules the system enforces:
- A project can only become Active once it has a boundary.
- A case can only be opened when the property data is 100% complete, the claimant data is 100% complete (including a verified bank account), the claimant link is approved, there are no open conflicts on the property or its claimant, and there are no blocking spatial flags on the property. The Open case dialog lists whatever is missing, with links. An approved survey is no longer needed.
- A property can have several cases, but the land can be in only one live case (Whole property or Land only) and each item in only one live case. Cancelling a case frees its land and items.
- A property has at most one open survey. A survey can only be approved if the property has a linked claimant.
- Each step needs its figures before it can be recorded, and only roles with that step’s permission can record it.
- Steps go forward one at a time. They cannot be skipped or reversed; use Correct values for typos, or Dispute to stop a case.
Data completeness
Every property and claimant is checked against a list of rules. The share of rules met is its % complete; the rules not met are listed as Missing. It is worked out again on every save, from the office, the field app or an import.
| Property rule | Needed to save |
|---|---|
| Project | Always |
| Property type | Always |
| GPS position or boundary | In the field app |
| At least one photo | In the field app |
| Boundary outline | — |
| LGA | — (the office form and imports ask for it) |
| Ward | — |
| Items listed (or confirmed none) | — |
| Front view photo | — |
| Claimant linked | — |
| Claimant link approved (no conflict holding it) | — |
| Claimant rule | Needed to save |
|---|---|
| Full name | Always |
| Phone or NIN | In the field app |
| Photo | In the field app |
| NIN | — |
| Phone number | — |
| Bank, account name and account number | — |
| BVN | — |
| Bank account verified | — |
Every rule counts towards 100%, and a case can only open on complete records. Incomplete records are listed on Records › Fill the gaps.
Case scopes and case numbers
Each case has a number made from its project code, such as COMP-KSR-2026-01-0001, and a scope: what it pays for.
| Scope | Pays for |
|---|---|
| Whole property (land and everything on it) | The land and every item listed on the property |
| Land only | The land, no items |
| Buildings and structures | The items from the Building classification dictionary |
| Economic trees and crops | The items from the Economic trees and Crops dictionaries |
| Supplementary (top-up of an earlier case) | A top-up of an earlier case on the same property |
For example, a claimant can take the land as a 30% allocation (a Land only case) and, at the same time, the buildings and trees in cash (a Buildings and structures case and an Economic trees and crops case, or one cash case with all those items ticked).
Cash compensation (bank cheque)
When a case opens, each of its lines — every property item, the land (for cases that pay for it) — starts with today’s dictionary rate as a guide and no value. The Valuer gives each line their own figure on the case’s Valuation tab: a rate (× the quantity, which they may correct) or a lump amount; they can add other amounts such as a disturbance allowance, and an adjustment with its reason. No reason is needed for a figure that differs from the guide.
- The assessed value is the total of the lines plus the adjustment, worked out to the kobo. It is never typed.
- Every save is a version; earlier versions stay readable and can be compared.
- Valuated needs every line to have a figure (₦0 is a figure).
- Approved may use a different amount, with a minute saying why.
- After approval, only someone who can correct recorded values may change the valuation; the case then goes back to Valuated. Once a cheque is issued the valuation is final; a supplementary case tops up its lines.
30% land allocation
The land area acquired is taken from the property’s boundary (or, without one, the approved survey or the recorded land area). When the case is valuated, 30% of it is calculated and recorded as the area to allocate back to the claimant.
Side states: disputed and cancelled
| Status | How it happens | What it means |
|---|---|---|
| Disputed (on hold) | Dispute, with a reason (comp.hold) | Paused at its current step. Nobody can advance it. Resolve & resume returns it to the step it was on. |
| Cancelled | Cancel case, with a reason and a second click (comp.hold) | Closed for good. Its land and items are freed, so a new case can be opened for them. |
Property stages
A property’s stage is never typed in; it is worked out from its claimant, survey and case.
Survey statuses
In the field app, a survey saved on the phone shows Waiting to sync until it uploads, or Upload problem if the office refused it. Properties captured under Field capture show Not synced, Photos waiting, Sync problem or Changed in office; see the Field Surveyor guide.
Identity and bank check results
Project statuses
A project can only become Active once its boundary is set. Otherwise project status is for information and filtering; it does not block any work.
Conflict statuses
Conflicts are raised by field sync and imports when new information clashes with what is on record. See the Compensation Officer guide.
Spatial flag statuses
Spatial flags are found on every boundary change and every night. See Spatial flags.
Background job statuses
Staff statuses
Message statuses
Each recipient also has a status: Queued, Sent or Failed (with the reason). Failed deliveries can be retried from the message.