---
title: "Portbase: container terminal bookings"
description: ""
url: https://help.qargo.com/us/articles/171730-portbase-container-terminal-bookings
locale: us
updated: 2026-02-25
---

# Portbase: container terminal bookings

## Getting started {#h_bd5e8dc6f3}

To request API credentials, [contact Portbase](https://support.portbase.com/en/). Portbase charges a fee for this. After receiving the API credentials, contact the Qargo support team to set up the integration.

The Qargo support team needs these API credentials (= Portbase-access-key-id and a Portbase-secret-access-key) before the next steps can proceed.

## Operational/day-to-day use {#h_5159989f66}

### Order detail {#h_a3f7a0f822}

When a new order is created and a terminal is selected, the terminal container icon appears:

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

After the order is saved, a booking object also appears:

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

The booking has the status **To register**, which means the statuses haven't been requested from Portbase yet.\
Once the **Sync container status with external system** task is completed, status updates start coming in and the status changes from **To register** to **Registered**.

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

The statuses are the following:

-   Available: the container has arrived at the port
-   Customs cleared: the container has gone through customs clearance
-   Released: the container has been released
-   General status: a summary of all the statuses above

Icons:

-   Question mark: no status information is available
-   Green: everything is OK
-   Red: there is an issue

This is similar to what is shown in Portbase.

### Planning {#h_754eb4b937}

In the **To plan** section, click **Customize**:

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

Then activate the **Container status** column:

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

The container status is then shown on the **To plan** screen.

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

The **To plan** section also has a dedicated container terminal booking screen:

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

Clicking this button opens an overview of all container terminal statuses:

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

* * *

## Configuration done by customer {#h_138a5b5830}

Terminal locations must be linked to the correct Portbase terminals. To do this, go to the location detail via the **Locations** tab.

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

Then open the location and select the correct terminal:

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

If the terminal isn't listed, click **Show all global locations** to get the full list:

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

After selecting the correct location, remember to click **Save**.

## Configuration done by Qargo {#h_798e4c6511}

### Configuration: Tasks {#h_d9e650dfd9}

Go to the task configuration:

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

An additional **Container terminals** section shows the following tasks:

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

1.  **Sync container status with external system**: requests the status from Portbase and displays it in Qargo. Ideally, this task is configured as **Automatically complete**.

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

2.  **Create container booking**: gathers the necessary information and creates the container booking, but does **not yet** send it to Portbase.

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

3.  **Send booking to terminal**: sends the booking to Portbase.

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


### Configuration: Organization settings {#h_1dc01f976e}

To enable container bookings, reach out to the **Onboarding Manager**, **Account Manager**, or **Support**.

### Configuration: Integrations {#h_60edf3faf7}

Portbase should be listed under **Configuration > Integration**:

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

If it isn't listed, contact the Qargo customer support team to have it activated.


## Related articles

- [Destin8: container terminal statuses](https://help.qargo.com/us/articles/185014-destin8-container-terminal-statuses.md)
- [DP World: container terminal bookings](https://help.qargo.com/us/articles/185004-dp-world-container-terminal-bookings.md)
- [Planning – Container bookings: linking external bookings & cancellation handling](https://help.qargo.com/us/articles/580934-planning-container-bookings-linking-external-bookings-cancellation-handling.md)
- [Integration - Portbase Secure Chain](https://help.qargo.com/us/articles/483948-integration-portbase-secure-chain.md)
- [Intermodal – Irish Revenue customs integration](https://help.qargo.com/us/articles/543438-intermodal-irish-revenue-customs-integration.md)
