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

NameTypeDescription 
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

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>