Cargo Controller Import information in your own systems
Getting started with the Cargo Controller Import API
The Cargo Controller Import API is useful for any organisation that tracks more than 20 Bills of Lading (B/Ls) per week and wishes to automate its import processes. Among other things, the API allows you to prepare customs declarations and automatically process status updates for cargo arriving via Dutch ports.
Here you can read about the experiences of other users and learn how to prepare your organisation before requesting the API.
Benefits of an API integration
- Processing of all cargo status updates directly within your own system.
- Full automation regarding Customs blocks and missing statuses, enabling faster action and the prevention of delays.
- Visibility for critical moments in the logistics process, tailored to your own workflows and alerts.
How do I prepare for an API implementation?
Thorough preparation speeds up the implementation timeline. Based on experience with other companies, a standard implementation takes approximately 12 weeks. Assemble a project team comprising the following roles:
Developers
One or more developers with knowledge of RESTful APIs, security, and JSON Web Tokens.
Consultant
A consultant from your software vendor, if the API is not developed in-house.
Forwarder
(Optional) an experienced forwarder with knowledge of the import process and the associated alerts
Customs declarant
(Optional) a customs declarant familiar with the benefits of Import Documentation Notification. Read more here.
Implementation choices
When setting up a system integration with Portbase, you have two implementation options to choose from. Make this decision in consultation with your implementation team beforehand. There are pros and cons for both options. The choice is a matter of preference and also depends on whether or not you are working with a software vendor known to Portbase.
1 . Testing in the production environment
Use the production environment for the implementation. Suitable when you want to activate the integration quickly and in a controlled manner.
2 . Testing in a test environment
Test the integration in a separate environment first before deploying it to production. This is ideal for validating processes and settings in advance.
An article containing the API specifications is available for developers. It also outlines the steps for connecting to our test and/or production environments.
Choose a software suplier
Check whether your software provider is already known to Portbase. If you work with a partner that has already connected, the lead time is often significantly shorter. On averaging 4–8 weeks.
More insight via Premium Terminal Data add-ons
Choose ‘Premium Terminal Data’ and receive additional data elements from deep-sea container terminals ECT, RWG and APMT. This allows you to rely on more accurate ETA/ETD, ship and cargo information. In addition, it provides an estimated unloading time for each import container, based on the unloading sequence, taken directly from the terminal planning system.
Read all about this add-on and the associated terms and conditions on the Premium Terminal Data page. It is important to make an informed decision beforehand about whether or not to add this to your system, ensuring the data is immediately available once the integration is complete.
Service description
The Cargo Controller Import API uses webhooks (web callbacks or HTTP push API). When new status updates become available, the API automatically sends them to the endpoint specified by your organization. Portbase manages this webhook registration and ensures that updates are transmitted reliably and securely. You can find the specifications on this website.
Costs
If you are already using the Cargo Controller Import web screens, the service fees remain unchanged; you only pay the one-time setup fee for the API integration.
Please note: If you request an (additional) webhook at a later stage, we will charge an extra fee for it. If you request the webhook at the time the integration is set up, no additional charges will apply.
Frequently asked questions about API integrations
Om een API of systeemkoppeling te maken met Portbase heb je een IAMconnected account nodig. Als je een account hebt, kan je een systeemkoppeling aanvragen via het aanvraagformulier en selecteer de service Cargo Controller Import.
Ja, dat is mogelijk. De uitgebreide uitleg hoe, vind je terug in het uitgebreide artikel Cargo Controller Import API implementeren op onze supportomgeving.
Ja, deze zijn beschikbaar voor zowel het technisch aansluiten als voor het functionele proces.
Zoals je zal herkennen is het importeren van lading altijd gebonden aan verschillende scenario’s. CCI API biedt veel datapunten aan waardoor veel scenario’s te herkennen of te herleiden zijn in onze updates.
Het zo breed mogelijk implementeren van onze updates zorgt ervoor dat je organisatie zoveel mogelijk toegevoegde waarde haalt uit deze service.
Veel voorkomende scenario’s hebben we uitgewerkt in use cases per onderwerp. Deze vind je terug in het artikel Cargo Controller Import API implementeren op onze supportomgeving.
Ja lees het artikel Extra webhook aanvragen voor Cargo Import Controller op onze supportomgeving.
Portbase kan jouw RSA-sleutel roteren. Dit doen we niet standaard, maar kun je aangeven bij de aanvraag of tijdens de test periode. We hanteren een minimale frequentie van 3 maanden en de overgangsperiode is maximaal 2 weken. Neem deze beslissing mee in je implementatietraject, al kun je dit ook op een later moment toevoegen.
Portbase blijft altijd haar services ontwikkelen, voor Cargo Controller Import wordt frequent onderhoud gepleegd, maar ook toegevoegde waarde aangevuld. Via e-mail aan de (hoofd)gebruikers, inservice berichten aan gebruikers in de webportal en via onze Softwareleveranciers delen wij onze laatste ontwikkelingen.
More about Cargo Controller Import
-
Cargo Controller Import
Full visibility when tracking your cargo.