Webservice endepunkt

Blanketmotoren giver jer mulighed for at få tilsendt indsendelsesdata via webservice, således at I vil kunne lave integrationer op mod jeres egne fagsystemer, eksempelvis et sagsbehandlingssystem. Dette kræver dog, at I har opsat en webservice hos jer, som kan modtage data i det format, Blanketmotoren sender i.

Ved valg af webservice som endepunkt skal der angives en adresse på webservicen samt tages stilling til, om der skal anvendes basic auth som sikkerhed eller ej. Ift. adressen er der et krav om, at den skal starte med https://

image-20240321-125334.png

Blanketmotoren tilbyder både SOAP og REST som muligheder for jer, men uanset hvilken af disse, I vælger at gå med, gør nedenstående sig gældende:

Certifikat: Ønsker I at anvende en certifikatbaseret sikkerhedsmodel, er der mulighed for det, men det kræver lidt koordinering. Skriv til blanketmotor@erst.dk for yderligere information.

IP-whitelistning: Hvis I har regler om IP-whitelistning på jeres side og derfor skal give adgang til Blanketmotoren, så skriv til blanketmotor@erst.dk for information om, hvilke IP-adresser, der skal åbnes for.

Transformation af XML inden afsendelse

Det er ifm. afsendelse af indsendelsesdata til webservice muligt at få transformeret den autogenererede XML-data således, at det har et format, der måske passer bedre med jeres modtagende webservice. Dette gøres ved at vælge Transform XML data before dispatch og uploade en XSLT-fil med den ønskede transformation.

Blanketmotorens produktteam yder ikke support på opsætning og fejlsøgning af XSLT-filen, og muligheden for transformation skal derfor udelukkende betragtes som et tilbud, man kan bruge på eget ansvar.

Test webservice ved opsætning af endepunkt

For ikke at skulle lave hele indsendelser hver gang du skal teste en webservice, giver Blanketmotoren mulighed for at teste webservicen under opsætning af endepunkt, hvor du kan sende en valgfri XML-struktur mod det angivne endepunkt og få svar tilbage: