Mistä tiedän, että konkurssi liittyy juuri oikeaan yritykseen?

Ilmoitukset on linkitetty Y-tunnukseen, ei nimeen. Samannimiset yritykset eivät siis sekoitu keskenään.

Kuinka nopeasti hälytys tulee?

Suomen tiedot päivittyvät joka arkipäivä. Hälytys lähtee, kun muutos on ensimmäisen kerran näkyvissä rekisteritiedoissa.

Löytyykö ilmoituksia ulkomaisista asiakkaista?

Konkurssi- ja maksukyvyttömyysilmoituksia on kahdestatoista markkinasta: Ranska, Saksa, Britannia, Itävalta, Sveitsi, Norja, Suomi, Yhdysvallat, Alankomaat, Tanska, Kroatia ja Ruotsi. Ilmoitukset koskevat vain oikeushenkilöitä. Saksan, Itävallan ja Alankomaiden osalta on ilmoituksia mutta ei yritystietoja.

Kuinka usein kokonaishaku kannattaa ajaa?

Suomen tiedot päivittyvät joka arkipäivä, joten päivittäinen ajo riittää. Tiheämpi kysely ei tuo uutta tietoa. Jos haluat tiedon yksittäisestä asiakkaasta heti kun se on rekisterissä, käytä POST /monitor -hälytystä.

Voiko ilmoituksen perusteella päättää luottorajasta?

Ilmoitus on yksi syöte päätökseen. Se kertoo, että asiasta on merkintä, ei sitä, miten asiakkaasi lopulta selviää. Yhdistä se laskujen maksukäyttäytymiseen ja omaan riskipolitiikkaasi.

Entä jos rekisterissä ei ole ilmoitusta mutta yritys on purettu?

Silloin tilan muutos näkyy kentissä status ja local_status, ja POST /monitor ilmoittaa siitä webhookilla.

Konkurssivalvonta asiakkaille ja toimittajille

Asiakkaan konkurssi tulee kalliiksi, kun siitä kuulee liian myöhään. Konkurssi- ja maksukyvyttömyysilmoitukset on linkitetty Y-tunnukseen, ja rekisterimuutokset tulevat webhookina.

Ongelma: tieto saapuu myöhässä

Kun asiakas asetetaan konkurssiin, saamiset on ilmoitettava konkurssipesän pesänhoitajalle, ja jokainen päivä, jona toimitat edelleen luotolla, kasvattaa tappiota. Toimittajan puolella ongelma on päinvastainen: kriittisen alihankkijan konkurssi katkaisee toimitusketjun yllättäen. Molemmissa tapauksissa merkintä on julkinen, mutta kukaan ei lue ilmoituksia joka päivä, ja nimen perusteella etsiminen on epävarmaa, koska samannimisiä yrityksiä on useita.

Rajapinta ratkaisee kaksi asiaa: ilmoitukset on sidottu Y-tunnukseen, ei nimeen, ja muutokset tulevat luoksesi sen sijaan, että joku joutuisi hakemaan niitä.

Näin se toimii

# Konkurssi- ja maksukyvyttömyysilmoitukset koko Suomesta
curl 'https://api.prometiam.com/functions/v1/risk-api/insolvency/search?country=FI' \
  -H 'Authorization: Bearer rk_live_...'

# Yksittäinen asiakas: profiili ja ilmoitukset yhdessä
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/{id}?include=insolvency' \
  -H 'Authorization: Bearer rk_live_...'

# Tilaa hälytykset asiakkaasta
curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/monitor' \
  -H 'Authorization: Bearer rk_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"company_id": 123, "country": "FI"}'

Aloita hakemalla asiakkaan id kutsulla GET /companies/search?country=FI&company_number=... ja anna se POST /monitor -kutsulle. Korvaa esimerkin 123 oikealla id-arvolla. Webhook-hälytys lähtee, kun yhtiön tila muuttuu, yritys puretaan, pakotelistaosuma (beta) tulee vastaan tai rekisterissä tapahtuu muutos. Webhook-hälytykset kuuluvat Professional-pakettiin.

Mitä saat

Konkurssi- ja maksukyvyttömyysilmoitukset, joiden haun voi rajata maahan (country=FI) ja yksittäiseen yritykseen. Ilmoitukset on linkitetty Y-tunnukseen.
Yhtiön tila rekisterissä (status, local_status), jotta purkautuminen näkyy myös ilman ilmoitusta.
Rekisterimuutokset tapahtumina (GET /company-events/search): nimi, tila, yhtiömuoto, rekisteröity osoite. Tapahtuma ajoitetaan sen mukaan, milloin muutos ensimmäisen kerran näkyy rekisteritiedoissa, aikaisintaan 30.9.2026 alkaen.
Verotiedot (tax_records) vuodesta 2020, jos haluat verrata veroasemaa muutoksiin.

Rajaukset

Vain oikeushenkilöiden ilmoitukset, ei yksityishenkilöiden.
Suomesta saa yritystason tiedot, ei toimitusjohtajia eikä hallitusta.
Hälytys perustuu rekisteriin ilmestyneeseen tietoon, eikä se ole oikeudellinen neuvo tai luottoluokitus.

Näin valvonnan voi rakentaa

Käytännössä valvonta rakentuu kahdesta kerroksesta. Ensimmäinen on seurantalista: kun asiakas tai toimittaja otetaan mukaan, hae sen id Y-tunnuksella, tallenna se omaan järjestelmääsi ja tilaa POST /monitor. Toinen on säännöllinen kokonaishaku: aja GET /insolvency/search?country=FI esimerkiksi kerran päivässä ja vertaa tulosta siihen, mitä olet jo käsitellyt, jotta myös seurantaan lisäämättömät yritykset huomataan.

Kun hälytys tulee, älä pysähdy hälytykseen. Avaa profiili kutsulla GET /companies/{id}?include=insolvency, tarkista status ja local_status sekä ilmoituksen päivämäärä ja kirjaa tulos asiakasriskin yhteyteen. Päätökset, kuten luottorajan lasku, ennakkomaksuvaatimus tai saamisen ilmoittaminen pesänhoitajalle, kuuluvat edelleen omaan prosessiisi ja talousosastollesi.

Vertaa myös hälytyksiä tapahtumiin: nimen, yhtiömuodon tai osoitteen muutos voi liittyä yritysjärjestelyyn tai maksuvaikeuksiin, mutta se ei yksin ole riskimerkki. Käsittele sellainen merkintä tarkistuspyyntönä, ei johtopäätöksenä.

Lähde: Contains data from the Finnish Patent and Registration Office (PRH), CC BY 4.0.

Sopiva paketti

Haut ja include=insolvency toimivat Starter-paketilla (9,99 €/kk). Webhook-hälytykset, joilla ei tarvitse pollata, kuuluvat Professional-pakettiin (29,99 €/kk). Katso hinnoittelu.

Aiheeseen liittyvät sivut

Aloita 14 päivän ilmainen kokeilu · API-dokumentaatio

Kokeilu kestää 14 päivää ja sisältää 500 krediittiä. Kortti vaaditaan, kokeilun aikana ei veloiteta mitään; sen jälkeen jatkuu Starter-paketti (9,99 € kuukaudessa), ellet peru.

Frequently asked questions

Mistä tiedän, että konkurssi liittyy juuri oikeaan yritykseen?: Ilmoitukset on linkitetty Y-tunnukseen, ei nimeen. Samannimiset yritykset eivät siis sekoitu keskenään.
Kuinka nopeasti hälytys tulee?: Suomen tiedot päivittyvät joka arkipäivä. Hälytys lähtee, kun muutos on ensimmäisen kerran näkyvissä rekisteritiedoissa.
Löytyykö ilmoituksia ulkomaisista asiakkaista?: Konkurssi- ja maksukyvyttömyysilmoituksia on kahdestatoista markkinasta: Ranska, Saksa, Britannia, Itävalta, Sveitsi, Norja, Suomi, Yhdysvallat, Alankomaat, Tanska, Kroatia ja Ruotsi. Ilmoitukset koskevat vain oikeushenkilöitä. Saksan, Itävallan ja Alankomaiden osalta on ilmoituksia mutta ei yritystietoja.
Kuinka usein kokonaishaku kannattaa ajaa?: Suomen tiedot päivittyvät joka arkipäivä, joten päivittäinen ajo riittää. Tiheämpi kysely ei tuo uutta tietoa. Jos haluat tiedon yksittäisestä asiakkaasta heti kun se on rekisterissä, käytä POST /monitor -hälytystä.
Voiko ilmoituksen perusteella päättää luottorajasta?: Ilmoitus on yksi syöte päätökseen. Se kertoo, että asiasta on merkintä, ei sitä, miten asiakkaasi lopulta selviää. Yhdistä se laskujen maksukäyttäytymiseen ja omaan riskipolitiikkaasi.
Entä jos rekisterissä ei ole ilmoitusta mutta yritys on purettu?: Silloin tilan muutos näkyy kentissä status ja local_status, ja POST /monitor ilmoittaa siitä webhookilla.