Here you can download WSDL file
In order to use the API you must have a valid environment-specific user and customer ID's. All API requests must be made over HTTPS.REQUEST THE USER AND CUSTOMER ID'S
COMPANY SOAP API
Company information
The API response contains e.g the company's basic information, rating, scoring and responsible person's credit remarks.
API endpoints
- https://test.soliditet.fi/frg/services/HaeYtjTiedot - test environment
- https://www.soliditet.fi/frg/services/HaeYtjTiedot - production environment
API request parameters
| Name | Type | Description | |
|---|---|---|---|
| kayttajatunnus | String | User ID. Bisnode will provide this ID. | M |
| asiakastunnus | String | Customer ID. Bisnode will provide this ID. | M |
| loppuasiakas_koodi | String | For example the service/site id that request was sent to. e.g. 54321 | O |
| loppuasiakas_nimi | String | The name of the company who made the request. e.g. Customer Company Ltd | O |
| loppuasiakas_henkilonimi | String | The name of the person who made the request. e.g. John Doe | O |
| asiakkaan_viite | String | Reference information. | O |
| hakukriteeri | String | Search criteria. It can be business identification number or duns number. Available options: ytunnus=business id, duns=duns number | M |
| hakuavain | String | Search key. Business identification number or duns number. e.g. 2373722-4 | M |
| tuotetyyppi | String | Product type. Available options: YTJ1, YTJ2, YTJ3, YTJ4, YTJS and YTJD | M |
| M = Mandatory, O = Optional | |||
Simple API request and response example
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:req="http://www.soliditet.fi/frg/HaeYtjTiedot/request">
<soapenv:Header/>
<soapenv:Body>
<req:Request>
<req:kayttajatunnus>GKFOD23123</req:kayttajatunnus>
<req:asiakastunnus>ABCDEFGH</req:asiakastunnus>
<req:hakukriteeri>ytunnus</req:hakukriteeri>
<req:hakuavain>2014838-7</req:hakuavain>
<req:tuotetyyppi>YTJ1</req:tuotetyyppi>
</req:Request>
</soapenv:Body>
</soapenv:Envelope>
Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:req="http://www.soliditet.fi/frg/HaeYtjTiedot/request" xmlns:resp="http://www.soliditet.fi/frg/HaeYtjTiedot/response" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:frg="http://www.soliditet.fi/frg/HaeYtjTiedot/wsdl" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<resp:Response>
<resp:YTJ1 y-tunnus="20148387" duns="539506084" status="voimassa">
<resp:toiminimi>
<resp:nimi>Bisnode Finland Oy</resp:nimi>
<resp:alkupvm>20060213</resp:alkupvm>
</resp:toiminimi>
<resp:aputoiminimet>
<resp:aputoiminimi>
<resp:nimi>Soliditet Finland</resp:nimi>
<resp:alkupvm>20060607</resp:alkupvm>
</resp:aputoiminimi>
<resp:aputoiminimi>
<resp:nimi>Yritystele</resp:nimi>
<resp:alkupvm>20121231</resp:alkupvm>
</resp:aputoiminimi>
<resp:aputoiminimi>
<resp:nimi>Bisnode Credit</resp:nimi>
<resp:alkupvm>20130419</resp:alkupvm>
</resp:aputoiminimi>
</resp:aputoiminimet>
<resp:yhtiomuoto arvo="Osakeyhtiö"/>
<resp:kotipaikka koodi="091" arvo="HELSINKI"/>
<resp:kieli arvo="Suomi"/>
<resp:toimiala>
<resp:tol>82910</resp:tol>
<resp:seloste>Perintä- ja luottotietopalvelut</resp:seloste>
<resp:alkupvm>20100215</resp:alkupvm>
</resp:toimiala>
<resp:yhteystiedot>
<resp:postiosoite>
<resp:posoite>Kumpulantie 3</resp:posoite>
<resp:ppostino>00520</resp:ppostino>
<resp:ppostitp>HELSINKI</resp:ppostitp>
<resp:alkupvm>20090306</resp:alkupvm>
</resp:postiosoite>
<resp:kayntiosoite>
<resp:kosoite>Kumpulantie 3</resp:kosoite>
<resp:kpostino>00520</resp:kpostino>
<resp:kpostitp>HELSINKI</resp:kpostitp>
<resp:alkupvm>20090626</resp:alkupvm>
</resp:kayntiosoite>
<resp:puhelin numero="09 75119100"/>
<resp:fax numero="09 5022940"/>
<resp:email osoite="asiakaspalvelu@bisnode.com"/>
</resp:yhteystiedot>
<resp:rekisteritiedot>
<resp:prh tila="Rekisterissä">
<resp:prh_alkupvm>20060213</resp:prh_alkupvm>
<resp:prh_loppupvm>20751231</resp:prh_loppupvm>
</resp:prh>
<resp:prh tila="Rekisteröimätön">
<resp:prh_alkupvm>20060123</resp:prh_alkupvm>
<resp:prh_loppupvm>20060212</resp:prh_loppupvm>
</resp:prh>
<resp:verohallinto>
<resp:vh_alkupvm>20060131</resp:vh_alkupvm>
<resp:vh_loppupvm>20751231</resp:vh_loppupvm>
</resp:verohallinto>
<resp:epr>
<resp:epr_alkupvm>20060201</resp:epr_alkupvm>
<resp:epr_loppupvm>20751231</resp:epr_loppupvm>
</resp:epr>
<resp:epr_tarkistuspaiva>
<resp:epr_tarkpvm>20170228</resp:epr_tarkpvm>
</resp:epr_tarkistuspaiva>
<resp:alv tarkenne="Liiketoiminnasta arvonlisäverovelvollinen">
<resp:alv_alkupvm>20060201</resp:alv_alkupvm>
<resp:alv_loppupvm>20751231</resp:alv_loppupvm>
</resp:alv>
<resp:tar>
<resp:tar_alkupvm>20060601</resp:tar_alkupvm>
<resp:tar_loppupvm>20751231</resp:tar_loppupvm>
</resp:tar>
</resp:rekisteritiedot>
<resp:fuusiot_ja_diffuusiot>
<resp:fuusio_vastaanottava>
<resp:fuusio_pvm>20121231</resp:fuusio_pvm>
<resp:fuu_sul_nimi>Yritystele Oy</resp:fuu_sul_nimi>
<resp:fuu_sul_ytunnus>23627332</resp:fuu_sul_ytunnus>
</resp:fuusio_vastaanottava>
</resp:fuusiot_ja_diffuusiot>
</resp:YTJ1>
</resp:Response>
</soapenv:Body>
</soapenv:Envelope>