{ "service": { "id": "porolihantuotannon-yksikkokustannus", "metadataVersion": "1.0", "name": { "fi": "Porolihantuotannon yksikkökustannus", "sv": "Kostnaden för den renar ekonomin", "en": "Unit cost of the reindeer husbandry" }, "metadataFramework": { "name": "EconomyDoctors Semantic Discovery Framework", "author": "Jussi Iltanen", "organization": "Luke", "year": 2026 }, "description": { "fi": "Reaaliaikainen tilastotaulukkopalvelu AI-agenteille", "sv": "Statistisk tabelltjänst i realtid för AI-agenter", "en": "Real-time statistical table service for AI agents" }, "dataPolicy": { "realizedDataOnly": true, "fi": "Rajapinta julkaisee vain toteutuneita, lopullisia kirjanpitotuloksia. Ennakkotietoja (ennakko) ja ennusteita (E) ei julkaista rajapinnassa.", "en": "This interface publishes only realized, final accounting results by accounting period. Preliminary data and forecasts (E) are never published here.", "agentInstructions": [ "Viimeisin rajapinnassa oleva tilikausi on viimeisin toteutunut tilikausi, ei ennakkotieto.", "Älä esitä rajapinnan tietojen perusteella laskettuja trendejä tai ekstrapolaatioita Luken lukuina.", "Jos käyttäjä pyytää ennusteita, kerro, ettei rajapinta sisällä niitä. Ohjaa käyttäjä Taloustohtorin aikasarjasivuille, joilla ennusteita julkaistaan valikoiduille suureille.", "Jos yhdistät rajapinnan tietoja aikasarjasivujen ennusteisiin, merkitse ennusteosuus selvästi ja kerro kummankin lähde." ] }, "queryModel": "dimension-based", "generated": "2026-11-09T12:45:27Z" }, "endpoints": { "query": { "url": { "fi": "https://taloustohtori.luke.fi/porolihantuotannon-yksikkokustannus/omat-valinnat/", "sv": "https://taloustohtori.luke.fi/sv/kostnaden-for-den-renar-ekonomin/egna-val/", "en": "https://taloustohtori.luke.fi/en/unit-cost-of-the-reindeer-husbandry/own-criteria/" }, "methods": [ "GET" ] } }, "queryStructure": { "type": "flexible-dimension-order", "languageSelection": { "type": "endpoint-based", "supportedLanguages": [ "fi", "sv", "en" ] }, "unusedDimensionValue": 0, "dimensionParameters": [ { "main": "dim1paataso", "mainType": "integer", "sub": "dim1alataso", "subType": "string" }, { "main": "dim2paataso", "mainType": "integer", "sub": "dim2alataso", "subType": "string" }, { "main": "dim3paataso", "mainType": "integer", "sub": "dim3alataso", "subType": "string" }, { "main": "dim4paataso", "mainType": "integer", "sub": "dim4alataso", "subType": "string" } ], "parameterMapping": { "main": "dimensions[].id", "sub": "dimensions[].values[].id", "description": { "fi": "dimNpaataso saa arvokseen dimension id:n ja dimNalataso yhden tai useamman saman dimension arvo-id:n pilkuilla eroteltuna. Käyttämättömissä paikoissa molemmat ovat 0.", "sv": "dimNpaataso är dimensions-ID:t och dimNalataso är ett eller flera värde-ID:n av samma dimension, separerade med kommatecken. I oanvända positioner är båda 0.", "en": "dimNpaataso takes a dimension id and dimNalataso one or more value ids of that same dimension, comma-separated. Unused slots set both to 0." } }, "maxDimensionsPerQuery": 4, "allSlotsRequired": true, "rules": { "fi": [ "Dimensioiden järjestys on joustava", "Mikä tahansa dimensio voi esiintyä missä tahansa kyselypositiossa", "AI-agenttien tulee kartoittaa dimensio-ID:t dynaamisesti" ], "sv": [ "Dimensionernas ordning är flexibel", "Vilken dimension som helst kan förekomma i vilken frågeposition som helst", "AI-agenter ska mappa dimensions-ID dynamiskt" ], "en": [ "Dimension order is flexible", "Any dimension may appear in any query position", "AI agents should map dimension IDs dynamically" ] } }, "dimensionValueEncoding": { "type": "comma-separated-string", "description": { "fi": "dimNalataso sisältää yhden tai useamman pilkuilla erotetun arvo-ID:n", "sv": "dimNalataso innehåller ett eller flera värde-ID:n separerade med kommatecken", "en": "dimNalataso contains one or more value IDs separated by commas" }, "examples": [ "25", "1,2", "1,2,3,4" ] }, "queryRules": { "requiredDimensions": [ { "dimensionId": 1, "name": { "fi": "Tilikausi", "sv": "Räkenskapsår", "en": "Accounting period" } } ], "combinationRules": [ { "family": "region", "dimensions": [18, 32, 33, 34], "combinable": true, "resolution": "paliskunta", "description": { "fi": "Aluedimensioita voi yhdistää samaan kyselyyn. Tulos muodostetaan paliskuntien perusteella, joten taulukkoon tulevat vain ne aluevalintojen yhdistelmät, joihin kuuluu paliskuntia. Yhdistelmät, joita ei ole olemassa, jäävät pois ilman virhettä. Jos mikään valittu yhdistelmä ei ole olemassa, tulos on tyhjä.", "sv": "Regionala dimensioner kan kombineras i samma sökning. Resultaten genereras utifrån renbeteslag (paliskunta); tabellen kommer därför endast att innehålla kombinationer av regionala val som omfattar renbeteslag. Kombinationer som inte existerar utelämnas utan felmeddelande. Om ingen av de valda kombinationerna existerar blir resultatet tomt.", "en": "Regional dimensions may be combined in one query. Results are resolved through reindeer herding cooperatives (paliskunta), so only existing combinations of regional selections appear in the table. Non-existent combinations are omitted without error. If no selected combination exists, the result is empty." }, "agentHint": { "fi": "Merkkipiirialueiden nimet kertovat, mitkä merkkipiirit niihin kuuluvat. Vältä yhdistelmiä, joita ei ole olemassa: ne eivät aiheuta virhettä, mutta ne kuluttavat sarakerajaa turhaan.", "sv": "Namnen på märkesdistriktsområdena anger vilka märkesdistrikt som ingår. Undvik kombinationer som inte existerar: de orsakar inget fel, men de förbrukar kolumngränsen i onödan.", "en": "Mark district area names list the mark districts they contain. Avoid non-existent combinations: they cause no error but consume the column limit unnecessarily." } } ], "rules": { "fi": [ "Raportti on valittava", "Tilikausidimensio on pakollinen", "Dimensioiden järjestys on joustava", "Dimensiovalinnat validoidaan palvelinpuolella" ], "sv": [ "En rapport måste väljas", "Räkenskapsårsdimensionen är obligatorisk.", "Dimensionernas ordning är flexibel", "Dimensionsval valideras på serversidan" ], "en": [ "A report must be selected", "The accounting period dimension is mandatory.", "Dimension order is flexible", "Dimension selections are validated server-side" ] } }, "response": { "contentType": "text/html", "primaryDataFormat": "html-table", "format": "html", "structure": "statistical-table", "resultLimits": { "maxColumns": 400, "enforcement": "server-side", "columnCalculation": { "formula": "number of existing value combinations × distributionFactor", "upperBound": "product(selectedValueCount per used dimension) × distributionFactor", "limitEnforcedOn": "upperBound", "distributionFactor": { "onlyAverages": 1, "withGroups": 3 }, "description": { "fi": "Sarakeraja tarkistetaan valintojen perusteella ennen hakua: valittujen arvojen lukumäärien tulo, hajontaryhmiä käytettäessä (lisa=2) kerrottuna kolmella. Valmiissa taulukossa sarakkeita voi olla vähemmän, koska vain olemassa olevat aluevalintojen yhdistelmät tulevat mukaan. Valitse vain tarpeelliset arvot, sillä myös ne valinnat, joihin ei osu paliskuntia, lasketaan rajaan.", "sv": "Kolumngränsen kontrolleras utifrån urvalet före sökningen: produkten av antalet valda värden, multiplicerad med tre när spridningsgrupper används (lisa=2). Den färdiga tabellen kan ha färre kolumner, eftersom endast befintliga kombinationer av regionala urval tas med. Välj endast nödvändiga värden, eftersom även urval som inte träffar något renbeteslag räknas mot gränsen.", "en": "The column limit is checked from the selection before the query runs: the product of selected value counts, multiplied by three when distribution groups are used (lisa=2). The resulting table may have fewer columns, since only existing combinations of regional selections are included. Select only the values you need, because selections that match no herding cooperative still count against the limit." }, "examples": [ { "selection": "5 accounting periods, only averages", "columns": 5 }, { "selection": "5 accounting periods, with groups", "columns": 15 }, { "selection": "1 period × merkkipiirialue 1 × merkkipiiri 1–14", "upperBound": 14, "columns": 2, "countsAgainstLimit": 14, "note": "only Utsjoki and Inari belong to area 1" }, { "selection": "21 periods × 14 merkkipiiri, with groups", "upperBound": 882, "valid": false } ] }, "onExceed": { "response": "html-notice", "tableGenerated": false, "detection": { "fi": "Valitsit liian suuren taulun (X saraketta). Taulun suurin koko on Y saraketta. Vähennä valintoja.", "sv": "Du valde en tabell som är för stor (X kolumner). Den maximala tabellstorleken är Y kolumner. Minska dina val.", "en": "You selected a table that is too large (X columns). The maximum table size is Y columns. Reduce your selections.", "placeholders": { "X": "column count calculated from the selection", "Y": "maximum column count (maxColumns)" } }, "fi": "Jos valintojen perusteella laskettu sarakemäärä ylittää 200, palvelin ei muodosta taulukkoa. Se palauttaa sivun, jossa kerrotaan rajan ylittyneen ja kehotetaan vähentämään valintoja. Pienennä valintaa tai jaa haku useaksi pienemmäksi kyselyksi, esimerkiksi tilikausittain tai alueittain, ja yhdistä tulokset itse.", "sv": "Om det antal kolumner som beräknas utifrån urvalet överstiger 200 skapar servern ingen tabell. Den returnerar i stället en sida som meddelar att gränsen har överskridits och uppmanar till färre val. Minska urvalet eller dela upp sökningen i flera mindre frågor, till exempel per räkenskapsår eller per område, och sammanställ resultaten själv.", "en": "If the column count calculated from the selection exceeds 200, the server does not generate a table. Instead it returns a page stating that the limit was exceeded and asking to reduce the selections. Reduce the selection or split the query into several smaller queries, for example by accounting period or by region, and combine the results yourself." } }, "description": { "fi": "HTML-sivu joka sisältää tilastotaulukon ja siihen liittyvät metatiedot", "sv": "HTML-sida som innehåller en statistisk tabell och tillhörande metadata", "en": "HTML page containing a statistical table and related metadata" } }, "queryParameters": { "tulostus": { "type": "integer", "semanticRole": "report-type", "required": true, "allowedValues": [{ "id": 1, "label": { "fi": "Kustannukset lihakiloa kohti", "sv": "Resultaträkning", "en": "Income statement"}, "description": "The report presents reindeer meat production returns and costs per kilogram of meat produced by accounting period. It provides a breakdown of monetary costs, imputed costs and individual cost items, including feed, supplies, vehicle use and fuel, payments to the reindeer herding cooperative, insurance, depreciation, the wage claim for own labour and the interest claim for own capital. The report also contains meat quantity, total reindeer economy return, production cost, and the numbers of represented and sampled holdings.", "tags": [ "reindeer meat unit cost","cost per kilogram of reindeer meat","costs per kilogram of meat","reindeer meat production cost","production cost per kilogram","return per kilogram of meat","monetary costs","imputed costs","cost structure","feed costs","fuel costs","vehicle costs","payments to reindeer herding cooperative","depreciation","wage claim for own labour","interest claim for own capital","meat quantity","production cost trend" ] }, { "id": 3, "label": { "fi": "Kustannukset eloporoa kohti", "sv": "Balansräkning", "en": "Balance sheet"}, "description": "Costs and returns of reindeer husbandry per live reindeer, including production costs, monetary and imputed costs, feed, supplies, vehicle and fuel costs, herding cooperative fees and purchased services, insurance, depreciation, own labour cost, interest on own capital, and total returns. The report shows the development of costs and returns per live reindeer across accounting periods.", "tags": [ "reindeer husbandry","live reindeer","cost per live reindeer","costs per reindeer","reindeer production costs","production cost per live reindeer","return per live reindeer","total return","monetary costs","imputed costs","cost structure","feed costs","roughage","other feed","supplies","vehicle costs","fuel costs","enclosure and calving costs","reindeer herding cooperative fees","purchased services","insurance costs","financing costs","depreciation","own labour cost","interest on own capital","number of live reindeer","cost development","production cost trend","accounting period" ] }] }, "distribution": { "semanticRole": "result-grouping", "description": { "fi": "Hajontavalinta määrittää tuloksiin muodostettavat vertailuryhmät. Kun valitaan muu kuin vain keskiarvot, luokittelijanro määrittää muuttujan, jonka perusteella havaintoyksiköt jaetaan vertailuryhmiin. Luokittelija ei rajaa raportoitavia tunnuslukuja, vaan määrittää ryhmät, joille valitun raportin tulokset esitetään. Hajontaryhmien käyttö tuottaa jokaiselle valinnalle kolme tulossaraketta keskiarvon yhden sarakkeen sijasta, joten tulostaulukko voi kasvaa huomattavasti leveämmäksi.", "sv": "Spridningsvalet bestämmer vilka jämförelsegrupper som bildas i resultaten. När något annat än endast medelvärden väljs anger luokittelijanro den variabel som används för att dela in observationsenheterna i jämförelsegrupper. Klassificeraren begränsar inte vilka nyckeltal som rapporteras, utan bestämmer de grupper för vilka resultaten i den valda rapporten visas. Användning av spridningsgrupper ger tre resultatkolumner för varje val i stället för en kolumn för medelvärdet, vilket kan göra resultattabellen betydligt bredare.", "en": "The distribution selection determines the comparison groups included in the results. When an option other than averages only is selected, luokittelijanro specifies the variable used to divide observation units into comparison groups. The classifier does not restrict the reported indicators; it determines the groups for which the selected report results are presented. Using distribution groups produces three result columns for each selection instead of the single average column, so the resulting table can become considerably wider." }, "classifier": { "parameter": "luokittelijanro", "requiredWhen": "distribution other than averages only", "allowedValues": [ { "id": 2, "label": { "fi": "Kannattavuuskerroin", "sv": "Lönsamhetskoefficient", "en": "Profitability Ratio" } }, { "id": 3, "label": { "fi": "Yrittäjätulo", "sv": "Lantbruksinkomst", "en": "Entrepreneur's income" } }, { "id": 4, "label": { "fi": "Kokonaistuotto", "sv": "Bruttointäkter", "en": "Gross Return" } }, { "id": 5, "label": { "fi": "Eloporomäärä", "sv": "Antal livrenar", "en": "Number of live reindeer" } } ] }, "allowedCombinations": [ { "label": { "fi": "Vain keskiarvot", "sv": "Bara medelvärden", "en": "Only averages" }, "note": { "fi": "Tuloksissa esitetään vain keskiarvot. Luokittelijaa ei käytetä.", "sv": "Resultaten visar endast medelvärden. Ingen klassificerare används.", "en": "Only average values are presented. No classifier is used." }, "lisa": 1, "ptyyppi": 1, "hhtark": "4,6,8", "classifierRequired": false } ] }, "nayta": { "type": "string", "required": true, "allowedValues": [ "laheta" ] } }, "dimensions": [ { "id": 1, "name": { "fi": "Tilikausi", "sv": "Räkenskapsår", "en": "Accounting period" }, "note": { "fi": "Tiedot esitetään tilikausittain. Tilikausi merkitään muodossa VVVV/VVVV, esimerkiksi 2022/2023. Merkintä tarkoittaa yhtä tilikautta, ei kahta erillistä kalenterivuotta. Mukana ovat vain toteutuneet tilikaudet; ennakko- ja ennustetietoja ei ole.", "sv": "Uppgifterna redovisas per räkenskapsår. Räkenskapsåret anges i formatet ÅÅÅÅ/ÅÅÅÅ, till exempel 2022/2023. Beteckningen avser ett räkenskapsår, inte två separata kalenderår. Endast realiserade räkenskapsår ingår; preliminära uppgifter och prognoser ingår inte.", "en": "Data is reported by accounting period. Accounting periods are expressed in YYYY/YYYY format, for example 2022/2023. The notation represents one accounting period, not two separate calendar years. Only realized accounting periods are included; preliminary data and forecasts are not included." }, "values": [{ "id": 25, "label": "2022/2023" },{ "id": 24, "label": "2021/2022" },{ "id": 23, "label": "2020/2021" },{ "id": 22, "label": "2019/2020" },{ "id": 21, "label": "2018/2019" },{ "id": 20, "label": "2017/2018" },{ "id": 19, "label": "2016/2017" },{ "id": 18, "label": "2015/2016" },{ "id": 17, "label": "2014/2015" },{ "id": 16, "label": "2013/2014" },{ "id": 15, "label": "2012/2013" },{ "id": 14, "label": "2011/2012" },{ "id": 13, "label": "2010/2011" },{ "id": 12, "label": "2009/2010" },{ "id": 11, "label": "2008/2009" },{ "id": 10, "label": "2007/2008" },{ "id": 9, "label": "2006/2007" },{ "id": 8, "label": "2005/2006" },{ "id": 7, "label": "2004/2005" },{ "id": 6, "label": "2003/2004" }] }, { "id": 18, "name": { "fi": "Poronhoitoalue, 2-jako", "sv": "Renskötselområde", "en": "Reindeer husbandry area" }, "values": [{ "id": 1, "label": "Reindeer husbandry area" },{ "id": 2, "label": "Other reindeer husbandry area" }] }, { "id": 32, "name": { "fi": "Poronhoitoalue, 3-jako", "sv": "Sameområde", "en": "Samiarea" }, "values": [{ "id": 1, "label": "Samiarea" },{ "id": 2, "label": "Ohter northern area" },{ "id": 3, "label": "Other reindeer husbandry area" }] }, { "id": 33, "name": { "fi": "Merkkipiiri", "sv": "Märkesdistrikt", "en": "Merkkipiiri" }, "values": [{ "id": 1, "label": "Utsjoki" },{ "id": 2, "label": "Inari" },{ "id": 3, "label": "Enontekiö" },{ "id": 4, "label": "Pallastunturi" },{ "id": 5, "label": "Kittilä" },{ "id": 6, "label": "Sodankylä" },{ "id": 7, "label": "Keminkylä" },{ "id": 8, "label": "Salla" },{ "id": 9, "label": "Raudanjoki" },{ "id": 10, "label": "Läntinen" },{ "id": 11, "label": "Itäkemijoki" },{ "id": 12, "label": "Kuusamo" },{ "id": 13, "label": "Pudasjärvi" },{ "id": 14, "label": "Kainuu" }] }, { "id": 34, "name": { "fi": "Merkkipiirialue", "sv": "Märkekretsområde", "en": "Markdistrict" }, "values": [{ "id": 1, "label": "Markdistrict Utsjoki-inari" },{ "id": 2, "label": "Markdistrict Enontekiö-Pallastunturi-Kittilä" },{ "id": 3, "label": "Markdistrict Raudanjoki-Läntinen-Itäkemijoki" },{ "id": 4, "label": "Markdistrict Sodankylä-Keminkylä-Salla" },{ "id": 5, "label": "Markdistrict Kuusamo-Pudasjärvi-Kainuu" }] }, { "id": 35, "name": { "fi": "Eloporomäärä", "sv": "Antal livrenar", "en": "Number of live reindeer" }, "values": [{ "id": 4, "label": "80-100 (rather small)" },{ "id": 5, "label": "100-130 (average)" },{ "id": 6, "label": "130-180 (rather large)" },{ "id": 7, "label": "180-230 (large)" },{ "id": 8, "label": ">230 (very large)" }] } ], "examples": [ { "description": { "fi": "Paljonko poronhoitajien ajoneuvojen polttoainekustannukset olivat tilikaudella 2021/2022?", "sv": "Hur stora var bränslekostnaderna för renskötarnas fordon under räkenskapsåret 2021/2022?", "en": "What were the fuel costs for reindeer herders' vehicles during the 2021/2022 financial year?" }, "request": { "method": "GET", "url": { "fi": "https://taloustohtori.luke.fi/porolihantuotannon-yksikkokustannus/omat-valinnat/?tulostus=1&nayta=laheta&dim1paataso=1&dim1alataso=24&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=1&ptyyppi=1&hhtark=4,6,8", "sv": "https://taloustohtori.luke.fi/sv/kostnaden-for-den-renar-ekonomin/egna-val/?tulostus=1&nayta=laheta&dim1paataso=1&dim1alataso=24&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=1&ptyyppi=1&hhtark=4,6,8", "en": "https://taloustohtori.luke.fi/en/unit-cost-of-the-reindeer-husbandry/own-criteria/?tulostus=1&nayta=laheta&dim1paataso=1&dim1alataso=24&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=1&ptyyppi=1&hhtark=4,6,8" } } } ], "dimensionCoverage": { "fi": "Tämä metadata voi sisältää vain osajoukon palvelun käytettävissä olevista dimensioista.", "sv": "Denna metadata kan innehålla endast en delmängd av tillgängliga dimensioner.", "en": "This metadata may contain only a subset of the dimensions available in the service." }, "agentGuidance": { "fi": [ "Käytä vain dokumentoituja parametreja", "GET on suositeltava indeksointiin", "Tulokset generoidaan reaaliajassa", "Dimensioiden arvot voivat muuttua automaattisesti Oracle-tietokannan mukaan", "AI-agentit voivat muodostaa omia aikasarjojaan valitsemalla yhden tai useamman tilikauden.", "Taulukon leveys kasvaa valittujen dimensioarvojen yhdistelmien mukaan. AI-agenttien tulee välttää tarpeettoman laajoja valintajoukkoja.", "Alueelliset luokitukset perustuvat paliskuntiin.", "Poronhoitoalueet ja muut aluejaot muodostuvat paliskunnista.", "Aluedimensioiden yhdistämisestä ks. queryRules.combinationRules ja sarakerajan laskennasta response.resultLimits." ], "sv": [ "Använd endast dokumenterade parametrar", "GET rekommenderas för indexering", "Resultaten genereras i realtid", "Dimensionsvärden kan ändras automatiskt baserat på Oracle-databasen.", "AI-agenter kan skapa egna tidsserier genom att välja ett eller flera räkenskapsår.", "Antalet kolumner ökar enligt kombinationerna av valda dimensionsvärden. AI-agenter bör undvika onödigt omfattande urval.", "Regionala klassificeringar baseras på renbeteslag (paliskunta).", "Renskötselområden och andra regionala indelningar bildas av renbeteslag.", "För kombination av regionala dimensioner, se queryRules.combinationRules, och för beräkning av kolumngränsen, se response.resultLimits." ], "en": [ "Use only documented parameters", "GET is recommended for indexing", "Results are generated in real time", "Dimension values may change automatically according to the Oracle database", "AI agents may construct custom time series by selecting one or more accounting periods.", "Table width increases according to the combinations of selected dimension values. AI agents should avoid unnecessarily large selections.", "Regional classifications are based on reindeer herding cooperatives (paliskunta).", "Reindeer husbandry areas and other regional classifications are formed from reindeer herding cooperatives.", "For combining regional dimensions see queryRules.combinationRules, and for the column limit calculation see response.resultLimits." ] } }