| Panel | ||||
|---|---|---|---|---|
| ||||
|
Summary
The Customs-MPI screen shows Customs CEDOs and MPI clearance messages that are linked to a Vessel Visit. The screen displays details for each cargo item on the Declaration (CDO number). All items on a declaration are either cleared‘Clear’, on hold ‘Hold’ or cancelled‘Cancelled’. Messages are linked and unlinked to a vessel at the header level ( per declaration). If one line item is linked, all other items on the same CEDO declaration are also linked by the system. Users must verify all individual cargo items before authorising the vessel for load.
The Customs page -MPI screen allows users to:
...
Review clearance messages linked to
...
Unlink CEDOs from a vessel
...
View CEDO details including ‘issued’ and ‘received’ date information
...
View full declaration details including current and previous versions
...
Filter and sort messages by:
Vessel Visit
Message received Date range
Exporter
Clearance Status
Cargo type
Checked status
...
Search for multiple Cargo Items
...
Mark vessels as ‘clear for load’
Functions
Vessel Visit filter
The Vessel Visit filter allows users to filter by vessel and see all CEDOs that have been linked to the vessel.
...
Next to the Vessel Visit search is a Vessel Visit Details icon.
Clicking on the icon will display the vessel visit details:
...
CEDO Received Date Range Filter
The Received filter allows users to filter results by the date the CEDO messages were received.
The display defaults to the date the first message received and the date the latest message was received.
...
Exporter Filter
The Exporter filter allows users to select an exporter from a dropdown list.
...
Clearance Status Filter
The Status filter allows users to filter by Status types. There are three Status types:
Clear
Hold
Cancelled
...
Cargo Type filter
The Cargo Type filter allows users to filter by Cargo types. The Cargo Types include: Container, BBK, Bulk and Vehicle.
...
Unchecked messages filter
The Unchecked Messages filter allows users to display all the CEDOs they have not yet checked/reviewed.
...
| Info |
|---|
The check box at the start of each row is expected to be checked by the user as they work through their Load List document. |
Search messages by keyword
Users can copy and paste multiple Bill of Lading or container numbers to search all the messages received. The system will search for the values in both the Cargo Item and Container Number columns.
...
Unlink CEDOs from a Vessel
...
vessels
Unlick clearances if required
Mark messages as checked and mark vessel visits as Clear for Load.
| Info |
|---|
The user is advised to check the Detailed View to confirm Recipient ID for duplicate messages. |
| Info |
|---|
MPI Food hold and clearance messages are excluded from being displayed. |
View Messages
Users can view messages by Exchange Type at these icons:
Selecting the Exchange Type will display either Exports (exchange type: Load) or Imports (exchange type: Discharge). All column headers for the grid can be sorted in alphanumeric order.
| Info |
|---|
Duplicate messages are not shown. |
Load
...
The grid displays rows of clearance messages at the item level. If an item is linked to a vessel, all other items on the same customs declaration (CDO) are also linked to that vessel. Linking occurs at the CDO level.
Discharge
...
The grid content is organized into 3 layers:
Item: unique consignment item for example, a container number.
Packaging: packages within the consignment item are shown underneath the item. This is only generated from import messages.
Action: contains the instruction for the consignment, such as Hold or Clear.
Filter Messages
Messages can be filtered in multiple ways including:
...
Vessel Visit: filter by typing in vessel visit or voyage and select from the prompted results in the drop down.
View Vessel Visit: when clicked, a pop-up window appears with the vessel visit details. For example,
Date: defaults to the first and last day of the received messages (exception messages).
Exchange Type: ‘Discharge’ refers to imports (CIDO records) and ‘Load’ refers to exports (CEDO records). This is a sticky filter, and the selected type will be applied across all screens until cleared.
Clear Filters: this icon is a button that clears set filters.
Select by Transship: a dropdown of results that can be ‘Internation’, ‘Domestic’ or blank. This is determined by the results showing on the grid.
Importer / Exporter: a dropdown of results to be chosen from. These results are pulled from what is showing on the grid.
Status: when filtering with ‘Status', it searches the status at the item level, not action (for imports). Status will show as ‘Clear’, ‘Hold’, or 'Cancelled’.
Cargo Type: filter messages in the grid by cargo types, Container, Breakbulk, Bulk, Vehicle.
Unchecked Messages: this filters the items on the grid to show only those which have not been checked.
Search: free text search is available. Note: this does not allow for spaces which will result in a new line.
CSV: export a CSV document with the displayed items on the grid.
Detail and History View
Open the detailed view pop up page for the corresponding item by clicking icon: 
or 
The detailed view provides further information not shown in the grid. Users can export all columns on the detailed view grid by way of CSV file by clicking icon: 
| Info |
|---|
Multiple versions of messages are shown in the detailed view. To navigate between versions, click the tab header, for example “Version 13-Jun-2024 15:04”. The default message details displayed is the current (most recent) version. |
Example
...
Unlink CDOs from a Vessel
If a message has been linked to the wrong vessel visit user can click the unlink icon, 
, found on the right of messages, to unlink the consignment item from the vessel. When a message is unlinked, it will be moved from the Customs-MPI page to the Customs-MPI Exceptions page.
...
| Info |
|---|
Note that if an item is unlinked all items associated with the CDO are unlinked. |
View message details
If the view document icon is clicked, all information provided by NZ Customs is displayed, if the icon for multiple documents is displayed, it indicates there are more than one version of the same CEDO, a status change may have received (Hold/Clear) or the CEDO may have a content change.
...
Mark vessels as Clear for Load
Mark messages as checked
Users can mark messages as checked using the Chk column. Once all messages related to a vessel visit have been checked then users can mark the vessel visit as Clear for Load.
...
Mark Vessels as Clear for Load
For outbound voyages, users have the ability to set the vessel as Cleared for Load. This is a user decision and not automated by the system, when the user attempts to click Clear for Load the .
All messages must be marked as Checked before clicking ‘Clear for Load’. The system will present a warning if there unchecked CEDOs.
It is up to the user to decide when to flag the vessel clear to load
a. if the button is pink, click to update the vessel to ‘Clear for Load’
...
| Info |
|---|
By clicking the button to clear the vessel for load, the vessel on the dashboard will be flagged with a cleared for load icon. |
...
b. if the button is grey, the vessel has been cleared for load
...
c. Cancel Vessel Clearance
The user can also remove the ‘clear for load’ status by clicking on the Cancel Clearance button
...
After clicking, a confirmation sign will display to confirm cancellation:
...
d. User history of the Cleared for Load action, using the history icon next to the button
...
CEDO Messages Displayed on Dashboard
The dashboard page has a CEDO Messages count within the Load view. The count numbers represent:
LEFT: Number of Cleared CEDOs
Right: Number of Hold or Cancel messages (not cleared)
Automatic Message Mapping Process
BBMS processes Customs messages and automatically attempts to link messages to an existing vessel visit. Messages are processed/Re-processed when:
...
New TSW messages are received
...
The vessel schedule is updated
...
Items can be cleared for load when the button is showing: 
...
Clear for Load: is greyed out when there are no items to be cleared showing on the grid.
Cancel Clearance: allows for cancellation of the cleared for load.
...
View Audit: enables a pop-up window with the Clearance History, date and user.
...