Do czego służy API wskaźników emisji

Wskaźnik emisji przelicza działalność na emisje: kWh energii elektrycznej, litry oleju napędowego, przejechane mile lub noclegi w hotelu mnoży się przez wskaźnik w kg CO2e na jednostkę. API (interfejs programowania aplikacji) pozwala jednemu programowi pobrać ten wskaźnik od innego przez internet. Państwa oprogramowanie wysyła np. „electricity, UK, kWh, 2026” i otrzymuje wskaźnik, jego jednostkę, rok zestawu, z którego pochodzi, a po przesłaniu ilości – także kg CO2e.

Dla kogo: firmy programistyczne dodające dane o emisjach do produktów do wydatków, floty, energii, zamówień lub księgowości; zespoły wewnętrzne wbudowujące emisje we własne systemy; konsultanci i księgowi, którzy chcą za każdym razem mieć te same wartości we własnych arkuszach i narzędziach. Jeśli chodzi tylko o własny ślad węglowy, API nie jest potrzebne; zob. nasz poradnik obliczania śladu węglowego firmy.

Oficjalne zbiory danych

Wielka Brytania: współczynniki konwersji DESNZ

Brytyjskie rządowe współczynniki konwersji gazów cieplarnianych do raportowania przez firmy publikuje co roku w czerwcu Department for Energy Security and Net Zero. Zestaw z 2026 r. ukazał się 11 czerwca 2026 r. jako pełny arkusz kalkulacyjny dla użytkowników i płaski plik „wyłącznie do automatycznego przetwarzania”, wraz z raportem metodologicznym i raportem o głównych zmianach. Obejmują działalność z Zakresu 1, 2 i 3, a GOV.UK wskazuje je jako właściwe dla rządowych wytycznych dotyczących raportowania, w tym SECR. Według GOV.UK można ich używać do innych celów, „ale użytkownicy robią to na własne ryzyko”. Carbon Recycling posiada każdy zestaw od 2002 do 2026 r.; zobacz brytyjskie wskaźniki emisji od 2002 r. oraz co zmieniło się we wskaźnikach z 2026 r.

Podlegają licencji Open Government Licence v3.0. Nasz wpis o wykorzystaniu brytyjskich współczynników konwersji we własnym oprogramowaniu omawia punkt po punkcie, na co licencja pozwala.

Energia elektryczna poza Wielką Brytanią

Wskaźniki DESNZ dotyczą działalności w Wielkiej Brytanii. Dla lokalizacji w innych krajach Carbon Recycling stosuje wartości rządowe danego kraju, jeśli zostały opublikowane na sprawdzonej przez nas licencji – obecnie Australia, Kanada, Chiny, Francja, Niemcy, Nowa Zelandia i Singapur – a w pozostałych przypadkach roczne dane Ember o energii elektrycznej, niezależny zbiór danych udostępniany na licencji CC BY 4,0. Lokalizacje w USA korzystają z wartości eGRID agencji US EPA według regionów energetycznych, które jako dzieło rządu USA są w domenie publicznej. Wszystkie wymienia strona wskaźniki dla energii elektrycznej według krajów, a nasz wpis o oficjalnych zagranicznych wskaźnikach dla energii elektrycznej wyjaśnia przejście na wartości rządowe.

Dane, których nie można odsprzedawać

Nie każdy zbiór danych o emisjach można umieścić w płatnym produkcie. Carbon Intensity API NESO, które podaje bieżącą i prognozowaną intensywność emisji sieci w Wielkiej Brytanii, jest bezpłatne, ale jego warunki stanowią, że nie wolno „sprzedawać, dzierżawić ani sublicencjonować Carbon Intensity API ani dostępu do niego”. Pokazujemy je bezpłatnie w aplikacji i nigdy go nie sprzedajemy. Inne zbiory danych, na które natrafiliśmy, odrzuciliśmy ze względu na licencję lub koszt. Nasza strona źródeł danych wymienia każde wykorzystywane źródło, zakres jego licencji oraz źródła, z których nie korzystamy.

Praktyczna zasada: zanim udostępni się jakikolwiek zbiór danych przez API, należy sprawdzić w jego licencji trzy rzeczy: wykorzystanie komercyjne, redystrybucję samych danych liczbowych i wymagane oznaczenie źródła.

Własne rozwiązanie czy API?

Arkusz DESNZ jest bezpłatny, więc zbudowanie własnej tabeli wskaźników jest realną opcją. Wszystko zależy od tego, ilu wskaźników Państwo potrzebują, z ilu lat i kto będzie je aktualizował.

Budowa na podstawie arkuszaUżyj API
Najlepszy, gdyPotrzebują Państwo kilku wskaźników (np. energia elektryczna, gaz i mile samochodem) dla roku lub dwóchPotrzebują Państwo wielu rodzajów działalności, lat ubiegłych, innych krajów lub tych samych wartości w kilku produktach
Co roku w czerwcuPobierz nowy zestaw, zmapuj zmienione wiersze i identyfikatory, przetestuj, wdrożDostawca wczytuje nowy zestaw; Państwo decydują, kiedy go użyć
KorektyTrzeba je zauważyć. W lipcu 2026 DESNZ ponownie opublikował plik 2026, ponieważ niektóre puste wartości wyświetlano jako 0Dostawca powinien je zastosować i poinformować, co się zmieniło
Inne krajeSamodzielne wyszukanie, sprawdzenie licencji i załadowanie każdego źródłaZależy od dostawcy: proszę sprawdzić, czy podano źródło i licencję każdej wartości
KosztBezpłatne dane plus co roku czas Państwa programistówSubskrypcja

Budując własne rozwiązanie, proszę używać pliku płaskiego (flat file) do ładowania danych, a pełnego zestawu do czytania uwag: wskazówki w każdym arkuszu wyjaśniają, kiedy stosuje się dany wskaźnik, i właśnie tam powstaje najwięcej błędów.

Wersja według roku współczynników

W tym miejscu większość narzędzi tworzonych samodzielnie popełnia błędy. Wskaźniki zmieniają się co roku, a niektóre znacznie. W 2026 r. DESNZ zmienił też sposób obliczania wskaźnika dla energii elektrycznej, skracając opóźnienie względem rzeczywistej sieci z dwóch lat do jednego. 100 000 kWh energii elektrycznej z brytyjskiej sieci to 17 700 kg CO2e według wskaźnika z 2025 r. (0,177 kg na kWh) i 13 096 kg według wskaźnika z 2026 r. (0,13096 kg na kWh) – o 26% mniej przy takim samym zużyciu. Nasz wpis o tym, dlaczego ślady węglowe spadły w 2026 r., omawia znaczenie tej zmiany dla raportów.

  • Zawsze podawać rok. Należy wybrać zestaw wskaźników dla roku sprawozdawczego, w którym miała miejsce działalność, a nie „najnowszy”. Nasz poradnik o współczynnikach konwersji wyjaśnia, którego zestawu użyć dla roku obejmującego dwa lata kalendarzowe.
  • Zapisywać użyte dane. Przy każdej obliczonej pozycji należy zapisać wartość wskaźnika, jednostkę, identyfikator wskaźnika, rok zestawu i źródło. Raport z zeszłego roku musi dać się dokładnie odtworzyć, a audytor lub klient może o to zapytać.
  • Nigdy nie nadpisywać po cichu. Gdy pojawi się nowy zestaw lub korekta, poprzednie lata należy przeliczać tylko celowo, np. w celu aktualizacji roku bazowego, i odnotować ten fakt.

Uznanie autorstwa

Każda otwarta licencja wymieniona tutaj wymaga podania źródła w produkcie lub aplikacji. Sformułowanie, którego używamy, z naszego rejestru licencji danych:

  • Współczynniki konwersji DESNZ: „Contains public sector information licensed under the Open Government Licence v3.0. Source: DESNZ, Greenhouse gas reporting: conversion factors.”
  • Ember: „Contains data from Ember, licensed under CC BY 4,0 (ember-energy.org).”
  • US EPA: „Source: US EPA, eGRID and GHG Emission Factors Hub”. Nie jest to wymagane prawem, ale podajemy źródło.
  • NESO Carbon Intensity API (wyświetlane w naszej aplikacji, nie odsprzedawane): „Carbon intensity data from the National Energy System Operator's Carbon Intensity API (carbonintensity.org.uk), CC BY 4,0.”

Gdy wymienienie każdego źródła nie jest praktyczne, Open Government Licence pozwala podać link do strony, która zawiera je wszystkie – temu służy nasza strona źródeł danych. Niezależnie od wybranej drogi nie należy używać logo rządowych ani sugerować, że rząd lub wydawca danych popiera Państwa produkt.

Jak pomaga Carbon Recycling

W Carbon Recycling każde obliczenie samo dobiera zestaw wskaźników dla swojego roku sprawozdawczego i zapisuje użyty wskaźnik (z lat 2002–2026), a każde źródło jest wymienione na stronie źródeł danych. Jeśli potrzebują Państwo tylko wartości, każdy używany przez nas wskaźnik można bezpłatnie sprawdzić na naszych stronach ze wskaźnikami emisji, wraz ze źródłem i licencją.

Jeśli są Państwo księgowym lub doradcą wykorzystującym wskaźniki w pracy dla klientów, portal dla księgowych pozwala prowadzić raportowanie emisji klientów przy jednym logowaniu. Samą usługę omawia nasz poradnik raportowanie emisji dla księgowych.