---
title: "Orders - Cargo & Goods Details for Cross-Border Shipments"
description: "Record customs cargo details — commercial invoice value, net weight, and shipping marks — directly on consignments and goods in Qargo for cross-border transport."
url: https://help.qargo.com/en/articles/627106-orders-cargo-goods-details-for-cross-border-shipments
locale: en
updated: 2026-04-07
---

# Orders - Cargo & Goods Details for Cross-Border Shipments

## Introduction {#h_a2036155e1}

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

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

-   **Consignment 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 and are designed specifically to meet the information requirements of customs authorities.

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

Carriers operating cross-border routes — particularly between the EU, UK, and Ireland — must supply detailed cargo 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 & how does it work?  {#h_97c2e91b92}

Previously, Qargo's goods data model was optimised for operational planning. The new customs fields make it possible to **_capture declaration-ready cargo information_** within the same system, reducing manual rework and ensuring 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** |
| --- | --- |
| _Consignment_ | 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 cargo 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 Cargo Detail Fields {#h_0847489a43}

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

### Consignment-level fields {#h_ba3a88f9bd}

**NAVIGATE** to _CONFIGURATION > Additional Fields_.\
**LOCATE** the _Consignment_ field group.\
**ENABLE** the following fields by toggling them on:

-   _Commercial invoice value_ — the total declared value of the consignment
-   _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 Consignment 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 your Account Manager to confirm that the **_Packaging items_ feature flag** is enabled for your 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 _Consignment_ 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 automatically appear, click **'+Add consignment information'** to display the additional fields.
:::

-   **SCROLL** to the _Cargo_ 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 _Consignment_ section and populate the commercial invoice fields.\
**EXPAND** each good in the _Cargo_ 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 cargo 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 cargo 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 Consignment 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/en/articles/567870-orders-adding-multiple-packaged-items-on-orders.md)
- [Intermodal - HS Commodity Codes: What, Why & How](https://help.qargo.com/en/articles/590352-intermodal-hs-commodity-codes-what-why-how.md)
- [ORDERS — Consignment Customs Fields: Export, Import & Transit Overview](https://help.qargo.com/en/articles/674380-orders-consignment-customs-fields-export-import-transit-overview.md)
- [Configurable fields for ADR](https://help.qargo.com/en/articles/217684-configurable-fields-for-adr.md)
- [Configure a product and a product type](https://help.qargo.com/en/articles/133833-configure-a-product-and-a-product-type.md)
