Shipment Douane API Interface

Stratech Shipment biedt de mogelijkheid een koppeling te realiseren vanuit het ERP-bedrijfssysteem. Hiermee kan je gegevens vanuit het bedrijfssysteem doorsturen naar Shipment voor het aanmaken en vullen van een aangifte of document. Het is een HTTPS / JSON API gebaseerd op REST principe.

Als je verbinding wilt maken met de Shipment API en deze wilt gebruiken, moet je bekend zijn met het HTTPS-protocol, de JSON gegevensweergave en REST-principes. Minimale vereisten voor de API verbindingen is TLS 1.3. Stratech gebruikt Postman voor interne test doeleinden.

Deze interface is bedoeld voor douaneaangiften. In deze documentversie zijn de interfaces beschreven voor:
DMS Export (4.0)
DMS Import (4.0)
DMS Inbound – ABBI (4.1)
DMS Outbound – ABBU (4.1)
DVA Vertrek (Outbound T1)
DVA Aankomst (Inbound T1)
EMCS Vertrek (accijns)

1. API Settings Configureren

Log in op de Stratech Shipment omgeving:
https://{Prefix}.stratechshipment.nl/

De juiste URL heb je van Stratech ontvangen in een activatie e-mail. Deze e-mail is verstuurd naar degene die de Stratech Shipment omgeving heeft aangevraagd.

Klik op instellingen > Klik op Import > Profielen

Klik op 'Genereer' om het 'Client ID' en 'Client Secret' te laten genereren

Stel de gegenereerde gegevens (client/secret) veilig – Deze zijn achteraf niet meer zichtbaar, dus je kan ze het beste in dit scherm kopiëren en plakken – Dit kan achteraf niet meer.

2. Adresboek Interne Code

Tijdens de configuratie van het Stratech adresboek dient ook een code te worden vastgelegd in de Aangever. Deze code dient te worden gebruikt in de JSON, om zo doende de interne code vanuit de JSON te koppelen aan de gegevens in het adresboek (waaronder het EORI nummer).

Tijdens de “on-boarding” van Stratech geeft een medewerker van Stratech uitleg over het vastleggen van gegevens in het adresboek. In de meeste gevallen is deze uitleg gegeven aan degene die Stratech Shipment heeft aangevraagd.

Tijdens deze stap wordt ook de ‘intern code’ vastgelegd t.b.v. de JSON koppeling. Tijdens deze uitleg is ook gevraagd om de interne code te delen met de ontwikkelaars.



Hieronder staat per bericht type van Stratech, welk JSON element hierbij hoort. In alle voorbeelden hieronder wordt de aangifte uit eigen naam en rekening gedaan.

3. URL set-up (Douane API)

De URL van de Shipment API wordt beschikbaar zodra de Shipment omgeving ‘geactiveerd’ is. De persoon die Shipment ‘aanvraagt’, ontvangt van Stratech een e-mail met daarin een instructie om de  omgeving te activeren. In deze e-mail staat o.a. de basis URL van Shipment.

De bedrijfsnaam van de aanvrager staat verwerkt in de URL. Dus als voorbeeld, stel dat bedrijf “Jansen Logistiek BV” Shipment aanvraagt, dan zou dit de URL kunnen zijn :

4. API Verbinding

Voor het versturen van JSON bestanden of het aanroepen van de swagger pagina, gebruik deze URL’s :

Testomgeving:
JSON Post: https://{Prefix}.shipment-stratech.nl/api/Import/Importdossier
Help page: https://{Prefix}.shipment-stratech.nl/help

Productieomgeving:
JSON Post: https://{Prefix}.stratechshipment.nl/api/Import/Importdossier
Help page: https://{Prefix}.stratechshipment.nl/help

Hierbij moet {Prefix} vervangen worden door de prefix die wordt gebruikt voor je eigen Stratech Shipment omgeving. De inloggegevens van de “API Gebruiker” en de URL moeten worden ingevuld binnen je eigen ERP zodat er een verbinding opgezet kan worden.

Authenticatie

Stratech maakt gebruik van een ‘Bearer token’ voor authenticatie. Om een ‘Bearer token’ op te halen dient
een aanroep te worden gemaakt naar een specifieke URL.

Voor Shipment Test omgevingen: https://shptrainingidentity.stratech.nl/connect/token
Voor Shipment Productie omgevingen: https://identity.stratech.nl/connect/token

Hieronder een voorbeeld van de cURL settings die Stratech zelf gebruikt vanuit Postman. Indien gebruik wordt gemaakt van andere technologieën, dan dien je zelf deze settings te vertalen richting je eigen programmatuur.

curl --location 'https://identity.stratech.nl/connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=INVULLEN DOOR KLANT\
--data-urlencode 'client_secret=INVULLEN DOOR KLANT' \
--data-urlencode 'scope=erpservice'

De geldigheidsduur van het ‘Bearer’ token is 1 uur. Om die reden adviseert Stratech om bij elke API aanroep, tevens een nieuw ‘Bearer token’ op te halen om dit proces automatisch te laten verlopen.

5. Berichten Business 2 Stratech (B2S)

De verschillende berichten voor DMS gebruiken hetzelfde schema. In de huidige versie van de koppeling
geeft de bovenliggende tag aan welk type bericht aangestuurd wordt.

6. Voorbeeldbestanden & Documentatie