Documenten en voorbeelden

Waar kan ik de XML-specificatie van AMICE downloaden?

Hier kunt u de XML-specificatie van de AMICE koppelvlakken downloaden:

  • Versie 2.1.1 - Vanaf juni 2022 niet meer beschikbaar
  • Versie 3.0 – Beschikbaar vanaf april 2022 op de productieomgeving van AMICE

Let op! U dient uiterlijk op 1 juli 2022 uw meldingen te doen via koppelvlakspecificatie versie 3.0. Meldingen die vanaf dan via de specificatie v2.1.1 worden gedaan worden dan geweigerd.

Ik probeer AMICE uit in de testomgeving. Via welke links ga ik naar de XML-webservices?

Gebruik onderstaande links als u naar de XML-webservices wilt.

Waar kan ik de WSDL van de AMICE-webservices downloaden?

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

  • Vraag een toegangsaccount voor de bedrijven-testomgeving aan via https://test.lma.nl
  • 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 v2.1.1

Voor de XML-Webservices v3.0

Waar kan ik een voorbeeld downloaden van een XML-bericht van de AMICE-webservices?

Gebruik 1 van de links hieronder als u een voorbeeld wilt downloaden. De velden in deze voorbeelden zijn leeg. Let op: u heeft wel een toegangsaccount voor de testomgeving nodig. Ook heeft een XML certificaat nodig. Vraag een account voor de testomgeving aan via https://test.lma.nl.

Voor de XML-Webservices v2.1.1

Voor de XML-Webservices v3.0

Ik krijg de melding ‘false’ of ‘500 error’ als ik een XML-bericht verstuur. Wat nu?

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

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

Ik heb een melding gedaan en ik krijg de melding ‘request entity too large’. Wat gaat er fout?

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.

Hoe maak ik speciale tekens in een 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&lt;is<

Ik doe een ‘Eerste Ontvangstmelding’ en ik krijg de melding ‘LokatieHerkomstAdresOnbekend’. Wat gaat er fout?

Krijgt u de melding ‘LokatieHerkomstAdresOnbekend’? En weet u zeker dat de postcode bestaat die u heeft ingevuld? Controleer dan de tekens die u heeft gebruikt. U mag maximaal 6 tekens gebruiken en u mag géén spatie zetten tussen de cijfers en de letters.

XML-verbindingsproblemen

Hieronder vindt u specifiek de vragen over XML-verbindingsproblemen.

Mijn programma krijgt geen verbinding met AMICE. Wat moet ik doen?

Krijgt uw programma geen verbinding met AMICE? Lees dan hieronder wat u moet doen.

  • Controleer of uw certificaat nog geldig is. Bij de vraag Hoe controleer ik of het certificaat geldig is staat voor u uitgelegd hou u deze controle uit kunt voeren.
  • Controleer of het AMICE Servercertificaat (Een PKIoverheid-certificaat) door uw software vertrouwd wordt. De uitgever van het certificaat, QuoVadis, moet door uw software worden beschouwd als een vertrouwde certificeringsinstantie. Vraag uw ICT-expert of softwareleverancier hoe dit voor uw software gerealiseerd kan worden.
  • Heeft u al langer dan 1 jaar geen gebruikgemaakt van AMICE met behulp van eHerkenning? Dan is uw certificaat tijdelijk geblokkeerd. Log dan 1 keer in met eHerkenning om uw certificaat weer te deblokkeren.
  • Controleer of het certificaat is geïnstalleerd volgens de procedure die uw programma voorschrijft. Neem bij vragen hierover contact op met uw softwareleverancier.
  • Gebruik de juiste inloggegevens. U vindt uw inlognaam boven in het scherm 'Aanmaken en Downloaden XML Certificaat'. Dit scherm opent u met de knop 'uw profiel' rechtsboven in AMICE en vervolgens de knop 'XML Certificaat'. Uw wachtwoord heeft u zelf gekozen toen u een AMICE-certificaat aanvroeg.
  • Controleer of u het juiste certificaat voor de juiste omgeving gebruikt. Let op: als u AMICE uitprobeert op de testomgeving, gebruikt u ook het certificaat dat u voor deze testomgeving heeft aangemaakt. Het certificaat van de testomgeving werkt niet voor het 'echte' AMICE, en andersom.
  • Controleer of uw meldsoftware, besturingssysteem en internetbrowser up-to-date zijn en dus overweg kunnen met moderne en veilige internetprotocollen.

Mijn computer accepteert het XML-bericht niet. Wat moet ik doen?

Accepteert uw computer het XML-bericht niet? Controleer dan of het bericht voldoet aan de XML Specificaties van het AMICE XML koppelvlak

Hoe controleer ik of het certificaat 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.

Ik krijg de melding '403 Forbidden'. Wat moet ik doen?

Krijgt u de melding '403 Forbidden'? Controleer dan de dingen hieronder.

Let op: weet u niet hoe u dit moet doen? Vraag dan uw afdeling ICT om hulp.

Mijn computer kent het certificeringspad niet. Hierdoor accepteert hij het AMICE-cliëntcertificaat niet. Wat moet ik doen?

Krijgt u de melding 'het certificeringspad kan niet worden achterhaald'? Installeer dan het 'rootcertificaat' van AMICE dat u samen met het AMICE certificaat heeft gedownload op het AMICE-webportaal. Het rootcertificaat heeft de bestandsnaam 'root_certificaat.cer'. Dit certificaat moet u installeren als 'vertrouwde basiscertificeringsinstantie'.

Let op: weet u niet hoe u dit doet? Vraag dan uw afdeling ICT om hulp.