Klimat v2.0 | Dokumentation

Allmän information

Denna endpoint används för att hämta klimatdata kopplat till byggprodukter. Det innehåller information hämtad från EPD:er (miljövarudeklarationer), beräkningar på dessa, samt kompletterande värden baserat på Boverkets klimatdatabas. API:t möjliggör både exakt klimatdata när EPD finns tillgänglig, och schablondata vid behov.

Tidsbaserad hämtning

Om inga tidsparametrar anges, beaktas endast datumet
Alla datum är inkluderande, både from och to.
Om även tid används ska den anges i UTC (t.ex. 2023-07-05T12:17:30.974Z)
Om endast from anges, antas to vara den nuvarande tiden.

finfoSupplierId utan kompletterande variabel
changed-from-date

Övriga noteringar

supplierArticleId kräver att finfoSupplierId också anges.

Om variabeln changed-from-date används kommer svaret filtreras på mottagarens specifika leverantörer.

Om andra variabler används kan svaret innehålla artiklar som inte tillhör mottagarens specifika leverantörer, matchning mot finfoArticleId kan då krävas.

Avvikelser mot v1.0/climate

Värdena för GWP-GHG som extraherats ur EPD hetter tidigare epdA1…epdA5 och har nu ersatts av extractedFromEpd.epdDataGwpGhgA.epdGwpGhgA1…extractedFromEpd.epdDataGwpGhgA.epdGwpGhgA5

Format på svar API-svar

JSON

{
  "pagination": {
    "offset": 0,
    "limit": 0,
    "totalCount": 0
  },
  "articleList": [
    {
      "epdMetaData": {},
      "extractedFromEpd": {},
      "calculatedFromEpd": {},
      "boverketData": {}
    }
  ]
}

1. pagination

Används för att hantera paginering av resultat.

offset: Startindex för resultaten.
limit: Antal artiklar per anrop.
totalCount: Totalt antal träffar i databasen.

2. articleList

En lista med artiklar som innehåller klimatdata. Varje artikel innehåller:

2.1 epdMetaData

Metadata från EPD (miljövarudeklaration).

finfoNumber: Internt artikelnummer i Finfo.
identifiers: Identifierare
- finfoSupplierId: Finfos leverantörs-ID
- supplierArticleId: Leverantörens artikelnummer
- gtin: Artikelns GTIN (Global Trade Item Number)
epdAssetLink: URL till själva EPD-dokumentet (PDF).
epdLastModified: Datum då EPD senast uppdaterades.
epdOwner: Organisation som äger EPD:n (ofta tillverkaren).
epdValidTo: Giltighetstidens slutdatum för EPD:n.
epdModel: Produktmodell (om tillgänglig).
epdProductName: Produktnamn enligt EPD.
epdPublisher: Publicerande EPD-program (t.ex. The International EPD System).
epdId: Unikt ID för EPD:n.
epdStandard: Standard enligt vilken EPD är framtagen (t.ex. EN 15804:2012+A2:2019).
epdFunctionalUnit: Funktionell enhet, t.ex. "1 m2".
epdFunctionalUnitWeight: Vikt per funktionell enhet (t.ex. kg/m2).
epdComment: Kommentarer från EPD:n.
externalDatasetId: Externt ID i annan databas.
externalDatasetUrl: Länk till extern källa (ex. EPD International).

2.2 extractedFromEpd

Rådata direkt extraherad från EPD.

epdDataGwpGhg[A–D]: Totala GWP-värden per modul A–D (Global Warming Potential, alla växthusgaser).
epdDataGwp[A–D]: Detaljerad uppdelning av GWP per modul.
- Kan inkludera t.ex. GWP-fossil, GWP-biogen, GWP-luluc.
- Enligt EN15804 A2-standard.

2.3 calculatedFromEpd

Omräkningar baserat på EPD-data.

byGtin.gtin: Vilket GTIN som beräkningarna gäller.
epdCalculation[A–D]: Beräkningar av utsläpp per livscykelmodul (A–D), omräknat till olika enheter:
- Ex: kg CO2e per kg, per m2, per liter eller per förpackning.
- Kan inkludera beräkningar från moduler A1–A3, A4, A5.

2.4 boverketData

Klimatdata baserad på Boverkets klimatdatabas (schablonvärden).

boverketResourceId: ID för resurs i Boverkets databas.
boverketDataA: Rådata per modul (vanligen A1–A3, A4, A5) från schablon.
boverketCalculationA: Omräkning av schablondata till andra enheter (t.ex. kg CO2e per m2).

Viktig information

Om en sektion är tom skickas endast rubriken med.
Om en sektion finns med innehåller den alla fält, även de med null.
Det innebär att exempelvis en epdCalculationA1M2 kan ha värdet null även om sektionen visas.

Om EPD och klimatdata

EPD:er (Environmental Product Declarations) är tredjepartsverifierade dokument som redovisar en byggprodukts miljöpåverkan. De följer standarder som EN15804 och används för att möjliggöra klimatberäkningar. Boverket tillhandahåller en klimatdatabas med schablondata som används när EPD saknas.

Relevanta källor:

Boverket: https://www.boverket.se/sv/klimatdeklaration/
EPD International: https://www.environdec.com/
IVL Svenska Miljöinstitutet: https://www.ivl.se/

Exempel på ett API-svar