Module setup, access and navigation

Understand soft deletion and record retention

Remove supported records without breaking historic operational links.

Audience: Courier operations staffPermission: Courier: DeleteModule v2.0.0
Exact navigationAdmin Area → Courier & Logistics → Relevant register → Delete

What this guide covers

Remove supported records without breaking historic operational links. The instructions below follow the supplied module’s controller, form and model rules, including server-side validation and downstream effects.

Exact step-by-step process

  1. Open the exact record.
  2. Confirm it is not needed for an active assignment or workflow.
  3. Use Delete.
  4. Confirm the action.
  5. Verify it no longer appears in normal active lists while linked history remains intact.

Fields, choices and supported possibilities

This action uses the values already stored on the selected source record. Review that record before continuing.

Code-backed validations and workflow rules

  • The controller accepts only supported entity names.
  • Deletion is implemented as soft deletion for supported records.
  • Do not delete a record merely to correct a status; use the workflow action instead.

Expected result and verification

  • The source record, status/history and any downstream notification, provider, POD or finance record should agree after the action.

Errors and rejected actions

  • Permission denied means the role lacks Delete.
  • Unsupported entity or missing record is rejected.

Security, audit and operational checks

  • Use the exact record and least-privilege role before changing any state.
  • Verify the saved record after every action; a browser message alone is not evidence that every downstream step completed.
  • Use protected document and image routes rather than exposing server filesystem paths.
  • Keep customer, driver, provider, financial and credential data within the authorised workflow.
  • For provider, finance, employment, transport and compliance decisions, follow the organisation’s authorised professional process.
Do not bypass the code flowDo not force database values, invent a status, mark a job completed without signed POD evidence, or expose encrypted credentials to make a screen appear successful.