ICS2 Troubleshooting
Diagnose filing errors. Resolve connection problems. Verify the outcome.
A practical troubleshooting guide for the EU Import Control System 2, covering rejected ENS messages, missing notifications, trader portal access, system-to-system connectivity and uncertain submission status.
Four checkpoints before corrective action.
Verify the original processing outcome before attempting a new submission.
Find the failure point. Before attempting a fix.
Troubleshooting ICS2 starts by identifying the last confirmed processing event. A failed login, a message transmission timeout, a validation rejection and a missing business notification require different investigations.
Use the checkpoints below to narrow the problem, preserve the evidence and select the correct recovery procedure.
Five checkpoints. One verified outcome.
Access
Can the operator authenticate and use the intended interface?
IDENTITY / AUTHORISATIONTransmission
Was the message successfully delivered through the communication channel?
CONNECTIVITY / DELIVERYValidation
Did the message pass the applicable technical and business checks?
SCHEMA / BUSINESS RULESRegistration
Is there a confirmed filing result and the relevant references?
FILING / LIFECYCLENotifications
Were the expected business messages received and processed?
ROUTING / RESPONSEStart with what you can observe.
A useful diagnosis connects the visible symptom to the evidence needed to confirm its cause. Do not treat a possible explanation as a confirmed failure.
| Observed symptom | Possible area | First verification | Avoid |
|---|---|---|---|
| Cannot sign in to STP | UUM&DS access or authorisation | Check identity, assigned rights, selected environment and available authentication evidence. | Assuming an ICS2 system-wide outage. |
| STI connection fails | Communication channel or technical configuration | Review the supported transport configuration, certificates, endpoint and connection logs. | Changing declaration data before checking connectivity. |
| Message is rejected | Technical or business validation | Retrieve the complete rejection response and identify the reported error. | Resending the unchanged message repeatedly. |
| No filing result received | Processing or response delivery | Correlate original message identifiers, acknowledgements and available status evidence. | Assuming that a timeout proves rejection. |
| ENS remains incomplete | Multiple filing or missing particulars | Verify required supplementary filings, registration status and linking references. | Assuming that one registered filing completes the ENS. |
| Expected notification is missing | Message routing or recipient configuration | Check the intended recipient, communication route and local message processing. | Assuming no customs action occurred. |
Preserve the original event. Then investigate.
Reliable incident resolution depends on traceable evidence. Before changing the filing or interface configuration, record what was sent, what was received and when the problem occurred.
A Local Reference Number (LRN), a transport message identifier and an MRN serve different purposes. An MRN should only be recorded where it has actually been assigned.
Original message ID, LRN where applicable and MRN if assigned.
Timestamp, relevant time zone, interface and production or test environment.
Preserve the submitted message and its relevant technical version.
Technical acknowledgements, business notifications and diagnostic logs.
Affected consignment, filing deadline and any outstanding customs instruction.
Choose the next action from confirmed evidence.
Transmission failure confirmed
Investigate and correct the communication problem. Before retrying, determine whether the original message could have been delivered or processed.
Validation rejection confirmed
Correct the identified data or message problem. Use the appropriate submission procedure and confirm the new processing result.
Filing registered successfully
Do not create a new original filing merely because a local notification is missing. Investigate response delivery and any outstanding filing issues.
Processing status remains uncertain
Reconcile the available references and escalate through the appropriate technical or customs support channel before taking an action that could create a duplicate.
When ICS2 cannot be reached. Diagnose the connection.
An access failure is not necessarily an ENS filing failure. The cause may lie in user authorisation, certificate configuration, network communication, an AS4 access point or a temporary service interruption.
The first step is to identify how the economic operator connects to ICS2. Portal users and system-to-system senders do not necessarily encounter the same technical problems.
Shared Trader Portal
Browser-based access
Economic operators can use the trader portal to interact with ICS2 through a user interface. Access depends on the applicable identity, authentication and authorisation arrangements.
Common investigation areas- UUM&DS registration and access rights
- National authentication arrangements
- Selected operator and delegated roles
- Browser session and portal availability
- Correct production or test environment
Shared Trader Interface
Automated message exchange
A technical sender connects through an appropriately configured system-to-system solution, using the required communication and security mechanisms. An IT service provider may operate this connection.
Common investigation areas- AS4 access point and message exchange
- Mutual TLS connectivity and certificates
- Message sealing and sender identification
- Endpoint and environment configuration
- Technical receipts and response handling
Login successful does not always mean access authorised.
Authentication establishes the user’s identity. Authorisation determines whether the user can perform the intended operation for the relevant economic operator.
Authentication failure
The user cannot complete the applicable sign-in procedure or identity verification.
National login method, account status, authentication response and correct portal entry point.
Missing authorisation
The user signs in but cannot access the required ICS2 function or act for the intended operator.
UUM&DS roles, permissions, delegations and the applicable EORI relationship.
Portal session problem
The interface fails to load, a session expires or a browser action does not complete.
Session validity, browser compatibility, local network restrictions and published service notices.
Incorrect environment
The operator uses the wrong access route or expects production data in a test environment.
Environment-specific URLs, permissions, registrations and configuration.
Follow the message. Across the connection.
For an AS4-based connection, the investigation should distinguish the transport layer, message security, sender configuration and subsequent business processing.
A successful network exchange does not, by itself, prove that the ENS has been registered.
Transport-layer TLS certificates and message-level sealing certificates serve different purposes. Check the certificate type, validity, trust, private-key availability and registration required by the applicable ICS2 specifications.
DNS, routing, endpoint reachability and mutual TLS negotiation
Access-point configuration, headers, message security and receipts
Message structure, data content and applicable business rules
Registration outcome, subsequent messages and recipient routing
What the technical symptom may indicate.
The examples below describe possible causes, not definitive interpretations of a particular ICS2 error code.
| Symptom | Potential cause | Diagnostic action | Important caution |
|---|---|---|---|
| TLS handshake failure | Certificate, trust-chain or mutual-authentication issue | Inspect TLS logs, certificate validity and configured trust material. | Do not disable certificate verification as a workaround. |
| Connection timeout | Network interruption, endpoint issue or unavailable service | Check connection logs, timing, routing and any service notices. | Timeout does not prove that the original message was rejected. |
| AS4 processing error | Messaging configuration, security or protocol mismatch | Review the actual AS4 error and relevant interface specifications. | Do not modify ENS business data without evidence of a data problem. |
| Certificate-related rejection | Expired, incorrect or improperly registered certificate | Check certificate purpose, registration, sender identity and environment. | Transport and sealing certificates are not interchangeable. |
| Receipt exists; business response missing | Response processing, routing or asynchronous delivery issue | Correlate transport evidence with the business-message lifecycle. | An AS4 receipt is not confirmation of ENS registration. |
| Test connection works; production fails | Environment-specific endpoint, rights or configuration | Compare production configuration with the approved deployment setup. | Successful conformance testing does not prove current production connectivity. |
The connection times out. Was the ENS received?
A sender transmits an ENS message through its AS4 access point. The application reports a timeout before a definitive processing outcome is available.
The sender cannot safely conclude that the filing failed. The message may not have reached the receiving system, or the communication may have been interrupted after delivery.
Reconcile the original message identifiers, available receipts, technical logs and business notifications before deciding whether a retry or another recovery action is appropriate.
Original transmission initiated
Processing outcome not established
Logs, receipts and filing references checked
Action selected according to confirmed status
A local outage is not an authorised contingency procedure.
If ICS2 appears unavailable, check official service communications and contact the appropriate support channel. Do not assume that an individual connectivity problem automatically activates a business continuity arrangement or suspends ENS obligations.
Where an official contingency procedure applies, follow its published scope, activation conditions and instructions.
Escalate with evidence, not assumptions.
Where the issue cannot be resolved locally, involve the technical sender, IT service provider or the appropriate National Service Desk, depending on the failure and the operator’s setup.
Production or conformance testing, access channel and relevant configuration.
Technical message ID, relevant filing references and precise timestamps.
Relevant error responses, sanitised logs and the observed failure sequence.
Affected filing, transport deadline and any outstanding customs instruction.
Consult the latest ICS2 specifications, operational FAQ and instructions issued by the relevant national customs administration.
Message rejected? Find the rule that failed.
A rejected ICS2 filing requires more than correcting an XML document. The problem may concern message structure, mandatory ENS particulars, business-rule consistency, operator identifiers or the status of an existing filing.
The effective error details must be taken from the received notification and the applicable ICS2 technical specifications. The examples below are diagnostic illustrations, not official error-code definitions.
XML & schema errors
The submitted message does not comply with the applicable technical structure or data format.
- Correct message type and schema version
- Element structure and cardinality
- Permitted data types and field lengths
- Namespace and technical formatting
ENS data errors
The message is technically structured but fails one or more applicable data requirements or business validations.
- Required particulars for the filing type
- Valid codes and reference values
- Consistency of goods and transport data
- Conditional requirements and dependencies
Identity & linking errors
Identifiers or references may be missing, inconsistent or unsuitable for the intended filing operation.
- EORI and relevant party identification
- LRN and other applicable references
- Master and house filing relationships
- Sender role and filing responsibility
Operation & status errors
The requested action may be incompatible with the declaration’s existing state or the applicable filing procedure.
- Original filing versus amendment
- Duplicate or previously processed requests
- Permitted operation for the current status
- Correct declaration and message references
Read the full response. Not just the notification code.
The notification identifies the type of system response. The diagnostic details explain what failed and where the correction should be made.
Always inspect the available error description, rule identifier, element reference and related message identifiers. Their exact format depends on the applicable message specification.
Was the message rejected? This is a processing-outcome question.
Why was it rejected? This requires interpreting the actual validation details.
Field: Transport reference
Issue: Required value not supplied
Action: Check applicable data rules
Validate the updated message before submitting the appropriate operation.
From rejection to verified processing.
Treat the rejected submission as a traceable incident. Correct the underlying data or operation, then verify the actual system result.
Capture the rejection
Preserve the original message, response, timestamps and relevant filing references. Record every reported validation error.
Identify the failed rule
Determine whether the problem is technical, business-related, reference-related or connected to the requested operation.
Correct the authoritative data
Fix the source system or declaration data. Avoid altering an XML output manually while leaving the underlying defect unresolved.
Run local validation
Recheck the schema, applicable business rules, mandatory particulars and consistency of related references.
Submit the appropriate operation
Use the correct filing or correction procedure for the confirmed status. Do not assume that every rejection should be handled as an amendment.
Verify and close
Confirm the actual response, record the resulting references and investigate any remaining ENS completeness or risk-assessment requirements.
Corrections that create another problem.
Repeated submission does not resolve an unchanged schema or business-rule defect.
An arbitrary reference change can interfere with traceability or the relationship between related filings.
A filing that was never registered must not automatically be treated as an accepted declaration requiring amendment.
In multiple filing, other required submissions may still be outstanding after one filing has been registered.
A generic application message may hide detailed validation information supplied by the receiving system.
Passing an internal XML validator does not establish that ICS2 will accept or register the filing.
One filing accepted. ENS still incomplete.
When several parties contribute ENS data, a successful response for one filing does not establish that all required particulars have been provided.
Check the status of each expected filing, the relevant master and house references, and whether the submissions can be associated correctly.
Understand ICS2 Multiple FilingMessage sent. Outcome unknown.
An ENS message can leave the sender’s system without an immediately visible filing result. The problem may concern transport acknowledgements, asynchronous processing, notification delivery or the local application’s ability to correlate responses.
The correct recovery action depends on what can actually be confirmed. A successful transport exchange is not proof of ENS registration, and a missing local response is not proof of rejection.
Follow the evidence across four boundaries.
Sender application
Original payload created and transmission initiated.
LOCAL MESSAGE ID / LRNTransport exchange
Communication-layer delivery and available technical receipts.
AS4 / TRANSPORT EVIDENCEICS2 processing
Applicable validation and filing lifecycle operations.
BUSINESS PROCESSING RESULTResponse delivery
Business notification delivered and matched to the original request.
RECEIVED / CORRELATED / RECORDEDCritical distinction: transport evidence, business validation, ENS registration and completion of risk assessment are separate concepts. Do not substitute one confirmation for another.
No MRN visible? Check what was confirmed.
A Movement Reference Number is associated with the relevant registered declaration or filing. Its absence from the sender’s application requires investigation, but does not by itself establish that ICS2 rejected the submission.
First determine whether the expected registration response was generated, whether it reached the technical recipient and whether the local application processed it correctly.
Keep the original LRN and technical message identifiers available for correlation. Record an MRN only when it has been assigned and confirmed by the relevant system response.
Processing outcome unresolved
Locate or reconcile the business response before choosing a recovery operation.
Six symptoms. Six different investigations.
Missing notifications can result from different causes. The evidence should identify whether the issue is in customs processing, technical delivery, recipient configuration or local software.
| Observed problem | What to verify | Next diagnostic action |
|---|---|---|
| AS4 receipt received, no business notification | Whether a business response was produced and delivered | Correlate transport IDs with the business-message exchange and check response processing. |
| MRN absent from the local system | Registration result and message import into the application | Check the expected response, its recipient and any failed local parsing or mapping. |
| Notification received by another party | Applicable notification recipient and filing arrangement | Verify operator roles, technical sender setup and authorised message routing. |
| Response exists but is not linked to the filing | Correlation references and local message-matching logic | Compare original identifiers with those contained in the received response. |
| ENS remains incomplete after a successful filing | Other required filings and master/house relationships | Reconcile expected contributions and verify their registration and linking references. |
| Notification arrives later than expected | Asynchronous processing, message queues and service availability | Review timestamps and available status evidence before initiating another operation. |
Connect every response to its original submission.
Message reconciliation requires consistent identifiers, timestamps and a complete audit trail. Do not confuse a transport identifier with a customs filing reference.
LRN
Identify the original filing using the applicable local reference and the sender’s own filing records.
Message ID
Trace the individual technical exchange using its message identifiers and available delivery evidence.
MRN
Record the customs reference where it has actually been assigned through the relevant registration process.
Timeline
Reconcile timestamps, responses, retries and any later filing operations in the correct sequence.
The message was delivered. The application shows nothing.
An operator submits an ENS through an STI connection. A technical receipt is available, but the local application displays no registration result.
Investigation reveals that a business response was received by the integration component but was not associated with the original filing.
In this illustrative scenario, the correct response is to repair the local correlation process and restore the filing status, not automatically create another original ENS.
Technical receipt located
Message found in integration logs
Response not matched to the local filing
Actual filing outcome verified and recorded
Resolve uncertainty without losing traceability.
Freeze uncontrolled retries. Preserve the original submission and establish which actions have already occurred.
Collect all available evidence. Review message identifiers, LRN, receipts, timestamps, application logs and received notifications.
Reconcile the processing result. Determine whether the original filing was rejected, registered or remains unresolved.
Check subsequent obligations. A registered filing may still require supplementary ENS data or a response to customs instructions.
Escalate unresolved cases. Contact the appropriate technical provider or customs support channel with the relevant evidence.
Document the final state. Record the confirmed result, corrective action and any remaining operational requirements.
ICS2 troubleshooting. Questions that matter.
Technical failures, rejected filings and customs notifications require different responses. These answers help economic operators distinguish confirmed processing results from unresolved system or operational problems.
Find the cause. Choose the right action.
Use the actual ICS2 response, the applicable technical specifications and the current instructions of the competent customs authority when resolving a specific incident.
01 Why is my ICS2 ENS message rejected?
An ENS filing may be rejected because it fails technical validation, applicable business rules, data requirements or checks associated with the requested filing operation.
Review the complete rejection notification, identify the reported validation errors and correct the underlying cause before submitting the appropriate message again.
02 What should I do if ICS2 does not respond?
First determine whether the problem concerns connectivity, message delivery, asynchronous business processing or notification handling.
Check the original message identifiers, transport evidence, application logs and available business responses. Do not assume that a timeout means the filing was rejected. Avoid uncontrolled resubmission while the original outcome remains uncertain.
03 Why have I not received an MRN?
The expected registration response may not have been generated, delivered, received or correctly processed by the local application. The absence of an MRN from your software does not independently establish rejection.
Reconcile the LRN, relevant technical message identifiers and available responses. Record the MRN only when its assignment has been confirmed.
04 Does an AS4 receipt confirm that ICS2 accepted the ENS?
No. A transport-level receipt concerns the technical message exchange. It must not be treated as confirmation that the ENS has passed business validation or been registered.
Check the relevant ICS2 business notification to establish the actual filing result.
05 Can an ENS be registered but still incomplete?
Yes. Under multiple filing arrangements, the registration of an individual filing does not necessarily establish that all required ENS particulars have been supplied.
Check the expected contributions, the master and house filing relationships, and the applicable completeness notifications.
Read the Multiple Filing guide06 What is the difference between an ENS rejection and an amendment?
Rejection means the relevant submission has not been successfully registered through that processing operation. An amendment concerns changes to an existing registered ENS, subject to the applicable legal and system conditions.
Before choosing an operation, establish the actual filing status. A rejected original submission should not automatically be handled as an amendment.
07 What should I check when an ICS2 certificate fails?
Check the certificate’s purpose, validity, trust chain, private-key availability and registration or configuration requirements. Verify that the correct certificate is used for the relevant environment.
Transport-layer authentication and message-level sealing are distinct security functions. Do not disable certificate verification to bypass a connection failure.
08 Can I resend an ENS after a connection timeout?
Not without checking the original transmission outcome and the applicable recovery procedure.
A timeout may occur before or after message delivery. Reconcile the available technical and business evidence before deciding whether a retry is appropriate. This reduces the risk of duplicate or inconsistent submissions.
09 What happens if customs issues an RFI, RFS or Do Not Load instruction?
Customs referrals require action according to the specific instruction received. A request for information, a request for screening and a Do Not Load instruction are not interchangeable.
In particular, a Do Not Load instruction must be respected. Correcting or supplementing ENS data does not, by itself, authorise loading contrary to that instruction.
Explore ICS2 Incidents10 Who should investigate a missing house-level filing?
The parties responsible for the relevant ENS data should verify their own filing obligations and the references needed to associate related submissions.
Depending on the filing arrangement, this may involve the carrier, freight forwarder, house-level filer and technical service provider. The investigation should identify the outstanding contribution, rather than assuming every participant must resubmit its data.
Understand House-level Filing11 Does an ICS2 outage suspend ENS obligations?
A local connection problem does not automatically suspend the applicable ENS obligations or activate an official business continuity procedure.
Check service communications and the instructions issued by the competent customs authority. Use contingency arrangements only where their activation conditions and scope apply.
12 What information should I provide to ICS2 technical support?
Provide the affected environment, access channel, operator and technical sender identification, relevant filing references, message IDs, precise timestamps and the actual error or notification received.
Include sanitised diagnostic logs and explain any operational urgency. Do not disclose passwords, private keys or unnecessary personal or commercially sensitive information.
Before contacting support. Build the evidence file.
A complete incident record helps technical teams identify the failing component and reduces unnecessary exchanges between the economic operator, software provider and customs support.
Share only the diagnostic information required for the investigation, through the appropriate authorised support channel.
- 01 Production or test environment identified
- 02 STP or STI connection method recorded
- 03 Relevant EORI and sender role identified
- 04 LRN, MRN if assigned, and message IDs collected
- 05 Exact timestamps and time zone recorded
- 06 Actual error or business notification preserved
- 07 Technical logs reviewed and sanitised
- 08 Operational impact and urgency documented
Turn troubleshooting into process improvement.
Repeated ICS2 errors often indicate a weakness in source data, software integration, message monitoring or the allocation of filing responsibilities.
Validate data upstream
Check required ENS particulars and reference consistency before message generation. Correct the original source of recurring errors.
Monitor every message state
Track submission, transport evidence, business responses and subsequent notifications without treating them as equivalent statuses.
Define ownership
Establish who investigates technical failures, missing house-level contributions, rejected filings and customs referrals.
Review recurring failures
Record incident categories, root causes, corrective actions and repeated defects. Use the findings to improve procedures and integration controls.
Identify the failing layer. Confirm the actual filing status. Resolve the cause without losing traceability.