Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

What are Notifications?

PortConnect can send email notifications when a range of events/changes occur against containers. Notification types include:

Notification

Description

Supply Chain

1

Available / Available Cancelled

Discharged import, all releases provided and no stops/holds. Ready to be picked up. An Available Cancelled Notification is sent if the container becomes unavailable.

Import

2

Cleared / Cleared Cancelled

All releases provided and no stops/holds. A Cancelled Notification is sent if a release is revoked or new impediment is placed on the container.

Import

3

Customs Release / Customs Release Cancelled

Customs clearance. A Cancelled Notification is sent if the release is revoked.

Import

4

Discharge

Discharged from vessel

Import

5

Gate Out

Delivered out of a port facility: Sea Port or Inland Port

Import

6

LFT Set / Changed

A notification is triggered as soon as a date/time is set or there is a change in that date/time

Import

7

24 Hours before LFT

A notification is triggered 24 hours prior to the LFT date/time

Import

8

LFT Exceeded

A notification is triggered once the LFT has passed

Import

9

LOP Release / LOP Release Cancelled

Line Operator clearance. A Cancelled Notification is sent if the release is revoked.

Import

10

MPI Release / MPI Release Cancelled

Ministry of Primary Industries clearance. A Cancelled Notification is sent if the release is revoked.

Import

11

Priority Gate-IN

Automated Gate-In Notifications when containers arrive at Metroport with a status of Priority (Only available for Imports via Port of Tauranga).

Import

12

Booking Discrepancy

Difference between Pre-Advice and booking details

Export

13

Hazardous Gate In

Details on when Hazardous containers can be received at the port

Export

14

Load

Loaded onto the vessel

Export

15

No Cedo

Warning that no Customs Export Delivery Order (CEDO) clearance has been received 48/24/2 hrs before vessel arrival

Export

16

Export Cleared / Export Cleared Cancelled

Notification when the CEDO is in place and there are no other stops.

Export

17

Active

Notification will alert you when a container record becomes live in our system (either from BAPLIE or Export Pre-Advice submitted)

Export / Import

17
18

Gate In

Received into a port facility: Sea Port or Inland Port

Export / Import

18
19

PIN Available

Notification that a POAL Express Pin has been obtained via Auto-Request or has changed from Suspended to Available (only available to Trucking companies)

Export / Import

19
20

PIN Suspended

Notification that a POAL Express Pin has changed from Available to Suspended (only available to Trucking companies)

Export / Import

...

What is B2B Registration Of Interest (ROI)?

...

Note: XML Elements are case sensitive and must display exactly as per below

Level

XML Element

Req’d

Repeats

Data Type

Description

0

AutoTrack xmlns:ns0="http://PortConnect/B2BIn/External/B2B_RoI/20132211"

Y

N

--

This is the message header and includes an attribute. This must match exactly what is in the below examples. Please note that the header of the Notification XML is different from the header of the ROI XML as these are two separate processes. The B2B ROI message must always have the ROI header as shown in the below examples.

1

Header

Y

N

--


2

Timestamp

Y

N

Datetime

e.g. 2014-05-31T13:20:00.000

2

SenderReference

Y

N

String

This is your own internal reference to help you identify the ROI request message. The sender reference will be included in the response acknowledgment email you receive from PortConnect but will not be included in Notification emails.

2

CustomerCode

Y

N

String

PortConnect will inform you on what this code is

2

CustomerPassword

N

N

String

Segment is not mandatory but you wish to include it then enter “unknown” - (function still in development)

2

RoIAcknowledgementEmail

Y

Y

String

Semi colon separated list of emails to send the ROI receival Acknowledgment email to

2

ContainerNotificationEmail

Y

N

String

This segment is mandatory but is no longer used. The value can be left blank or your can enter the email from the acknowledgment segment.

1

RegisterOfInterest

Y

N

--


2

Containers

Y

N

--


3

Container

Y

Y

--


4

PartnerPortCode

Y

N

String

NZAKL, NZTRG, NZTIU or

NZTIU

NZLYT

4

ContainerNumber

Y

N

String

Container Number

4

CustomerReference

N

N

String

This is your own internal reference

4

ClientReference

N

N

String

This is your own internal reference

4

SupplyChainCode

Y

N

String

Enter E, I, T or D. E= Export, I= Import, T=Transhipment, D=Domestic. Domestic is used for any container that has Load and Discharge ports that are both in NZ.

4

SpecialInstructions

N

N

String


4

Associates

N

N

--


5

Associate

N

N

--


5

AssociateCode

N

N

String

This field can be used to identify another Trading Party to also send the Notification to

5

ContainerNotificationEmail

N

N

String

Semi colon separated list of emails to send Notification emails to


Customer Reference within the ROI

...

To receive Notifications for both the terminal and inland port, the PartnerPortCode needs to be specified:

PartnerPortCode

Notifications sent for Sea port and Inland Port

NZTRG

NZTRG - Port of Tauranga (Sulphur Point)
NZMKL - MetroPort Auckland

NZAKL

NZAKL - Ports of Auckland 
NZWII - Wiri, Ports of Auckland South Auckland Freight Hub

NZTIU

NZTIU - Timaru Container Terminal
NZOLT - MetroPort Christchurch Rolleston

NZLYT

NZLYT - Lyttelton Port Company
NZCHC - City Depot
NZOLT - MetroPort Christchurch Rolleston

The correct PartnerPortCode and SupplyChainCode must be sent in the ROI message.

E.g. Container ABCD1234567 is an Import at NZTRG.
An ROI is received with SupplyChainCode 'E' (Export) and PartnerPortCode ‘NZAKL’.
This will result in the ROI being queued but no notification will be sent unless anExport version of this container moves through NZAKL.

Once a ROI message is received, PortConnect attempts to identify the container based on the notified Supply Chain and Port codes.

...