Ratkaisut Bisnodesta Syvennä osaamistasi Toimialat Asiakaspalvelu Osta verkosta
Etsi
COMPANY SOAP API

Company information

The API response contains e.g the company's basic information, rating, scoring and responsible person's credit remarks.

Company Information
Company Information

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
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>