Handleiding Noodvoorziening XML ijw/iwmo 1 maart 2017 Handleiding Noodvoorziening XML ijw/iwmo 1 / 9
Inhoud Inleiding 3 1 Werken met de Noodvoorziening 4 1.1 Toelichting 5 1.2 In drie stappen bestanden converteren 6 1.3 Handig om te weten 6 2 Werking van de Noodvoorziening 7 2.1 Berichten converteren 7 2.2 StUF-envelop converteren 7 2.3 Fouten opsporen en oplossen 7 3 Meldingen van de Noodvoorziening 9 3.1 Overzicht van meldingen 9 3.2 Beperkte conversie van retourberichten 9 Handleiding Noodvoorziening XML ijw/iwmo 2 / 9
Inleiding Medio juni 2017 worden de nieuwe versies van ijw en iwmo van kracht: ijw 2.1 en iwmo 2.1. Het zijn de eerste releases waarin XML de primaire taal is voor het berichtenverkeer tussen zorgaanbieders en gemeenten. In de voorgaande releases van de informatiestandaarden voor de Wmo en de Jeugdwet werd gecommuniceerd in EI. De overgang naar de 2.1-releases verloopt via een big bang. Dit betekent dat vanaf het moment dat de nieuwe versie in gebruik wordt genomen, alleen nog maar berichten volgens de nieuwe standaard uitgewisseld kunnen worden. Berichten volgens de 2.0-standaard worden vanaf dat moment afgekeurd. Zodra de 2.1-releases gelden, kunnen gemeenten en zorgaanbieders gebruikmaken van een conversieservice: de Noodvoorziening XML ijw/iwmo. Wat doet de Noodvoorziening? Gemeenten en zorgaanbieders kunnen met de noodvoorziening berichten converteren van iwmo 2.0 (EI) naar iwmo 2.1 (XML) en andersom, en van ijw 2.0 (EI) naar ijw 2.1 (XML) en andersom. De applicatie ondersteunt alle Jeugdwet- en Wmo-berichten, behalve de JW321 en JW322. Wat vindt u in deze handleiding? In deze handleiding vindt u de informatie om met de dienst te kunnen werken. De Noodvoorziening is een bestand dat op aanvraag beschikbaar is en dat u op uw eigen computer kunt installeren. Achtergrond en aanleiding Doordat de overgang naar de 2.1-releases van iwmo en ijw in juni via een big bang verloopt, is extra zekerheid gewenst. Daarom kunnen gemeenten en zorgaanbieders vanaf het moment van de overgang naar de 2.1-releases van iwmo en ijw de Noodvoorziening gebruiken. Dat ondervangt eventuele problemen in de levering en declaratie van zorg en ondersteuning wanneer hun softwaresysteem nog niet gereed is voor uitwisseling van de nieuwe standaard. Ontwikkelaar en doelgroep De Noodvoorziening XML ijw/iwmo is een extra service die Zorginstituut Nederland samen met i-sociaal Domein ontwikkeld heeft. De dienst is bedoeld voor gemeenten en zorgaanbieders die niet tijdig hun software hebben kunnen bijwerken van versie 2.0 naar versie 2.1 van de berichtstandaarden iwmo en ijw. Aanvragen en meer informatie De Noodvoorziening is een applicatie die via uw softwareleverancier op aanvraag verkrijgbaar is Deze handleiding is opgenomen op de pagina Noodvoorziening XML ijw/iwmo op www.istandaarden.nl. Daar vindt u aanvullende informatie om de Noodvoorziening mee aan te vragen. Hebt u vragen of opmerkingen over de Noodvoorziening of deze handleiding? Neemt u dan contact op met: Handleiding Noodvoorziening XML ijw/iwmo 3 / 9
Zorginstituut Nederland Beheerteam istandaarden (020) 797 89 48 info@istandaarden.nl www.istandaarden.nl Bezoekadres Eekholt 4 1112 XH Diemen Postadres Postbus 320 1110 AH Diemen Versiebeheer Handleiding Noodvoorziening XML ijw/iwmo Versie Datum Toelichting en status 1.0 1 maart 2017 Eerste uitgave Handleiding Noodvoorziening XML ijw/iwmo 4 / 9
1 Werken met de Noodvoorziening Nadat u het installatiebestand hebt gedownload en geïnstalleerd op uw computer, kunt u de applicatie openen. U ziet dan dit scherm: 1.1 Toelichting Het venster linksboven toont de bestanden die u wilt vertalen. Het venster rechtsboven toont de bestanden die vertaald zijn. In het venster onderaan ziet u de voortgang in de vorm van meldingen. Handleiding Noodvoorziening XML ijw/iwmo 5 / 9
1.2 In drie stappen bestanden converteren Actie Toelichting 1 Selecteer een bestand in het venster linksboven. Direct onder de lijst met bestanden in het linkervenster staat de naam van het bestand dat u geselecteerd hebt om te converteren. 2 Pas desgewenst de bestandsnaam aan van het doelbestand of wijzig de map waarin het bestand moet komen. De Noodvoorziening geeft aan de bestandsnaam altijd een postfix mee: _v20 of_v21 (versie 2.0 of versie 2.1), eventueel i.c.m. _ENV (STuF-envelop). 3 Klik op Vertaal ->. In het rechtervenster wordt zo mogelijk het geconverteerde bestand opgeleverd. Eventuele meldingen staan in het onderste venster. 1.3 Handig om te weten De Noodvoorziening doet zelf een voorstel voor de naamgeving van het uitvoerbestand. Als u wilt, kunt u de naam aanpassen voordat de vertaling plaats heeft gevonden. De postfix is echter altijd _v20, _v21, _ENV_v20 of _ENV_v21. Het venster linksboven, met de bestanden die u wilt vertalen, en het venster rechtsboven dat de bestanden toont die vertaald zijn kunt u beide verversen met F5. De Noodvoorziening onthoudt de map die u als laatst hebt gekozen. Advies: bewaar het oorspronkelijke bericht voor eventuele accountantcontrole. Handleiding Noodvoorziening XML ijw/iwmo 6 / 9
2 Werking van de Noodvoorziening De Noodvoorziening XML ijw/iwmo kan berichten en de StUF-envelop converteren. Treden er fouten op, dan krijgt u daarvan een melding. 2.1 Berichten converteren De Noodvoorziening converteert ijw- en iwmo-berichten van versie 2.0 (EI) naar 2.1 (XML) en andersom. Automatisch wordt vastgesteld of een 2.0- of 2.1 bestand wordt ingediend en dit wordt naar de andere versie omgezet. 2.2 StUF-envelop converteren De Noodvoorziening stelt vast of het bestand een StUF-envelop bevat. Zo ja, dan wordt de StUF-envelop geconverteerd van 2.0 naar 2.1 en andersom. 2.3 Fouten opsporen en oplossen Tijdens het gebruik kan de Noodvoorziening diverse foutmeldingen geven. Elke melding is voorzien van een foutcode en een melding waarin de fout omschreven staat. De tabel toont alle mogelijke fouten en geeft een toelichting bij elke foutmelding. Code Melding Toelichting FO01 Het invoerbestand is geen istandaarden- of declaratiebericht. Selecteer een geldig bericht. Deze foutmelding wordt gegeven wanneer het inlezen van het bestand niet lukt, bijvoorbeeld wanneer een JW322-bericht wordt aangeboden. FO03 Het invoerbestand kan niet worden vertaald. Nadat het bestand correct is ingelezen, treedt er een fout op bij het vertalen. FO03 is de algemene foutmelding die u dan krijgt. Het naar versie 2.1 vertaalde bericht levert een incorrect bericht op. Deze fout treedt op wanneer een 315- bericht wordt ingelezen dat als correctie bedoeld is op een eerder verstuurd 315-bericht. De XML 2.1- versie ondersteunt dit niet. FO04 Het uitvoerbestand is geen geldig 2.1-bericht. FO05 Het corrigeren van een verzoek om toewijzing wordt niet ondersteund. Neem contact op met de betreffende gemeente om de gewenste wijziging door te geven. FO06 Administratieve correctie ijw 2.1 en iwmo 2.1 ondersteunen het wordt niet ondersteund in doorgeven van administratieve istandaarden versie 2.0. correcties, zoals typefouten. Neem contact op met de betreffende zorgaanbieder ijw 2.0 en iwmo 2.0 ondersteunen dit om de gewenste wijziging niet. Daardoor is automatische door te geven. vertaling niet mogelijk. FO07 Het retourbericht Als een retourbericht retourcodes bevat <berichttype> bevat als reactie op een heenbericht met retourcodes; het bericht fouten dan wordt het niet vertaald. wordt niet vertaald. Handleiding Noodvoorziening XML ijw/iwmo 7 / 9
Code Melding Toelichting FO08 Geheime cliënten mogen niet via het berichtenverkeer verwerkt worden. Geheime cliënten mogen vanwege de veiligheid niet via het berichtenverkeer gecommuniceerd worden. FO09 Onbekende waarde opgegeven in rubriek IDENTIFICATIECODE BETALING AAN. Alleen de waardes 02, 03, 04 zijn toegestaan in het berichtenverkeer. Handleiding Noodvoorziening XML ijw/iwmo 8 / 9
3 Meldingen van de Noodvoorziening Tijdens het gebruik toont de Noodvoorziening de voortgang van het conversieproces. Daarbij kunnen meldingen optreden, die elk een code hebben. 3.1 Overzicht van meldingen Code Melding Toelichting ME01 Ingelezen Envelopversie <versie>. Bericht <berichttype>, versie <versie>. Metadata van het ingelezen bestand tonen aan de gebruiker. ME02 Succesvol vertaald Bericht <berichttype>, versie <versie>. ME04 Retourcode <retourcode> - <omschrijving> ME05 Cliënt is als geheim geclassificeerd. Deze informatie kan niet worden doorgegeven in een 2.1-bericht. Metadata van het vertaalde bestand tonen aan de gebruiker. Bij een retourbericht met retourcodes worden de retourcodes afgedrukt in het meldingenscherm. Het berichtenverkeer dient niet gebruikt te worden in het geval de veiligheid van de cliënt in het geding zou kunnen komen. 3.2 Beperkte conversie van retourberichten De 304-retourberichten van zowel iwmo als ijw de antwoorden op een factuur of declaratie worden volledig geconverteerd inclusief eventueel commentaar. Retourberichten met heenbericht-fouten worden niet geconverteerd. De retourcodes die in het retourbericht zitten, worden wel getoond. Handleiding Noodvoorziening XML ijw/iwmo 9 / 9