Aansluitdocument webservices VSP-EDP Validatiemodule Versie 2.0 Pagina 2 van 20
Historie Versie Datum Veranderingen 0.1 12-07-2010 Initiële versie 0.2 19-07-2010 Wijzigingen n.a.v. opmerkingen reviewteam VECOZO 0.3 25-08-2010 Wijzigingen WSDL: Referentie optioneel geworden 0.4 10-09-2010 Resultaatcode VSPEDP357 toegevoegd. 0.5 29-09-2010 Verduidelijking HTTPS 1.0 26-10-2010 Wijzigingen WSDL (namespaces) + bijwerken resultaatcodes en types 1.1 15-06-2011 Bijwerken n.a.v. versie 1.2 Resultaatcode 309 komt niet meer terug. 2.0 31-01-2012 - Bijwerken n.a.v. VSP-EDP 2.2 - Herstructurering - Nieuwe VECOZO huisstijl Referenties REF WSDL Validatie Indienen WSDL Validatie Opvragen WSDL Validatie Ontvangen Naam document vsp_edp_incoming_validatie_indienen_flat vsp_edp_incoming_validatie_downloaden_flat vsp_edp_outcoming_validatie_flat Pagina 3 van 20
Inhoudsopgave 1 Inleiding... 6 2 Communicatie... 6 2.1 HTTPS... 6 2.2 Certificaten... 7 2.3 Niet geauthenticeerd... 9 2.4 XML... 9 2.5 SOAP... 10 2.6 Bestandsuitwisseling... 10 2.7 Versiebeheer... 11 2.8 Zip... 11 2.9 Foutafhandeling... 11 2.10 SOAP Fault... 12 3 Communicatie VSP-EDP Validatiemodule specifiek... 15 4 VSP-EDP Validatiemodule Functionaliteit... 16 4.1 Inleiding... 16 4.2 Functionaliteit... 16 4.3 Overzicht... 19 4.4 Controleproces... 21 4.5 Levenscyclus... 23 5 VSP-EDP Validatiemodule webservices... 25 5.1 Overzicht... 25 5.2 Validatie Indienen service... 26 5.3 Validatie Opvragen service... 28 5.4 Validatie Ontvangen service... 30 Bijlage A WSDL endpoints per omgeving... 33 Bijlage B Operaties versus Resultaatcodes... 36 Bijlage C VECOZO Meldingen... 38 Pagina 4 van 20
1 Inleiding Dit document is bedoeld voor software ontwikkelaars en de afdeling Functioneel beheer VECOZO. De scope beperkt zich tot de webservices van VSP-EDP Validatiemodule en richt zich op het ondersteunen bij het integreren van externe systemen met de webservices van VECOZO. Indien u extra informatie wenst, of problemen ondervindt tijdens de integratie, kunt u contact opnemen met de helpdesk voor softwareleveranciers van VECOZO. Het telefoonnummer is 013-46 25 648 en het e-mailadres is softwarehelpdesk@vecozo.nl. De WSDL endpoints zijn beschreven in Bijlage A WSDL endpoints per omgeving. 2 Communicatie In dit hoofdstuk is de communicatie tussen VECOZO en externe partijen beschreven. 2.1 HTTPS Als applicatieprotocol wordt gebruik gemaakt van HyperText Transfer Protocol Secure. Voor de versleuteling van de gegevens worden SSL 3.0 en TLS 1.0 ondersteund. HTTPS is een vereiste voor het gebruik van webservices van VECOZO. 2.2 Certificaten VECOZO vereist dat het server certificaat van de externe partij is uitgegeven door een Certificate Authority die vertrouwd wordt door VECOZO. Om deze communicatie mogelijk te maken kan men dit als volgt configureren in Windows (IIS): 1. Voeg het VECOZO rootcertificaat toe aan de Trusted Root Certification Authority 2. Zorg dat een eigen certificaat is toegevoegd aan de website, zodat de website onder HTTPS beschikbaar is. (bijvoorbeeld met een certificaat van VeriSign of Thawte) VECOZO zal bij uitgaande aanroepen naar webservices van externe partijen altijd gebruik maken van een client certificaat. Beide certificaten zorgen ervoor dat vanuit beide kanten de data uitwisseling versleuteld kan worden. Om zeker te zijn dat de aanroepen enkel met het gewenste VECOZO certificaat kunnen gebeuren dient hierop een controle plaats te vinden. Dit kan bijvoorbeeld door het uitlezen van de thumbprint van het certificaat of in IIS kan dit ook door gebruik te maken van een Client Certificate Mapping. De public keys van de client certificaten en de VECOZO root certificaten zijn te downloaden op de website van VECOZO. Via onderstaande URL s zijn de public keys voor die verschillende omgevingen te vinden. Test: http://tstwww.vecozo.nl/web/help/vraag_en_antwoord/technisch/default.aspx Productie: http://www.vecozo.nl/web/help/vraag_en_antwoord/technisch/default.aspx Voor de authenticatie bij VECOZO wordt gebruik gemaakt van door VECOZO uitgegeven client certificaten (X.509). Enkel systeem certificaten kunnen gebruikt worden om een webservice van VECOZO aan te roepen. Voor de test- en acceptatieomgeving geldt dat alleen testcertificaten (uitgegeven door VECOZO TEST G2) geaccepteerd worden. In de productieomgeving worden enkel productiecertificaten geaccepteerd (uitgegeven door VECOZO G2). 2.3 Niet geauthenticeerd Indien er geen certificaat wordt aangeboden of wanneer het certificaat verlopen is wordt de fout HTTP 403 teruggegeven. Pagina 5 van 20
2.4 XML De berichten moeten worden uitgewisseld in XML 1.0 met als encoding UTF-8. Dit wordt als volgt aangegeven: <?xml version="1.0" encoding="utf-8"?> 2.5 SOAP Alle webservices die VECOZO aanbiedt ondersteunen SOAP 1.1 en SOAP 1.2 en ondersteunen ook MTOM 1. De webservices die door externe partijen geïmplementeerd worden, moeten minstens SOAP 1.1 ondersteunen. VECOZO zal kan zowel SOAP 1.1 als SOAP 1.2 berichten naar externe partijen versturen. 2.6 Bestandsuitwisseling Voor de uitwisseling van bestanden wordt gebruikt gemaakt van base64encoding 2. DIME wordt niet ondersteund. Veel webservice frameworks coderen een bestand al naar base64 formaat tijdens het genereren van een SOAP bericht. In dat geval hoeft u uiteraard het bestand zelf niet nog eens te coderen. 2.7 Versiebeheer De versie van de WSDL staat na de dubbele punt genoemd in de targetnamespace van de WSDLdefinitie. Indien een nieuwe versie van de WSDL wordt gerealiseerd wordt dit versienummer opgehoogd van bijvoorbeeld v1 naar v2. Voorbeeld: targetnamespace="urn:www-vecozo-nl:<applicatie>:<methode>:v1" 2.8 Zip De bestanden die gezipt worden. Het bestand moet aangemaakt zijn volgens versie 2.0 of hoger van de.zip-specificatie. Hierbij dient het DEFLATE-algoritme voor bestandscompressie te worden gebruikt. DEFLATE64 wordt niet ondersteund. 2.9 Foutafhandeling VECOZO stopt (na een aantal pogingen) met versturen van berichten indien de webservice van externe partij niet bereikbaar is of als er bij het aanroepen van de webservice te veel foutmeldingen optreden. Er wordt een e-mailnotificatie verstuurd naar het e-mailadres dat is ingesteld voor de betreffende webservice. De te versturen berichten worden bijgehouden in een queue en doorgestuurd zodra de situatie is hersteld en VECOZO het versturen weer activeert. 2.10 SOAP Fault Als er een technische fout optreedt in een webservice van VECOZO, dan wordt er een SOAP Fault verstuurd naar de client. De exacte structuur van de Fault is beschreven in de WSDL van de betreffende webservice. De SOAP Fault bevat twee belangrijke elementen: een resultaatcode en een message. 2.10.1 Niet geautoriseerd Wanneer er wel een geldig certificaat is aangeboden, maar de gebruiker waaraan dit certificaat is gekoppeld, is niet geautoriseerd om die actie uit te voeren, wordt de Fault met resultaatcode <Applicatie>001 verstuurd. 1 een methode om op efficiënte wijze binaire data naar en van webservices te versturen. 2 http://www.w3.org/tr/2004/per-xmlschema-2-20040318/#base64binary Pagina 6 van 20
Als u toch het juiste certificaat hebt aangeboden, dient u contact op te nemen met de helpdesk om aan de gebruiker de juiste autorisaties toe te kennen! Hieronder wordt een voorbeeld (fictief) getoond van deze Fault. <s:envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:body> <s:fault> <s:code> <s:value>s:sender</s:value> </s:code> <s:reason> <s:text xml:lang="">not authorized</s:text> </s:reason> <s:detail> <FaultContract xmlns="urn:www-vecozo-nl:vsp:edp:indienen:v1" xmlns:a="urn:wwwvecozo-nl:types:vsp:awbz:faultcontract" xmlns:i="http://www.w3.org/2001/xmlschema-instance"> <a:resultaatcode><applicatie>001</a:resultaatcode> <a:message>not authorized</a:message> </FaultContract> </s:detail> </s:fault> </s:body> </s:envelope> Figuur 1 2.10.2 Onbekende technische fout Als er aan de kant van VECOZO een technische fout optreedt tijdens het uitvoeren van een operatie, zal de Fault met resultaatcode <Applicatie>999 verstuurd worden. Als deze fout vaker optreedt, kunt u contact opnemen met de helpdesk voor softwareleveranciers van VECOZO. Hieronder wordt een voorbeeld (fictief) getoond van deze Fault. <s:envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:body> <s:fault> <s:code> <s:value>s:sender</s:value> </s:code> <s:reason> <s:text xml:lang="">onbekende technische fout</s:text> </s:reason> <s:detail> <FaultContract xmlns="urn:www-vecozo-nl:types:vsp:awbz:faultcontract" xmlns:i="http://www.w3.org/2001/xmlschema-instance"> <Resultaatcode><Applicatie>999</Resultaatcode> <Message>Onbekende technische fout</message> </FaultContract> </s:detail> </s:fault> </s:body> </s:envelope> Figuur 2 Pagina 7 van 20
3 Communicatie VSP-EDP Validatiemodule specifiek In dit hoofdstuk is de communicatie tussen VECOZO en externe partijen specifiek m.b.t. de VSP-EDP Validatiemodule beschreven. 3.1 Bestandsgrootte Een bestand dat aangeleverd wordt bij VECOZO mag maximaal 10 MB groot zijn (al dan niet gecomprimeerd). De inhoud van een ZIP-bestand mag uitgepakt maximaal 100 MB groot zijn. Ook mag een ZIP-bestand maximaal 30 bestanden bevatten. 3.2 Bewaartermijn validatieresultaten Het Systeem zal het fysieke EI-bestand, metagegevens rondom het EI-bestand en het validatieresultaat zelf verwijderen vijf dagen nadat het de status Correct bevonden of Afgekeurd heeft verkregen. Er wordt 1x per dag (rond middernacht) bekeken welke gegevens verwijderd moeten worden door het systeem. Deze worden dan op dat moment ook verwijderd. Pagina 8 van 20
4 VSP-EDP Validatiemodule Functionaliteit 4.1 Inleiding Dit hoofdstuk geeft een beschrijving van de aangeboden webservices: wat de functionaliteit van iedere webservice is en wanneer welke webservice gebruikt moet worden en hoe de webservices samenhangen. 4.2 Functionaliteit Als VECOZO een EI-bestand ontvangt ter validatie wordt dit bestand opgeslagen en ontvangt de indiener een response met daarin een uniek validatie ID. In het geval dat de aanlevering een ZIPbestand met daarin meerdere EI-bestanden betreft ontvangt de verzender een reeks met unieke ID s. Na ontvangst voert VECOZO de bestand- en routeringscontroles uit. Zie hiervoor paragraaf 4.4 Controleproces. Als resultaat kunnen er één VECOZO melding en/of één of meerdere VEKTIS meldingen opgeslagen worden. VECOZO zal hierbij aangeven op welke regel en rubriek de fout zich voordeed. Ook zal VECOZO, net zoals in het reguliere verwerkingsproces, een EI-retourbestand genereren. Na uitvoering van de controles wordt het validatieresultaat beschikbaar gesteld via de website of via een push of pull mechanisme. Als de indiener heeft aangegeven notificaties te willen ontvangen zal er ook een e-mailnotificatie verstuurd worden. Indien de indiener een webservice heeft geïmplementeerd om validatieresultaten te ontvangen zal het validatieresultaat direct doorgestuurd worden naar deze webservice. De indiener heeft de mogelijkheid om zelf een webservice te implementeren (PUSH) om de validatieresultaten automatisch te ontvangen of een webservice aan te roepen (PULL) om de validatieresultaten op te vragen. De validatieresultaten kunnen altijd opgehaald worden via de website. Tijdens het schrijven van versie 2.0 is de schaduwdraaiperiode in volle gang. Declaratieregels die niet voldoen aan de nieuwe controles worden niet afgekeurd maar gesignaleerd. Dit onderscheidt is zichtbaar op de website maar niet bij het gebruik van validatiemodule webservices. Pagina 9 van 20
4.3 Overzicht In onderstaande figuur is de validatie van EI-bestanden weergegeven in de vorm van methode aanroepen. In de figuur wordt uitgegaan van een volledige geautomatiseerde oplossing. Onder de figuur is een tabel opgenomen met de methode aanroepen en toelichting. Figuur 3 Methode Indienen bestand Toelichting De indiener verstuurt een bestand naar VECOZO. Dit kan een gezipt of niet gezipt bestand met hierin een EI-bericht. Er kunnen optioneel twee e-mailadressen meegegeven worden waar vervolgens notificaties naar toegestuurd worden. Als VECOZO het bestand ontvangt, wordt het opgeslagen en wordt direct een response bericht gestuurd naar de indiener. Het responsebericht geeft de validatieid s terug van het bestand of van de bestanden. Pagina 10 van 20
Methode Controleren Toelichting Na ontvangst voert VECOZO een aantal controles uit op het aangeleverde bestand. Als het bestand aan alle controles voldoet, wordt het bestand goedgekeurd. De indiener van het bestand ontvangt een statuswijzigingsmelding. Als het bestand wordt afgekeurd wordt er een retourbestand gegenereerd en verstuurd. De indiener van het bestand ontvangt ook een statuswijzigingsmelding. Als het niet mogelijk is om een retourbestand te genereren ontvangt de indiener van het bestand alleen een statuswijzigingsmelding. Zie paragraaf 4.4 Controleproces voor meer informatie. OpvragenValidatielijst OpvragenValidatieResultaat Versturen Statuswijzingsmelding VersturenValidatieResultaat De goedgekeurde EI-bestanden worden opgehaald door eerst de validatieid s op te vragen van de gevalideerde bestanden en vervolgens één voor één op te halen op basis van het validatieid. Bij een statuswijziging van het EI-bestand (een afkeuring is ook een statuswijziging) wordt een statuswijziging via de mail gestuurd (indien deze is meegegeven) Hiermee wordt het resultaat van een validatie direct doogestuurd naar de indiener. (PUSH) Pagina 11 van 20
4.4 Controleproces Het controleproces bestaat uit vier onafhankelijke controles. In onderstaande tabel zijn ze beschreven: Controle Omschrijving Retourbestand bij fout Parsercontrole Controleren of het een EI-bestand is. Nee Bestandscontrole Controleren correcte vulling voorlooprecord en Ja sluitrecord. Recordcontrole Controle op de detailrecords in het bestand Ja Als het bestand wordt afgekeurd op basis van de parsercontroles is het niet mogelijk om een retourbestand te genereren en te versturen. Het retourbericht bestaat dan alleen uit een retourcode. In onderstaande tabel is weergegeven welke foutmelding bij welke soort controle hoort. De foutafhandeling voor een heen en retourbericht is zoveel mogelijk hetzelfde met als uitzondering dat alleen op een heenbestand een retourbestand gestuurd kan worden. Controle Declaratiebestand Retourbestand Parscontrole 1 Het voorlooprecord ontbreekt VECMELD001 VECMELD001 CODE EXTERNE-INTEGRATIEBERICHT + VECMELD002 VECMELD002 2 VERSIENUMMER BERICHTSTANDAARD + SUBVERSIENUMMER BERICHTSTANDAARD wordt niet ondersteund Bestandscontrole 3 4 Het voorlooprecord is verkeerd gevuld Het sluitrecord ontbreekt of is verkeerd gevuld Genereer retourbestand en Vektis Melding Genereer retourbestand en Vektis Melding Vektis Melding of VECOZO Melding VECMELD007 bij rubrieken die niet in het EI-bestand staan 3 Vektis Melding of VECOZO Melding VECMELD007 bij rubrieken die niet in het EI-bestand staan 3 3 De eerste gevonden fout zal worden gebruikt als Vektis of VECOZO melding. Indien er fouten zijn die kunnen leiden tot allebei type meldingen dan zal ook de eerst gevonden fout bepalen welke melding er aanwezig zal zijn. Pagina 12 van 20
4.5 Levenscyclus Hieronder is de levenscylus van een te valideren bestand weergegeven in de vorm van een statusovergang diagram. Figuur 4 - De door VECOZO ontvangen bestanden krijgen de status ontvangen indien ze gevalideerd kunnen worden. - Na de controle (validatie) is de status van het bestand Correct bevonden indien er geen fouten in het bestand aanwezig zijn en Afgekeurd indien dit wel het geval is. Pagina 13 van 20
5 VSP-EDP Validatiemodule webservices 5.1 Overzicht VSP-EDP Validatiemodule is gerealiseerd met gebruikmaking van drie webservices. Twee webservices zijn geïmplementeerd door VECOZO. De andere webservice is optioneel en kan geïmplementeerd worden door de zorgzorgverzekeraars en de zorgaanbieders (externe partij). In onderstaande figuur zijn de webservices schematisch weergegeven. Figuur 5 Webservice Validatie Indienen Validatie Opvragen Validatie Ontvangen Paragraaf VECOZO 5.2 Validatie Indienen service 5.3 Validatie Opvragen service Externe partij 5.4 Validatie Ontvangen service 5.2 Validatie Indienen service Dit is een service die een endpoint aanbiedt waarop EI-bestanden of ZIP-bestanden (met daarin EIbestanden) ingediend kunnen worden bij VECOZO. De technische beschrijving van de operaties en berichtstructuur is terug te vinden in [WSDL Validatie Indienen]. 5.2.1 Operatie ValiderenEIBestand Deze operatie wordt aangeroepen om één of meerdere declaraties (gezipt) in te dienen ter validatie. Er wordt direct een response bericht gestuurd met hierin per ingediende EI-bestand een uniek nummer, het validatieid. Vermeld wordt ook of het EI-bestand gevalideerd kan worden. Dit is bijvoorbeeld niet het geval wanneer het bestand groter is dan 10MB. Zie voor de mogelijke andere resultaatcodes en uitleg Bijlage B Operaties versus Resultaatcodes. Beperkingen Bestandsgrootte Aantal bestanden Omschrijving Een bestand dat ingediend wordt mag, uitgepakt, voor heenberichten maximaal 100MB groot zijn, en voor retourberichten maximaal 120MB groot zijn. De te versturen (gezipte) bestanden mogen niet groter zijn dan 10MB. Er mogen maximaal 30 bestanden in één gezipt bestand worden Pagina 14 van 20
Beperkingen Omschrijving aangeleverd. 5.2.2 Berichten Onderstaand de berichten die een rol spelen bij de operaties van de Validatie Indienen service. Figuur 6 Veldnaam Bestandsgrootte Bestand.Bestandsnaam ValidatieIndienenResponse.Bestandsnaam Data IndienerEmailadres Referentie Resultaatcode ValidatieID Toelichting Aanwezig om te verifiëren of de gestuurde data aan deze grootte voldoet. Naam van het bestand zonder padnaam. Als deze niet aanwezig is dan wordt de naamgeving ValidatieBestand + datumtijd. Nodig in verband met afhandeling ZIP-bestand waarvan onbekend is voor de indiener voor welk bestand in het ZIP-bestand er een resultaatcode wordt teruggegeven. Base64Encoded Optioneel. Het e-mailadres waar de resultaten van de validatie naartoe gestuurd worden. Hieronder valt ook het op de hoogte worden gehouden van moment van verwijderen van de validatieresultaten (4x een e-mail per validatie). Referentie van de indiener van een bestand ter validatie. Het resultaat van de ontvangst van een te valideren bestand. Zie Bijlage B Operaties versus Resultaatcodes. Het unieke ID dat gekoppeld wordt aan een validatieresultaat. Het is afwezig indien de controle niet uitgevoerd kon worden (bestand te groot bijvoorbeeld). Pagina 15 van 20
5.3 Validatie Opvragen service Dit is een service die een endpoint aanbiedt waarop de resultaten van validaties kunnen worden opgevraagd. De technische beschrijving van de operaties en berichtstructuur is terug te vinden in [WSDL Validatie Opvragen]. 5.3.1 Operatie OpvragenValidatieresultaten Deze operatie kan aangeroepen worden om validatieresultaten op te vragen die klaarstaan om opgehaald te worden. Er wordt een lijst van 0 of meer ValidatieID s teruggegeven. Optioneel kan er één ValidatieID worden meegegeven. In dat geval wordt het resultaat van de validatie met het betreffende ValidatieID teruggegeven. 5.3.2 Operatie DowloadValidatieresultaat Op basis van een (eerder opgehaald) ValidatieID kunnen met deze operatie de validatieresultaten opgevraagd worden inclusief een gegenereerd EI-retourbestand. 5.3.3 Berichten Onderstaand de berichten die een rol spelen bij de operaties van Validatie Opvragen service. Figuur 7 Veldnaam Toelichting AantalResultaten Als het aantal resultaten 0 is zijn er ook geen validatieresultaten aanwezig. Dit getal kan hoger zijn dan de maximaal 1000 aanwezige resultaten. Bestandsgrootte Grootte van de aanwezige data om kilobytes. Bestandsnaam De naam wordt gegeneerd: Validatie_Retourbestand_ + ValidatieID. CodeExterneIntegratie Uit het bestand gelezen CEI. Bijv: 101 Data Base64Encoded EIStandaardCode Aan de hand van het bestand geconstateerde code van de EI-standaard. Bijv: ZH308 Pagina 16 van 20
Veldnaam EIStandaardVersie EIStandaardSubversie IdentificatieDetailRecord Kenmerkrecord Meldingcode MeldingOmschrijving Referentie Regelnummer Resultaatcode Retourbestand Rubrieknummer Status ValidatieID Toelichting Uit het bestand gelezen EI-Standaard versie Uit het bestand gelezen EI-Standaard subversie. Als er geen subversie aanwezig is dan is deze 00. Identificatie van het detailrecord waar de validatie is misgegaan. Deze identificatie komt uit het bestand. Kenmerk van het record waar de de validatie is misgegaan. Het kenmerk komt uit een record in het bestand. Code van de melding. Zie Bijlage C VECOZO Meldingen voor de VECOZO meldingen Omschrijving van de melding. Zie Bijlage C VECOZO Meldingen voor de VECOZO meldingen. Referentie gegeven bij het indienen van een te valideren bestand. Het nummer van de regel waar de meldingcode betrekking op heeft indien dit te bepalen is. Een unieke code die aangeeft wat de status van het ontvangen bericht is. Zie Bijlage B Operaties versus Resultaatcodes. Het door VECOZO gegenereerde retourbestand wanneer de ingediende declaratie is afgekeurd. De rubriek waar de meldingcode betrekking op heeft indien dit te bepalen is. De status van de validatie. De identificatie van de validatie. 5.4 Validatie Ontvangen service Dit is een service die een endpoint aanbiedt waarop VECOZO validatieresultaten zal doorsturen en eventuele EI-retourbestanden. De technische beschrijving van de operaties en berichtstructuur is terug te vinden in [WSDL Validatie Ontvangen]. 5.4.1 Operatie Validatieresultaat Operatie die door een externe partij wordt geïmplementeerd om de validatieresultaten via een webservice te kunnen ontvangen. 5.4.2 Berichten Onderstaand de berichten die een rol spelen bij de operaties van Validatie Ontvangen service. Pagina 17 van 20
Figuur 8 Veldnaam Toelichting Bestandsgrootte Grootte van de aanwezige data om kilobytes. Bestandsnaam De naam wordt gegeneerd: Validatie_Retourbestand_ + ValidatieID. CodeExterneIntegratie Uit het bestand gelezen CEI. Bijv: 101 Data Base64Encoded EIStandaardCode Aan de hand van het bestand geconstateerde code van de EI-standaard. Bijv: ZH308 EIStandaardSubversie Uit het bestand gelezen EI-Standaard subversie. Als er geen subversie aanwezig is dan is deze 00. EIStandaardVersie Uit het bestand gelezen EI-Standaard versie IdentificatieDetailRecord Identificatie van het detailrecord waar de validatie is misgegaan. Deze identificatie komt uit het bestand. Kenmerkrecord Kenmerk van het record waar de de validatie is misgegaan. Het kenmerk komt uit een record in het bestand. Meldingcode Code van de melding MeldingOmschrijving Omschrijving van de melding Referentie Referentie gegeven bij het indienen van een te valideren bestand. Regelnummer Het nummer van de regel waar de meldingcode betrekking op heeft indien dit te bepalen is. Resultaatcode Een unieke code die aangeeft wat de status van het ontvangen bericht is. Zie Bijlage B Operaties versus Resultaatcodes. Retourbestand Het door VECOZO gegenereerde retourbestand wanneer de ingediende declaratie is afgekeurd. Rubrieknummer De rubriek waar de meldingcode betrekking op heeft indien dit te bepalen is. Status De status van de validatie. ValidatieID De identificatie van de validatie. Pagina 18 van 20
Bijlage A WSDL endpoints per omgeving WSDL endpoints zonder Soap11 extensie ondersteunen SOAP 1.2 Test https://tstedpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1 https://tstedpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1soap11 https://tstedpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1mtom https://tstedpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1soap11mtom https://tstedpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1 https://tstedpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1soap11 https://tstedpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1mtom https://tstedpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1soap11mtom Acceptatie https://accedpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1 https://accdpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1soap11 https://accedpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1mtom https://accedpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1soap11mtom https://accedpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1 https://accedpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1soap11 https://accedpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1mtom https://accedpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1soap11mtom Productie https://edpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1 https://edpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1soap11 https://edpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1mtom https://edpwebservice.vecozo.nl/router.v1.svc/indienenvalidatiev1soap11mtom https://edpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1 https://edpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1soap11 https://edpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1mtom https://edpwebservice.vecozo.nl/router.v1.svc/downloadenvalidatiev1soap11mtom Pagina 19 van 20
Bijlage B Operaties versus Resultaatcodes Functionele fouten worden teruggekoppeld d.m.v. een resultaatcode in het response bericht. In onderstaande tabel zijn alle resultaatcodes opgenomen die voor kunnen komen binnen de VSP-EDP Validatiemodule. Webservice operaties Resultaat Omschrijving code Technisch VSPEDP001 Niet geautoriseerd X X X X VSPEDP999 Onbekende technische fout X X X X VSPEDP100 199 Succes VSPEDP101 EI-bestand succesvol ontvangen door validatie. X VSPEDP110 Lijstopvraag succesvol. X VSPEDP111 Validatieresultaat op vraag succesvol. X VSPEDP112 Validatieresultaat succesvol ontvangen door ontvangende partij. X VSPEDP300 999 Foutmelding VSPEDP303 Het declaratiebestand is groter dan 100MB en kan niet worden verwerkt. X VSPEDP304 Het aangeleverde bestand is groter dan 10MB en kan niet worden verwerkt. X VSPEDP330 Validatieresultaat kon niet worden ontvangen. X VSPEDP331 Met het gegeven validatieid kan geen validatieresultaat worden gevonden. X X VSPEDP347 Één van de e-mailadressen is onjuist. X VSPEDP348 De bestandsgrootte is niet gelijk aan de grootte van het bestand. X VSPEDP353 De maximale grootte van de aanlevering mag maar 10MB zijn. X VSPEDP354 Een ZIP-bestand mag maximaal 30 EI-bestanden bevatten. X VSPEDP356 Status kon niet worden opgevraagd voor EDP EIdeclaratiebestand. VSPEDP357 De bestandsnaam (van het EI-bestand in de ZIP) mag maximaal 150 karakters bevatten. X VSPEDP362 De bestandsnaam (van het EI-bestand in de ZIP) mag alleen cijfers, letters, koppeltekens, liggende streepjes en punten X bevatten. De volgende resultaatcodes worden vermeld in de WSDL maar worden niet teruggegeven: VSPEDP327, VSPEDP328, VSPEDP329, VSPEDP355. Bij de eerstvolgende update van de WSDL zullen deze verwijderd worden. Operatie ValiderenEIBestand Operatie OpvragenValidatieresultaten Operatie DowloadValidatieresultaat Operatie Validatieresultaat Pagina 20 van 20
Bijlage C VECOZO Meldingen Hieronder de lijst met de mogelijke VECOZO Meldingen. Code VECMELD001 VECMELD002 VECMELD006 VECMELD007 Omschrijving Het ingediende bestand is geen EI-bestand. Declaratiebestand voldoet niet aan een ondersteunde standaard. De standaard voor het ingediende bestand is niet toegestaan. Rubrieknummer <rubrieknummer> bevat geen waarde of een onjuiste waarde. Pagina 21 van 20