---
title: "Orders – Freight and goods details for cross-border shipments"
description: "Record customs freight details (commercial invoice value, net weight, and shipping marks) directly on shipments and goods in Qargo for cross-border transport."
url: https://help.qargo.com/us/articles/627106-orders-freight-and-goods-details-for-cross-border-shipments
locale: us
updated: 2026-04-07
---

# Orders – Freight and goods details for cross-border shipments

## Introduction {#h_a2036155e1}

### What are customs freight details? {#h_0738977373}

Customs freight details are the structured data fields required to prepare accurate customs declarations for cross-border shipments. In Qargo, these cover two levels:

-   **Shipment level**: commercial invoice value, currency, and reference name
-   **Good item level**: net weight, shipping marks, and commercial invoice value per item

These fields sit alongside existing operational goods data. They are designed specifically to meet the information requirements of customs authorities.

### Why record customs freight details in Qargo? {#h_acfe422db4}

Carriers operating cross-border routes, particularly between the EU, UK, and Ireland, must supply detailed freight information when submitting customs declarations. This includes the commercial value of the shipment, net weights per goods line, and package identification marks.

### What's new and how does it work?  {#h_97c2e91b92}

Previously, Qargo's goods data model was optimized for operational planning. The new customs fields make it possible to **capture declaration-ready freight information** within the same system. This reduces manual rework and ensures that PDF documents and API integrations carry the correct customs data.

The fields are **optional default fields that must be enabled in Configuration > Additional fields** before they appear in the order form. Once enabled, they can be populated manually during order creation or editing, or supplied via the order import API. All fields flow automatically into PDF document templates.

* * *

## Terminology {#h_b09dcd0239}

| **Term** | **Definition** |
| --- | --- |
| _Shipment_ | The shipment unit within an order, grouping goods under a single movement. Commercial invoice details are recorded at this level. |
| _Good item_ | A packaged item within the freight section of an order. Net weight, shipping marks, and per-item invoice values are recorded at this level. |
| _Commercial invoice value_ | The declared total monetary value of the goods being shipped, as stated on the commercial invoice. Used by customs authorities to assess duties. |
| _Commercial invoice currency_ | The ISO currency code (e.g. EUR, GBP) corresponding to the declared invoice value. |
| _Commercial invoice name_ | The reference name or number of the commercial invoice document (e.g. "INV-2026-00123"). |
| _Net weight_ | The weight of the goods excluding all packaging material, expressed in the same unit as the existing gross weight. |
| _Shipping marks_ | Identifying marks or labels applied to packages to enable individual identification. Required on many customs declarations (e.g. "ADDR" when marks are unknown). |

* * *

## Enabling customs freight detail fields {#h_0847489a43}

All new customs freight fields are optional and must be activated in **Configuration > Additional fields** before they appear in the order form.

### Shipment-level fields {#h_ba3a88f9bd}

**Navigate** to **Configuration > Additional fields**.\
**Locate** the **Shipment** field group.\
**Enable** the following fields by toggling them on:

-   **Commercial invoice value**: the total declared value of the shipment
-   **Commercial invoice currency**: the ISO currency code for that value
-   **Commercial invoice name**: the reference or invoice number

**Save** the configuration.

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

Once enabled, these fields appear in the **Shipment** section of the order edit form.

### Good item-level fields {#h_5f4edafad9}

**Navigate** to **Configuration > Additional fields**.\
**Locate** the **Packaged item** field group.\
**Enable** the following fields:

-   **Net weight**: the goods weight excluding packaging
-   **Shipping marks**: package identification marks
-   **Commercial invoice value**: the declared value for this specific goods line

**Save** the configuration.

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

:::callout{tone="info"}
💬 If the **Packaged item** field group is not visible, contact Qargo Support or the account manager to confirm that the **Packaging items feature flag** is enabled for the tenant.
:::

* * *

## Entering customs details on an order {#h_4cced99797}

### During order creation {#h_2541cb54d5}

-   **Open** the order input form and complete the standard order fields.
-   **Locate** the **Shipment** section and **enter** the commercial invoice value, currency, and reference name for the shipment.

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

:::callout{tone="info"}
📚 If the commercial invoice details do not appear automatically, click **'+Add shipment information'** to display the additional fields.
:::

-   **Scroll** to the **Freight** section and **expand** a good item.
-   **Enter** the net weight, shipping marks, and per-item commercial invoice value as applicable.

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

-   **Save** the order.

### On an existing order {#h_e132120f8b}

**Navigate** to the order detail page.\
**Click** **Edit order** to open the order form.\
**Locate** the **Shipment** section and populate the commercial invoice fields.\
**Expand** each good in the **Freight** section and populate the goods-level customs fields.\
**Save** the order.

::video{src="/media/video/d322e0c8b2aa-2026-04-01_17-06-24-1-.mp4"}

## Customs details via order import {#h_f250b00483}

All customs freight fields can be supplied when importing orders via the External API or file-based import.

* * *

## Customs details in PDF templates and DFS {#h_4ed06ee7d2}

Once customs freight fields are populated on an order, they are automatically available in:

**PDF document templates**: commercial invoice value, currency, net weight, and shipping marks can be included in any document template that references shipment or good item fields, including:

-   customs declarations
-   CMRs
-   commercial invoices

No additional template configuration is required beyond enabling the fields in **Additional fields**.


## Related articles

- [Orders – Adding multiple packaged items on orders.](https://help.qargo.com/us/articles/567870-orders-adding-multiple-packaged-items-on-orders.md)
- [Intermodal – HS commodity codes: what, why and how](https://help.qargo.com/us/articles/590352-intermodal-hs-commodity-codes-what-why-and-how.md)
- [Orders — Shipment customs fields: export, import, and transit overview](https://help.qargo.com/us/articles/674380-orders-shipment-customs-fields-export-import-and-transit-overview.md)
- [Configurable fields for ADR](https://help.qargo.com/us/articles/217684-configurable-fields-for-adr.md)
- [Configure a product and a product type](https://help.qargo.com/us/articles/133833-configure-a-product-and-a-product-type.md)
