Gegevensuitwisseling Exporteurs - Client Export CLIENT Export Mest Kernteam Definitief v1.22 Den Haag, 1maart 2011
INHOUDSOPGAVE Versiebeheer 3 1 Inleiding 4 2 Berichtenverkeer 6 2.1 CME0315U: Indienen Aanvraag 9 2.2 CME0301U: Opvragen status aanvraag 12 2.3 CME0311U : Opvragen status aanvraag 13 2.4 CME0301U: AanvragenInspecties 14 2.5 CME0302U : Verstrekken afdrukopdracht 14 2.6 CME0320U: IntrekkenAfgegevenAanvraag 15 2.7 CME0321U :WijzigTransportMoment 16 3 Gegevensverzamelingen 18 3.1 Domeinen 18 3.2 Publieke informatie 18 3.3 Exclusieve informatie 19 4 Techniek 20 4.1 HTTP 20 4.2 SOAP 20 4.3 WSDL 20 4.4 XML 20 5 Beveiliging 21 5.1 Procedureel 21 5.2 Beveiligingssleutel 21 5.3 Machtigen en vertegenwoordigen 21 Bijlage I: Uitwisselingsschema 22 2
VERSIEBEHEER Versie Auteur Datum Aanpassing Concept 0.1 Rian de Putter Basisversie gevormd obv Zuivel v2.0 Concept 0.2 Rian de Putter Aanpassen: CLExxxU: Intrekken- AfgegevenAanvraag Concept 0.3 Rian de Putter 04-03-2010 Verwerking feedback Patrick Laenen Concept 0.4 Rian de Putter 05-03-2010 Versie ter indicatie voor softwareleveranciers Concept 0.5 Rian de Putter 08-04-2010 Verwerking besluiten nav issues Concept 1.00 Patrick Laenen 01-06-2010 Verwerking alle openstaande punten nav webapplicatie release 2.0 Definitief 1.21 Patrick Laenen 01-02-2011 Definitieve versie Definitief 1.22 Patrick Laenen 1-3-2011 Correctie op documentatie mbt werking CME302 3
1 INLEIDING Het Client Export-programma is een samenwerking tussen het exporterend bedrijfsleven en de directie Industrie en Handel van het ministerie van Landbouw, Natuur en Voedselkwaliteit, om de met de export gepaard gaande administratieve lasten verder terug te dringen. Voor de export van agro-producten vragen de bestemmingslanden een verklaring omtrent de (veterinaire en fytosanitaire) kwaliteit van de betreffende producten. Een dergelijke verklaring kan verstrekt worden door LNV op basis van door het bedrijfsleven aangeleverde informatie. Met Client Export ontstaan twee manieren om de overheid deze informatie aan te leveren: Vastleggen in de webapplicatie Client Export Mest: via speciaal daarvoor ontwikkelde schermen wordt de exporteur (of diens vertegenwoordiger) gevraagd om stap voor stap de benodigde informatie aan te bieden Aanbieden op de webservice Client Export Mest: via een opgesteld koppelvlak, kan informatie volledig digitaal worden aangeleverd. De webapplicatie en de webservice zijn wat betreft gegevens volledig uitwisselbaar 1. Een aanvraag voor een exportwaardigheidsverklaring via de webapplicatie, levert exact hetzelfde eindresultaat op als een aanvraag die wordt ingediend via de webservice. Een aanvraag die in eerste instantie is ingediend via de webservice kan prima worden aangevuld c.q. aangepast met de webapplicatie. Functioneel bevat de webapplicatie meer componenten dan de webservice (het koppelvlak). Zo is het bijvoorbeeld mogelijk om via de webapplicatie voorbeelden van de af te geven documenten in te zien; via de webservice kan dat niet. In het navolgende wordt de digitale gegevensuitwisseling via de webservice van Client Export meer in detail uiteengezet. Voor meer informatie over de gehanteerde technologie van webservices en de gebruikte standaarden wordt verwezen naar de volgende locaties: http://nl.wikipedia.org/wiki/webservice http://schemas.xmlsoap.org/wsdl/soap1 1 Alleen in de tijd kan een verschil ontstaan doordat certificaatkenmerken (aanvullende exportgegevens) eerder in de webapplicatie beschikbaar zijn dan in de webservice. 4
5
2 BERICHTENVERKEER Het berichtenverkeer in het kader van de export van mest wordt gevormd door de mogelijkheden voor: Indienen Aanvraag: het indienen van de feitelijke aanvraag voor exportwaardigheid van een exportzending Opvragen status aanvraag: het opvragen van de meest actuele status ( rood/oranje/groen ) van de ingediende aanvraag Aanvragen inspecties: toekomstige functionaliteit Aanvragen afdrukken: het verstrekken van de opdracht aan de VWA om de exportdocumenten definitief te vervaardigen Intrekken afgegeven aanvraag: het intrekken van een mestexportaanvraag nadat de exportdocumenten definitief zijn vervaardigd Wijzigen transportmoment: het wijzigen van het transportmoment nadat de exportdocumenten definitief zijn vervaardigd De werkwijze in het digitaal uitwisselen van gegevens verloopt op hoofdlijnen als volgt: Stap 1: De exporteur roept de webservicefunctie Indienen Aanvraag aan. Deze aanroep moet alle informatie in digitale vorm bevatten die een aanvraag in Client Export moet bevatten om de exportwaardigheid te kunnen bepalen. De webservice antwoordt met het teruggeven van het aanvraagnummer waaronder de betreffende aanvraag in Client Export is aangemaakt. Stap 2: Uit het antwoord van stap 1 kan het aanvraagnummer worden gebruikt om de webservicefunctie Opvragen status aanvraag aan te roepen. De webservice antwoordt met de meest actueel bekende status van de aanvraag waarvoor de status wordt aangevraagd. Het antwoord bestaat uit de status van de exportzending per eis die de Europese verordening en/of het bestemmingsland stelt (rood/oranje/groen) en aanvullende detailgegevens daar waar het die eisen betreft. Als het antwoord aangeeft dat er nog eisen zijn met de status oranje, betekent dit dat er nog inspecties moeten worden uitgevoerd door de VWA. 6
Stap 3: Als het antwoord op stap 2 Exportwaardigheid Akkoord is, dan kan de webservicefunctie Aanvragen afdrukken aangeroepen worden. Voor de zekerheid wordt voordat de afdrukopdracht aan de VWA wordt verstrekt, nogmaals gecontroleerd of alle zekerheden groen vallen. Bovendien wordt gecontroleerd of alle verplichte velden van een waarde zijn voorzien. De webservice antwoordt met een ok-bericht waarin ook de PDF s van de zelf af te drukken documenten zijn opgenomen. Bovendien zorgt de webservice ervoor dat de aanvraag van het gezondheidscertificaat indien van toepassing naar de VWA wordt verstuurd zodat deze daar afgedrukt, ondertekend en opgehaald of verzonden kan worden. Stap 4: Als de exportdocumenten definitief zijn aangevraagd via Aanvragen Afdrukken en het transport gaat toch niet (op de opgegeven dag) plaatsvinden, dan dient de webservicefunctie Intrekken afgegeven aanvraag aangeroepen te worden. Via deze functie wordt de aangemelde export ingetrokken. NB: Door het intrekken van de afgegeven aanvraag wordt het proces van afgifte van de documenten stilgelegd en worden alle documenten die door CLIENT Export/de VWA voor deze export reeds zijn afgegeven ongeldig. Stap 5: Als de exportdocumenten zijn aangevraagd en het transport gaat niet door kan de exporteur tot 12 uur voor het verstrijken van de transportdatum en tijdsindicatie, de transportdatum nog aanpassen binnen de grenzen van geldigheid van de exportdocumenten. Via het bericht wordt een nieuwe transportdatum van de aanvraag en tijdsindicatie van vertrek vastgelegd. De stappen zijn uitgewerkt in het schema welke hieronder is afgebeeld. 7
Omwille van de leesbaarheid is het schema ook in bijlage 1 vergroot opgenomen. Het berichtenboek bestaat uit de volgende berichten: - CME0315U wordt gebruikt voor het indienen of wijzigen van de aanvraag van een mestexport. - CME0301U wordt gebruikt om direct de status op te vragen van een aanvraag. De status kan zijn rood, oranje of groen. - CME0311U wordt gebruikt om op asynchrone wijze de status van een aanvraag op te vragen. - CME0302U wordt gebruikt om de opdracht tot afdrukken te verstrekken aan de VWA en/of om afdrukvoorbeelden van aangevraagde documenten op te vragen. - CME0310U kan in de toekomst worden gebruikt om inspecties bij de VWA aan te vragen. Deze functie is momenteel gedeactiveerd. - CME0320U wordt gebruikt om een afgegeven aanvraag in te trekken. - CME0321U wordt gebruikt om de geplande transportdatum en tijdstip te verschuiven De bij de webservices behorende WSDL s, de datadictionary van de te gebruiken gegevenselementen en de mogelijke waarden die gebruikt mogen worden bij het geven van waarden aan de gegevenselementen zijn als Excel-documenten opgenomen in de totaalset aan documenten behorende tot het berichtenboek. In bijlage II staat het 8
overzicht van de documenten met de soort informatie die in het betreffende document staat. 2.1 CME0315U: Indienen Aanvraag De webservicefunctie IndienenAanvraag is bedoeld om volledig digitaal een complete aanvraag voor verwerking aan Client Export aan te bieden. Daartoe roept de exporteur de webservice aan met de volgens de gegevensstructuur gevormde aanroep. Er zijn 3 mogelijke functies gedefinieerd, die onderkend kunnen worden middels de vulling van de velden aanvraagnummer en actie in het bericht. De verwerking van het bericht volgt op hoofdlijnen de stappen zoals hieronder per functie weergegeven. 1. Functie = Toevoegen Indien het aanvraagnummer leeg blijft (of niet meegegeven wordt) en er is geen actie gespecificeerd, dan dient het bericht voor het toevoegen van een nieuwe exportzending en alle bijbehorende gegevens (samenstelling vracht, transport- en relatiegegevens, etc.). 2. Functie = Wijzigen Indien het aanvraagnummer gevuld is en de actie is W, dan kan het bericht gebruikt worden om enkele gegevens van een al eerder ingediende zending te wijzigen. Zaken die gewijzigd mogen worden, zijn achtereenvolgens: De vrachtgegevens Het veld uw referentie, de gegevens mbt leverancier en afnemer en het veld geschatte hoeveelheid, met die kanttekening dat de hoeveelheid alleen maar kleiner gemaakt mag worden. De samenstelling van de vracht De velden product (mestcode-niveau), referentie en percentage. Transportgegevens De velden verschepingsdatum, plaats en postcode van vertrek/laden, de gegevens over het transportmiddel en de gegevens over de vervoerder en overige betrokkene. 9
Documentverzendgegevens De velden verzending, type postverzending en verzendingsinformatie. Verklaringsgegevens Het veld soort verklaring. Daarnaast geldt dat de exporteiskenmerken en certificaatkenmerken ook gewijzigd mogen worden. NB: Alle wijzigbare velden dienen in zijn geheel opnieuw aangeboden te worden indien actie = Wijzigen. Indien er bij het toevoegen geen exportgegevens zijn aangeleverd en bij het wijzigen wel, dan worden deze gegevens dus toegevoegd. Andersom geldt dat in een dergelijk geval de exportgegevens worden verwijderd indien deze initieel wel waren aangeleverd. Probeert men een wijziging door te voeren op een veld dat niet geoorloofd is, dan wordt de verwerking van het bericht gestaakt en wordt de gebruiker een foutmelding gepresenteerd in de vorm: U heeft getracht een niet toegestane wijziging door te voeren: <naam veld>. 3. Functie = Intrekken Indien het aanvraagnummer gevuld is en de actie is I kan het bericht gebruikt worden om een reeds ingediende exportaanvraag in te trekken (lees : de status ingetrokken krijgt). NB: hier geldt: het intrekken van een exportaanvraag waarvoor nog geen exportdocumenten aangevraagd zijn. Indien de exportdocumenten al aangevraagd zijn, dan dient de webservicefunctie CME0320U gebruikt te worden. Indien de functie niet eenduidig is te herleiden wordt een passende foutmelding (e.g. Ongeldige actie gespecificeerd. Geldige waarden zijn T(oevoegen), W(ijzigen) & I(ntrekken) ) verstrekt en wordt de verdere verwerking van de service gestaakt. Nadat de functie is gevalideerd worden de aangeleverde sector- en relatiegegevens gevalideerd. Deze validatie is algemeen van aard en vindt plaats voordat de specifieke aanvraaggegevens worden gevalideerd. De algemene validaties omvatten de volgende controles: 10
Indien zowel i_binnummer als i_kvknummer leeg zijn dan O_succesindicator := N (Nee) O_soortFoutIndicator := E (Error) O_foutcode := CLE-00065 O_foutmelding := BIN nummer en KVK nummer zijn beide leeg Stop de verdere verwerking. Check of exportrolnaam is gevuld. Indien nee, dan O_succesindicator := N (Nee) O_soortFoutIndicator := E (Error) O_foutcode := CLE-00065 O_foutmelding := Verplichte parameter <parameternaam> is niet gevuld. Stop de verdere verwerking. Check of beveiligingssleutel is gevuld. Indien nee, dan O_succesindicator := N (Nee) O_soortFoutIndicator := E (Error) O_foutcode := CLE-00065 O_foutmelding := Beveiligingssleutel is leeg. Stop de verdere verwerking. Met behulp van het (i_binnummer of i_kvknummer), vestigingsnummer, exportrolnaam en beveiligingssleutel wordt de unieke exportrol bepaald. Indien geen resultaat gevonden dan O_succesindicator := N (Nee) O_soortFoutIndicator := E (Error) O_foutcode := CLE-00065 O_foutmelding := Unieke exportrol kan niet worden bepaald. Stop de verdere verwerking. Check of sectorcode is gevuld. Indien nee, dan O_succesindicator := N (Nee) O_soortFoutIndicator := E (Error) O_foutcode := CLE-00065 O_foutmelding := Verplichte parameter <parameternaam> is niet gevuld. Stop de verdere verwerking. Check of de sectorcode een bestaande sectorcode betreft. Indien nee, dan 11
O_succesindicator := N (Nee) O_soortFoutIndicator := E (Error) O_foutcode := CLE-00065 O_foutmelding := Sector <parameternaam> onbekend. Stop de verdere verwerking. Check of de sectorcode gelijk is aan CME. Indien nee, dan O_succesindicator := N (Nee) O_soortFoutIndicator := E (Error) O_foutcode := CLE-00065 O_foutmelding := SectorCode niet juist gespecificeerd. Stop de verdere verwerking. Na het succesvol uitvoeren van alle validaties wordt de aanvraag vervolgens in de database aangemaakt c.q. gewijzigd. Bij het niet succesvol uitvoeren van bovenstaande blokkerende validaties of bij het optreden van andersoortige gecontroleerde en ongecontroleerde fouten wordt de verwerking gestaakt en wordt een foutmelding aan de gebruiker geretourneerd. Er worden dan geen wijzigingen doorgevoerd in de database. 2.2 CME0301U: Opvragen status aanvraag De webservicefunctie OpvragenStatusAanvraag is bedoeld om van een in CLIENT Export aanwezige aanvraag de status op te vragen. Daartoe wordt de webservice aangeroepen conform de daarvoor benodigde gegevensstructuur. De verwerking van het bericht volgt op hoofdlijnen de volgende stappen: 1. Met het opgegeven aanvraagnummer wordt de betreffende aanvraag opgezocht in CLIENT Export. 2. Voor dat aanvraagnummer wordt de functie ververs waarborgen uitgevoerd. 3. Vervolgens wordt het uitbericht samengesteld met de meest actuele stand van de waarborgen voor de betreffende aanvraag. De aanroep van de webservice resulteert in de status van de exportzending per eis die de Europese verordening en/of het bestemmings- 12
land stelt (rood/oranje/groen) en aanvullende detailgegevens daar waar het die eisen betreft. Bij het gebruiken van deze functie gelden de volgende beperkingen/aandachtspunten: Per aanroep kan de status van één aanvraag opgevraagd worden. 2.3 CME0311U : Opvragen status aanvraag De webservicefunctie CME0311U OpvragenStatusAanvraag is bedoeld om van een in Client Export aanwezige aanvraag de status asynchroon op te vragen. Daartoe wordt de webservice aangeroepen conform de daarvoor benodigde gegevensstructuur. De verwerking van het bericht volgt op hoofdlijnen de volgende stappen: 1. Met het opgegeven aanvraagnummer wordt de betreffende aanvraag opgezocht in CLIENT Export. 2. Voor dat aanvraagnummer wordt de functie ververs waarborgen uitgevoerd. 3. Vervolgens wordt een request_id afgegeven bij het aanvraagnummer. 4. Met het aanvraagnummer en het request_id kan op de CM- E0311U de status van de aanvraag worden opgevraagd. De aanroep van de webservice met het request_id resulteert in de status van de exportzending per eis die de Europese verordening en/of het bestemmingsland stelt (rood/oranje/groen) en aanvullende detailgegevens daar waar het die eisen betreft. Bij het gebruiken van deze functie gelden de volgende beperkingen/aandachtspunten: Per aanroep kan de status van één aanvraag opgevraagd worden. 13
2.4 CME0301U: AanvragenInspecties Deze webservicefunctie kan in de toekomst gebruikt worden om inspecties bij de VWA aan te vragen. Deze functie is momenteel niet beschikbaar voor gebruik. 2.5 CME0302U : Verstrekken afdrukopdracht De webservicefunctie VerstrekkenAfdrukOpdracht is bedoeld om van een in CLIENT Export aanwezige aanvraag het afdrukken van de exportdocumenten bij de VWA te initiëren. Daartoe wordt de webservice aangeroepen conform de daarvoor benodigde gegevensstructuur. De verwerking van het bericht volgt op hoofdlijnen de volgende stappen: 1. Met het opgegeven aanvraagnummer wordt de betreffende aanvraag opgezocht in CLIENT Export 2. Voor dat aanvraagnummer wordt de functie ververs waarborgen uitgevoerd. 3. Als de status van de aanvraag groen is (exportwaardigheid akkoord), dan antwoordt de webservice met een ok-bericht. De webservice zorgt ervoor dat de aanvraag van het gezondheidscertificaat indien van toepassing naar de VWA wordt verstuurd zodat deze daar afgedrukt, ondertekend en opgehaald of verzonden kan worden. Hierbij worden zowel de inhoudelijke documenten (in PDF-vorm) alsmede de door de VWA benodigde metagegevens mee geleverd. NB de PDF-bestanden die aan de VWA worden verstrekt, worden uit hoofde van de bewaarplicht in de CLIENT Export-database opgeslagen. Als bij gebruik van de functie AFGIFTE ook het veld certdoctype van een waarde (XML, PDF, Beiden) wordt voorzien, dan bevat de response niet alleen de succesindicator maar ook afdrukvoorbeelden van de alle documenten in de aanvraag. LET OP deze documenten zijn BASE64 gecodeerd. De aanroep van de webservice resulteert in een reactie waarin wordt aangegeven dat de afdrukopdracht succesvol aan de VWA is aangeboden. Let wel daarmee is niet gezegd dat de documenten feite- 14
lijk al afgedrukt zijn. De VWA creëert een kleine werkvoorraad om het logistieke proces van afdrukken zo efficiënt mogelijk in te richten. Deze webservice kan ook gebruikt worden om alleen afdrukvoorbeelden van documenten op te vragen. Daarvoor moet het gegevenselement functie de waarde AFDRUKVOORBEELD hebben en moet het veld certdoctype gevuld zijn. Per aanroep van de webservice kan een afdrukvoorbeeld van één aanvraag opgevraagd worden. Dat afdrukvoorbeeld kan één specifiek document zijn maar kan ook alle documenten van die aanvraag betreffen. (In dat geval moet certdoctype wel gevuld maar naamcertificaat niet gevuld zijn) 2.6 CME0320U: IntrekkenAfgegevenAanvraag De webservicefunctie IntrekkenAfgegevenAanvraag is bedoeld om een aanvraag waarvoor de documenten al zijn aangevraagd in te trekken. Door het intrekken van de afgegeven aanvraag, krijgt de aanvraag de status Ingetrokken en worden alle documenten die door CLIENT Export/de VWA voor deze export zijn afgegeven ongeldig. Ook wordt de melding van de betreffende export door CLIENT Export/de VWA uit TRACES gehaald. De verwerking van het bericht volgt op hoofdlijnen de volgende stappen: Er is 1 mogelijke functie gedefinieerd, die aangeroepen kan worden middels de vulling van het veld actie in het bericht: 1. Functie = Intrekken na aanvraag exportdocumenten Indien het aanvraagnummer gevuld is en de actie is I kan het bericht gebruikt worden om een export waarvoor de documenten reeds zijn aangevraagd, alsnog in te trekken. Vervolgens vinden de volgende acties plaats: 1. Met het opgegeven aanvraagnummer wordt de betreffende aanvraag opgezocht in CLIENT Export. 2. De status van het opgegeven aanvraagnummer wordt gecontroleerd. Indien de status van het opgegeven aanvraagnummer niet gelijk is aan gewaarmerkt of verklaring verstrekt, dan stopt de verwerking en volgt een foutmelding. In- 15
dien de status van het opgegeven aanvraagnummer gelijk is aan gewaarmerkt of verklaring verstrekt, dan gaat het proces intrekking na afgifte van exportdocumenten verder. 3. Het opgegeven aanvraagnummer krijgt de status Ingetrokken en de datum van de intrekking na afgifte wordt geregistreerd in Client Export. 4. Alle voor de betreffende export afgegeven documenten (gezondheidscertificaat, VDM, etc) krijgen de status ongeldig. 5. De exportmelding in TRACES wordt verwijderd. De aanroep van deze webservicefunctie resulteert in een succesindicator die aangeeft of het intrekken van de aanvraag na afgifte van de exportdocumenten succesvol is verlopen. Bij het gebruiken van deze functie gelden de volgende beperkingen/aandachtspunten: Per aanroep kan één aanvraag na afgifte van de exportdocumenten ingetrokken worden. 2.7 CME0321U :WijzigTransportMoment De webservicefunctie WijzigTransportMoment is bedoeld om te voorkomen dat de aanvraag als definitief wordt gezien in verband met de verplichte 12-uursmelding aan de AID. In de aanvraag is een transportdatum en een tijdsindicatie opgegeven. Deze transportdatum en tijdsindicatie mag tot 12 uur voor het verstrijken ervan veranderd worden. Gebeurt dat niet, dan gaat de AID ervan uit dat de 12uursmelding gedaan is conform het gestelde in de aanvraag en zal zij daarop handhaven. De verwerking van het bericht volgt op hoofdlijnen de volgende stappen: 1. Met het opgegeven kvk-nummer en beveiligingssleutel wordt de betreffende aanvrager opgezocht in Client Export 2. Met het betreffende aanvraagnummer wordt de aanvraag opgezocht in Client. Als deze aanvraag niet de status gewaarmerkt of verklaring verstrekt heeft, dan volgt een foutboodschap. Immers alleen voor reeds aangevraagde en afgegeven exportdocumenten is deze functie actief. 16
3. Voor de gevonden aanvraag wordt bepaald of de nieuwe opgegeven transportdatum en tijdstip voldoet aan de daaraan gestelde beperkingsregels. Is dat het geval dan worden in de database transportdatum en tijdsindicatie overschreven met de nieuwe waarden. 17
3 GEGEVENSVERZAMELINGEN 3.1 Domeinen Bij het uitwisselen van gegevens via de webservice wordt voor diverse gegevenselementen gebruik gemaakt van sets van vaste waarden, zogenaamde domeinen. Daar waar gegevenselementen gebruik maken van een domein, is dat aangegeven in het document Client Export - Berichtenboek CME - Berichtstructuur CLE-berichten v2.00.xls, in de kolom Domein. U kunt vervolgens het domein opzoeken in het document Client Export - Domeinen v2.00.xls om de toegestane waarden voor het betreffende gegevenselement op te zoeken. De meest actuele lijst van de domeinen kunt u opvragen bij de VWA. 3.2 Publieke informatie Verder wordt bij enkele gegevenselementen gebruik gemaakt van publieke referentiegegevens. Deze gegevens wijzigen vaker dan domeinen, voornamelijk als gevolg van wijzigingen in de eisen van bestemmingslanden. De volgende overzichten zijn beschikbaar: Bindende Afspraken met kenmerken : De combinatie van sel- ProductNaam, sellandvanbestemming, Certificaattype, CertificaatmodelTaal en de gegevens die nodig zijn om de certificaatkenmerken te vullen (naam, optionaliteit en niveau) Publieke Verzoeken met kenmerken : De combinatie van verzoeknummer, Certificaattype, CertificaatmodelTaal en de gegevens die nodig zijn om de certificaatkenmerken te vullen (naam, optionaliteit en niveau) Bindende Afspraken met verklaringsteksten : De combinatie van selproductnaam, sellandvanbestemming, Certificaattype, CertificaatmodelTaal en optioneleverklaringstekst voor het kunnen aangeven welke van de optionele verklaringsteksten op het certificaat moeten worden afgedrukt. Publieke Verzoeken met kenmerken : De combinatie van verzoeknummer, Certificaattype, CertificaatmodelTaal en optioneleverklaringstekst voor het kunnen aangeven welke van de 18
optionele verklaringsteksten op het certificaat moeten worden afgedrukt. De meest actuele lijst van de publieke gegevens kunt u opvragen bij de VWA. 3.3 Exclusieve informatie In sommige gevallen kunt/moet u gebruik maken van referentiegegevens die alleen voor uw organisatie beschikbaar zijn. Dit in verband met de bescherming van uw handelsbelangen. Het gaat om de volgende gegevensverzamelingen: Exclusieve Verzoeken met kenmerken : De combinatie van verzoeknummer, Certificaattype, CertificaatmodelTaal en de gegevens die nodig zijn om de certificaatkenmerken te vullen (naam, optionaliteit en niveau) Exclusieve Verzoeken met kenmerken : De combinatie van verzoeknummer, Certificaattype, CertificaatmodelTaal en optioneleverklaringstekst voor het kunnen aangeven welke van de optionele verklaringsteksten op het certificaat moeten worden afgedrukt. De meest actuele lijst van de exclusieve gegevens kunt u opvragen bij de VWA. 19
4 TECHNIEK 4.1 HTTP De webservice maakt gebruik van de transportlaag Hypertext Transfer Protocol - HTTP/1.1, RFC 2616. 4.2 SOAP De webservice maakt gebruik van Technologie stack: Simple Object Access Protocol - SOAP/1.2 4.3 WSDL De webservice biedt de informatie aan de gebruikers aan via de interface specificatie: Web Service Description Language - WSDL Version 1.1, binding extension for SOAP 1.2. Het message format is document based. 4.4 XML Elk bericht gebruikt uitsluitend de ISO-8859-1 tekenverzameling gecodeerd volgens de UTF-8 codering. Alle tekens niet vallend in de ASCIIsubset worden hierbij gecodeerd in hexadecimale vorm (zoals è voor kleine e met accent grave, de è). Codering met decimalen, of entiteitafkortingen (zoals voor een kleine e met accent grave: è of è) is NIET toegestaan. Teneinde de compatibiliteit te vergroten worden voor het aangeven van optionele velden twee xml-tags gebruikt: Nillable = true Minoccurs = 0 Bovendien wordt ook de indicatie Maxoccurs gebruikt voor het aangeven van het maximum van meerdere voorkomens van een gegevenselement. 20
5 BEVEILIGING Teneinde onjuist en onterecht gebruik van de webservice te voorkomen zijn de diverse maatregelen geïmplementeerd. Het is niet uitgesloten dat in de toekomst aanvullende maatregelen ter beveiliging van het gebruik van de webservices worden geïmplementeerd. 5.1 Procedureel Het gebruik van de webservices wordt gemonitord. Bij oneigenlijk gebruik van de webservice wordt de toegang tot de webservice onmiddellijk ingetrokken. 5.2 Beveiligingssleutel In de sectie relatiegegevens is het gegevenselement beveiligings- Sleutel toegekend. Bij iedere aanroep van de webservice moet deze beveiligingssleutel worden toegevoegd aan het bericht. De beveiligingssleutel bestaat uit 64 tekens. Bij het aanbieden van het bericht wordt getoetst of de in het bericht aangegeven beveiligingssleutel hoort bij de aanvrager die het bericht ter verwerking aanbiedt. Is dat niet het geval, dan wordt het bericht niet in behandeling genomen. Het is van belang dat u de beveligingssleutel als absoluut vertrouwelijk behandeld; het is te vergelijken met de pincode van uw pinpas. De beveiligingssleutel wordt verstrekt door de Functioneel Applicatie Beheerder van Client Export en wordt alleen aan een daartoe bevoegde persoon verstrekt als daarom schriftelijk wordt verzocht. 5.3 Machtigen en vertegenwoordigen Het is niet mogelijk om de bevoegdheid om berichten aan Client Export aan te bieden, te verleggen naar een andere relatie middels het verstrekken van een machtiging. 21
BIJLAGE I: UITWISSELINGSSCHEMA