Usein kysytyt kysymykset

Krediitit ovat valuutta, jolla käytät API:amme. Jokainen pyyntö maksaa päätepisteen ja valittujen asetusten mukaan tietyn määrän krediittejä.

Saat krediittejä kolmella tavalla:

• Rekisteröitymisbonus: Uudet käyttäjät saavat rekisteröityessään 150 ilmaista krediittiä
• Kuukausittaiset tilauskrediitit: Jokainen paketti sisältää kuukausittaisen krediittikiintiön
• Lisäkrediitit: Osta lisää krediittejä tarpeen mukaan

Kustannukset riippuvat päätepisteestä ja valituista tiedoista. Tarkat tiedot löydät täältä:

• API-dokumentaatiostamme löydät kaikki päätepisteet hintoineen
• Arvioi kustannuksesi etusivumme krediittilaskurilla

Se riippuu siitä, onko sinulla tilaus:

• Tilauksen kanssa: Lisäkrediitit ja rekisteröitymisbonus eivät vanhene niin kauan kuin tilauksesi on voimassa
• Ilman tilausta: Krediitit ovat voimassa 30 päivää hyvityksestä
• Tilauskrediitit: Voimassa kunkin laskutuskauden loppuun

Kun saldosi ei enää riitä:

• API-pyynnöt vastaavat virheellä ”Insufficient credits” (HTTP 402)
• Osta lisää krediittejä tai odota seuraavia kuukausittaisia tilauskrediittejä
• Tilisi ja API-pääsysi säilyvät, sinun tarvitsee vain ladata lisää krediittejä

Näet kulutuksesi hallintapaneelissa; siellä näkyy ilmoitus, kun saldosi on vähissä.

Kaikki paketit sisältävät:

• Vanhenemattomat krediitit: Ostamasi krediitit eivät vanhene niin kauan kuin tilauksesi on voimassa
• Kuukausittainen krediittikiintiö: Uusia krediittejä joka kuukausi
• API-pääsy: Kaikki päätepisteet; osa datapisteistä ja suodattimista edellyttää Pro- tai Max-pakettia

Lisäksi paketista riippuen:

• Plus: Sopii pienempiin projekteihin ja testaukseen
• Pro: 5% bonus kaikista krediittiostoista, prioriteettituki
• Max: 15% bonus krediittiostoihin, suurin kuukausikiintiö, prioriteettituki

• Jokaisen laskutuskauden alussa saat pakettisi krediitit, vuosimaksussa joka kuukausi
• Kuukausikrediitit kulutetaan ennen ostettuja krediittejä
• Käyttämättömät kuukausikrediitit vanhenevat jakson lopussa
• Kuukausikrediittejä saat niin kauan kuin tilauksesi on voimassa, irtisanomisen jälkeen maksetun jakson loppuun

Kyllä, tilauksesi on täysin hallinnassasi:

• Päivitys: Vaihda milloin tahansa korkeampaan pakettiin: vaihto tulee voimaan heti, uusi laskutuskausi alkaa ja uusi hinta veloitetaan suoraan
• Pienempään pakettiin: Vaihda milloin tahansa pienempään pakettiin: vaihto tulee voimaan heti, uusi laskutuskausi alkaa ja uusi hinta veloitetaan saman tien
• Irtisanominen: Irtisano milloin tahansa ilman vähimmäissopimuskautta; pakettisi jatkuu maksetun jakson loppuun
• Jatkaminen: Voit jatkaa peruttua tilausta ennen sen päättymistä hallintapaneelin kohdassa ”Hallinnoi”

Tärkeää: kun vaihdat pakettia, jäljellä olevat tilauskrediittisi siirtyvät uuteen pakettiin. Vuosimaksusta kuukausimaksuun voit vaihtaa vasta, kun vuositilauksesi päättyy.

Irtisanomista ja maksutietoja hallinnoit hallintapaneelissa, pakettia vaihdat etusivun hinnoitteluosiossa.

Kun perut tilauksesi:

• Kuukausikrediitit: Käytettävissä maksetun jakson loppuun
• Lisäkrediitit: Eivät vanhene maksetun jakson loppuun mennessä; sen jälkeen niiden alkuperäinen vanhenemispäivä on taas voimassa
• API-pääsy: Säilyy niin kauan kuin sinulla on krediittejä; henkilöprofiilit edellyttävät kuitenkin aktiivista tilausta

Ostat krediittejä hallintapaneelissa tai etusivun hinnoitteluosiossa kohdassa ”Top-up Credits”. Hallintapaneelissa:

1. Avaa hallintapaneelisi
2. Vieritä kohtaan ”Osta krediittejä”
3. Valitse määrä liukusäätimellä tai pikavalinnalla
4. Tarkista bonukset ja krediittien kokonaismäärä
5. Viimeistele turvallinen maksu Stripen kautta

Krediitit ovat käytettävissä heti oston jälkeen.

Kyllä, tilauksen kanssa. Ilman tilausta lisäkrediitit ovat voimassa 30 päivää ostosta. Niin kauan kuin sinulla on tilaus (Plus, Pro tai Max), ne eivät vanhene – eivät myöskään aiemmin ostetut, kunhan ne ovat vielä voimassa tilauksen alkaessa. Kun tilaus päättyy, niiden alkuperäinen vanhenemispäivä on taas voimassa.

Mitä enemmän ostat kerralla, sitä enemmän bonuskrediittejä saat:

Bonukset lisätään automaattisesti ja ne summataan pakettisi bonukseen.

Kyllä, lisäkrediittiosto on vähintään 2.000 krediittiä. Tämä takaa:

• Pienemmät transaktiokustannukset krediittiä kohden
• Parempi hinta sinulle
• Vähemmän vaivaa maksujen käsittelyssä

Voit valita yhteen ostoon enintään 500.000 krediittiä.

Määrä- ja pakettibonus lasketaan yhteen:

Molemmat bonukset lasketaan peruskrediiteistä.

Hinnoittelumme on yksinkertainen:

• Krediitit: 0,01 € / krediitti (ennen bonuksia)
• Tilaukset: Kiinteä kuukausi- tai vuosihinta, johon sisältyy krediittejä
• Ei piilomaksuja: Maksat sen, minkä näet

Kaikki hinnat euroina, lisäksi lakisääteinen arvonlisävero.

Ei, kaikki hinnat ovat nettohintoja. Sovellettava arvonlisävero riippuu maastasi ja ALV-tunnisteestasi; se lasketaan ja näytetään kassalla.

Hyväksymme seuraavat maksutavat:

• Luottokortti (Visa, Mastercard, American Express)
• Debit-kortti
• PayPal
• Maksu laskulla tilisiirtona Enterprise-sopimuksella ([email protected])

Kaikki verkkomaksut käsitellään turvallisesti ja PCI-vaatimusten mukaisesti Stripen kautta.

Kyllä, jokaisesta maksusta luodaan automaattisesti lasku:

• Saatavilla heti maksun jälkeen
• Tilauksella haettavissa milloin tahansa hallintapaneelista kohdasta ”Näytä laskut”
• Kaikkine tarvittavine verotietoineen
• Sähköpostitse jokaisen maksun jälkeen

Laskumme täyttävät EU:n verosäännökset ja sisältävät kaikki kirjanpitoosi tarvittavat tiedot.

Paketit ja lisäkrediitit maksat Stripen kassalla luotto- tai debit-kortilla tai PayPalilla, ja saat niistä laskun. Laskulla ja tilisiirrolla maksamista tarjoamme Enterprise-sopimuksella; kirjoita meille osoitteeseen [email protected].

Vanhenemattomat krediitit ovat jokaisen tilauksen etu:

• Koskee ostettuja krediittejä ja rekisteröitymisbonusta
• Krediittien on oltava voimassa tilauksen alkaessa
• Ne eivät vanhene niin kauan kuin tilauksesi on voimassa
• Kun tilaus päättyy, voimaan palaa 30 päivän määräaika ostosta lukien

Krediitit kulutetaan tässä järjestyksessä:

1. Tilauskrediitit (jos sinulla on tilaus)
2. Ostetut krediitit ja rekisteröitymisbonus (vanhimmat ensin)

Näin varmistamme:

• Kuukausikrediitit käytetään ennen kuin ne vanhenevat
• Ostetut krediitit riittävät pidempään
• Hyödynnät krediittisi parhaalla tavalla

Veloitus tapahtuu automaattisesti:

• Krediitit veloitetaan vastauksen jälkeen ja vain toimitetuista tiedoista
• Jokainen veloitus kirjataan yksityiskohtineen
• Saldosi päivittyy heti
• Epäonnistuneet pyynnöt eivät maksa krediittejä, paitsi yritysprofiilien AI-tila: se veloitetaan myös virheen sattuessa

Tietokantalukitukset varmistavat, että jokainen veloitus on oikein myös suuren kuormituksen aikana.

AI-tila on yritysprofiilien (/api/v1/fetch-organization) lisävalinta:

• Parempi täsmäytys: löytää usein yrityksiä, jotka tarkka nimihaku ohittaa
• Verkkotiedot: yhteystiedot, avainsanat, tuotteet ja palvelut sekä täydellinen WZ-luokitus
• Maksaa 20 krediittiä lisää, myös jos pyyntö epäonnistuu
• Valinnainen päätepisteessä /api/v1/fetch-organization; päätepisteessä /api/v1/fetch-person aina käytössä (sisältyy 15 krediitin perushintaan)

Palvelimemme sijaitsevat Saksassa ja EU:ssa.

Kyllä, handelsregister.ai on GDPR-yhteensopiva. Tiedot ovat peräisin julkisista rekistereistä, ja palvelimemme sijaitsevat Saksassa ja EU:ssa.

Tietojenkäsittelysopimuksen teemme pyynnöstä. Kirjoita meille osoitteeseen [email protected].

Kaikki yksityiskohdat löytyvät tietosuojaselosteestamme.

API:n tämänhetkisen tilan näet milloin tahansa tilasivultamme osoitteessa handelsregister.ai/status.

Sopimuksella taattu saatavuus (SLA) kuuluu Enterprise-sopimukseen.

Saksan kaupparekisterille ei ole virallista API:a. handelsregister.ai on Fusionbase GmbH:n riippumaton API, joka toimittaa virallisia yritystietoja kaupparekisteristä, Bundesanzeigerista ja maksukyvyttömyyskuulutuksista jäsenneltynä JSON-muodossa – haluttaessa reaaliajassa, ohjelmistoille ja AI-agenteille.

Tiedot ovat peräisin virallisista rekistereistä ja julkisista lähteistä, ennen kaikkea:

• Kaupparekisteri: Rekisteritiedot, kuten yhtiömuoto, kotipaikka ja johto, sekä kuulutukset, osakasluettelot ja asiakirjat
• Unternehmensregister ja Bundesanzeiger: Julkaistut tilinpäätökset taseineen ja tuloslaskelmineen
• Insolvenssituomioistuimet: Maksukyvyttömyyskuulutukset
• Lehdistö ja verkko: Uutiset, yritysten verkkosivustot ja muut julkisesti saatavilla olevat verkkosivut

API sisältää yli 5 miljoonaa yritystä ja organisaatiota.

Kaikki yritykset ja organisaatiot, jotka on merkitty Saksan kaupparekisteriin tai johonkin muuhun virallisen rekisteriportaalin rekisteriin:

• Kaupparekisterin osasto B (HRB): Pääomayhtiöt, kuten GmbH, UG (haftungsbeschränkt), AG, SE ja KGaA
• Kaupparekisterin osasto A (HRA): Yksityiset elinkeinonharjoittajat (e.K.) ja henkilöyhtiöt, kuten OHG, KG ja GmbH & Co. KG
• Osuuskuntarekisteri (GnR): rekisteröidyt osuuskunnat (eG)
• Partnerschaft-rekisteri (PR): vapaiden ammattien harjoittajien Partnerschaft-yhtiöt (PartG, PartG mbB)
• Yhdistysrekisteri (VR): rekisteröidyt yhdistykset (e.V.)
• Yhtiörekisteri (GsR): rekisteröidyt siviilioikeudelliset yhtiöt (eGbR)

AI-tilassa löydät julkisesti saatavilla olevien verkkosivujen kautta lisäksi yrityksiä, joilla ei ole rekisterimerkintää, kuten yksityisiä elinkeinonharjoittajia ja freelancereita.

Yrityksestä riippuen saatavilla on seuraavat tietoluokat:

Kaikilla yrityksillä ei ole kaikkia tietoluokkia; saatavuus riippuu koosta, yhtiömuodosta ja julkistamisvelvollisuuksista.

Taloustietoja (taseet, tuloslaskelmat, tunnusluvut) on saatavilla yrityksistä, joiden on julkaistava tilinpäätöksensä. Tämä koskee ennen kaikkea:

• Kaikki GmbH-, UG-, AG- ja KGaA-yhtiöt
• Tietyt henkilöyhtiöt, joissa vastuunalaisena yhtiömiehenä ei ole luonnollista henkilöä (esim. GmbH & Co. KG)

Yksityiskohtaisuus vaihtelee: suuremmat yritykset julkaisevat yleensä kattavampia taloudellisia raportteja, pienemmät usein vain lyhennetyn taseen. Yksityisillä elinkeinonharjoittajilla ja henkilöyhtiöillä, joissa vastuunalaisena yhtiömiehenä on luonnollinen henkilö, ei yleensä ole taloustietoja.

Monet konsernit julkaisevat kaksi tilinpäätöstä: yhtiön oman tilinpäätöksen ja konsernitilinpäätöksen. API:ssa, Playgroundissa ja yritystietojen rikastamisessa voit valita, mikä tilinpäätöstyyppi ja kuinka monta tilikautta toimitetaan; yritysprofiileissa vaihdat yhdellä napsautuksella yhtiö- ja konsernilukujen välillä, kun samalta vuodelta on saatavilla molemmat.

Osakastietoja on saatavilla erityisesti seuraaville:

• GmbH ja UG: Osakasluettelot toimitetaan kaupparekisteriin, ja niissä on nimet, panokset ja omistusosuudet
• AG: Yksittäisiä osakkeenomistajia ei yleensä rekisteröidä; vain suuret osakkeenomistajat voivat olla tiedossa julkisista ilmoituksista

Saatavuus riippuu siitä, onko rekisteriin toimitettu ajantasaiset osakasluettelot.

Käsittelemme tiedot automatisoitujen järjestelmien ja tekoälyavusteisen poiminnan yhdistelmällä:

• Viralliset rekisteriasiakirjat ja julkaisut luetaan automaattisesti
• Tekoäly jäsentää, täydentää ja analysoi tiedot
• Useiden lähteiden tiedot yhdistetään ja pidetään ajan tasalla

Se riippuu lähteestä:

• Kaupparekisteri: Perustiedot, henkilöt ja rekisterikuulutukset pidämme jatkuvasti ajan tasalla rekisterin pohjalta. Reaaliaikatilassa API hakee yritysprofiilin pyynnön hetkellä suoraan kaupparekisteristä.
• Tilinpäätökset: Uudet julkaistut tilinpäätökset otamme mukaan päivittäin. Yrityksillä on julkaisuun aikaa jopa kaksitoista kuukautta, joten uusin tilinpäätös koskee usein toissa vuotta.
• Maksukyvyttömyyskuulutukset: Tuomioistuimet julkaisevat ne yleensä päätöspäivänä tai pian sen jälkeen.
• Asiakirjat: Rekisteriotteet, osakasluettelot ja yhtiöjärjestykset API hakee aina suoraan kaupparekisteristä.

Kyllä. Reaaliaikatilassa (parametri realtime_mode) API hakee yritysprofiilin pyynnön hetkellä suoraan kaupparekisteristä, nykyinen johto mukaan lukien. Se maksaa 10 krediittiä lisää, vain jos reaaliaikainen haku onnistuu, ja kestää muutaman sekunnin pidempään. Ilman reaaliaikatilaa profiili tulee tietokannastamme.

Reaaliaikainen haku ei sisällä aiempia toimitusjohtajia eikä muita historiallisia tietoja.

Asiakirjat, kuten kaupparekisteriotteet, osakasluettelot ja yhtiöjärjestykset, API hakee aina reaaliajassa kaupparekisteristä. Jos samaa asiakirjaa on haettu viimeisten 24 tunnin aikana, toimitamme sen välimuistista.

Kyllä, Enterprise-sopimuksella: saat koko tietokannan viennin, ja sovimme käyttöoikeuksista yksilöllisellä lisenssillä. Kerro suunnitelmistasi osoitteeseen [email protected]; vastaamme yhden arkipäivän kuluessa.

Yksittäisille listoille on vienti kohdassa ”Haku & vienti”: enintään 5.000 yritystä vientiä kohden.