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.
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.
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 |
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.
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.
Must provide a valid booking
Load Port must match the booking
Load Port must be valid
Line Operator code must be valid
Line Operator code must match the booking
Vessel Visit must match the booking
Discharge Port must match the booking
Reefer ISO type containers must have a Temperature (unless specified as a Non-Operating Reefer)
Freight Kind (Full vs Empty) must match the booking
Reefer temperatures must match the booking
Conditioning details must match the booking. Conditioning details include: Humidity %, Vent value, Vent Type, O2% and CO2%
Hazard UN Codes must match the booking
Container ISO Type Groups much match the booking.
Total Pre-Advised Containers must not exceed the booking quanta (count)
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.
Contact the PortConnect team, info@portconnect.co.nz, to advise that you would like to develop B2B Pre-Advice.
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.
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.
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.
End-to-end testing will be done through the PortConnect test environment.
Once the testing is complete you will be able to start sending B2B Pre-Advice messages to PortConnect.
Note: XML Elements are case sensitive and must display exactly as per below
Level | XML Element | Required 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 | 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. | ALL |
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. | 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 | offPowerTemperature | N | N | Float | NO LONGER SUPPORTED | NZAKL |
4 | maximumOffPowerHours | N | N | Float | Number in hours. This must be whole numbers - no decimal points. This should be calculated from the offPowerTimestamp datetime. | NZAKL |
4 | offPowerTimestamp | N | N | Datetime | e.g. 2014-05-31T13:20:00.000 | NZAKL |
4 | onPowerTargetTime | N | N | Datetime | NO LONGER SUPPORTED | NZAKL |
4 | timeAllowedOffPowerHours | N | N | Float | Number in hours. This must be whole numbers - no decimal points. Applies to after Gate-In time. When including this segment you must also supply <timeAllowedOffPowerMinutes> If the time allowed off power is a whole number supply: <timeAllowedOffPowerHours>Xhours<timeAllowedOffPowerHours> <timeAllowedOffPowerMinutes>0<timeAllowedOffPowerMinutes> | NZTRG, NZTIU |
4 | timeAllowedOffPowerMinutes | N | N | Float | Number in Minutes. This must be whole numbers - no decimal points. Applies to after Gate-In time. When including this segment you must also supply <timeAllowedOffPowerHours> If the time allowed off power is a whole number supply: <timeAllowedOffPowerHours>Xhours<timeAllowedOffPowerHours> <timeAllowedOffPowerMinutes>0<timeAllowedOffPowerMinutes> If the time allowed off power is a whole less than 1 hour supply: <timeAllowedOffPowerHours>0<timeAllowedOffPowerHours> <timeAllowedOffPowerMinutes>Xminutes<timeAllowedOffPowerMinutes> | 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 | ALL |
4 | packagingGroup | N | N | Float | Values: 0, 1, 2 or 3. If no packaging group then select 0. | ALL |
4 | limitedQuantities | N | N | Boolean | Either true or false - must be lower case. | ALL |
4 | marinePollutant | N | N | Boolean | Either true or false - must be lower case. | ALL |
4 | hazardousWeight | N | N | Float | Weight of the hazardous cargo. Must be in KGs. | ALL |
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. | ALL |
4 | flashPoint | N | N | Float | Range: -999-999 | NZTRG, NZTIU |
4 | medicalFirstAidGuide | N | N | String (50) | NZTRG, NZTIU | |
4 | contactPhone | N | N | String (50) | ALL | |
4 | contactName | N | N | String (255) | ALL | |
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 |
XSDs for the Pre-Advice and Acknowledgment:
<?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:ns0="http://PortConnect.ExportPreAdvice.BizTalk.GenericXML/201404" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://PortConnect.ExportPreAdvice.BizTalk.GenericXML/201404" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="PreadviseContainerRequest"> <xs:complexType> <xs:sequence> <xs:element name="header"> <xs:complexType> <xs:sequence> <xs:element name="MessageType" type="xs:string" /> <xs:element name="TradingPartnerCode" type="xs:string" /> <xs:element name="PartnerPortCode" type="xs:string" /> <xs:element name="BusinessNotificationEmailList" type="xs:string" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="PreAdvice"> <xs:complexType> <xs:sequence> <xs:element name="Shipper"> <xs:complexType> <xs:sequence> <xs:element name="shipperReference" type="xs:string" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element maxOccurs="unbounded" name="Equipment"> <xs:complexType> <xs:sequence> <xs:element name="equipmentID" type="xs:string" /> <xs:element name="MessageAction" type="xs:string" /> <xs:element name="IMEX" /> </xs:sequence> <xs:attribute name="equipmentType" type="xs:string" use="required" /> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> |
<?xml version="1.0" encoding="utf-16"?> <schema xmlns:tns="http://PortConnect.ExportPreAdvice.BizTalk.Common/201208" xmlns:b="http://schemas.microsoft.com/BizTalk/2003" xmlns:ns0="https://PortConnect.ExportPreAdvice.BizTalk.Common.Schemas.Property_PreAdviceCanonical" elementFormDefault="qualified" targetNamespace="http://PortConnect.ExportPreAdvice.BizTalk.Common/201208" xmlns="http://www.w3.org/2001/XMLSchema"> <element name="PreadviceContainerResult" type="tns:Message"> </element> <complexType name="Header"> <sequence> <element minOccurs="1" maxOccurs="1" name="MessageID" type="string" /> <element name="MessageType" type="string" /> <element name="TradingPartnerCanonicalID" type="string" /> <element name="PartnerPortCanonicalID" type="string" /> <element minOccurs="0" maxOccurs="1" name="NotificationType"> <simpleType> <restriction base="string"> <enumeration value="Business" /> <enumeration value="Functional" /> </restriction> </simpleType> </element> <element minOccurs="0" maxOccurs="1" name="AcknowledgementType"> <simpleType> <restriction base="string"> <enumeration value="ACK" /> <enumeration value="NACK" /> </restriction> </simpleType> </element> <element minOccurs="0" maxOccurs="1" name="ValidationErrors" type="string" /> </sequence> </complexType> <complexType name="PreAdvice"> <sequence minOccurs="1" maxOccurs="1"> <element maxOccurs="unbounded" name="equipment" type="tns:Equipment" /> <element minOccurs="0" maxOccurs="1" name="comments"> <simpleType> <restriction base="string"> <maxLength value="255" /> </restriction> </simpleType> </element> </sequence> <attribute name="gateType"> <simpleType> <restriction base="string"> <enumeration value="GATEIN" /> <enumeration value="GATEOUT" /> </restriction> </simpleType> </attribute> </complexType> <complexType name="Equipment"> <sequence minOccurs="1" maxOccurs="1"> <element minOccurs="1" maxOccurs="1" name="equipmentID"> <simpleType> <restriction base="string"> <maxLength value="14" /> </restriction> </simpleType> </element> <element name="BusinessAcknowledgement"> <simpleType> <restriction base="string"> <enumeration value="Succeed" /> <enumeration value="Fail" /> </restriction> </simpleType> </element> <element minOccurs="0" name="Errors" type="tns:ErrorMessages" /> </sequence> </complexType> <complexType name="Message"> <sequence> <element name="header" type="tns:Header" /> <element maxOccurs="unbounded" name="PreAdvice" type="tns:PreAdvice" /> </sequence> </complexType> <xs:complexType name="ErrorMessages" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:sequence minOccurs="0" maxOccurs="unbounded"> <xs:element minOccurs="0" maxOccurs="unbounded" name="ErrorID" type="xs:integer"> <xs:annotation> <xs:documentation>0 = succcess. Not zero = failure</xs:documentation> </xs:annotation> </xs:element> <xs:element minOccurs="0" maxOccurs="unbounded" name="ErrorText" type="xs:string"> <xs:annotation> <xs:documentation>Contains the error message to be displayed to the user or sent back to the trading party via B2B, as appropriate</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType> </schema> |
You can view the PortConnect code lists here, CODE LISTS.
<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: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>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:marinePollutant>false</ns0:marinePollutant> <ns0:hazardousWeight>400</ns0:hazardousWeight> <ns0:emsCode>F-AS-A</ns0:emsCode> <ns0:medicalFirstAidGuide>2</ns0:medicalFirstAidGuide> <ns0:flashPoint>-1</ns0:flashPoint> <ns0:contactPhone>0212345678</ns0:contactPhone> <ns0:contactName>John Smith</ns0:contactName> </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:marinePollutant>false</ns0:marinePollutant> <ns0:hazardousWeight>400</ns0:hazardousWeight> <ns0:emsCode>F-AS-A</ns0:emsCode> <ns0:medicalFirstAidGuide>2</ns0:medicalFirstAidGuide> <ns0:flashPoint>-999</ns0:flashPoint> <ns0:contactPhone>0212345678</ns0:contactPhone> <ns0:contactName>John Smith</ns0:contactName> </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_Name</ns0:arrivalCarrier> <ns0:pointOfOriginCode>pointOfOriginCode_0</ns0:pointOfOriginCode> </ns0:Equipment> <ns0:comments>comments</ns0:comments> </ns0:PreAdvice> </ns0:PreadviseContainerRequest> |
<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> |
<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> |
<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>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:marinePollutant>false</ns0:marinePollutant> <ns0:hazardousWeight>400</ns0:hazardousWeight> <ns0:emsCode>F-AS-A</ns0:emsCode> <ns0:medicalFirstAidGuide>2</ns0:medicalFirstAidGuide> <ns0:flashPoint>1</ns0:flashPoint> <ns0:contactPhone>0212345678</ns0:contactPhone> <ns0:contactName>John Smith</ns0:contactName> </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:marinePollutant>false</ns0:marinePollutant> <ns0:hazardousWeight>400</ns0:hazardousWeight> <ns0:emsCode>F-AS-A</ns0:emsCode> <ns0:medicalFirstAidGuide>2</ns0:medicalFirstAidGuide> <ns0:flashPoint>-999</ns0:flashPoint> <ns0:contactPhone>0212345678</ns0:contactPhone> <ns0:contactName>John Smith</ns0:contactName> </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> |
<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> |
<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> |
A cancel message only needs 5 key pieces of information to succeed:
Trading Partner
Partner Port
User Reference
Container Number
Message Action
If the message includes these 5 pieces of information then PortConnect can extract the remaining details from the latest successful submission and populate these details before processing the cancellation.
<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></ns0:name> <ns0:shipperReference>Internal Reference</ns0:shipperReference> </ns0:Shipper> <ns0:Equipment equipmentType="CONTAINER"> <ns0:equipmentID>TEST1234567</ns0:equipmentID> <ns0:isoTypeCode></ns0:isoTypeCode> <ns0:isFull></ns0:isFull> <ns0:commodityCode></ns0:commodityCode> <ns0:LoadPortFacility></ns0:LoadPortFacility> <ns0:MessageAction>Cancel</ns0:MessageAction> <ns0:refrigeration> <ns0:isFantainer>false</ns0:isFantainer> </ns0:refrigeration> <ns0:IMEX> <ns0:LineOperatorCode></ns0:LineOperatorCode> <ns0:shipName></ns0:shipName> <ns0:voyageNumber></ns0:voyageNumber> <ns0:partnerPortshippingReference></ns0:partnerPortshippingReference> <ns0:loadPortCode></ns0:loadPortCode> <ns0:portOfDischarge></ns0:portOfDischarge> <ns0:foreignPortOfDischarge></ns0:foreignPortOfDischarge> <ns0:bookingReference></ns0:bookingReference> </ns0:IMEX> <ns0:CargoWeight></ns0:CargoWeight> <ns0:TotalWeight></ns0:TotalWeight> <ns0:containerSeals> <ns0:SealType></ns0:SealType> <ns0:SealCode></ns0:SealCode> </ns0:containerSeals> <ns0:arrivalCarrierType></ns0:arrivalCarrierType> <ns0:pointOfOriginCode></ns0:pointOfOriginCode> </ns0:Equipment> </ns0:PreAdvice> </ns0:PreadviseContainerRequest> |
Date | Change |
---|---|
2024/01/04 | Acknowledgment response XSD added. |
2023/05/31 | Cancel action message example added. |
2022/10/11 | XSD updated. |
2022/05/26 |
|