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.
How to get started
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.
XML Requirements
Sending XML
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.
Validation rules include:
- 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
- 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
- Total Pre-Advised Containers must not exceed the booking quanta (count)
- Seal Type must be valid
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.
