Software koppelen aan het LAVS

Inhoud deze pagina

• Koppelvlak
• Mogelijkheden koppelvlak
• Wat heeft u nodig
• Technische gegevens
• Wat moet u doen
• Volgende stap: koppelen met de productieomgeving

Koppelvlak

De koppeling met eigen software is een onderdeel in het LAVS. Alle bedrijven die in het LAVS werken, kunnen van het koppelvlak gebruik maken. Dit is niet verplicht. Het grote voordeel van gebruikmaking van het koppelvlak is dat tweemaal invoeren van gegevens niet nodig is. Ook weet u zeker dat de gegevens in uw eigen bedrijfssysteem en het LAVS met elkaar overeenkomen.

Mogelijkheden koppelvlak

Met het koppelvlak kunt u:

• projecten aanmaken (mits het bezit is aangemaakt via de website)
• opdrachten aannemen, (voorlopig) aannemen, opleveren of afwijzen
• meldingen maken en versturen
• opdrachtgegevens uploaden / bijwerken
• documenten / bijlagen toevoegen
• status opvragen van een eerdere XML request
• projectgegevens downloaden

Wat u nodig heeft

Om te koppelen met de bedrijvenacceptatie-omgeving (verwijst naar een andere website) en het LAVS heeft u de volgende producten en documenten nodig:

• eHerkenningsmiddel (met minimaal betrouwbaarheidsniveau 2) om een account aan te maken.
  Let op: u heeft een eHerkenningsmiddel nodig voor zowel de bedrijvenacceptatieomgeving als voor de productieomgeving.
  Vanaf 1 juli 2025 is eHerkenning niveau 2+ verplicht. Op dit moment wordt alleen niveau 2+ of hoger verstrekt. Heeft u al eHerkenning niveau 2? Daarmee is inloggen in het LAVS nog steeds mogelijk,
• het zip-bestand met het technisch ontwerp-koppelvlak WSDL-definitie (zip, 12 kB) van het LAVS en de koppelvlakspecificatie (Functioneel ontwerp koppelvlak LAVS (pdf, 1.3 MB))
• de eindpunten van de bedrijvenacceptatie- (https://acceptatie.tws-esb.rws.nl/lavs-koppelvlak-bacc (verwijst naar een andere website)) en de productieomgeving (https://tws-esb.rws.nl/lavs-koppelvlak (verwijst naar een andere website))
• mogelijk heeft u het servercertificaat van de LAVS-omgeving ook nodig (het zip-bestand van het publieke deel van het certificaat bedrijvenacceptatieomgeving (m7z, 9.7 kB) en productieomgeving (m7z, 5.4 kB))

Technische gegevens

• Functioneel Ontwerp Berichtenverkeer (pdf, 385 kB)
• Enumeraties (xlsx, 14 kB)

Wat u moet doen

• Vraag eHerkenning beveiligingsniveau 2+ aan. Uw eHerkenningleverancier verstrekt u een pre-prod account voor de bedrijvenacceptatieomgeving.
• Maak een account aan in de bedrijvenacceptatieomgeving (verwijst naar een andere website) met inloggen via eHerkenning.
• Voor de bedrijvenacceptatie- en de productieomgeving van het LAVS heeft u een PKIoverheid service-certificaat nodig. Kijk voor meer informatie op de pagina PKIoverheid van Logius (verwijst naar een andere website). U kunt het certificaat laten activeren voor beide LAVS-omgevingen.
• Installeer het private deel van het certificaat op uw server(s). Doe dit ook met het publieke deel van de LAVS-servercertificaten als dat nodig is.
• Neem contact op met de helpdesk LAVS via het vragenformulier en geef hierbij aan dat u een koppeling wilt maken met de bedrijvenacceptatieomgeving. Voeg in het vragenformulier het publieke deel van uw (PKI-)certificaat toe en vermeld uw KVK-nummer.
• Voer alle testen uit.

Volgende stap: koppelen met de productieomgeving

Zijn alle testen goed gegaan? Neem dan opnieuw contact op met de helpdesk via het vragenformulier. Hierin vraagt u de koppeling te realiseren met de productieomgeving van het LAVS. Stuur hierbij ook het publieke deel van het PKI-certificaat (*.cer of *.crt-formaat) dat u heeft aangeschaft en vermeld uw KVK-nummer.