Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

API Name

API Description

Container Visit API

A summary of details related to a container visit. B2B equivalent of searching a container on Track & Trace.

Vessel Schedule API

A summary of all Vessel Schedule information. B2B equivalent of searching the Vessel Schedule on the PortConnect website.

Container Visit Event API

Register interest in container visits and event types and then PortConnect will send you event information when those events occur.

Vessel schedule Event API

Register interest in container vessel visits and event types and then PortConnect will send you event information when those events occur.

Export Pre-Advice API

Send pre-advice to PortConnect directly from your system rather than manually entering the data via our website.

...

Container Visit and Container Visit Event Combo

Most of our users B2B customers use a combination of the Container Visit Event API and the Container Visit Event API. Users subscribe to specific events and get informed when they happen then they call the Container Visit API to check any other details that may have changed against the container visit.

See the discount section to understand why this is the preferred method.

What Container event types are available?

...

Event Type

Description

Gate In/Out

Gate events can occur across multiple facilities. Gate events include the specific facility location information.

Line Release, MPI Release, Customs Release, Available, Cleared

These events all have a corresponding Cancelled version that you must subscribe to separately. Clearances can be revoked or updated and PortConnect records a Cancelled type event when this occurs. Once the issue has been resolved then a new release event will be created with a new event time.

VBS Changed

As trucking companies plan and replan their jobs, VBS bookings may be cancelled and changed. This event will be sent each time a booking is changed.

Vessel ETA/ETD

When can I use the container

...

data APIs? When will container data be available?

Containers will only show up in the APIs when the containers have been created in the ports' systems. For Imports this occurs when the port loads the Baplie (aka the vessel manifest) and for exports this occurs when a pre-advice has been submitted. See the combination section).

How does the pricing work?

...

  1. Customs/MPI/Line release

  2. Container created via Baplie (Active)

  3. Cleared event recorded

  4. Discharge

  5. Available event recorded

  6. VBS obtained or Rail booked (rules vary by port)

  7. LFT set

  8. Gate Out of Seaport

  9. Gate in at Inland Port (Optional)

  10. LFT Changed (Optional)

  11. Gate out of inland port (Optional)

  12. Empty container returned to a depot (Depot Gate In)

Exports

  1. Container pre-advised (Active)

  2. CEDO applied (Export Cleared)

  3. VBS obtained

  4. Gate In at Inland Port (Optional)

  5. Gate Out of Inland Port (Optional)

  6. Gate In at Seaport

  7. Load

...

Where should we begin with an API integration?

  1. Send a link to our detailed technical documents to your developers/software provider and they can confirm if/how your system could process the APIs.

  2. Determine what data you are interested in processing into your system.

  3. Once you have determined what data you want and your developers have read the documentation then PortConnect is available to answer any process or technical questions you might have. Send an email to info@portconnect.co.nz to get started.