Intermodal – Irish Revenue customs integration
A unified workflow for customs pre-notification (PBN) between Qargo and Irish Revenue services. Covers forwarding MRN/PBN data to Irish Revenue, status syncing of PBN declarations, and task and integration setup.
Introduction
In global logistics, speed, accuracy, and traceability are non-negotiable. The Irish Revenue MRN/PBN forwarding feature provides an integrated, end-to-end flow. It connects the booking system, customs tasks, and Irish Revenue services in a single, auditable workspace. Through the integration, MRN data and the associated customs pre-notification (PBN) are automatically forwarded to Irish Revenue. The PBN is stored on the booking, and its status is continuously synchronized. The result is improved compliance, faster clearance, and clearer visibility for operations, compliance teams, and freight partners.
Key benefits
- Single source of truth: Centralized routing of MRN and PBN data across multiple terminals under one Irish Revenue integration.
- Automated status visibility: Real-time or near-real-time synchronization of PBN lifecycle states, reducing manual checks.
- Flexible onboarding: Scales from a single terminal to a multi-terminal rollout with centralized configuration and per-terminal overrides.
Terminology
| Term | Definition |
|---|---|
| MRN (Master Reference Number) | The unique reference for a master shipment record used in customs processing. |
| PBN (customs pre-notification) | The pre-declaration payload sent to Irish Revenue that accompanies a shipment’s customs clearance process. |
| Irish Revenue | The national tax and customs authority in Ireland responsible for processing MRN/PBN data and related declarations. |
| Global location | A configured, centralized location (Qargo) representing the Irish Revenue integration, used to route data for multiple terminals. |
| Tenant location / terminal | An individual terminal or location within the organization that can be linked to a global location for data routing. |
| Border-crossing point | The port or crossing location associated with a load where PBN data is relevant for compliance and clearance. |
| Customs task | A configured workflow item that governs the forwarding of PBN/MRN data to Irish Revenue. |
| Feature flag | A configuration toggle (global or per tenant) used to enable or disable specific capabilities, such as customs pre-notification. |
| Status sync | The automated process of updating the PBN/MRN state in Irish Revenue and reflecting it in Qargo. |
| Onboarding | Activities to enable and configure the Irish Revenue integration for one or more terminals, including location mapping and task templates. |
Prerequisites (Qargo admin only)
-
Activate the Customs Pre Notification feature flag
-
Link account locations to the global configuration location, which includes the integration link.


-
Create and activate a new ‘Irish Revenue’ integration
Create a workflow task (super admin / admin user)
-
Create a standard customs task to send data to Irish Revenue and return status updates.
PBN workflow to Irish Revenue
The steps below describe how to use the MRN/PBN forwarding process.
-
Create a load with a border-crossing point linked to Irish Revenue.

-
If data is entered manually, make sure the PBN data is complete before forwarding.

-
-
When a location is linked to Irish Revenue, the system automatically forwards the associated PBN/MRN data according to the configured triggers.

- The PBN is stored on the booking after forwarding.
-
Complete the customs task to forward the PBN details
- Once triggered, the task automatically forwards MRNs to Irish Revenue.

Track PBN status
- Status values map to lifecycle stages and indicate the next actions.

| Irish Revenue status | Description |
|---|---|
| CHECKED_IN | The PBN has been provided to the carrier, and this is a post-check-in confirmation. The ferry operator processed the PBN at the terminal and marked the vehicle as ready to board.\ |
| Indicates the end of the PBN lifecycle for the outbound scenario. | |
| EXIT_PORT | Inbound status. The vehicle can exit the port after inspection or after disembarking.\ |
| Indicates the end of the PBN lifecycle for the inbound scenario. | |
| PROCEED | Outbound: All required customs declarations (MRNs) are filed, validated, and cleared by Revenue. The PBN is complete and valid. The driver is cleared to proceed to the ferry terminal for check-in with the ferry operator. |
| NOT_FINALISABLE | There is an error with the PBN, and it hasn’t been created yet because of missing or incorrect information. |
| REQUIRES_UPDATE_IN_PORTAL | There is an error with the PBN, but it has already been created and needs to be updated in the Irish Revenue portal. |
| CUSTOMS | Inspection required at customs.\ |
| Contains additional information on where the driver needs to be for the inspection. |
