---
title: "Intermodal – Customs UK HMRC integration"
description: ""
url: https://help.qargo.com/us/articles/543446-intermodal-customs-uk-hmrc-integration
locale: us
updated: 2026-02-05
---

# Intermodal – Customs UK HMRC integration

## Introduction {#h_fd68ab544b}

In transport and logistics, speed, accuracy, and traceability are non-negotiable. The Qargo integration delivers an end-to-end, connected flow that links core systems, such as booking and status tracking, into a single, auditable workspace. With the integration, data is automatically shared between systems, so there is no need to re-enter information or chase updates. The result is improved compliance, faster operations, and clearer visibility for operations teams, dispatch, and freight partners.

### Key benefits {#h_72f174f07a}

-   Faster, more accurate shipment updates
-   Reduced manual data entry and fewer mistakes
-   End-to-end visibility across the supply chain
-   Flexible, scalable integration that adapts to changing routes, carriers, and systems

### Terminology {#h_50bf81a27f}

| **Term** | **Definition** |
| --- | --- |
| MRN declaration | A Movement Reference Number (MRN) declaration is a unique 18-character identifier that customs assigns to a specific shipment when an import, export, or transit declaration is submitted. |
| GMR declaration | A Goods Movement Reference (GMR) is a unique, mandatory digital code used when transporting goods between the UK and the EU, as well as between GB and Northern Ireland. |
| Connector | The component that enables communication between systems, handling authentication, data mapping, and transport |
| Data mapping | Aligning fields from one system with matching fields in another to ensure correct data transfer. |
| Authentication | Verifying identity to access resources (e.g., API keys, OAuth tokens). |
| Authorization | Granting permissions to perform actions or access data after authentication. |
| Logging & audit trail | Recorded events that provide visibility into the integration's activity for troubleshooting and compliance. |

## Prerequisites (Qargo Admin only) {#h_3789209f0a}

:::callout{tone="note"}
💬 **Integration with UK HMRC services requires activation.**\
Contact the Account Manager to request setup assistance.
:::

-   Activate the Customs Pre Notification feature flag

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

-   **_Global_** locations will include the Port ID in the profile

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

-   Tenant locations must be linked to the **_'Global location'_** via the **'Qargo container terminal or intermodal location'** field

    ::video{src="/media/video/bf44cbb7ce32-2026-02-04_15-04-02-1-.mp4"}

-   Create & activate a new **_'UK HMRC'_** integration (**Qargo Admin only**)

    ::video{src="/media/video/e147e5feec44-2026-02-04_15-07-27-1-.mp4"}

-   The integration with UK HMRC must be authorized.
-   Use the **'Copy authentication URL'** link

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

-   Paste the copied link into a browser and click **_'Authorise API'_**

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


Once the integration is authenticated, it is ready for use.

* * *

### Create workflow task (Super Admin / Admin user) {#h_d5cb4e4fc8}

-   Create a standard Customs Task to send data and return status updates.

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


:::callout{tone="info"}
🧰 If multiple customs integrations are used (Irish Revenue / UK HMRC), create a single standard Customs Task.\
Enable the **_'automatically determine integration'_** toggle to send to the correct integration partner.
:::

* * *

## Practical workflow (step-by-step) {#h_101a4dc866}

The steps below walk through how to use the forwarding process

1.  Add the intermodal booking to a load that includes locations linked to UK HMRC locations

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

    Create a load with a location that:

    1.  has a border crossing
    2.  is linked to HMRC
2.  The import/export customs field should appear

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

3.  Once the **Customs** panel is available, users can manually add customs information

    1.  Use **_Add info/doc > Add customs information_** to manually add details

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

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

4.  With the import location selected and the GMR/MRN numbers entered, the task should appear.

    1.  Once triggered, it will automatically forward to HMRC

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


* * *

**Supported status updates**

| **UK HMRC status** | **Description** |
| --- | --- |
| CHECKED\_IN | The GMR has been provided to the carrier |
| OPEN | This is the initial status when a GMR is created but not yet finalized or submitted. |
| EMBARKED | This status shows that the vehicle has boarded the transport |
| PROCEED | This status grants permission for the vehicle to proceed through the border after checks. It is often a post-arrival status, indicating that no holds or further inspections are needed. |
| COMPLETED | This status means the GMR's lifecycle is **fully resolved**.\
​\
​**Inbound**: The goods have arrived in GB, disembarked, and passed any inbound customs controls (e.g., import declarations matched and cleared).\
The GMR is closed, and no further action is needed unless audits occur later.\
​\
​**Outbound**: The goods have departed GB and arrived at the EU/NI destination, with export/transit declarations finalized (e.g., via EU systems such as NCTS for transits).\
The GMR is archived, confirming successful export. |
| NOT\_FINALISABLE | This is an error or warning status indicating that the GMR cannot be finalized (i.e., marked ready for border crossing) due to issues such as incomplete/invalid declarations, mismatches, or system errors.\
Prevents progression until resolved. |
| INSPECTION | Inspection required at customs.\
Will contain additional information on where the driver needs to be for inspection. |


## Related articles

- [Intermodal – Irish Revenue customs integration](https://help.qargo.com/us/articles/543438-intermodal-irish-revenue-customs-integration.md)
- [Intermodal: customs pre-notification process](https://help.qargo.com/us/articles/248194-intermodal-customs-pre-notification-process.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)
- [Intermodal - Intermodal planning](https://help.qargo.com/us/articles/133848-intermodal-intermodal-planning.md)
- [Integrations – Qargo API – What, why & how](https://help.qargo.com/us/articles/865547-integrations-qargo-api-what-why-how.md)
