Handleiding Reeleezee Taxonomie Webservice

Reeleezee Technical Documentation
Reeleezee Taxonomy Webservice
Authors:
M. van Bergen, J. Posny, R. Witteveen
(C) Reeleezee 2009
1311-6-2009
Reeleezee Taxonomy WebService
pagina 1
Reeleezee Technical Documentation
Inhoud
1.
Inleiding ........................................................................................................................................................... 3
2.
Gegevens voor gebruik.................................................................................................................................... 3
3.
Functie Import .................................................................................................................................................. 3
2311-6-2009
Reeleezee Taxonomy WebService
pagina 2
Reeleezee Technical Documentation
1. Inleiding
De Reeleezee Taxonomy Webservice is beschikbaar voor klanten van Reeleezee. Met deze service kan een groot
bereik aan gegevens aangeleverd én automatisch geimporteerd worden in de opgegeven Reeleezee Administratie.
De aan te leveren data moet hiervoor in de vorm van XML zijn, conform de Reeleezee Taxonomie.
2. Gegevens voor gebruik
De Reeleezee Taxonomy Webservice is bereikbaar op de volgende URL:
https://portal.reeleezee.nl/ezVersionService/externalServices/TaxonomyService/TaxonomyWebService.asmx
Voor de communicatie met deze Reeleezee Webservice zijn verder geen bijzondere vereisten, het is een publiek
beschikbare service.
3. Functie Import
Deze functie is bedoeld om data in XML conform Reeleeze Taxonomy aan te leveren voor import in een Reeleezee
Administratie. Naast automatisch importeren van de aangeleverde data kent deze functie nog de mogelijkheid om
alleen een validatie te doen van de aangeboden data; dit is met name bedoeld ter ondersteuning van de
ontwikkeling van aansluitingen op deze webservice. Voor authenticatie wordt de combinatie van gebruikersnaam en
wachtwoord gebruikt, dit moet een geldige login zijn voor de doel-administratie in Reeleezee.
Declaratie van deze functie:
public byte[] Import
(
string userName,
string password,
[System.Xml.Serialization.XmlElementAttribute(DataType="base64Binary")] byte[] xmlDocument,
bool checkValidityOnly
)
Parameters:
username
password
xmlDocument
checkValidityOnly
gebruikersnaam [ zoals toegekend door Reeleezee ]
wachtwoord
[ zoals toegekend door Reeleezee ]
byte array met xml data (optioneel gecomprimeerd met GZIP compressie)
indicatie of de xml data alleen gevalideerd moet worden, of ook geimporteerd
Resulaat:
byte[]
byte array met xml data (optioneel gecomprimeerd met GZIP compressie)
Het resultaat van de verwerking van de aangeboden import komt in de vorm van xml data, conform Reeleezee
Taxonomy . Voor meer informatie over de inhoud van dit resultaat zie de Reeleezee Taxonomy -> ImportResult
Als bij de aanroep Gzip compressie toegepast wordt, dan is ook het resultaat gecomprimeerd.
3311-6-2009
Reeleezee Taxonomy WebService
pagina 3

Download Report