Voor softwareontwikkelaars

Het is mogelijk om de meldingen aan het LMA te doen via hiervoor ontwikkelde software. De software stuurt dan de meldingen via een beveiligde verbinding naar het meldsysteem AMICE.

Op deze pagina

Specificaties voor meldsoftware

Meldingen via de software moeten plaatsvinden via bestanden in een zogenaamd XML-formaat. De specificaties zijn vastgelegd in het volgende document.

Download de xml-specificaties (versie 3.1) (pdf, 1.5 MB)

Naast deze specificaties is het aan te bevelen een aantal checks in te bouwen waardoor uw klant geen meldingen kan doen die technisch worden afgekeurd. Een voorbeeld is een check waarbij alle verplicht ingevulde velden ook daadwerkelijk zijn ingevuld.

Software testen

Voor het testen van uw software stellen wij een testomgeving van AMICE beschikbaar. U heeft voor de testomgeving een account nodig. Die kunt u aanvragen door met eHerkenning op de testomgeving in te loggen.

Via de volgende links gaat u naar de XML-webservices voor de testomgeving:

Controleren of het certificaat nog geldig is

Wilt u weten of uw AMICE-certificaat geldig is? Klik dan op 1 van de volgende links en log in met uw gebruikersnaam en wachtwoord. Lukt dat? Dan is uw certificaat geldig.

Voorbeelden XML-berichten

Er zijn voorbeelden van XML berichten beschikbaar. Klik op een van de onderstaande links als u een voorbeeld wilt downloaden. Let op: om de berichten te kunnen downloaden heeft u een toegangsaccount voor de testomgeving van AMICE nodig:

WSDL van de AMICE-webservices

Wilt u de WSDL van de AMICE-webservices downloaden? Doorloop dan de volgende stappen:

Vraag een toegangsaccount voor de testomgeving van AMICE aan.
Stuur hierna een mail naar de LMA helpdesk zodat uw toegangsaccount kan worden goedgekeurd.
Genereer een XML certificaat via de menuoptie ‘Uw profiel’.
Open één van de onderstaande links in de testomgeving.

Voor de XML-Webservices:

Speciale tekens in XML-bericht

Wilt u een speciaal teken maken in een XML-bericht? Doe dit dan op dezelfde manier als in een HTML-bericht. Bijvoorbeeld: de code <is<

Melding 'false' of '500 error' bij versturen XML-bericht

Als u de melding 'false' of '500 error' krijgt, voldoet uw XML-bericht niet aan alle regels. Hierdoor krijgt u géén retourbericht. Hier kunt u de XML-specificatie van AMICE downloaden: XML-specificatie

Krijgt u de melding 'true' en krijgt u toch geen retourbericht? Bel dan de LMA-helpdesk.

Melding 'request entity too large'

Het bericht dat u stuurt, is te groot. Deel het bericht in kleine stukken, bijvoorbeeld minder meldingen in een bericht. Stuur deze kleinere berichten apart naar AMICE.