Cargo Controller Import-Informationen in Ihren eigenen Systemen
Erste Schritte mit der Cargo Controller Import API
Die Cargo Controller Import API ist nützlich für alle Organisationen, die wöchentlich mehr als 20 B/Ls verfolgen und ihre Importprozesse automatisieren möchten. Mit der API können Sie unter anderem Zollanmeldungen vorbereiten und Statusupdates für Ladungen, die über niederländische Häfen eingehen, automatisch verarbeiten.
Hier lesen Sie Erfahrungen anderer Nutzer und wie Sie Ihre Organisation vorbereiten können, bevor Sie die API beantragen.

Vorteile einer API-Verbindung
- Direkte Verarbeitung aller Statusupdates Ihrer Ladung in Ihren eigenen Systemen.
- Vollständige Automatisierung von Blockaden und fehlenden Status, damit Sie schneller handeln und Verzögerungen vermeiden können.
- Einblick in entscheidende Momente im Logistikprozess, abgestimmt auf Ihre eigenen Workflows und Benachrichtigungen.
Wie bereite ich eine API-Implementierung vor?
Eine gute Vorbereitung beschleunigt die Durchlaufzeit. Basierend auf Erfahrungen bei anderen Unternehmen dauert eine Standardimplementierung durchschnittlich etwa 12 Wochen. Stellen Sie eine Projektgruppe mit den folgenden Rollen zusammen:
Entwickler
Ein oder mehrere Entwickler mit Kenntnissen in Bezug auf RESTful APIs, Sicherheit und JSON Web Tokens.
Berater
Ein Berater Ihres Softwareanbieters, wenn die API nicht intern entwickelt wird.
Spediteur
(Optional) ein erfahrener Spediteur mit Kenntnissen des Importprozesses und der dazugehörigen Benachrichtigungen.
Zoll-Deklarant
(Optional) ein Zoll-Deklarant, der mit den Vorteilen der Notification Import Documentation (NID) vertraut ist. Hier erfahren Sie mehr.
Implementierungsentscheidungen
Wenn Sie eine Systemverbindung mit Portbase herstellen, haben Sie die Wahl zwischen zwei Implementierungsmöglichkeiten. Treffen Sie diese Wahl vorab mit Ihrem Implementierungsteam. Für beide Optionen lassen sich Vor- und Nachteile benennen. Diese Entscheidung ist individuell und hängt zudem davon ab, ob Sie mit einem für Portbase bekannten Softwareanbieter arbeiten oder nicht.
1 . Testen op de proin der Produktionsumgebung
Nutzen Sie direkt die Produktionsumgebung für die Implementierung. Geeignet, wenn Sie die Verbindung schnell und kontrolliert aktivieren möchten.
2 . Testen in einer Testumgebung
Testen Sie die Verbindung zuerst in einer separaten Umgebung, bevor Sie diese in Produktion nehmen. Ideal, um Prozesse und Einstellungen vorab zu validieren.
Für die Entwickler ist ein ein Artikel mit den API-Spezifikationen verfügbar. Hierin verweisen wir auch auf die Schritte, um eine Verbindung zu unserer Testumgebung und/oder Produktionsumgebung herzustellen.
Wählen Sie einen Softwareanbieter
Überprüfen Sie, ob Ihr Softwareanbieter bei Portbase bereits bekannt ist. Wenn Sie mit einem Partner zusammenarbeiten, der bereits früher eine Verbindung hergestellt hat, ist die Durchlaufzeit oft deutlich kürzer, nämlich durchschnittlich 4 bis 8 Wochen.
Servicefunktionen
Die Cargo Controller Import API arbeitet mit Webhooks (Web-Callback oder HTTP-Push-API). Wenn neue Status-Updates verfügbar sind, sendet die API diese automatisch an den von Ihrer Organisation angegebenen Endpunkt. Portbase verwaltet diese Webhook-Registrierung und stellt sicher, dass Updates zuverlässig und sicher übertragen werden. Die Spezifikationen finden Sie auf dieser Website.
Kosten
Wenn Sie bereits mit den Web-Bildschirmen von Cargo Controller Import arbeiten, bleiben die Servicekosten gleich. Sie zahlen lediglich die einmaligen Anschlusskosten für die API-Verbindung.
Anmerkung: Wenn Sie später im Prozess dennoch einen (zusätzlichen) Webhook beantragen, berechnen wir hierfür zusätzliche Kosten. Beantragen Sie den Webhook direkt bei Beginn der Verbindung, werden hierfür keine zusätzlichen Kosten berechnet.
Häufig gestellte Fragen zu API-Verbindungen
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.
