> For the complete documentation index, see [llms.txt](https://docs.flowretail.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowretail.com/docs/getting-started/software-clients/assistant/order-handling-and-picking.md).

# Order handling and picking

Pick web shop orders and click-and-collect orders on the handheld or a phone: take the next order in the queue, scan the items off the shelf, and complete the order when everything is in the box. Several people can pick at the same time without picking the same order twice.

## The Orders tab

The **Orders** tab shows the orders waiting to be picked in your store, oldest first. The badge on the tab shows how many new orders are waiting. Under the title you see how many orders are left to handle and how many were completed today.

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FXQZXpPYMAXTXPWcr9a1l%2Forder_handling-01_orders_tab-dd393fe9.png?alt=media" alt="The Orders tab with handlings, statuses and the queue of orders" width="300"><figcaption><p>The queue on the Orders tab</p></figcaption></figure>

* The first row picks the handling, for example **Web orders** or **Click and collect**, or **All**. The number is the new orders in each.
* The second row picks the statuses to show: **New**, **In progress** and **On hold**. Tap a status to show or hide it.
* Search by order number or customer, or scan the order's receipt to open it right away. The filter button has more choices.

{% hint style="info" %}
The **Orders** tab is there when order handlings are set up in Flow Admin. Canceled orders are never shown in the queue or counted.
{% endhint %}

## Take an order

Tap an order to start picking it. A new order is set to **In progress** in your name at once, so your colleagues don't start on the same one.

If someone else took the order just before you, the app says so. Tap **Take the next one** to start on the next new order instead, or **Open anyway** if you are picking it together.

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FceW3oMSGS3vPVcz2nPQ3%2Forder_handling-02_order_taken-06a14f19.png?alt=media" alt="Someone else already took the order, with Take the next one and Open anyway" width="300"><figcaption><p>Someone else was faster</p></figcaption></figure>

## Pick the items

At the top you see the customer, the store and channel, and any note from the customer or internal note. Below that, every line shows the product, variant, location on the shelf and stock.

Scan each item as you take it off the shelf, or tap **+** on the line. **All** picks the whole quantity of a line at once. A picked line turns green, and the bar at the top counts how many items are picked.

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FVhXTWXIvPd6SutrXkGfe%2Forder_handling-03_picking-33bd7bd8.png?alt=media" alt="An order being picked: notes, progress and the first line picked" width="300"><figcaption><p>Picking an order</p></figcaption></figure>

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FndlFtNUFpmGBDyaspdFJ%2Forder_handling-order_handling_pick_by_scanning-fc139f60.webp?alt=media" alt="Scanning two mittens and a hat: each scan opens the line, Pick takes them, and the line turns green" width="300"><figcaption><p>Pick by scanning: scan, scan again for one more, then <strong>Pick</strong></p></figcaption></figure>

When a line has more than one item left, scanning it asks how many you have in hand. Scan again for one more, or tap the number, then tap **Pick 2** (the button shows the number you chose).

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FxctA4RggXMdj04fXnhqn%2Forder_handling-04_pick_quantity-bf27b925.png?alt=media" alt="How many do you have in hand? with 1, 2 and All 3" width="300"><figcaption><p>How many do you have in hand?</p></figcaption></figure>

Tap a line to see where to pick it from: the stock and location in each warehouse. Here you can choose another warehouse, add a note to the line, or order the product from the supplier (if you have access to purchasing).

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FV35tODjPkVouJNfetHIh%2Forder_handling-05_line_details-83225de6.png?alt=media" alt="Line details with stock and location per warehouse" width="300"><figcaption><p>Where to pick the item from</p></figcaption></figure>

{% hint style="info" %}
If you scan something that isn't on the order, or a line that is already picked, the scanner warns you and nothing is counted.
{% endhint %}

## Notes, labels and more

The buttons at the bottom print what you need for the order:

* **Print pick note** prints the whole order, before you have picked anything.
* As soon as something is picked, the same button becomes **Shortage note** and prints only the items that are still missing.
* The right button prints a pickup label on the device's label printer, or creates the shipping label when the order is sent with a carrier.

Press and hold a print button to choose another printer. **⋯** at the top opens more options: show the order, put it on hold, print the full pick note, notes on the order, and more.

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FJjgKwlFXCQd867F0o0PN%2Forder_handling-06_more_options-dbe2ffd0.png?alt=media" alt="More options for the order" width="300"><figcaption><p>More options</p></figcaption></figure>

## When something is missing

If an item isn't on the shelf, tap **Complete with 1 missing** (the button counts what is missing). The app lists what is missing, and you choose:

* **Print shortage note and put on hold**: stick the note on the order and put it aside until the items are in place.
* **Complete anyway**: only if the customer accepts the order without them.
* **Continue picking**: go back to the order.

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FhOTMb97ALlJIbfbDfbig%2Forder_handling-07_missing_items-d683deea.png?alt=media" alt="Not everything is picked, with the missing item and three choices" width="300"><figcaption><p>Not everything is picked</p></figcaption></figure>

If you leave an order before it's done, the app asks which status it should keep: **In progress** (you or a colleague carry on later), **On hold** (waiting for items or the customer), or **New** (back in the queue). Tap **Save and close**, or **Keep picking** to stay in the order. With **In progress** or **On hold**, what you picked is kept on this device, so you can carry on where you left off.

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2Fz1EiZTe4MRFYpBhBYXfP%2Forder_handling-08_close_status-d920d07b.png?alt=media" alt="Close the order? with In progress, On hold and New" width="300"><figcaption><p>Leaving an unfinished order</p></figcaption></figure>

## Complete the order

When everything is picked, tap **Complete picking**. If a product needs a serial number, the app asks for it first.

If the handling sends the customer a message, check the e-mail address or phone number and the text, then tap **Confirm and complete**. The order is then completed in Flow, and the customer gets the message.

<div><figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FKKbmy1v3VsgmSGMaRRFz%2Forder_handling-09_complete-05136de3.png?alt=media" alt="Complete the order with an e-mail to the customer" width="300"><figcaption><p>Message to the customer</p></figcaption></figure> <figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FlDBgwdzo7DW7fk8hy6B5%2Forder_handling-10_completed-81966c98.png?alt=media" alt="The order is completed, with Start next and Back to the list" width="300"><figcaption><p>Completed</p></figcaption></figure></div>

Tap **Start next · #20432** (with the number of the next order) to go straight to the oldest new order in the same handling, or **Back to the list**.

{% hint style="success" %}
With the Start next button you can pick one order after another without going back to the list. When there are no more new orders, the app tells you.
{% endhint %}

## Alert for new orders

When a new order comes in while the app is open, the device plays a sound, vibrates and shows a card at the top of the screen. Tap **Open** to go to the orders, or **Mute 1 hour** for some quiet. The card hides by itself after a few seconds, and the new orders are counted on the **Orders** tab.

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FSk9jZAjEgoEr679y6rmU%2Forder_handling-11_new_order_alert-7f079cac.png?alt=media" alt="Alert at the top of the screen: New order in Web orders, 3 orders waiting" width="300"><figcaption><p>A new order has come in</p></figcaption></figure>

You get at most one alert every half hour; orders that come in meanwhile are included in the next one. To choose which handlings alert on this device, tap **Setup** on the card, or go to **More** › **Settings** › **Alert for new orders**. All handlings are on to begin with.

<figure><img src="https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FQbYUKoE4gAiOFMZD0T2U%2Forder_handling-12_alert_settings-565cb68f.png?alt=media" alt="Settings with a switch per order handling under Alert for new orders" width="300"><figcaption><p>Choose which handlings alert</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flowretail.com/docs/getting-started/software-clients/assistant/order-handling-and-picking.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
