B2B XML Pre-Advice On-Boarding Guide

 

What is B2B Pre-Advice?

Business to Business (B2B) Pre-Advice is a way pre-advise export containers by sending pre-advice details in an XML format to PortConnect. The export information can be extracted from your system in the XML format and sent to PortConnect. PortConnect will automatically process the file and email back a confirmation of success or failure.

This is an alternative to manual Pre-Advice through the PortConnect website.

What is XML?

Extensible Markup Language (XML) defines a set of rules for encoding documents in a format which is both human-readable and machine-readable. The XML standard is a flexible way to create information formats and electronically share structured data via the public Internet, as well as via corporate networks.

The XML format can be used by any individual or group of individuals or companies that want to share information in a consistent way.

How can the XML file be sent to PortConnect?

XML files can be sent by FTPS or email. Please confirm which option you would like to use and we can provide you with further details. If you are sending the file by email the body of the email needs to be blank and the only attachment should be the XML file. Any other attachments may stop the XML file from being processed. 

The file name and the email subject can be anything. 

PortConnect Terms & Conditions

Before using PortConnect B2B Pre-Advice you must send written confirmation that you accept PortConnect’s Terms & Conditions to info@portconnect.co.nz

How will I know if the Pre-Advice has succeeded?

Automated acknowledgement emails can be sent which confirm whether individual containers were successful or not.

The emails contain two boxes, a green box in which successful containers will display and a red box in which unsuccessful containers will display.

Containers in the green box show all the key details of the container. You can use this email to share the details with other parties.

Any unsuccessful containers will show in the red box with a comment about why the Pre-Advice was not successful. The same message also appears on the PortConnect website.

The emails also contain an XML file which records the status of the Pre-Advice.

These emails can be set up to be automatically sent to multiple email addresses. If you would like to receive these messages automatically please let us know the email address(es) you would like them sent to.

Functional Notifications (Validation Rules)

If a Pre-Advice message has missing or incorrect information then the pre-advice will not be sent to the port and the submitter will be sent a Functional Notification email (also called a validation error message). The validation error message will identify which data is missing or incorrect.

Validation rules include:

  1. Must provide a valid booking

  2. Load Port must match the booking

  3. Load Port must be valid

  4. Line Operator code must be valid

  5. Line Operator code must match the booking

  6. Vessel Visit must match the booking

  7. Discharge Port must match the booking

  8. Reefer ISO type containers must have a Temperature (unless specified as a Non-Operating Reefer)

  9. Freight Kind (Full vs Empty) must match the booking

  10. Reefer temperatures must match the booking

  11. Conditioning details must match the booking. Conditioning details include: Humidity %, Vent value, Vent Type, O2% and CO2%

  12. Hazard UN Codes must match the booking

  13. Total Pre-Advised Containers must not exceed the booking quanta (count)

  14. Seal Type must be valid

If you receive one of these Functional Notification emails please check and amend the information before resubmitting the Pre-Advice. You may need to contact your shipping line to request that they update their booking.

 

How do I get started with XML Pre-Advice?

  1. Contact the PortConnect team, info@portconnect.co.nz, to advise that you would like to develop B2B Pre-Advice.

  2. Send a link to this page to your IT team and they can review it and confirm whether your system can produce a XML file which meets the format and requirements listed below.

  3. Once your IT team has developed the XML message you can contact info@portconnect.co.nz and let us know that you are ready to start testing. Please send PortConnect at least two test messages.

  4. PortConnect will review the test messages to confirm that they are in the correct format. Your IT team may need to make some revisions to the message format.

  5. End-to-end testing will be done through the PortConnect test environment.

  6. Once the testing is complete you will be able to start sending B2B Pre-Advice messages to PortConnect.

XML Format

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

Level

XML Element

Reqired segments

Repeats

Data Type

Description

Applicable Port

0

PreadviseContainerRequest

Y

N

--

This is the message header and includes an attribute. This must match exactly what is in the below examples.

ALL

1

header

Y

N

--



ALL

2

MessageType

Y

N

String

Enter “ExportPreAdvice”

ALL

2

TradingPartnerCode

Y

N

String

Portconnect will inform you on what this code is

ALL

2

PartnerPortCode

Y

N

String

This is either NZAKL, NZTRG or NZTIU

ALL

2

BusinessNotificationEmailList

Y

N

String

Semi colon separated list of emails to send Pre-Advice Acknowledgment emails to

ALL

2

UserName

Y

N

String

PortConnect login name

ALL

2

UserPassword

N

N

String

Enter “unknown” (function still in development)

ALL

1

PreAdvice

Y

N

--



ALL

2

Shipper

Y

N

--



ALL

3

name

Y

N

String (40)

The name of the Exporter or the party with the contract with the shipping line. This is a Code. Please provide PortConnect with a list of shippers and PortConnect will provide the relevant code.

ALL

3

shipperReference

Y

N

String

This is your own internal reference and can be anything

ALL

2

Consignee

N

N

--



NZTRG, NZTIU

3

name

Y

N

String (40)

Contact PortConnect to confirm if you need to include this or not. This field is used to facilitate billing at the port.

NZTRG, NZTIU

2

Equipment

Y

Y

String

Add a space then add the following attribute to the the opening element ‘equipmentType=’. Then include the following text: “CONTAINER” – Include the speech marks. The Equipment segment and all relevant sub-segments repeat when adding multiple containers.

ALL

3

equipmentID

Y

N

String (11)

Container Number

ALL

3

attachedEquipmentIDs

N

N

--

Segment to list bundled flatrack containers.

NZTRG, NZTIU

4

equipmentID

Y

Y

String (11)

Container Number

NZTRG, NZTIU

3

isoTypeCode

Y

N

String

e.g. 2210, 4500 etc using the UN standard ISO codes

ALL

3

flexiTank

N

N

Boolean

Either true or false - must be lower case.

NZTRG, NZTIU

3

isFull

Y

N

Boolean

Either true or false - must be lower case

ALL

3

isNonOperatingReefer

N

N

Boolean

Either true or false - must be lower case. If True then Refrigeration segment does not need to be included.

NZTRG, NZTIU

3

commodityCode

Y

N

String

e.g. 10, 1701, 081050 etc using the Harmonised System codes here, Commodity Code List. Enter the commodity which makes up the greatest percentage of the container

ALL

3

LoadPortFacility

Y

N

String

This is the facility the container will be delivered to.
NZTRG locations are: “MET” - Metroport Auckland and “TCT” – Tauranga Container Terminal.
NZAKL location is: “Auckland”
NZTIU locations are: “ROL” – Metroport Rolleston and “PPT” Timaru Container Terminal

ALL

3

MessageAction

Y

N

String

For new Pre-Advice or updates to previously submitted containers enter “Create”. To Cancel a previously submitted incorrect container number enter "Cancel".

ALL

3

refrigeration

Y

N

String

If the container is a reefer, add a space then add the following attribute to the the opening element ‘refrigerationType=’. Then include one of the following options: “FROZEN”, “CHILLED”, “INSULATED”, “HOT” – Include the speech marks

ALL

4

isFantainer

Y

N

Boolean

Either true or false - must be lower case.

ALL

4

maximumOffPowerHours

N

N

Float

Number in hours. This must be whole numbers - no decimal points.

ALL

4

offPowerTemperature

N

N

Float

Temperature

ALL

4

offPowerTimestamp

N

N

Datetime

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

ALL

4

onPowerTargetTime

N

N

Datetime

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

ALL

4

timeAllowedOffPowerHours

N

N

Float

Number in hours. This must be whole numbers - no decimal points. Applies to after Gate-In time.

NZTRG, NZTIU

4

timeAllowedOffPowerMinutes

N

N

Float

Number in Minutes. This must be whole numbers - no decimal points. Applies to after Gate-In time.

NZTRG, NZTIU

4

activeRefrigerationRequired

N

N

Boolean

Either true or false - must be lower case.

NZTRG, NZTIU

4

requiredTemperature

*

N

Float

*If the container is a reefer then this field is required. Put a minus symbol in front of the number if it is a negative number.

ALL

4

humidityPercent

N

N

Float

Humidity percentage

ALL

4

co2Percent

N

N

Float

CO2 percentage

ALL

4

o2Percent

N

N

Float

O2 percentage

ALL

3

vent

N

N

--



ALL

4

VentSettingType

N

N

String

Value list: PercentageOpen, FlowM3PerHour

ALL

4

VentSetting

N

N

Float



ALL

3

IMEX

Y

N

--



ALL

4

LineOperatorCode

Y

N

String

MAEU, ACLU, HSUD etc. See the following list for all Shipping Lines.

ALL

4

shipName

Y

N

String

Name of the vessel - This element is mandatory but the content can be blank if you have entered the partnerPortshippingReference details

ALL

4

voyageNumber

Y

N

String

Voyage number - This element is mandatory but the content can be blank if you have entered the partnerPortshippingReference details

ALL

4

partnerPortshippingReference

Y

N

String (20)

Vessel reference – This element is mandatory but the content can be blank if you have entered the shipName and voyageNumber details. If you are not entering a value then the element needs to be in one of the following formats:

<ns0:partnerPortshippingReference></ns0:partnerPortshippingReference>

<ns0:partnerPortshippingReference/>

If the element has a space in between then this can cause the Pre-Advice to fail.

Note - in additon to the above, PortConnect will attempt to populate the Vessel Reference directly from the booking in preference of any details supplied by the pre-adviser. This is intended to reduce booking discrepancies.

ALL

4

loadPortCode

Y

N

String

NZAKL, NZTRG or NZTIU

ALL

4

portOfDischarge

Y

N

String

As per the vessel voyage rotation - UN Location code.

If you don't know what this value is you can leave the element empty and PortConnect can populate this value for you if the shipping line has sent a valid booking. If the value cannot be populated from the booking then you will receive a validation error and you will be required to populate the value yourself before the Pre-Advice can be submitted to the port.

ALL

4

foreignPortOfDischarge

N

N

String

Final destination port - UN Location code

ALL

4

overseasDestinationFinal

N

N

String

Final destination - UN Location code

ALL

4

cutOffTimestamp

N

N

Datetime

Final export gate in time for vessel

ALL

4

bookingReference

Y

N

String (20)

Shipping Line booking reference - Must be capitals. Only 1 booking per Pre-Advice message. Mixing bookings may result it validation errors.

ALL

4

customsClearanceNumber

N

N

String (16)

If known

ALL

4

exportEntryNumber

N

N

String (16)

If known

ALL

3

CargoWeight

Y

N

Float

Weight of the cargo. Must be in KGs.

ALL

3

TotalWeight

Y

N

Float

This segment is where you must enter the Verified Gross Mass of the container. Must be in KGs.

ALL

3

hazardous

N

Y

--



ALL

4

hazardousClass

N

N

String (25)

e.g. 1.1f, 1.1g etc.

ALL

4

UNNumber

N

N

String (20)

e.g. 0005, 0121 etc

ALL

4

quantity

N

N

String

Number and Type of packages e.g. 2 Pallets or 1 box

NZTRG, NZTIU

4

packagingGroup

N

N

Float

Values: 0, 1, 2 or 3. If no packaging group then select 0.

NZTRG, NZTIU

4

limitedQuantities

N

N

Boolean

Either true or false - must be lower case.

NZTRG, NZTIU

4

marinePollutants

N

N

Boolean

Either true or false - must be lower case.

NZTRG, NZTIU

4

hazardousWeight

N

N

Float

Weight of the hazardous cargo. Must be in KGs.

NZTRG, NZTIU

4

emsCode

N

N

String (20)

Fire Rating and Spill Rating. F-A to F-Z and S-A to S-Z. No space between values.

NZTRG, NZTIU

4

HazardousContact

 

 

 

 

NZTRG, NZTIU

5

phone

N

N

String (50)

 

NZTRG, NZTIU

5

name

N

N

String (255)

 

NZTRG, NZTIU

3

overGauge

N

Y

--



ALL

4

OverDimensionArea

N

N

String

Value list: Back, Front, Top, Bottom, Left, Right. Note - this segment is case sensitive and the values must be entered exactly as recorded here with Proper Case.

ALL

4

OverDimensionUOM

N

N

String

Value: CENTIMETER

ALL

4

OverDimensionMeasure

N

N

Double

This is the cm measurement of the over dimension

ALL

3

containerSeals

Y

Y

--



ALL

4

SealType

Y

N

String

Value list: NZFSA, LineOperator, Shipper, Other.

If you enter a value that is not on our approved list then the Pre-Advice will fail.

NZFSA stands for NZ Food Safety Authority and this is the seal type you must enter when using MPI seals.

If you are using a shipping line seal then you can enter the seal type as LineOperator.

ALL

4

SealCode

Y

N

String

The seal number. This field most only include alphanumeric characters - It must not include any special characters.

ALL

3

arrivalCarrierType

Y

N

String

Value list: Truck, Rail. This is the mode of arrival at the receival facility which can be an inland port or directly to the Seaport

ALL

3

arrivalCarrier

N

N

String

See the following list for all Arrival Carrier Codes. This segment is currently only sent to Port of Tauranga.

ALL

3

pointOfOriginCode

Y

N

String

Location where the container was packed or the goods originated from - UN Location code. If your location is not in the list then use the nearest UN location

ALL

2

comments

N

N

String (255)

Additional comments (not currently read by the ports)

ALL



XML XSD

XSDs for the Pre-Advice and Acknowledgment: Pre-adviceGenericXML.XSD



Code Lists

You can view the PortConnect code lists here, CODE LISTS.



B2B Pre-Advice XML Example Messages

All Fields Example

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 <ns0:PreadviseContainerRequest xmlns:ns0="http://PortConnect.ExportPreAdvice.BizTalk.GenericXML/201404"> <ns0:header> <ns0:MessageType>ExportPreAdvice</ns0:MessageType> <ns0:TradingPartnerCode>TradingPartnerCode_0</ns0:TradingPartnerCode> <ns0:PartnerPortCode>DestinationPortCode_0</ns0:PartnerPortCode> <ns0:BusinessNotificationEmailList>EmailList_0</ns0:BusinessNotificationEmailList> <ns0:UserName>yourusername</ns0:UserName> <ns0:UserPassword>yourpassword</ns0:UserPassword> </ns0:header> <ns0:PreAdvice> <ns0:Shipper> <ns0:name>name</ns0:name> <ns0:shipperReference>shipperReference_0</ns0:shipperReference> </ns0:Shipper> <ns0:Consignee> <ns0:name>name</ns0:name> </ns0:Consignee> <ns0:Equipment equipmentType="CONTAINER"> <ns0:equipmentID>equipmentIDequ</ns0:equipmentID> <ns0:attachedEquipmentIDs> <ns0:equipmentID>aaaaaaaaaa</ns0:equipmentID> <ns0:equipmentID>bbbbbbbbbb</ns0:equipmentID> </ns0:attachedEquipmentIDs> <ns0:isoTypeCode>isoTypeCode_0</ns0:isoTypeCode> <ns0:flexiTank>true</ns0:flexiTank> <ns0:isFull>true</ns0:isFull> <ns0:isNonOperatingReefer>false</ns0:isNonOperatingReefer> <ns0:commodityCode>commodityCode_0</ns0:commodityCode> <ns0:LoadPortFacility>LoadPortFacility_0</ns0:LoadPortFacility> <ns0:MessageAction>Create</ns0:MessageAction> <ns0:refrigeration refrigerationType="FROZEN"> <ns0:isFantainer>true</ns0:isFantainer> <ns0:maximumOffPowerHours>10</ns0:maximumOffPowerHours> <ns0:offPowerTemperature>10</ns0:offPowerTemperature> <ns0:offPowerTimestamp>2014-05-31T13:20:00.000</ns0:offPowerTimestamp> <ns0:onPowerTargetTime>2014-05-31T13:20:00.000</ns0:onPowerTargetTime> <ns0:timeAllowedOffPowerHours>2</ns0:timeAllowedOffPowerHours> <ns0:timeAllowedOffPowerMinutes>3</ns0:timeAllowedOffPowerMinutes> <ns0:activeRefrigerationRequired>true</ns0:activeRefrigerationRequired> <ns0:requiredTemperature>10</ns0:requiredTemperature> <ns0:humidityPercent>10</ns0:humidityPercent> <ns0:co2Percent>10</ns0:co2Percent> <ns0:o2Percent>10</ns0:o2Percent> </ns0:refrigeration> <ns0:vent> <ns0:VentSettingType>PercentageOpen</ns0:VentSettingType> <ns0:VentSetting>10</ns0:VentSetting> </ns0:vent> <ns0:IMEX> <ns0:LineOperatorCode>LineOperatorCode_0</ns0:LineOperatorCode> <ns0:shipName>shipName_0</ns0:shipName> <ns0:voyageNumber>voyageNumber_0</ns0:voyageNumber> <ns0:partnerPortshippingReference>partnerPor</ns0:partnerPortshippingReference> <ns0:loadPortCode>loadPortCode_0</ns0:loadPortCode> <ns0:portOfDischarge>portOfDischarge_0</ns0:portOfDischarge> <ns0:foreignPortOfDischarge>foreignPortOfDischarge_0</ns0:foreignPortOfDischarge> <ns0:overseasDestinationFinal>overseasDe</ns0:overseasDestinationFinal> <ns0:cutOffTimestamp>1999-05-31T13:20:00.000</ns0:cutOffTimestamp> <ns0:bookingReference>BOOKINGREF1</ns0:bookingReference> <ns0:customsClearanceNumber>customsClearance</ns0:customsClearanceNumber> <ns0:exportEntryNumber>exportEntryNumbe</ns0:exportEntryNumber> </ns0:IMEX> <ns0:CargoWeight>2000</ns0:CargoWeight> <ns0:TotalWeight>4000</ns0:TotalWeight> <ns0:hazardous> <ns0:hazardousClass>1.2G</ns0:hazardousClass> <ns0:UNNumber>0009</ns0:UNNumber> <ns0:quantity>2</ns0:quantity> <ns0:packagingGroup>2</ns0:packagingGroup> <ns0:limitedQuantities>true</ns0:limitedQuantities> <ns0:marinePollutants>true</ns0:marinePollutants> <ns0:hazardousWeight>200</ns0:hazardousWeight> <ns0:emsCode>F-DS-C</ns0:emsCode> <ns0:HazardousContact> <ns0:phone>0212345678</ns0:phone> <ns0:name>John Smith</ns0:name> </ns0:HazardousContact> </ns0:hazardous> <ns0:hazardous> <ns0:hazardousClass>4.1</ns0:hazardousClass> <ns0:UNNumber>2001/<ns0:UNNumber> <ns0:quantity>1</ns0:quantity> <ns0:packagingGroup>1</ns0:packagingGroup> <ns0:limitedQuantities>false</ns0:limitedQuantities> <ns0:hazardousWeight>400</ns0:hazardousWeight> <ns0:emsCode>F-AS-A</ns0:emsCode> <ns0:HazardousContact> <ns0:phone>0212345678</ns0:phone> <ns0:name>John Smith</ns0:name> </ns0:HazardousContact> </ns0:hazardous> <ns0:overGauge> <ns0:OverDimensionArea>Back</ns0:OverDimensionArea> <ns0:OverDimensionUOM>CENTIMETER</ns0:OverDimensionUOM> <ns0:OverDimensionMeasure>10</ns0:OverDimensionMeasure> </ns0:overGauge> <ns0:overGauge> <ns0:OverDimensionArea>Left</ns0:OverDimensionArea> <ns0:OverDimensionUOM>CENTIMETER</ns0:OverDimensionUOM> <ns0:OverDimensionMeasure>25</ns0:OverDimensionMeasure> </ns0:overGauge> <ns0:containerSeals> <ns0:SealType>NZFSA</ns0:SealType> <ns0:SealCode>SealCode1</ns0:SealCode> </ns0:containerSeals> <ns0:containerSeals> <ns0:SealType>Shipper</ns0:SealType> <ns0:SealCode>SealCode2</ns0:SealCode> </ns0:containerSeals> <ns0:arrivalCarrierType>Truck</ns0:arrivalCarrierType> <ns0:arrivalCarrier>Carrier_Code</ns0:arrivalCarrier> <ns0:pointOfOriginCode>pointOfOriginCode_0</ns0:pointOfOriginCode> </ns0:Equipment> <ns0:comments>comments</ns0:comments> </ns0:PreAdvice> </ns0:PreadviseContainerRequest>

 

General Container Example

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 <ns0:PreadviseContainerRequest xmlns:ns0="http://PortConnect.ExportPreAdvice.BizTalk.GenericXML/201404"> <ns0:header> <ns0:MessageType>ExportPreAdvice</ns0:MessageType> <ns0:TradingPartnerCode>COMPANYCODE</ns0:TradingPartnerCode> <ns0:PartnerPortCode>NZTRG</ns0:PartnerPortCode> <ns0:BusinessNotificationEmailList>info@portconnect.co.nz;info@portconnect.co.nz</ns0:BusinessNotificationEmailList> <ns0:UserName>UserA</ns0:UserName> <ns0:UserPassword>Password123</ns0:UserPassword> </ns0:header> <ns0:PreAdvice> <ns0:Shipper> <ns0:name>Export Company Name</ns0:name> <ns0:shipperReference>Internal Reference</ns0:shipperReference> </ns0:Shipper> <ns0:Equipment equipmentType="CONTAINER"> <ns0:equipmentID>TEST1234567</ns0:equipmentID> <ns0:isoTypeCode>4200</ns0:isoTypeCode> <ns0:isFull>true</ns0:isFull> <ns0:commodityCode>commodityCode_0</ns0:commodityCode> <ns0:LoadPortFacility>TCT</ns0:LoadPortFacility> <ns0:MessageAction>Create</ns0:MessageAction> <ns0:refrigeration> <ns0:isFantainer>false</ns0:isFantainer> </ns0:refrigeration> <ns0:IMEX> <ns0:LineOperatorCode>MAEU</ns0:LineOperatorCode> <ns0:shipName>LEXA MAERSK</ns0:shipName> <ns0:voyageNumber>458N</ns0:voyageNumber> <ns0:partnerPortshippingReference>LEX1234</ns0:partnerPortshippingReference> <ns0:loadPortCode>NZTRG</ns0:loadPortCode> <ns0:portOfDischarge>AUSYD</ns0:portOfDischarge> <ns0:foreignPortOfDischarge>USLAX</ns0:foreignPortOfDischarge> <ns0:bookingReference>951265789</ns0:bookingReference> </ns0:IMEX> <ns0:CargoWeight>14000</ns0:CargoWeight> <ns0:TotalWeight>18000</ns0:TotalWeight> <ns0:containerSeals> <ns0:SealType>Shipper</ns0:SealType> <ns0:SealCode>ABC789</ns0:SealCode> </ns0:containerSeals> <ns0:arrivalCarrierType>Truck</ns0:arrivalCarrierType> <ns0:pointOfOriginCode>NZAKS</ns0:pointOfOriginCode> </ns0:Equipment> </ns0:PreAdvice> </ns0:PreadviseContainerRequest>

 



Reefer Container Example

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 <ns0:PreadviseContainerRequest xmlns:ns0="http://PortConnect.ExportPreAdvice.BizTalk.GenericXML/201404"> <ns0:header> <ns0:MessageType>ExportPreAdvice</ns0:MessageType> <ns0:TradingPartnerCode>TradingPartnerCode_0</ns0:TradingPartnerCode> <ns0:PartnerPortCode>DestinationPortCode_0</ns0:PartnerPortCode> <ns0:BusinessNotificationEmailList>EmailList_0</ns0:BusinessNotificationEmailList> <ns0:UserName>yourusername</ns0:UserName> <ns0:UserPassword>unknown</ns0:UserPassword> </ns0:header> <ns0:PreAdvice> <ns0:Shipper> <ns0:name>name</ns0:name> <ns0:shipperReference>shipperReference_0</ns0:shipperReference> </ns0:Shipper> <ns0:Equipment equipmentType="CONTAINER"> <ns0:equipmentID>equipmentIDequ</ns0:equipmentID> <ns0:isoTypeCode>isoTypeCode_0</ns0:isoTypeCode> <ns0:isFull>true</ns0:isFull> <ns0:commodityCode>commodityCode_0</ns0:commodityCode> <ns0:LoadPortFacility>LoadPortFacility_0</ns0:LoadPortFacility> <ns0:MessageAction>Create</ns0:MessageAction> <ns0:refrigeration refrigerationType="FROZEN"> <ns0:isFantainer>true</ns0:isFantainer> <ns0:maximumOffPowerHours>10</ns0:maximumOffPowerHours> <ns0:offPowerTemperature>10</ns0:offPowerTemperature> <ns0:offPowerTimestamp>2014-05-31T13:20:00.000</ns0:offPowerTimestamp> <ns0:onPowerTargetTime>2014-05-31T13:20:00.000</ns0:onPowerTargetTime> <ns0:timeAllowedOffPowerHours>2</ns0:timeAllowedOffPowerHours> <ns0:timeAllowedOffPowerMinutes>3</ns0:timeAllowedOffPowerMinutes> <ns0:activeRefrigerationRequired>true</ns0:activeRefrigerationRequired> <ns0:requiredTemperature>10</ns0:requiredTemperature> <ns0:humidityPercent>10</ns0:humidityPercent> <ns0:co2Percent>10</ns0:co2Percent> <ns0:o2Percent>10</ns0:o2Percent> </ns0:refrigeration> <ns0:vent> <ns0:VentSettingType>PercentageOpen</ns0:VentSettingType> <ns0:VentSetting>10</ns0:VentSetting> </ns0:vent> <ns0:IMEX> <ns0:LineOperatorCode>LineOperatorCode_0</ns0:LineOperatorCode> <ns0:shipName>shipName_0</ns0:shipName> <ns0:voyageNumber>voyageNumber_0</ns0:voyageNumber> <ns0:partnerPortshippingReference>partnerPor</ns0:partnerPortshippingReference> <ns0:loadPortCode>loadPortCode_0</ns0:loadPortCode> <ns0:portOfDischarge>portOfDischarge_0</ns0:portOfDischarge> <ns0:foreignPortOfDischarge>foreignPortOfDischarge_0</ns0:foreignPortOfDischarge> <ns0:bookingReference>BOOKINGREF1</ns0:bookingReference> </ns0:IMEX> <ns0:CargoWeight>16000</ns0:CargoWeight> <ns0:TotalWeight>18000</ns0:TotalWeight> <ns0:containerSeals> <ns0:SealType>Shipper</ns0:SealType> <ns0:SealCode>SealCode1</ns0:SealCode> </ns0:containerSeals> <ns0:arrivalCarrierType>Truck</ns0:arrivalCarrierType> <ns0:pointOfOriginCode>pointOfOriginCode_0</ns0:pointOfOriginCode> </ns0:Equipment> </ns0:PreAdvice> </ns0:PreadviseContainerRequest>



Hazardous Container Example

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 <ns0:PreadviseContainerRequest xmlns:ns0="http://PortConnect.ExportPreAdvice.BizTalk.GenericXML/201404"> <ns0:header> <ns0:MessageType>ExportPreAdvice</ns0:MessageType> <ns0:TradingPartnerCode>TradingPartnerCode_0</ns0:TradingPartnerCode> <ns0:PartnerPortCode>DestinationPortCode_0</ns0:PartnerPortCode> <ns0:BusinessNotificationEmailList>EmailList_0</ns0:BusinessNotificationEmailList> <ns0:UserName>yourusername</ns0:UserName> <ns0:UserPassword>yourpassword</ns0:UserPassword> </ns0:header> <ns0:PreAdvice> <ns0:Shipper> <ns0:name>name</ns0:name> <ns0:shipperReference>shipperReference_0</ns0:shipperReference> </ns0:Shipper> <ns0:Equipment equipmentType="CONTAINER"> <ns0:equipmentID>equipmentIDequ</ns0:equipmentID> <ns0:isoTypeCode>isoTypeCode_0</ns0:isoTypeCode> <ns0:isFull>true</ns0:isFull> <ns0:commodityCode>commodityCode_0</ns0:commodityCode> <ns0:LoadPortFacility>LoadPortFacility_0</ns0:LoadPortFacility> <ns0:MessageAction>Create</ns0:MessageAction> <ns0:refrigeration>         <ns0:isFantainer>false</ns0:isFantainer> </ns0:refrigeration> <ns0:IMEX> <ns0:LineOperatorCode>LineOperatorCode_0</ns0:LineOperatorCode> <ns0:shipName>shipName_0</ns0:shipName> <ns0:voyageNumber>voyageNumber_0</ns0:voyageNumber> <ns0:partnerPortshippingReference>partnerPor</ns0:partnerPortshippingReference> <ns0:loadPortCode>loadPortCode_0</ns0:loadPortCode> <ns0:portOfDischarge>portOfDischarge_0</ns0:portOfDischarge> <ns0:foreignPortOfDischarge>foreignPortOfDischarge_0</ns0:foreignPortOfDischarge> <ns0:bookingReference>BOOKINGREF1</ns0:bookingReference> </ns0:IMEX> <ns0:CargoWeight>16000</ns0:CargoWeight> <ns0:TotalWeight>18000</ns0:TotalWeight> <ns0:hazardous> <ns0:hazardousClass>1.2G</ns0:hazardousClass> <ns0:UNNumber>0009</ns0:UNNumber> <ns0:quantity>2</ns0:quantity> <ns0:packagingGroup>2</ns0:packagingGroup> <ns0:limitedQuantities>true</ns0:limitedQuantities> <ns0:marinePollutants>true</ns0:marinePollutants> <ns0:hazardousWeight>200</ns0:hazardousWeight> <ns0:emsCode>F-DS-C</ns0:emsCode> <ns0:HazardousContact> <ns0:phone>0212345678</ns0:phone> <ns0:name>John Smith</ns0:name> </ns0:HazardousContact> </ns0:hazardous> <ns0:hazardous> <ns0:hazardousClass>4.1</ns0:hazardousClass> <ns0:UNNumber>2001/<ns0:UNNumber> <ns0:quantity>1</ns0:quantity> <ns0:packagingGroup>1</ns0:packagingGroup> <ns0:limitedQuantities>false</ns0:limitedQuantities> <ns0:marinePollutants>false</ns0:marinePollutants> <ns0:hazardousWeight>400</ns0:hazardousWeight> <ns0:emsCode>F-AS-A</ns0:emsCode> <ns0:HazardousContact> <ns0:phone>0212345678</ns0:phone> <ns0:name>John Smith</ns0:name> </ns0:HazardousContact> </ns0:hazardous> <ns0:containerSeals> <ns0:SealType>Shipper</ns0:SealType> <ns0:SealCode>SealCode1</ns0:SealCode> </ns0:containerSeals> <ns0:arrivalCarrierType>Truck</ns0:arrivalCarrierType> <ns0:pointOfOriginCode>pointOfOriginCode_0</ns0:pointOfOriginCode> </ns0:Equipment> </ns0:PreAdvice> </ns0:PreadviseContainerRequest>



Out-Of-Gage Container Example

 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 <ns0:PreadviseContainerRequest xmlns:ns0="http://PortConnect.ExportPreAdvice.BizTalk.GenericXML/201404">  <ns0:header> <ns0:MessageType>ExportPreAdvice</ns0:MessageType> <ns0:TradingPartnerCode>TradingPartnerCode_0</ns0:TradingPartnerCode> <ns0:PartnerPortCode>DestinationPortCode_0</ns0:PartnerPortCode> <ns0:BusinessNotificationEmailList>EmailList_0</ns0:BusinessNotificationEmailList> <ns0:UserName>yourusername</ns0:UserName> <ns0:UserPassword>yourpassword</ns0:UserPassword> </ns0:header> <ns0:PreAdvice> <ns0:Shipper> <ns0:name>name</ns0:name> <ns0:shipperReference>shipperReference_0</ns0:shipperReference> </ns0:Shipper> <ns0:Equipment equipmentType="CONTAINER"> <ns0:equipmentID>equipmentIDequ</ns0:equipmentID> <ns0:isoTypeCode>isoTypeCode_0</ns0:isoTypeCode> <ns0:isFull>true</ns0:isFull> <ns0:commodityCode>commodityCode_0</ns0:commodityCode> <ns0:LoadPortFacility>LoadPortFacility_0</ns0:LoadPortFacility> <ns0:MessageAction>Create</ns0:MessageAction> <ns0:refrigeration>   <ns0:isFantainer>false</ns0:isFantainer> </ns0:refrigeration> <ns0:IMEX> <ns0:LineOperatorCode>LineOperatorCode_0</ns0:LineOperatorCode> <ns0:shipName>shipName_0</ns0:shipName> <ns0:voyageNumber>voyageNumber_0</ns0:voyageNumber> <ns0:partnerPortshippingReference>partnerPor</ns0:partnerPortshippingReference> <ns0:loadPortCode>loadPortCode_0</ns0:loadPortCode> <ns0:portOfDischarge>portOfDischarge_0</ns0:portOfDischarge> <ns0:foreignPortOfDischarge>foreignPortOfDischarge_0</ns0:foreignPortOfDischarge> <ns0:bookingReference>BOOKINGREF1</ns0:bookingReference> </ns0:IMEX> <ns0:CargoWeight>16000</ns0:CargoWeight> <ns0:TotalWeight>18000</ns0:TotalWeight> <ns0:overGauge> <ns0:OverDimensionArea>Top</ns0:OverDimensionArea> <ns0:OverDimensionUOM>CENTIMETER</ns0:OverDimensionUOM> <ns0:OverDimensionMeasure>310.00</ns0:OverDimensionMeasure> </ns0:overGauge> <ns0:overGauge> <ns0:OverDimensionArea>Left</ns0:OverDimensionArea> <ns0:OverDimensionUOM>CENTIMETER</ns0:OverDimensionUOM> <ns0:OverDimensionMeasure>50.00</ns0:OverDimensionMeasure> </ns0:overGauge> <ns0:containerSeals> <ns0:SealType>Shipper</ns0:SealType> <ns0:SealCode>SealCode1</ns0:SealCode> </ns0:containerSeals> <ns0:arrivalCarrierType>Truck</ns0:arrivalCarrierType> <ns0:pointOfOriginCode>pointOfOriginCode_0</ns0:pointOfOriginCode> </ns0:Equipment> </ns0:PreAdvice>  </ns0:PreadviseContainerRequest>



Multiple Containers Example

 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 <ns0:PreadviseContainerRequest xmlns:ns0="http://PortConnect.ExportPreAdvice.BizTalk.GenericXML/201404"> <ns0:header> <ns0:MessageType>ExportPreAdvice</ns0:MessageType> <ns0:TradingPartnerCode>COMPANYCODE</ns0:TradingPartnerCode> <ns0:PartnerPortCode>NZTRG</ns0:PartnerPortCode> <ns0:BusinessNotificationEmailList>info@portconnect.co.nz;info@portconnect.co.nz</ns0:BusinessNotificationEmailList> <ns0:UserName>UserA</ns0:UserName> <ns0:UserPassword>Password123</ns0:UserPassword> </ns0:header> <ns0:PreAdvice> <ns0:Shipper> <ns0:name>Export Company Name</ns0:name> <ns0:shipperReference>Internal Reference</ns0:shipperReference> </ns0:Shipper> <ns0:Equipment equipmentType="CONTAINER"> <ns0:equipmentID>TEST1234567</ns0:equipmentID> <ns0:isoTypeCode>4200</ns0:isoTypeCode> <ns0:isFull>true</ns0:isFull> <ns0:commodityCode>commodityCode_0</ns0:commodityCode> <ns0:LoadPortFacility>TCT</ns0:LoadPortFacility> <ns0:MessageAction>Create</ns0:MessageAction> <ns0:refrigeration> <ns0:isFantainer>false</ns0:isFantainer> </ns0:refrigeration> <ns0:IMEX> <ns0:LineOperatorCode>MAEU</ns0:LineOperatorCode> <ns0:shipName>LEXA MAERSK</ns0:shipName> <ns0:voyageNumber>458N</ns0:voyageNumber> <ns0:partnerPortshippingReference>LEX1234</ns0:partnerPortshippingReference> <ns0:loadPortCode>NZTRG</ns0:loadPortCode> <ns0:portOfDischarge>AUSYD</ns0:portOfDischarge> <ns0:foreignPortOfDischarge>USLAX</ns0:foreignPortOfDischarge> <ns0:bookingReference>951265789</ns0:bookingReference> </ns0:IMEX> <ns0:CargoWeight>14000</ns0:CargoWeight> <ns0:TotalWeight>18000</ns0:TotalWeight> <ns0:containerSeals> <ns0:SealType>Shipper</ns0:SealType> <ns0:SealCode>ABC789</ns0:SealCode> </ns0:containerSeals> <ns0:arrivalCarrierType>Truck</ns0:arrivalCarrierType> <ns0:pointOfOriginCode>NZAKS</ns0:pointOfOriginCode> </ns0:Equipment>  <ns0:Equipment equipmentType="CONTAINER">  <ns0:equipmentID>TEST1234510</ns0:equipmentID>  <ns0:isoTypeCode>2200</ns0:isoTypeCode>  <ns0:isFull>true</ns0:isFull>  <ns0:commodityCode>commodityCode_0</ns0:commodityCode>  <ns0:LoadPortFacility>TCT</ns0:LoadPortFacility>  <ns0:MessageAction>Create</ns0:MessageAction>  <ns0:refrigeration>  <ns0:isFantainer>false</ns0:isFantainer> </ns0:refrigeration>  <ns0:IMEX> <ns0:LineOperatorCode>MAEU</ns0:LineOperatorCode> <ns0:shipName>LEXA MAERSK</ns0:shipName> <ns0:voyageNumber>458N</ns0:voyageNumber> <ns0:partnerPortshippingReference>LEX1234</ns0:partnerPortshippingReference> <ns0:loadPortCode>NZTRG</ns0:loadPortCode> <ns0:portOfDischarge>AUSYD</ns0:portOfDischarge> <ns0:foreignPortOfDischarge>USLAX</ns0:foreignPortOfDischarge> <ns0:bookingReference>951265789</ns0:bookingReference> </ns0:IMEX> <ns0:CargoWeight>16000</ns0:CargoWeight>  <ns0:TotalWeight>18000</ns0:TotalWeight>  <ns0:containerSeals>  <ns0:SealType>Shipper</ns0:SealType>  <ns0:SealCode>ABC123</ns0:SealCode>  </ns0:containerSeals>  <ns0:arrivalCarrierType>Truck</ns0:arrivalCarrierType>  <ns0:pointOfOriginCode>NZAKS</ns0:pointOfOriginCode>  </ns0:Equipment> </ns0:PreAdvice> </ns0:PreadviseContainerRequest>

 

 

Related Articles