Cargo Controller Import informatie in jouw eigen systemen
Aan de slag met de Cargo Controller Import API
De Cargo Controller Import API is handig voor alle organisaties die wekelijks meer dan 20 B/L’s volgen en hun importprocessen willen automatiseren. Met de API kun je onder andere Douane aangiften voorbereiden en statusupdates automatisch verwerken voor lading die via Nederlandse havens binnenkomt.
Hier lees je ervaringen van andere gebruikers en hoe je jouw organisatie kunt voorbereiden voordat je de API aanvraagt.
Voordelen
- Directe verwerking van alle statusupdates van je lading in je eigen systemen.
- Volledige automatisering van blokkades en ontbrekende statussen, zodat je sneller kunt handelen en vertragingen voorkomt.
- Inzicht in cruciale momenten in het logistieke proces, afgestemd op je eigen workflows en alerts.
Hoe bereid ik een API-implementatie voor?
Een goede voorbereiding versnelt de doorlooptijd. Op basis van ervaringen bij andere bedrijven duurt een standaardimplementatie gemiddeld circa 12 weken. Stel een projectgroep samen met de volgende rollen:
Developers
Een of meer developers of ontwikkelaars met kennis van van Restfull API, beveiliging en JSON Web Tokens.
Consultant
Een consultant van je softwareleverancier wanneer de API niet in-house ontwikkeld wordt.
Expediteur
(Optioneel) een ervaren expediteur met kennis van het het importproces en de bijbehorende alerts
Douane-Declarant
(Optioneel) een Douane-declarant die bekend is met de voordelen van Melding Import Documentatie. Lees hier meer.
Implementatie keuzes
Wanneer je een systeemkoppeling met Portbase maakt heb je de keuze uit twee implementatie mogelijkheden. Maak deze keuze vooraf met jouw implementatie team. Voor beide keuzes zijn voor- en nadelen te benoemen. De keuze is persoonlijk en daarnaast ligt het eraan of je werkt met een voor Portbase bekende softwareleverancier of niet.
1 . Testen op de productieomgeving
Gebruik direct de productieomgeving voor de implementatie. Geschikt wanneer je de koppeling snel en gecontroleerd wilt activeren.
2 . Testen in een testomgeving
Test de koppeling eerst in een aparte omgeving voordat je deze in productie neemt. Ideaal om processen en instellingen vooraf te valideren.
Voor de developers is een een artikel beschikbaar met de API-specificaties. Hierin verwijzen we ook naar de stappen om aan te sluiten op onze testomgeving en/of productie omgeving.
Kies een softwareleverancier
Controleer of jouw softwareleverancier al bekend is bij Portbase. Werk je met een partner die al eerder heeft aangesloten, dan is de doorlooptijd vaak aanzienlijk korter, namelijk gemiddeld 4–8 weken.
Aanvullende mogelijkheden: Premium Terminal Data
De service Cargo Controller Import kan je aanvullen met de add-on Premium Terminal Data. Dit zijn de data punten rechtstreeks afkomstig van deepsea containerterminals Rotterdam World Gateway (RWG), Hutchison Ports ECT Rotterdam (ECT) en APM Terminals (APMT).
Lees alles over deze add-on en voorwaarden op de pagina Premium Terminal Data. Het is belangrijk om vooraf een bewuste keuze te maken of je deze wel of niet wil toevoegen in je systeem, zodat de data direct beschikbaar is op het moment dat de integratie afgerond is.
Service kenmerken
De Cargo Controller Import API werkt met webhooks (web callback of HTTP push API). Wanneer er nieuwe statusupdates beschikbaar zijn, stuurt de API deze automatisch naar het door jouw organisatie opgegeven endpoint. Portbase beheert deze webhookregistratie en zorgt ervoor dat updates betrouwbaar en veilig worden verzonden. De specificaties vind je op deze website.
Kosten
Wanneer je al werkt met de webschermen van Cargo Controller Import, blijven de servicekosten gelijk. Je betaalt alleen de eenmalige aansluitkosten voor de API-koppeling.
Let op: Vraag je later in het proces alsnog een (aanvullende) webhook aan, dan brengen we hiervoor extra kosten in rekening. Vraag je de webhook direct aan bij het starten van de koppeling, dan worden hiervoor geen extra kosten berekend.
Veelgestelde vragen over API-koppelingen
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.
Meer over Cargo Controller
-
Cargo Controller Import
Inzicht in het volgen van je lading