> ## Documentation Index
> Fetch the complete documentation index at: https://help.rekkeh.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Receive and Manage Parcels

> Learn how to receive, store, mark ready for collection, and confirm parcel collection using the Deliveries module in Gate Ops.

The Deliveries module in Gate Ops lets you receive parcels at the gate, record their details, store them, and track them through to collection. Every action is recorded in the delivery timeline so you and residents can stay informed.

<Note>
  Deliveries is only available when your facility has the deliveries module enabled. If it is disabled, the app returns "Deliveries are not enabled for this facility."
</Note>

## Access the deliveries list

Open **Deliveries** from **Profile > Operations**. The list subtitle reads "Parcels received at the gate, waiting for collection."

Use the search bar or the filter tabs to find parcels:

| Filter               | Description                                                     |
| -------------------- | --------------------------------------------------------------- |
| All active           | Parcels currently at the gate, regardless of status.            |
| Expected             | Parcels residents have created in advance via the Resident app. |
| Ready for collection | Parcels the recipient has been told to collect.                 |
| Collected today      | Parcels collected today.                                        |
| Exceptions           | Parcels marked as returned, lost, or cancelled.                 |

Each row shows the reference, status, recipient, courier, package summary, received time, and storage location (or "No location").

* Empty list: "No parcels waiting" with "Receive a delivery at the gate to start tracking it."
* No search match: "No deliveries match" with "Try a different status or search."

## Receive a delivery

<Steps>
  <Step title="Start receiving">
    On the Deliveries screen, select **Receive delivery**.
  </Step>

  <Step title="Select the recipient">
    Under **Recipient**, search by name or phone and select the person. If no match is found, the app shows "No people match that search."
  </Step>

  <Step title="Choose the courier">
    Under **Courier company**, choose DHL, FedEx, UPS, Jumia Logistics, GIG Logistics, or **Other…** and enter the company name.
  </Step>

  <Step title="Set package details">
    Under **Package**, set **Count** (default 1, range 1 to 99) and choose the type: Box, Envelope, Bag, Pallet, or Other.
  </Step>

  <Step title="Add optional details">
    Expand **Add courier contact, tracking & notes** to optionally fill in courier name, courier phone, tracking number, storage location, notes, and parcel photos (up to 5).
  </Step>

  <Step title="Mark as received">
    Select **Mark as Received**.
  </Step>
</Steps>

If required fields are missing, the app shows "Select a recipient to continue" or "Enter a courier company to continue." On success, the app shows "{reference} received" and opens the delivery detail page.

<Tip>
  You can take up to 5 parcel photos. Tap **Take parcel photo** to capture an image. Once the limit is reached, the action reads "Photo limit reached." If camera or library access is denied, enable it in your device Settings.
</Tip>

## Store the parcel

This action is only available while the parcel status is **Received**.

<Steps>
  <Step title="Open the delivery detail">
    On the delivery detail page, select **Store parcel**.
  </Step>

  <Step title="Enter the storage location">
    Enter the **Storage location**, for example "Main Gate — Locker B12". This is required.
  </Step>

  <Step title="Confirm storage">
    Select **Store parcel**. The status changes to **Stored**.
  </Step>
</Steps>

## Mark ready for collection

This action is available from **Received** or **Stored** status.

On the delivery detail page, select **Mark ready for collection**. The status changes to **Ready for collection** and runs immediately without a confirmation prompt.

## Confirm collection

This action is available from **Ready for collection** status.

<Steps>
  <Step title="Start collection">
    Select **Confirm collection**.
  </Step>

  <Step title="Review the prompt">
    Review the prompt: "Confirm collection? The recipient is collecting the parcel."
  </Step>

  <Step title="Confirm">
    Select **Confirm collection**. The status changes to **Collected**.
  </Step>
</Steps>

If the person collecting is not authorized, the app shows "This person is not authorized to collect this parcel."

## Handle an exception

Use exception actions when a parcel cannot be collected as planned.

| Action            | Available from                         | Result                                                                      |
| ----------------- | -------------------------------------- | --------------------------------------------------------------------------- |
| Return to courier | Received, Stored, Ready for collection | Confirm "Return this parcel to the courier?" — status becomes **Returned**. |
| Mark lost         | Received, Stored, Ready for collection | Confirm "Mark this parcel as lost?" — status becomes **Lost**.              |
| Cancel            | Expected, Received                     | Confirm "Cancel this delivery?" — status becomes **Cancelled**.             |

Every action is recorded in the delivery **Timeline**. The timeline includes:

* Delivery created
* Received at gate
* Stored
* Marked ready for collection
* Collected
* Returned to courier
* Marked lost
* Cancelled

<Note>
  Residents can create an expected delivery beforehand from **My Deliveries** in the Resident app. Expected deliveries appear under the **Expected** filter and can be received at the gate.
</Note>
