---
title: "PN - PalletLine order import/export"
description: "Covers how Palletline orders are imported into Qargo via API polling and exported via dispatch tasks. Includes guidance on the third-party label ID feature for customers managing their own labels."
url: https://help.qargo.com/us/articles/143830-pn-palletline-order-import-export
locale: us
updated: 2026-03-17
---

# PN - PalletLine order import/export

### Export (API) {#h_d5498060cf}

For the order export, a dispatch task sends the shipment to Palletline. The same feature set is therefore available (e.g., the task can be auto-completed to automatically send shipments to Palletline):\
​\
In the dispatch task configuration, the integration to dispatch to is "Palletline":

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

\
Dispatch tasks are only generated for contract carrier resources that have the Palletline integration active. The **Pallet network** toggle can be activated to hide these resources from the regular planning board and show them in the pallet network planning board.

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

In Qargo, dispatching is always performed at load level, and the Palletline API expects a single shipment. During dispatch, Qargo verifies that **only a single shipment is present on the load being dispatched**.\
​\
It is therefore **not** possible to consolidate multiple loads and send them to the Palletline API together.

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

\
The terminal codes passed to the API are:

-   **as requesting terminal:** the result of the Qargo gazetteering of the location on the stage that is not being exported, or the default when exporting direct stages;
-   **as pickup terminal:** the result of the Qargo gazetteering when exporting the delivery stage;
-   **as delivery terminal:** never passed.

After the dispatch, the Palletline API returns some information to Qargo, such as the routing information and the pallet barcodes.

### Import (API) {#h_34e1be7ccf}

The order import happens over API. Every minute, Qargo polls the Palletline API to get the shipments assigned to one of the tenant's terminals.\
​\
The terminal codes are taken from the imported orders and are not re-gazetteered in Qargo.\
​\
Orders coming in via API are assigned the Palletline transport network because of the transportation service configuration.\
​\
They follow the Palletline transport network configuration for splitting at the terminal and automatic resource assignment:

-   the transport network is configured to auto-assign a resource
-   the contract carrier assigned to the transport network has active resources with the **Palletline integration** toggle turned off

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

:::callout{tone="note"}
📚 If an imported order is canceled in the Network system, Qargo receives and applies the update, setting the load / order to canceled.\
If the job later becomes active again in the Network system, the Qargo status **does not** update. The order must be manually reset back to live.
:::

### \
Import (file) – only while onboarding – not live {#h_14c1f93506}

During the onboarding period, Palletline customers can also import orders by file import. This allows them to generate a single invoice for their customers (containing both pre-Qargo and post-Qargo shipments).\
​\
Orders imported via file have no data synchronization from the Palletline system (e.g., status updates are lost).\
The shipments must be updated manually to get them into the correct state for invoicing.

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

* * *

## Third-party label ID {#h_df09a5c326}

By default, when a shipment is created in Qargo for a Palletline job, Qargo automatically requests a label ID from the Palletline network. Some customers manage their own Palletline labels through a separate system (for example, a WMS or ERP) and supply their own label ID into Qargo instead of having Qargo generate one.\
The **_palletline\_\_third\_party\_label\_id_** field supports this workflow. When a value is present on the order, Qargo skips the automatic label creation step at order creation and uses the supplied ID instead. Barcodes are confirmed with the Palletline network at the point of dispatch.

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

### How it works {#h_c12fd2c6d6}

The third-party label ID is supplied via the Qargo API or EDI import. It cannot be set manually in the Qargo user interface.

-   The ID is included when the order is created in Qargo and replaces the standard Qargo label request to Palletline.
-   **Dispatch** the shipment using the standard **_Export to Palletline_ dispatch task**.

    -   At dispatch, Qargo confirms the barcodes with the Palletline network using the supplied label ID.

:::callout{tone="note"}
📚 Palletline barcodes are **not available in Qargo before the dispatch task** is completed.

-   Labels cannot be printed ahead of dispatch for orders using a third-party label ID.

📚 For cross-dock scenarios occurring before dispatch, the delivery terminal must be provided at the time of order creation.

📚 Using _Create similar order_ on an order that has a third-party label ID copies the label ID to the new order.

-   The field must be updated or cleared before dispatching the copied order to avoid duplicate label IDs in the network.
:::


## Related articles

- [PN - PalletForce order import/export](https://help.qargo.com/us/articles/143829-pn-palletforce-order-import-export.md)
- [FAQ – Palletforce: troubleshooting common issues](https://help.qargo.com/us/articles/456606-faq-palletforce-troubleshooting-common-issues.md)
- [Pallet network routing & local zone extension](https://help.qargo.com/us/articles/143822-pallet-network-routing-local-zone-extension.md)
- [Multiple terminals](https://help.qargo.com/us/articles/143914-multiple-terminals.md)
- [Tracking: pallet barcodes & statuses](https://help.qargo.com/us/articles/143827-tracking-pallet-barcodes-statuses.md)
