---
title: "Customer portal: creating and planning orders shown in customer portal views"
description: "Set the order status in organization settings, on the transportation service or in the customer profile. Let portal customers edit and cancel orders with the customer portal order import feature."
url: https://help.qargo.com/us/articles/316497-customer-portal-creating-and-planning-orders-shown-in-customer-portal-views
locale: us
updated: 2026-09-07
---

# Customer portal: creating and planning orders shown in customer portal views

## Introduction {#h_0200b9a2e7}

The customer portal gives customers a seamless order capture experience for the orders they submit. However, customers can select only some of the order parameters.

To keep order capture consistent, default or pre-filled order details can be configured. The order status for newly submitted orders (Quote / To plan) can also be set.

:::callout{tone="note"}
📚 By default, orders submitted through the portal cannot be edited once submitted. If the tenant has the **Customer portal order import** feature enabled, portal customers can be allowed to edit and cancel their own orders.\
See below 👉 [Enabling order edit and cancel](#h_5031c60cbe)
:::

-   The order status can be set in 3 locations:

    -   **_Organization settings_**: This is the default setting. It applies if no other settings are added. _Set this as a minimum._
    -   **_Transportation service_**: This takes priority over the default setting.
    -   **_Customer profile_**: This is the primary setting if included.

-   Order status options:

    -   **_Quote:_** When the customer submits the order through the portal, it is created and shown as a **Quote** until it is processed further.

        -   The customer sees the assigned quote number in the portal under the All tab.
        -   In the tenant, the quote appears in the Quote tab rather than under orders.
        -   Once the quote is accepted and sent to planning, a new order number is generated.
    -   **_To plan:_** When the customer submits the order through the portal, it is created and shown as an order with the status **'To plan'**.

        -   The order number stays the same for the duration of the load.

The system uses _fallback logic_ to decide which customer portal status field applies when an order is created in the customer portal:

1.  **Status on customer**: If the customer has a value, the system uses it.
2.  **Status on transportation service**: If the customer field is empty, the system falls back to the value on the transportation service.
3.  **Status on tenant**: If both the customer field and the transportation service field are empty, the system uses the value set for the tenant.

* * *

## Configure order defaults  {#h_cb3c7c581a}

### Organization settings {#h_e96822992f}

-   Navigate to **Configuration > Organization settings > Customer portal**
-   Under _Customer portal order creation statuses_, select how orders are created when a customer submits an order in the portal.

    -   Options: Quote / To plan, as described above.

### Transportation service {#h_1f6440ee42}

-   Navigate to **Rates > Order input**
-   In the left-hand menu, select **Transportation services**. This shows all configured services.
-   Click the service. Navigate to **Customer portal permissions**.

![](https://help.qargo.com/media/9db17e5a9fea-image.png)

1.  Customers who can select this service. Make the service available to all customers with portal access, or to specific customers only.
2.  Default customer portal order status. Select the default status for orders that customers submit through the portal: **Quote** or **To plan**.
3.  Cutoff for orders with same-day pickup.

    1.  No cutoff for same-day pickups. Customers can submit orders with any date and time for same-day pickup.
    2.  Orders must be entered 1 day before pickup. A cutoff time must also be specified. Customers cannot submit an order for pickup on the same day.
    3.  Define a cutoff time for same-day orders. A cutoff time must be specified. Customers can submit an order for same-day pickup, provided they submit it before the cutoff time.

### Customer profile {#h_ea5ef9c9c7}

-   Navigate to **Companies > Customers**
-   Click the customer name to open the profile. If the customer is not in the list, find the customer with the search box.
-   In the customer profile, scroll to _Create order: default values_. Select the preferred status from the dropdown menu.

![](https://help.qargo.com/media/cbe1ab82bf1a-ScreenFloat-Shot-of-Google-Chrome-on-2026-01-25-at-14-54-54.png)

#### Set order default values {#h_fede8c0754}

-   **_Default order values_** can also be added here.

    -   These can include order details that are the same every time an order is submitted.
    -   Once all the details are added, click **Save**.

![](https://help.qargo.com/media/0d361c37833d-image.png)

-   When a customer creates an order in the portal, the order details are pre-filled. This further reduces the data entry the user has to do.

Carriers using Qargo's customer portal for groupage orders can now make piece dimensions (length, width, height) mandatory when shippers place orders. This ensures complete data and accurate loading meter calculations.

* * *

### Configure required freight details {#h_a603017694}

:::callout{tone="info"}
📚 Make sure the additional fields are enabled under **Configuration > Additional fields > Orders > Freight**.
:::

1.  In the **Default fields** section, locate the **Width**, **Length**, and **Height** fields.
2.  For each dimension to **make mandatory**, click the field and turn on the **Required** toggle.

![](https://help.qargo.com/media/ffd86c8fd5fb-image.png)

![](https://help.qargo.com/media/47c1d2361103-image.png)

* * *

### How it works for customers {#h_141c6c1cc8}

Once at least one dimension is marked as **Required**:

-   The **piece dimensions panel** (with the Length, Width and Height fields) is **automatically displayed** to customers when they place an order in the portal, even if they would not normally see it.
-   Customers cannot submit the order until they fill in the required dimension fields.

![](https://help.qargo.com/media/839971855e4e-image.png)

### Limitations {#h_40ed795c9f}

-   **Global configuration only.** The required dimension settings **apply to all customer** portal users. Dimensions cannot be required for one customer and optional for another.
-   **Customer portal only.** This requirement applies to orders placed through the customer portal. It does **not** apply to:

    -   Orders created through the **mobile app or carrier portal**
    -   Orders imported through **order import**
    -   Orders created directly in the Qargo web interface

### Disabling the fields {#h_e28f5a09ba}

Besides being enabled or required, dimension fields can also be **disabled** entirely. A disabled dimension field does not appear in the portal and is not pre-filled on the order.

-   Disabling a dimension field does not affect existing orders that already have dimensions entered.

* * *

### Display charges {#h_30d96a672c}

-   In the customer profile, scroll down to the _Contacts_ panel.
-   Turn on the **_Show charges on customer portal_** option.
-   Navigate to the relevant price list and set the invoice process to **Approval request sent to customer**.
-   With this option turned on, the user can **view** the charges on the order in the portal.

-   Charges that require approval can also be handled in the portal.
-   Approved or rejectable charges are visible for all orders, not only during billing. This keeps every stage of the order process transparent.
-   Where approval is required, a 'To approve' label is displayed.
-   Hovering over the label shows the option to approve or reject the charge.
-   Once handled, the charge updates in both the portal and the tenant.

![](https://help.qargo.com/media/d11652f7d95c-image.png)

Approve a charge:

::video{src="/media/video/98581f8f305c-2025-07-29_15-28-21-1-.mp4"}

Reject a charge:

::video{src="/media/video/b93e842519e0-2025-07-29_16-08-29-1-.mp4"}

* * *

## Customer portal: hide excluded stops and the Empty option {#h_dfccfc3176}

The route planning and optimization settings already control which stops are excluded from the price calculation. This now extends to the customer portal: the selected stop types can also be hidden from the portal route timeline.

A new _Empty_ option has been added to the _Ordered route: stops to exclude_ dropdown. It covers stop activities marked as empty, such as hooking an empty trailer or picking up and dropping an empty container.

Previously, the customer portal showed end customers every operational stop. This included terminal stops, parking, hook and drop activities, empty container moves and day-boundary stops.

The new _Hide excluded stops on customer portal_ toggle removes the selected stop types from the portal timeline entirely. The timeline then matches the visualized order route.

**To configure the setting:**

1.  **Open** **Configuration > Organization settings > Route planning & optimization**.
2.  **Select** the stop types to hide in _Ordered route: stops to exclude for price calculation_, including the new _Empty_ option.
3.  **Turn on** the _Hide excluded stops on customer portal_ toggle.

![](https://help.qargo.com/media/edb2845e7c14-Screenshot-2B2026-06-25-2Bat-2B13_37_22.png)

The toggle is off by default for existing tenants and on by default for new tenants. The setting applies during route calculation. It takes effect on new orders, or when an existing order route is updated.

:::callout{tone="note"}
‼️ When the toggle is on, the selected stop types are removed entirely from the customer portal route timeline, with no gaps or grayed-out placeholders. Portal users can also no longer create orders that contain those stop types. Hiding applies to the selected stop types across the whole tenant and cannot be configured for individual end customers.
:::

* * *

## Enabling intermodal booking visibility {#h_27cebb8f25}

1.  **Navigate** to **Configuration > Organization settings > Customer portal settings**
2.  **Turn on** the _Show ferry booking data_ toggle
3.  **Save**. The _Booking_ section is now visible to all portal users on this tenant

![](https://help.qargo.com/media/4349149e3545-image.png)

:::callout{tone="info"}
🧰 The toggle is off by default. When it is off, no _Booking_ section or empty placeholder appears in the portal.
:::

## What end customers see {#h_6cda81fb3e}

When the toggle is on, a read-only _Booking_ section appears on the order detail page in the customer portal. It appears for orders with an active intermodal booking. The section shows:

-   _Booking name_
-   _Booking status_ (e.g., Requested, Booked)
-   _Booking reference_: the reference number assigned by the carrier
-   The from and to stop locations of the intermodal connection

The section is hidden automatically when:

-   The toggle is off
-   The order has no active intermodal booking
-   The booking is canceled

End customers cannot edit any booking fields in the portal.

::video{src="/media/video/04f9213b00a1-2026-06-15_17-27-47--1-.mp4"}

## Limitations {#h_efd11f51aa}

-   The operations status (e.g., Checked in, On board, Sailed) is not shown. Planners can view it in **Planning > Intermodal**
-   Departure and arrival times are not shown, only the from and to stop locations
-   The setting applies to the whole tenant and cannot be turned on or off for individual end customers
-   Only intermodal bookings are visible. Warehouse bookings and customs pre-notifications are excluded
-   The displayed fields cannot be configured

## Troubleshooting {#h_41222e8fca}

| **Issue** | **Likely cause and resolution** |
| --- | --- |
| _Booking_ section not visible in the portal | The toggle is off.\
**Turn on** the _Show intermodal booking on customer portal_ toggle under **Organization settings > Customer portal settings** |
| _Booking_ section not visible although the toggle is on | The order has no active intermodal booking, or the booking is canceled.\
Check in **Planning > Intermodal** that the order has an active intermodal booking that is not canceled |
| Warehouse or customs pre-notification bookings not shown | Only intermodal bookings are shown.\
Warehouse bookings and customs pre-notifications are excluded in this version |

* * *

## Provision order import features (Qargo and Super Admin only) {#h_dcb3f559da}

-   Select:

    -   **_Customer portal order import >_ Provision**

![](https://help.qargo.com/media/93ae8e0e24eb-image.png)

:::callout{tone="note"}
‼️ Once the feature is **provisioned**, the fields that configure the order import functions are displayed.\
Turn off **_'Customer portal order creation via order import enabled'_** to return to the previous order behavior.
:::

![](https://help.qargo.com/media/ea53bbc6b7af-image.png)

![](https://help.qargo.com/media/a941a871e7e5-image.png)

:::callout{tone="note"}
🧰 This cannot be configured for individual customers. Once enabled, it is available to all customer portal users.
:::

### Enabling order edit and cancel {#h_cb6b7f3e30}

:::callout{tone="info"}
📚 To train customers on these new features, share the training walkthrough article [Customer portal walkthrough](https://help.qargo.com/us/articles/133782-customer-portal-walkthrough#h_59114e8fc4).
:::

Once enabled, this feature gives **portal customers the ability to edit or cancel orders** **they have already submitted**.

-   Under **Customer portal order import**, users can set the preferred order import workflow.
-   To let customers update submitted orders, turn **the 'Enable updates' toggle on**.
-   The **Automation** panel has three new toggles:

    -   _Automatically create orders:_ Portal orders are automatically created as transportation orders

        -   When this is off, users must manually approve customer-submitted orders on the **_'Order imports' page_**
        -   Click **_'Create order'_** to verify and save the order

    ![](https://help.qargo.com/media/173002c2f013-image.png)

    -   _Apply changes automatically:_ Portal customers can edit the details of a submitted order, provided it has not been picked up yet

        -   Only available if **_'Enable updates'_** is turned on.
        -   Where updates are not accepted automatically, users must approve them on the **_'Order imports'_** page
        -   Customer portal users see update requests as _'Update awaiting approval'_ and under the **_'Waiting for approval'_** tab

![](https://help.qargo.com/media/19ac0889b166-image.png)

![](https://help.qargo.com/media/0d4857eab620-image.png)

-   Set a status to block updates beyond a specific point in the workflow:

![](https://help.qargo.com/media/cb12d3a9b217-image.png)

-   _Apply cancellations automatically:_ Portal customers can cancel a submitted order, provided it has not been picked up yet.

    -   Set a status to block updates beyond a specific point in the workflow:

![](https://help.qargo.com/media/b50fa53e29d4-image.png)

### How it works {#h_b9861c1831}

-   To submit a new order, portal customers **must use a unique customer reference**. Otherwise, the user sees an error

    -   This reference number links the portal order to the TMS order.

![](https://help.qargo.com/media/60c02ce2616c-image.png)

:::callout{tone="info"}
📚 Set the customer reference number field to 'Always show' on the order form. This helps customer portal users fill in the required information.
:::

-   Once submitted successfully, the order appears in the order list view with the 'Portal' label.

    -   If **_'Automatically create orders'_** is **not set**, all orders must be updated manually in the 'Order import' tab

![](https://help.qargo.com/media/f25e8b3f9fb1-image.png)

-   If orders submitted by customers generate a quote first, the quotes appear in the Quote tab with the 'Portal' label.

![](https://help.qargo.com/media/7a754e1a4082-image.png)

-   Portal customers see **'Edit' and 'Cancel' options** **on eligible orders.**

![](https://help.qargo.com/media/866510a85bcb-image.png)

-   When automatic updates are enabled, changes submitted by the customer update the order in the TMS automatically.

    -   Portal users see the label _'Update awaiting approval'_ until the order is opened in the carrier account. Opening the order 'approves' the update.
-   Where automatic updates **are not enabled**, customers can still edit the order. The carrier then sees an **'Update'** label on the order

    -   Click the update to open the revised order.
    -   Validate and save the update.

![](https://help.qargo.com/media/20efc4757172-image.png)

::video{src="/media/video/1190783d9b49-2026-02-23_15-30-37--281-29.mp4"}

:::callout{tone="info"}
📚 Only orders created through the new order import flow can be edited or canceled this way. Orders created through the previous portal flow remain non-editable. New orders submitted through a third-party integration also **cannot be edited or canceled** by the portal user. These options are 'grayed out'.
:::

![](https://help.qargo.com/media/84315164a208-image.png)

* * *

### Troubleshooting order import {#h_120f816883}

**The customer reference error appears, but there is no visible place to enter the reference number.**\
Unless the field is set to 'Always show', the customer reference field is under the **'+ Add information' link** in General details on the order form. The recommendation is to set this field to **'Always show'**, so that it appears as a field on the order form.

![](https://help.qargo.com/media/6ab0ce10289b-image.png)

![](https://help.qargo.com/media/b75b6267e284-image.png)

* * *

**Customers cannot autoprint labels after creating an order in the customer portal. This used to work. Why does it no longer work?**\
When the order import workflow is enabled and a customer submits an order in the portal, the order is not created in the customer portal immediately; this depends on approvals. The order import workflow includes approval automation for the order, which can cause a delay. Once the order is approved, the customer portal user can download the label manually. If this affects autoprinting and the customer wants to return to the previous behavior, **turn off _'Customer portal order creation via order import enabled'_.** This restores the previous order behavior, including autoprinting. However, the customer **will not** be able to **edit or cancel orders.**

![](https://help.qargo.com/media/84796caa030d-image.png)

* * *

**Order import error showing _'Not allowed to create or update the order after the cutoff time'_. How can this be fixed?**\
This error appears because a lead time applies to the transportation service or service level selected on the order. The customer submitting the order does not see this error, so users can decide whether to override the lead time.\
Click the _'Fix the error'_ option. This opens the order capture page so the user can correct the data and save the order.

::video{src="/media/video/d24dd38186d1-2026-02-23_14-50-10--281-29.mp4"}

* * *

**A customer submitted an order, then made a change that needs manual approval. On review, the location was outside the delivery area, so the order cannot be accepted. The order was canceled, but how does the customer find out?**

When the customer portal is not set up to accept automatic order creation, orders go to the Waiting for approval tab. If the carrier then decides not to carry out the order, it moves to the Canceled tab.\
​\
When the customer cancels an order that is in the Waiting for approval tab, it also appears in the Canceled tab.

* * *

## Share planned and actual load times via a task flag {#h_b817303d64}

Control which loads share planned and actual times in the customer portal by turning on a task flag. Estimates and confirmed times then appear only when they are reliable.

🎥 This video explains how to share load times, and also how to grant access to the customer portal and enable exports for customer portal users:

::embed{src="https://watchclueso.com/embed/jxzf2fbdu0fbw2qu"}

## Prerequisites {#h_307f2e479c}

-   A resource-allocation load task must exist under **Configuration > Tasks > Loads**.
-   Super Admin rights are required to edit tasks in Configuration.

## Use cases {#h_3ab8286164}

-   A carrier wants end customers to see a _confirmed delivery time_ only after a planner has verified the load. This avoids calls triggered by rough planning estimates.
-   A logistics team shares actual completion times for delivered loads. Customers get an accurate record without seeing unconfirmed estimates.

## Enable time sharing on a load task {#h_76f940bf1e}

1.  **Navigate** to **Configuration > Tasks > Loads**.
2.  **Open** the resource-allocation task that runs when a load is planned, or create one.
3.  **Turn on** the **Share load planned/actual times to the customer portal/API** toggle, next to **Re-dispatch automatically if load changes**.
4.  **Save** the task configuration.

:::callout{tone="note"}
Once enabled, this toggle shows the full planned times for each leg: the date and time together. It is not currently possible to show the date only.
:::

## Share times for a specific load {#h_c752532a02}

1.  **Plan** the load and assign resources as usual.
2.  **Complete** the load task that carries the **Share load planned/actual times to the customer portal/API** flag. Completing this task starts sharing the load's times with the customer.
3.  **Check** the customer portal order list. It now shows the planned date and time for the load.

## What the customer sees in the portal {#h_60298f5fd6}

By default, the portal shows no estimated times: the customer sees only the requested time. Once a flagged load task is completed, the portal shows the shared times:

-   The order list shows the planned date and time for the load.
-   On the order detail, while the load is still planned and not yet confirmed, only the date is shown, with a 'To confirm' tag.
-   If the flagged task has been completed but the load is not yet completed, the actual date and time are shown.
-   Once a stop is completed, the exact completion time is shown. A completed load always shows the completion times, even if the flagged task was not run.

:::callout{tone="note"}
📚 This shares the planned and actual times that Qargo already holds. It does not add a live-updating ETA. A shared planned time is the time set during planning and does not update while the load is in progress.
:::


## Related articles

- [Customer portal: create orders from templates](https://help.qargo.com/us/articles/685597-customer-portal-create-orders-from-templates.md)
- [Customer portal: Giving access to the customer portal](https://help.qargo.com/us/articles/133781-customer-portal-giving-access-to-the-customer-portal.md)
- [Customer portal: How to create orders in bulk from an Excel or CSV file](https://help.qargo.com/us/articles/879687-customer-portal-how-to-create-orders-in-bulk-from-an-excel-or-csv-file.md)
- [Intermodal - Intermodal planning](https://help.qargo.com/us/articles/133848-intermodal-intermodal-planning.md)
- [FAQ: How to approve a charge](https://help.qargo.com/us/articles/251714-faq-how-to-approve-a-charge.md)
