← Dokumentaatio · API-pikaopas

eForms-kenttäopas SDK 1.14

Tämä opas dokumentoi eForms BT-kentät (Business Terms), jotka Pauhu palauttaa TED-hankintahauissa. Kentät noudattavat EU:n täytäntöönpanoasetusta (EU) 2019/1780 ja eForms SDK 1.14 -versiota.

Sisällysluettelo

1. Hankinnan perustiedot

Jokaisen hankintailmoituksen ydintiedot.

BT-koodiNimiKuvausTyyppi
BT-21Hankinnan nimiHankintailmoituksen otsikkoTeksti
BT-22Sisäinen tunnisteHankintayksikön sisäinen viitenumeroTunniste
BT-23Hankinnan pääluonneTavarat / Palvelut / RakennusurakatKoodi
BT-24KuvausHankinnan kohteen kuvausTeksti
BT-26Suorituspaikka (NUTS)EU:n NUTS-aluekoodi (esim. FI1B1 = Helsinki-Uusimaa)Koodi
BT-25Suorituspaikka (muu)Vapaamuotoinen paikkakunta, jos NUTS ei sovelluTeksti

2. Arvot ja rahoitus

Hankinnan taloudelliset tiedot.

BT-koodiNimiKuvausTyyppi
BT-27Arvioitu arvoHankinnan ennakoitu kokonaisarvo (ilman ALV:a)Summa (EUR)
BT-271Sopimuksen arvoSopimuksen lopullinen arvoSumma (EUR)
BT-1118EnimmäisarvoPuitejärjestelyn enimmäisarvoSumma (EUR)
BT-722EU-rahoitusOnko hankinta EU-rahoitteinen (kyllä/ei)Indikaattori
BT-6110EU-rahoitusohjelmaEU-ohjelman tunniste (esim. Horizon Europe)Tunniste

3. Luokittelu (CPV)

Common Procurement Vocabulary -luokittelu. Pauhu tukee hakua CPV-koodilla.

BT-koodiNimiKuvausTyyppi
BT-262Pää-CPV-koodiHankinnan ensisijainen CPV-koodi (esim. 72000000 = IT-palvelut)Koodi
BT-263Lisä-CPV-kooditTäydentävät CPV-kooditKoodi (lista)

Yleisimmät CPV-koodit julkishallinnon ICT-hankinnoissa

CPV-koodiKuvaus
72000000IT-palvelut: konsultointi, ohjelmistokehitys, internet ja tuki
72212000Sovellusohjelmistojen ohjelmointipalvelut
72260000Ohjelmistoihin liittyvät palvelut
72300000Tietoliikennepalvelut
48000000Ohjelmistopaketit ja tietojärjestelmät
48800000Tietojärjestelmät ja palvelimet
72222300Tietotekniikkapalvelut

4. Osapuolet

Hankintaan osallistuvat organisaatiot.

BT-koodiNimiKuvausTyyppi
BT-500Hankintayksikön nimiHankinnan toteuttava organisaatioTeksti
BT-501Hankintayksikön tunnisteKansallinen tunniste (esim. Y-tunnus)Tunniste
BT-505VerkkosivustoHankintayksikön URLURI
BT-508Hankintayksikön maaISO 3166-1 alpha-2 -maakoodiKoodi
BT-510YhteyshenkilöHankinnan yhteystiedotTeksti
BT-720Tarjoajan nimiVoittaneen tarjoajan nimiTeksti
BT-721Tarjoajan maaVoittaneen tarjoajan maakoodiKoodi

5. Hankintamenettely

Hankintalain mukainen menettely.

BT-koodiNimiKuvausTyyppi
BT-105Menettelyn tyyppiAvoin / Rajoitettu / Neuvottelu / Kilpailullinen neuvottelu / InnovaatiokumppanuusKoodi
BT-106Nopeutettu menettelyKäytetäänkö nopeutettua menettelyä (kyllä/ei)Indikaattori
BT-109PuitejärjestelyOnko kyseessä puitejärjestely ja sen tyyppiKoodi
BT-111Dynaaminen hankintajärjestelmäDPS-tyyppi ja kattavuusKoodi
BT-300LisätiedotMenettelyn vapaamuotoiset lisätiedotTeksti

6. Määräajat

Hankinnan aikataulut.

BT-koodiNimiKuvausTyyppi
BT-131Tarjousten jättöaikaViimeinen päivä ja kellonaika tarjousten vastaanottamisellePäivämäärä
BT-1311Osallistumishakemusten määräaikaRajoitetussa menettelyssä: hakemuksen viimeinen jättöpäiväPäivämäärä
BT-36Sopimuksen kestoSopimuksen voimassaoloaika kuukausina tai päivämäärinäKesto
BT-132Tarjousten avauspäiväTarjousten avaamisen ajankohtaPäivämäärä

7. Sopimustiedot

Tulostiedot hankintapäätöksen jälkeen.

BT-koodiNimiKuvausTyyppi
BT-142Voittaneiden tarjousten lukumääräEri tarjoajilta vastaanotettujen tarjousten kokonaismääräLuku
BT-144Pk-yritystarjouksetPk-yrityksiltä vastaanotettujen tarjousten määräLuku
BT-145EU:n ulkopuoliset tarjouksetETA-alueen ulkopuolelta vastaanotettujen tarjousten määräLuku
BT-1451Voittaja pk-yritysOnko voittaja pk-yritys (kyllä/ei)Indikaattori
BT-150Sopimuksen päivämääräHankintasopimuksen allekirjoituspäiväPäivämäärä

8. API-esimerkkivastaus

Esimerkki TED-haun vastauksesta, jossa eForms-kentät:

curl "https://staging.pauhu.eu/eurlex/all?classification=ted&lang=fi&q=tekoälyjärjestelmä&limit=1"
{
  "results": [
    {
      "title": "Tekoälypohjaisen asiakaspalvelujärjestelmän hankinta",
      "noticeId": "2026/S 041-123456",
      "bt21_title": "Tekoälypohjaisen asiakaspalvelujärjestelmän hankinta",
      "bt23_mainNature": "services",
      "bt27_estimatedValue": 450000,
      "bt27_currency": "EUR",
      "bt262_mainCpv": "72212000",
      "bt26_nuts": "FI1B1",
      "bt500_buyerName": "Valtiokonttori",
      "bt501_buyerIdentifier": "0245358-8",
      "bt105_procedureType": "open",
      "bt131_deadline": "2026-04-30T14:00:00+03:00",
      "bt36_duration": "36 months",
      "bt722_euFunding": false,
      "sourceUrl": "https://ted.europa.eu/notice/123456-2026"
    }
  ],
  "total": 1,
  "lang": "fi"
}

Huomaa: Vastausobjektin kenttänimet käyttävät camelCase-muotoa BT-tunnisteen perusteella (esim. BT-27bt27_estimatedValue). Kaikki arvot palautetaan SDK 1.14:n mukaisina.

Lisätiedot

Pauhu® — Sovereign EU search. Kaikki TED-tiedot haetaan suoraan EU:n virallisista lähteistä.