API Service

Het verschil is voornamelijk gericht op kosten versus informatie. Je kunt in de volgende situatie zonder onze transactie kosten (per B/L) toch de Vertrouwensketen handelingen uitvoeren, maar hier zijn wel voorwaarden aan verbonden.

Scenario's

In twee scenario's kan je toegewezen worden aan een B/L die niet door jezelf is gekoppeld:

1. Een rederij heeft een release toegestuurd voor een B/L die jezelf op dat moment nog niet volgde. Je krijgt de B/L automatisch in het overzicht in Cargo Controller, in het tabje My Release. Je kunt hiervoor een e-mailnotificatie inrichten, hoe je dit kan doen lees je hier.

2. Een andere partij heeft je organisatie aangewezen als ketenpartij voor een B/L die jezelf op dat moment nog niet volgde. Je krijgt de B/L automatisch in het algemene overzicht in Cargo Controller nadat u bent aangewezen als de volgende ketenpartij. Ook hiervoor kan je een e-mailnotificatie inrichten, hoe je dit kan doen lees je hier.

Let op! In onze Cargo Controller API specificatie's zijn er aanvullende details die te maken hebben met een systeemkoppeling. Deze kan je hier lezen.

Basic tracking

Als je zelf een B/L koppelt (via Web of API) is dat voor Portbase een indicator dat er behoefte is aan aanvullende gegevens die wij met jouw organisatie delen. Om die reden rekenen wij per B/L een transactie, dit noemen wij een 'Extended tracking'.

Met de bovenstaande twee scenario's heb je niet zelf gekozen om voor dat B/L aanvullende data op te halen. Voor die situatie koppelt Portbase een 'Basic Tracking', je ziet op dat moment een zeer beperkt hoeveelheid data in de B/L. Dit beeld is op dat moment gelijk aan wat een klant ziet in onze service 'Cargo Release Manager'.

In beide vormen van tracking kunnen de handelingen van de Vertrouwensketen uitgevoerd worden.

Upgrade tracking - via Web

Als je toch meer informatie wilt hebben over de lading, dan is de keuze aan jouw om een 'Basic tracking' om te zetten naar een 'Extended tracking'.

1. Klik op op B/L-niveau
2. Klik op 'Toegang B/L'
   
3. De data wordt nu bijgewerkt. Voor een 'Extended tracking' wordt dan nu een transactie gerekend.

Upgrade tracking - via API

Als je toch meer informatie wilt hebben over de lading, dan is de keuze aan jouw om een 'Basic tracking' om te zetten naar een 'Extended tracking'. Via API stuur je dan een standaard track request in voor dit B/L welke wij zullen beantwoorden met alle beschikbare informatie. Hier lees je daar meer over. Voor een 'Extended tracking' wordt een transactie gerekend.

Ja, ook via de Cargo Controller API.

Je kunt in de volgende situatie zonder onze transactie kosten (per B/L) toch de Vertrouwensketen handelingen uitvoeren, maar hier zijn wel voorwaarden aan verbonden.

Scenario's

In twee scenario's kan je toegewezen worden aan een B/L die niet door jezelf is gekoppeld:

1. Een rederij heeft een release toegestuurd voor een B/L die jezelf op dat moment nog niet volgde. Je krijgt de B/L automatisch in het overzicht in Cargo Controller, in het tabje My Release. Je kunt hiervoor een e-mailnotificatie inrichten, hoe je dit kan doen lees je hier.

2. Een andere partij heeft je organisatie aangewezen als ketenpartij voor een B/L die jezelf op dat moment nog niet volgde. Je krijgt de B/L automatisch in het algemene overzicht in Cargo Controller nadat u bent aangewezen als de volgende ketenpartij. Ook hiervoor kan je een e-mailnotificatie inrichten, hoe je dit kan doen lees je hier.

Let op! In onze Cargo Controller API specificatie's zijn er aanvullende details die te maken hebben met een systeemkoppeling. Deze kan je hier lezen.

Basic tracking

Als je zelf een B/L koppelt (via Web of API) is dat voor Portbase een indicator dat er behoefte is aan aanvullende gegevens die wij met jouw organisatie delen. Om die reden rekenen wij per B/L een transactie, dit noemen wij een 'Extended tracking'.

Met de bovenstaande twee scenario's heb je niet zelf gekozen om voor dat B/L aanvullende data op te halen. Voor die situatie koppelt Portbase een 'Basic Tracking', je ziet op dat moment een zeer beperkt hoeveelheid data in de B/L. Dit beeld is op dat moment gelijk aan wat een klant ziet in onze service 'Cargo Release Manager'.

In beide vormen van tracking kunnen de handelingen van de Vertrouwensketen uitgevoerd worden.

Upgrade tracking - via Web

Als je toch meer informatie wilt hebben over de lading, dan is de keuze aan jouw om een 'Basic tracking' om te zetten naar een 'Extended tracking'.

1. Klik op op B/L-niveau
2. Klik op 'Toegang B/L'
   
3. De data wordt nu bijgewerkt. Voor een 'Extended tracking' wordt dan nu een transactie gerekend.

Upgrade tracking - via API

Als je toch meer informatie wilt hebben over de lading, dan is de keuze aan jouw om een 'Basic tracking' om te zetten naar een 'Extended tracking'. Via API stuur je dan een standaard track request in voor dit B/L welke wij zullen beantwoorden met alle beschikbare informatie. Hier lees je daar meer over. Voor een 'Extended tracking' wordt een transactie gerekend.

Ja en Nee.

Ja, u kunt met een Cargo Controller API abonnement de release ontvangen en uw ketenpartners machtigen en nomineren. Lees daar meer over in onze API specificaties (Engelstalig) en dan met name de Use Cases rondom de Vertrouwensketen.

Nee, u kunt het toevoegen en beheren van klantcodes per rederij en het beheren van authorisaties van ketenpartners niet via API aansturen. Dit zult u via de webschermen moeten onderhouden.

Activatie Vertrouwensketen

Binnen de Cargo Controller API heeft u direct toegang tot de Vertrouwensketen en de informatie die daarin beschikbaar wordt gesteld.

Als u een bestaande klant bent moet u voor de webschermen via uw hoofdgebruiker of gebruikersbeheerder eerst rechten opvragen om deze functionaliteiten in de webschermen vrij te geven. Hier leest u daar meer over.

In de service Melding Container Achterland (MCA) is de EAN-code verplicht bij het maken van een voormelding. Hiermee wordt een bedrijf geïdentificeerd.

Vertrouwensketen

Terminals controleren op de geldigheid van de EAN-code en of de organisatie achter de chauffeur ook de organisatie is die binnen de Vertrouwensketen is. Indien deze match niet gevonden is zal de chauffeur toegang geweigerd worden tot de terminal.

Secure Logistics

De organisatie Secure Logistics geeft een EAN-code uit aan een bedrijf dat zichzelf registreert. Zij checken verschillende gegevens van het bedrijf, zoals de NIWO-vergunning. Om de digitale veiligheid ook in andere services te waarborgen, die onderdeel uitmaken van de Vertrouwensketen, is ervoor gekozen om dit ook in de service Cargo Controller op te nemen.

Om niet steeds de EAN-code handmatig in te moeten voeren, zijn we een adressenboek aan het ontwikkelen. Hierin worden de EAN-codes van bedrijven (automatisch) opgeslagen na een eerste invoer.

Hoe kan ik de EAN-code van mijn vervoerder achterhalen?

Deze kan uw vervoerder aan u aanleveren. U kunt deze ook zelf manueel achterhalen via de webschermen van nomineren:

1. Ga naar de -knop op de container (of B/L) waarvan u de nominatie wilt intrekken en klik op 'Nomineer Vervoerder'.
   
2. Het scherm opent en u kunt hier de naam van uw vervoerder in typen. Wij vullen deze automatisch aan met alle vervoerders die bekend zijn binnen PCS.
   
3. U ziet in de resultaten zowel de vestigingsplaats als het EAN-nummer van de vervoerder. Deze kunt u overnemen voor uw eigen administratie.

Voor de volledige technische specificaties kunt u onze Developer Portal raadplegen.

Indien u gebruik gaat maken van onze API-koppeling moet u, uw webhook bij Portbase registreren. Dit is als het ware het postvak waar uw software alle updates vanuit Cargo Controller ontvangt. Uw IT-specialist of softwareleverancier kan hiervoor zelf een URL aanmaken.

Interface Specialisten

Uw IT-specialist of softwareleverancier wordt in contact gebracht met onze Interface Specialisten. Zij verstrekken de API-keys en stemmen de webhook registratie met elkaar af. U bent op die manier verzekerd dat uw connectie succesvol is geregistreerd.

Meerdere webhooks

Op dit moment ondersteunt Portbase maximaal 2 afwijkende URL's. Dit is met name efficiënt als u gebruik maakt van verschillende systemen die beide, gelijkertijd geupdate moeten worden. Beide URL's ontvangen dan dezelfde B/L updates tegelijkertijd. De transactiekosten zullen hierbij niet verdubbelen, transacties worden geregistreerd op basis van B/L's die u trackt, niet op het aantal updates die u van ons ontvangt.

Als u hier gebruik van wilt maken zult u de tweede webhook als een aanvullende service moeten aanvragen, dit kunt u doen bij de Sales afdeling. Hier zijn eenmalige aansluitkosten aan verbonden.

Ja. Als u gebruik maakt van de systeemkoppeling heeft u ook altijd toegang tot de webschermen.

Als u een B/L koppelt via de systeemkoppeling, dan is deze automatisch ook zichtbaar in de webschermen. Andersom werkt dit ook; als u een B/L koppelt in de webschermen, ontvangt u de updates ook via de API in uw in-huis systeem.

Cargo Controller is beschikbaar als API voor een directe koppeling met uw inhuis-systeem.

Indien u gebruikt wilt maken van de API, neem dan contact op met onze sales afdeling. Zij helpen u bij de aansluiting op onze systeemkoppeling.

Kijk voor de specificaties van onze API op onze developer portal.

Ja, ook via de Cargo Controller API.

Je kunt in de volgende situatie zonder onze transactie kosten (per B/L) toch de Vertrouwensketen handelingen uitvoeren, maar hier zijn wel voorwaarden aan verbonden.

Scenario's

In twee scenario's kan je toegewezen worden aan een B/L die niet door jezelf is gekoppeld:

1. Een rederij heeft een release toegestuurd voor een B/L die jezelf op dat moment nog niet volgde. Je krijgt de B/L automatisch in het overzicht in Cargo Controller, in het tabje My Release. Je kunt hiervoor een e-mailnotificatie inrichten, hoe je dit kan doen lees je hier.

2. Een andere partij heeft je organisatie aangewezen als ketenpartij voor een B/L die jezelf op dat moment nog niet volgde. Je krijgt de B/L automatisch in het algemene overzicht in Cargo Controller nadat u bent aangewezen als de volgende ketenpartij. Ook hiervoor kan je een e-mailnotificatie inrichten, hoe je dit kan doen lees je hier.

Let op! In onze Cargo Controller API specificatie's zijn er aanvullende details die te maken hebben met een systeemkoppeling. Deze kan je hier lezen.

Basic tracking

Als je zelf een B/L koppelt (via Web of API) is dat voor Portbase een indicator dat er behoefte is aan aanvullende gegevens die wij met jouw organisatie delen. Om die reden rekenen wij per B/L een transactie, dit noemen wij een 'Extended tracking'.

Met de bovenstaande twee scenario's heb je niet zelf gekozen om voor dat B/L aanvullende data op te halen. Voor die situatie koppelt Portbase een 'Basic Tracking', je ziet op dat moment een zeer beperkt hoeveelheid data in de B/L. Dit beeld is op dat moment gelijk aan wat een klant ziet in onze service 'Cargo Release Manager'.

In beide vormen van tracking kunnen de handelingen van de Vertrouwensketen uitgevoerd worden.

Upgrade tracking - via Web

Als je toch meer informatie wilt hebben over de lading, dan is de keuze aan jouw om een 'Basic tracking' om te zetten naar een 'Extended tracking'.

1. Klik op op B/L-niveau
2. Klik op 'Toegang B/L'
   
3. De data wordt nu bijgewerkt. Voor een 'Extended tracking' wordt dan nu een transactie gerekend.

Upgrade tracking - via API

Als je toch meer informatie wilt hebben over de lading, dan is de keuze aan jouw om een 'Basic tracking' om te zetten naar een 'Extended tracking'. Via API stuur je dan een standaard track request in voor dit B/L welke wij zullen beantwoorden met alle beschikbare informatie. Hier lees je daar meer over. Voor een 'Extended tracking' wordt een transactie gerekend.