Toimittajan taustaselvitys rajapinnalla

Alihankkijan Y-tunnuksesta saat kaupparekisterin tilan, konkurssimerkinnät, ALV-numeron ja verohallinnon julkiset yhteisöverotiedot. Toistettavasti ja tallennettavassa muodossa.

Ongelma: tilaajan on tarkistettava ennen sopimusta

Tilaajavastuulaki (laki tilaajan selvitysvelvollisuudesta ja vastuusta ulkopuolista työvoimaa käytettäessä, 1233/2006) velvoittaa tilaajan pyytämään sopimuspuolelta selvitykset ennen alihankinta- tai vuokratyösopimuksen tekemistä. Selvitykset koskevat muun muassa sitä, että yritys on merkitty kaupparekisteriin, ennakkoperintärekisteriin, työnantajarekisteriin ja arvonlisäverovelvollisten rekisteriin, sekä verovelkaa ja eläkevakuutusmaksujen suorittamista. Jos sopimus on voimassa yli 12 kuukautta, sopimuspuolen on toimitettava tietyt todistukset uudelleen 12 kuukauden välein. Selvitysvelvollisuuden laiminlyönnistä voi seurata laiminlyöntimaksu, joten selvitysten on oltava tallessa ja löydyttävä, kun työsuojeluviranomainen niitä pyytää. Tämä sivu ei ole oikeudellista neuvontaa.

Monissa hankintaorganisaatioissa tämä tehdään käsin tai ostamalla raportteja yksitellen. Rajapinta ei korvaa viranomaisten antamia todistuksia, mutta se kattaa ne osat, jotka ovat avointa rekisteritietoa: onko yhtiö olemassa, missä tilassa se on, onko sille kirjattu konkurssi tai muu maksukyvyttömyysmerkintä, ja mitä Verohallinto on julkaissut sen yhteisöverosta.

Näin se toimii

import os, requests

API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}

def tarkista_toimittaja(y_tunnus: str):
    haku = requests.get(f'{API}/companies/search', headers=HEAD,
                        params={'country': 'FI', 'company_number': y_tunnus}).json()
    yritys = haku['data'][0]
    profiili = requests.get(f'{API}/companies/{yritys["id"]}', headers=HEAD,
                            params={'include': 'insolvency'}).json()['data']
    return {
        'nimi': profiili['company_name'],
        'tila': profiili['local_status'],
        'alv': profiili.get('vat_number'),
        'konkurssi': profiili.get('insolvency_notices'),
    }

print(tarkista_toimittaja('0112038-9'))

Kun toimittajan tila, nimi, yhtiömuoto tai osoite muuttuu, POST /monitor ilmoittaa siitä webhookilla, joten sopimuskauden aikainen seuranta ei vaadi jatkuvaa kyselyä.

Mitä saat

• Yhtiön tila: status ja rekisterin oma local_status, esimerkiksi onko yritys purettu tai asetettu selvitystilaan.
• Konkurssi- ja maksukyvyttömyysilmoitukset: include=insolvency liittää Y-tunnukseen sidotut ilmoitukset yrityksen profiiliin (insolvency_notices). Kaikkien ilmoitusten haku: GET /insolvency/search?country=FI. Vain oikeushenkilöt, ei yksityishenkilöitä.
• ALV-numero: vat_number, kun rekisteri vahvistaa ALV-rekisteröinnin; tarkistus VIES-rekisteristä GET /vat/{numero}.
• Tilinpäätökset (Scale): PRH:lle sähköisesti (XBRL) toimitetut tilinpäätökset ja listattujen konsernien ESEF-raportit osoitteesta GET /companies/{id}/financials. Sähköisesti tilinpäätöksensä toimittaa noin joka kahdeskymmenes yritys, ja ne ovat rekisterissä heinäkuusta 2023 alkaen; pieniltä toimittajilta tilinpäätöstä ei siis useinkaan löydy.
• Verotiedot jokaisesta suomalaisesta yrityksestä: tax_records sisältää verohallinnon julkiset yhteisöjen verotiedot verovuosittain vuodesta 2020 alkaen: verotettava tulo ja maksuunpannut verot. Arvo 0 tarkoittaa nollaa, ei tuntematonta. Lähde on CC BY 4.0 -lisenssillä.

Mitä rajapinta ei korvaa

• Tilaajavastuulain edellyttämät selvitykset ja todistukset, kuten todistus eläkevakuutusmaksujen suorittamisesta sekä rekisterikuulumista koskevat tiedot, hankitaan edelleen viranomaisilta tai toimittajalta. Rajapinta täydentää niitä, ei korvaa.
• Ei roolitietoja eikä rekisterin vaatimustenmukaisuussignaalia: Suomesta saa vain yritystason tiedot.
• Verotiedot ovat verohallinnon julkaisemia, ja ne tulevat vasta verovuoden päätyttyä ja verotuksen valmistuttua, joten ne eivät kerro kuluvasta vuodesta.

Käytännön työnkulku

Ennen sopimusta: hae toimittaja Y-tunnuksella ja tallenna profiili, konkurssimerkinnät ja ALV-numero hankintakansioon päivämäärän kanssa. Pyydä toimittajalta tai viranomaiselta ne selvitykset, joita rajapinta ei kata. Jos toimittajan nimi, yhtiömuoto tai tila poikkeaa sopimusluonnoksesta, selvitä ero ennen allekirjoitusta.

Sopimuskaudella: tilaa POST /monitor jokaisesta kriittisestä toimittajasta ja kirjaa saamasi hälytykset samaan kansioon. Kun määräaikaiset todistukset uusitaan, aja haku uudelleen ja vertaa tulosta edelliseen tallenteeseen. Näin hankintakansiosta näkyy, milloin ja mitä on tarkistettu.

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

Sopiva paketti

Starter (9,99 €/kk) kattaa rekisteri-, konkurssi- ja verotiedot. Seuranta webhookeilla kuuluu Professional-pakettiin (29,99 €/kk). Tilinpäätöstiedot vaativat Scale-paketin (99,99 €/kk); muissa paketeissa ja kokeilussa tilinpäätöshakuja on 10 kuukaudessa. Katso hinnoittelu.

Aiheeseen liittyvät sivut

• Etusivu: yritystiedot rajapinnasta
• KYB-tunnistaminen
• Konkurssivalvonta
• Y-tunnus-haku
• Mikä on kaupparekisteri?
• Toimittajan huolellisuusselvitys (EN)

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.