재무 – 문서 | handelsregister.ai

기능
기능	반환 내용	크레딧
financial_kpi	재무 KPI: 회계연도마다 KPI 한 행	1
balance_sheet_accounts	재무상태표: 회계연도별 모든 항목을 트리로	3
profit_and_loss_account	손익계산서(독일어 GuV): 회계연도별 모든 항목을 트리로	3
annual_financial_statements	연간 재무제표(Markdown): AI 에이전트용으로 간결한 재무제표 전문	5
annual_financial_statements__html	연간 재무제표(HTML): 표가 HTML로 된 전문, 표시용	5

규칙

금액은 유로이며, 천 단위로 반올림하지 않은 전체 금액이에요. 매출 5억 3,820만 유로는 538151607.13으로 와요.
부호: 비용은 재무제표에 인쇄된 부호를 따라요. 어떤 재무제표는 양수로, 어떤 것은 음수로 표시해요. 그러니 비용은 부호를 빼고 비교하세요. 손실과 결손은 음수예요.
비율과 마진은 소수예요: 0.75는 75%예요. debt_to_equity와 interest_coverage 같은 배수는 몇 배인지를 나타내요.
회계연도: year는 회계연도가 끝나는 역년이에요. 따라서 2024-10-01부터 2025-09-30까지의 회계연도는 2025예요. 정확한 날짜는 _provenance.period_start와 period_end에 있어요.
순서: 각 기능은 회계연도마다 항목 하나씩, 최신순으로 된 목록을 반환해요. 재무제표가 없는 해는 두 해 사이에서 빠질 수 있어요.
null은 재무제표에 그 값이 없거나 거기서 도출할 수 없다는 뜻이에요. 예를 들어 소형 회사는 손익계산서를 공개하지 않으므로 revenue가 비어 있어요.

회사에 맞는 재무제표가 없으면 기능은 빈 목록 []으로 와요. 이 경우 크레딧을 과금하지 않아요.

개별 및 연결 재무제표

개별 재무제표(Jahresabschluss)는 회사 자체를, 연결 재무제표(Konzernabschluss)는 그룹 전체를 보여 줘요. 추가 입력이 없으면 각 기능이 스스로 골라요. 그래서 한 응답에 개별 수치와 그룹 수치가, 같은 해라도 기능에 따라 다르게 담길 수 있어요.

각 항목은 _provenance에 수치의 출처인 재무제표를 알려 줘요. 연도는 같은 statement_type 안에서만 비교하세요. 그렇지 않으면 회사를 그 그룹과 비교하게 돼요.

financial_statement_type=annual이면 개별 재무제표만, consolidated면 연결 재무제표만 받아요. financial_years는 응답을 최근 회계연도 1~30개로 제한해요. 두 파라미터 모두 다섯 기능 전부에 적용되며 가격은 바뀌지 않아요. 자세한 내용은 재무 KPI 분석에 있어요.

항목의 출처

재무 KPI, 재무상태표, 손익계산서의 각 항목에는 모든 플랜에서, 플랜이 없어도 _provenance가 있어요. 필드는 세 기능 모두 같아요. 재무 KPI에서 _provenance는 항상 행의 마지막 키예요.

필드
필드	의미	예시	제공 빈도
financial_kpi[]._provenanceobject	행의 수치가 나온 재무제표. 모든 플랜에서, 플랜이 없어도 모든 행에 있으며 항상 마지막 키예요.`financial_kpi`	–	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[]._provenance.statement_typestring\|null	등기부가 부르는 재무제표의 종류.값: `Jahresabschluss` 회사의 개별 재무제표, `Bilanz` 단독으로 공개된 재무상태표, `Konzernabschluss` 그룹의 수치, `null` 상장 회사의 시장 데이터	`"Jahresabschluss"`	위와 같음
financial_kpi[]._provenance.period_startstring\|null	재무제표에 인쇄된 회계연도의 첫날.비어 있는 경우: 재무제표에 시작일이 없음, 그리고 시장 데이터	`"2023-01-01"`	위와 같음
financial_kpi[]._provenance.period_endstring\|null	회계연도의 마지막 날, 즉 결산일. 설립이나 회계연도 변경 후처럼 회계연도가 12개월보다 짧거나 길 수 있어요.	`"2023-12-31"`	위와 같음
financial_kpi[]._provenance.exempt_subsidiaryboolean	회사가 자체 재무제표 대신 모회사의 연결 재무제표를 공개했다면 true. 이때 그 해의 모든 수치는 `parent_organization`의 그룹에 대한 것이에요.	`false`	위와 같음
financial_kpi[]._provenance.parent_organizationobject\|null	연결 재무제표를 공개한 회사, entity_id와 이름 포함. 이름으로 회사를 고유하게 식별할 수 없으면 entity_id는 null이에요.비어 있는 경우: exempt_subsidiary가 false	`null`	드묾

규모와 법적 형태

회사가 공개하는 내용은 법적 형태와 규모 등급에 따라 법이 정해요. 이에 따라 어떤 필드에 값이 있는지가 정해져요.

GmbH와 UG, AG, SE, KGaA, GmbH & Co. KG, eG는 재무제표를 공개해요. 자연인이 무한책임사원인 KG나 OHG는 매우 클 때만 공개해요. 개인 상인도 마찬가지예요. 파트너십 회사(PartG)는 재무제표를 공개하지 않아요. 그룹 자회사는 일정 조건에서 자체 재무제표 공개를 생략할 수 있어요. 이를 위해서는 모회사의 연결 재무제표에 포함되어야 해요(§ 264 (3) HGB).

규모 등급
규모 등급	공개 내용	받는 내용
초소형	약식 재무상태표	재무상태표와 거기서 나온 수치, 예: 총자산
소형	재무상태표와 주석, 손익계산서 없음	재무상태표와 거기서 나온 수치, 일부는 직원 수; 매출은 대개 없음
중형	재무상태표, 손익계산서, 주석, 경영 보고서; 손익계산서는 매출총이익부터 시작할 수 있음	재무상태표와 손익계산서; 손익계산서에 따로 표시되어 있으면 매출
대형	경영 보고서가 포함된 완전한 연간 재무제표	재무상태표, 손익계산서, KPI를 모두 상세하게

초소형 회사는 재무상태표를 기탁만 할 수도 있어요. 그러면 자유롭게 열람할 수 없어요. 규모 등급과 기한에 대한 자세한 내용은 데이터 제공 범위에 있어요.

회사는 회계연도 종료 후 12개월 안에 공개하면 되고, 많은 회사가 그 기간을 모두 써요. 그래서 최신 항목이 재작년이나 그 이전인 경우가 많아요.

아래 표의 제공 빈도 열은 이를 법적 형태별로 요약해요. “일부”는 회사의 규모 등급이 그 값을 공개하면 값이 온다는 뜻이에요.

기본 KPI

이 KPI는 플랜 여부와 관계없이 모든 계정에서 financial_kpi 기능(재무 KPI)으로 받아요.

필드
필드	의미	예시	제공 빈도
financial_kpiarray	재무 KPI: 회계연도마다 한 행, 최신순.비어 있는 경우: 회사가 분석할 수 있는 재무제표를 공개하지 않음`financial_kpi`	–	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].yearinteger	회계연도가 끝나는 역년.	`2023`	위와 같음
financial_kpi[].revenuenumber\|null	유로 단위 매출.비어 있는 경우: 재무제표에 손익계산서나 매출이 없음	`538151607.13`	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].net_incomenumber\|null	유로 단위 당기순이익 또는 순손실; 손실은 음수.	`164916783.06`	위와 같음
financial_kpi[].active_totalnumber\|null	유로 단위 총자산.	`397093655.67`	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].employeesnumber\|null	재무제표에 기재된 직원 수.비어 있는 경우: 재무제표에 직원 수가 담긴 주석이 없음, 예: 초소형 회사	`340`	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].material_expensesnumber\|null	유로 단위 재료비, 재무제표의 부호 그대로.	`116509640.56`	위와 같음
financial_kpi[].personnel_expensesnumber\|null	유로 단위 인건비, 재무제표의 부호 그대로.	`37557386.2`	위와 같음

예를 들어 Hetzner Online GmbH, Ansbach HRB 6089에 대한 예시 요청의 한 회계연도, 기본 KPI와 출처:

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'q=Hetzner Online GmbH' \
  --data-urlencode 'feature=financial_kpi' \
  --data-urlencode 'financial_years=1'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "q": "Hetzner Online GmbH",
        "feature": ["financial_kpi"],
        "financial_years": "1",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");
url.searchParams.append("feature", "financial_kpi");
url.searchParams.append("financial_years", "1");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

1{2  "financial_kpi": [3    {4      "year": 2023,5      "employees": 340,6      "active_total": 397093655.67,7      "revenue": 538151607.13,8      "material_expenses": 116509640.56,9      "personnel_expenses": 37557386.2,10      "net_income": 164916783.06,11      "_provenance": {12        "statement_type": "Jahresabschluss",13        "period_start": "2023-01-01",14        "period_end": "2023-12-31",15        "exempt_subsidiary": false,16        "parent_organization": null17      }18    }19  ]20}

예시 응답: Hetzner Online GmbH의 financial_kpi 발췌, 2023 회계연도

확장 KPI

Pro와 Max 플랜에서는 재무 KPI의 각 행에 90개 이상의 KPI가 더 담겨요. 같은 행에, 같은 가격으로 와요.

비율, 마진, ebitda나 net_debt_broad 같은 합계는 재무제표 항목으로 계산해요. 필요한 항목이 없으면 KPI는 null이에요.

규모와 직원당 값

필드
필드	의미	예시	제공 빈도
financial_kpi[].company_size_by_employeesstring\|null	직원 수 기준 규모 등급.값: `micro` 초소형, `small` 소형, `medium` 중형, `large` 대형`financial_kpi` · Pro부터	`"large"`	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].company_size_by_assetsstring\|null	총자산 기준 규모 등급.값: `micro` 초소형, `small` 소형, `medium` 중형, `large` 대형	`"large"`	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].company_size_by_revenuestring\|null	매출 기준 규모 등급.값: `micro` 초소형, `small` 소형, `medium` 중형, `large` 대형	`"large"`	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].revenue_per_employeenumber\|null	유로 단위 직원 1인당 매출.	`1582798.844`	위와 같음
financial_kpi[].net_income_per_employeenumber\|null	유로 단위 직원 1인당 당기순이익.	`485049.362`	위와 같음

재무상태표: 합계와 항목

필드
필드	의미	예시	제공 빈도
financial_kpi[].assets_totalnumber\|null	재무상태표상 자산 합계, 유로.`financial_kpi` · Pro부터	`397093655.67`	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].equity_totalnumber\|null	유로 단위 자기자본.	`297695266.84`	위와 같음
financial_kpi[].liabilities_totalnumber\|null	유로 단위 부채 총계.	`28921831.79`	위와 같음
financial_kpi[].provisions_totalnumber\|null	유로 단위 충당금 총계.	`55716527.94`	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].current_assets_totalnumber\|null	유로 단위 유동자산.	`75902450.81`	위와 같음
financial_kpi[].fixed_assets_totalnumber\|null	유로 단위 고정자산.	`316193205.41`	위와 같음
financial_kpi[].inventory_totalnumber\|null	유로 단위 재고자산.	`2605622.88`	위와 같음
financial_kpi[].receivables_totalnumber\|null	유로 단위 채권 및 기타 자산.	`34451734.53`	위와 같음
financial_kpi[].trade_receivablesnumber\|null	유로 단위 매출채권.	`25390709.7`	위와 같음
financial_kpi[].intragroup_receivablesnumber\|null	유로 단위 관계회사 채권.	`548819.99`	위와 같음
financial_kpi[].securities_current_totalnumber\|null	유로 단위 유동자산으로 보유한 유가증권.	`null`	위와 같음
financial_kpi[].cash_and_equivalentsnumber\|null	유로 단위 현금, 은행 예금, 수표.	`38845093.4`	위와 같음
financial_kpi[].ppe_totalnumber\|null	유로 단위 유형자산.	`269497218.27`	위와 같음
financial_kpi[].land_and_buildingsnumber\|null	타인 토지 위 건물을 포함한 토지와 건물, 유로.	`46944085.59`	위와 같음
financial_kpi[].intangible_assetsnumber\|null	유로 단위 무형자산.	`18788946.41`	위와 같음
financial_kpi[].goodwillnumber\|null	유로 단위 영업권.	`null`	위와 같음
financial_kpi[].long_term_financial_assetsnumber\|null	유로 단위 금융자산(장기).	`27907040.73`	위와 같음
financial_kpi[].prepaid_expensesnumber\|null	유로 단위 선급비용.	`4997999.45`	위와 같음
financial_kpi[].capital_reservesnumber\|null	유로 단위 자본잉여금.	`536224.77`	위와 같음
financial_kpi[].revenue_reservesnumber\|null	유로 단위 이익잉여금.	`20005000`	위와 같음
financial_kpi[].profit_loss_carried_forwardnumber\|null	유로 단위 이월 이익 또는 이월 손실; 이월 손실은 음수.	`332187259.01`	위와 같음
financial_kpi[].pension_provisionsnumber\|null	유로 단위 연금 및 유사 의무 충당금.	`null`	위와 같음
financial_kpi[].other_provisionsnumber\|null	유로 단위 기타 충당금.	`22278401.94`	위와 같음
financial_kpi[].trade_payablesnumber\|null	유로 단위 매입채무.	`14625866.4`	위와 같음
financial_kpi[].intragroup_payablesnumber\|null	유로 단위 그룹 회사에 대한 부채.	`2667666.2`	위와 같음
financial_kpi[].liabilities_to_affiliated_companiesnumber\|null	유로 단위 관계회사에 대한 부채.	`2667666.2`	위와 같음
financial_kpi[].other_liabilitiesnumber\|null	유로 단위 기타 부채.	`11628299.19`	위와 같음
financial_kpi[].deferred_incomenumber\|null	유로 단위 선수수익.	`14760029.1`	위와 같음
financial_kpi[].bank_debtnumber\|null	유로 단위 은행 차입금.	`null`	위와 같음
financial_kpi[].bondsnumber\|null	유로 단위 사채.	`null`	위와 같음

구조와 재무상태표 비율

필드
필드	의미	예시	제공 빈도
financial_kpi[].equity_rationumber\|null	자기자본비율: 자기자본을 총자산으로 나눈 값.`financial_kpi` · Pro부터	`0.75`	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].debt_to_equitynumber\|null	부채 대 자기자본: 부채를 자기자본으로 나눈 값, 배수.	`0.097`	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].debt_to_assetsnumber\|null	부채를 총자산으로 나눈 값.	`0.073`	위와 같음
financial_kpi[].cash_to_assetsnumber\|null	현금 및 현금성 자산을 총자산으로 나눈 값.	`0.098`	위와 같음
financial_kpi[].cash_to_liabilitiesnumber\|null	현금 및 현금성 자산을 부채로 나눈 값.	`1.343`	위와 같음
financial_kpi[].receivables_to_assetsnumber\|null	채권을 총자산으로 나눈 값.	`0.087`	위와 같음
financial_kpi[].inventory_to_assetsnumber\|null	재고자산을 총자산으로 나눈 값.	`0.007`	위와 같음
financial_kpi[].ppe_to_assetsnumber\|null	유형자산을 총자산으로 나눈 값.	`0.679`	위와 같음
financial_kpi[].intangible_to_assetsnumber\|null	무형자산을 총자산으로 나눈 값.	`0.047`	위와 같음
financial_kpi[].goodwill_to_assetsnumber\|null	영업권을 총자산으로 나눈 값.	`null`	위와 같음
financial_kpi[].intangible_to_equitynumber\|null	무형자산을 자기자본으로 나눈 값.	`0.063`	위와 같음
financial_kpi[].tangible_equitynumber\|null	무형자산과 영업권을 뺀 자기자본, 유로.	`278906320.43`	위와 같음
financial_kpi[].tangible_equity_rationumber\|null	유형 자기자본을 총자산으로 나눈 값.	`0.702`	위와 같음

운전자본과 부채

필드
필드	의미	예시	제공 빈도
financial_kpi[].operating_working_capitalnumber\|null	재고자산에 매출채권을 더하고 매입채무를 뺀 값, 유로.`financial_kpi` · Pro부터	`13370466.18`	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].net_working_capital_strictnumber\|null	유동자산에서 단기 부채를 뺀 값, 좁은 정의, 유로.	`61276584.41`	위와 같음
financial_kpi[].net_working_capital_approxnumber\|null	재무제표에 모든 만기가 없을 때의 순운전자본 근사치, 유로.	`46980619.02`	위와 같음
financial_kpi[].interest_bearing_debt_strictnumber\|null	이자부 부채, 좁은 정의: 주로 은행 차입금과 사채, 유로.	`null`	위와 같음
financial_kpi[].interest_bearing_debt_broadnumber\|null	이자부 부채, 넓은 정의, 유로.	`14295965.39`	위와 같음
financial_kpi[].net_debt_narrownumber\|null	순부채: 이자부 부채(좁은 정의)에서 현금 및 현금성 자산을 뺀 값, 유로. 음수면 순현금이에요.	`null`	위와 같음
financial_kpi[].net_debt_broadnumber\|null	순부채: 이자부 부채(넓은 정의)에서 현금 및 현금성 자산을 뺀 값, 유로. 음수면 순현금이에요.	`-24549128.01`	위와 같음

손익계산서 항목과 이익

필드
필드	의미	예시	제공 빈도
financial_kpi[].material_expenses_goodsnumber\|null	원재료, 소모품, 공급품과 매입 상품의 비용, 유로.`financial_kpi` · Pro부터	`1157010.5`	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].material_expenses_servicesnumber\|null	유로 단위 매입 서비스 비용.	`115352630.06`	위와 같음
financial_kpi[].wages_salariesnumber\|null	유로 단위 임금과 급여.	`33140885.29`	위와 같음
financial_kpi[].social_expensesnumber\|null	유로 단위 사회보장 분담금.	`4416500.91`	위와 같음
financial_kpi[].pension_costsnumber\|null	유로 단위 연금 및 지원 비용.	`null`	위와 같음
financial_kpi[].depreciation_amortizationnumber\|null	무형자산과 유형자산의 감가상각비, 유로.	`129958760.25`	위와 같음
financial_kpi[].depreciation_amortization_operatingnumber\|null	금융자산 평가손을 뺀 영업상 감가상각비, 유로.	`129958760.25`	위와 같음
financial_kpi[].write_downs_financial_assets_and_securitiesnumber\|null	금융자산과 유동자산으로 보유한 유가증권의 평가손, 유로.	`null`	위와 같음
financial_kpi[].other_operating_incomenumber\|null	유로 단위 기타 영업수익.	`1229615.57`	위와 같음
financial_kpi[].other_operating_expensesnumber\|null	유로 단위 기타 영업비용.	`29380170.42`	위와 같음
financial_kpi[].selling_expensesnumber\|null	유로 단위 판매비, 매출원가법 손익계산서의 경우.	`null`	위와 같음
financial_kpi[].admin_expensesnumber\|null	유로 단위 일반관리비, 매출원가법 손익계산서의 경우.	`null`	위와 같음
financial_kpi[].gross_profitnumber\|null	매출총이익: 매출에서 재료비 또는 매출원가를 뺀 값, 유로.	`null`	위와 같음
financial_kpi[].ebitnumber\|null	유로 단위 이자 및 세전 이익(EBIT).	`null`	위와 같음
financial_kpi[].ebtnumber\|null	유로 단위 경상 활동의 세전 이익(EBT).	`null`	위와 같음
financial_kpi[].ebitdanumber\|null	유로 단위 이자, 세금, 감가상각 전 이익(EBITDA).	`null`	위와 같음
financial_kpi[].income_taxesnumber\|null	유로 단위 소득 및 수익에 대한 세금.	`67650181.5`	위와 같음
financial_kpi[].other_taxesnumber\|null	유로 단위 기타 세금.	`94694.61`	위와 같음
financial_kpi[].income_after_taxesnumber\|null	유로 단위 세후 이익.	`165011477.67`	위와 같음
financial_kpi[].interest_incomenumber\|null	유로 단위 이자 및 유사 수익.	`5025778.39`	위와 같음
financial_kpi[].interest_expensenumber\|null	유로 단위 이자 및 유사 비용, 재무제표의 부호 그대로.	`42.37`	위와 같음
financial_kpi[].finance_incomenumber\|null	재무 활동에서 나온 수익 총계, 유로.	`5025778.39`	위와 같음
financial_kpi[].finance_income_from_affiliatesnumber\|null	관계회사 투자에서 나온 수익, 유로.	`null`	위와 같음

마진과 손익계산서 비율

필드
필드	의미	예시	제공 빈도
financial_kpi[].gross_marginnumber\|null	매출총이익률: 매출총이익을 매출로 나눈 값.`financial_kpi` · Pro부터	`null`	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].ebitda_marginnumber\|null	EBITDA 마진: EBITDA를 매출로 나눈 값.	`null`	위와 같음
financial_kpi[].ebit_marginnumber\|null	EBIT 마진: EBIT를 매출로 나눈 값.	`null`	위와 같음
financial_kpi[].net_marginnumber\|null	순이익률: 당기순이익을 매출로 나눈 값.	`0.306`	위와 같음
financial_kpi[].material_intensitynumber\|null	재료비율: 재료비를 매출로 나눈 값.	`0.216`	위와 같음
financial_kpi[].personnel_intensitynumber\|null	인건비율: 인건비를 매출로 나눈 값.	`0.07`	위와 같음
financial_kpi[].sganumber\|null	판매비와 관리비 합계(SG&A), 유로.	`null`	위와 같음
financial_kpi[].sga_rationumber\|null	판매비와 관리비를 매출로 나눈 값.	`null`	위와 같음
financial_kpi[].opex_corenumber\|null	회계연도의 핵심 영업비용, 유로.	`66937556.62`	위와 같음
financial_kpi[].opex_rationumber\|null	핵심 영업비용을 매출로 나눈 값.	`0.124`	위와 같음
financial_kpi[].interest_coveragenumber\|null	이자보상배율: EBIT를 이자 비용으로 나눈 값, 배수.	`null`	위와 같음
financial_kpi[].effective_tax_ratenumber\|null	유효세율: 소득세를 세전 이익으로 나눈 값.	`null`	위와 같음
financial_kpi[].capitalized_own_work_rationumber\|null	자본화된 자체 작업을 매출로 나눈 값.	`0.003`	위와 같음
financial_kpi[].inventory_change_rationumber\|null	재고 변동을 매출로 나눈 값.	`null`	위와 같음
financial_kpi[].finance_to_ebt_rationumber\|null	금융 손익을 세전 이익으로 나눈 값.	`null`	위와 같음

행의 출처

필드
필드	의미	예시	제공 빈도
financial_kpi[].source_statement_datestring\|null	행의 출처인 재무제표의 결산일. _provenance.period_end와 같아요.`financial_kpi` · Pro부터	`"2023-12-31"`	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
financial_kpi[].source_statement_typestring\|null	행의 출처인 재무제표의 종류. _provenance.statement_type과 같아요.	`"Jahresabschluss"`	위와 같음

회계 기준

회사는 서로 다른 규칙에 따라 재무제표를 작성해요. 대부분은 독일 상법(HGB)을 따라요. 자본시장의 그룹은 연결 재무제표를 국제 기준 IFRS에 따라 작성해요.

HGB 안에서도 재무제표의 모습은 달라요. 재무상태표는 § 266 HGB의 양식을 따르며, 소형 회사는 약식으로 공개해요. 손익계산서는 총원가법이나 매출원가법(§ 275 HGB)을 따라요. 각 방식은 고유한 항목을 가져요.

연도와 회사를 넘어 항목을 비교할 수 있도록, 인식한 모든 줄에 통일된 이름을 붙여요. 재무제표가 어떤 기준과 어떤 레이블로 그 줄을 인쇄하든 name.de와 name.en에 있어요. 그래서 “5. Personalaufwand”는 어디서나 Personalaufwand와 Personnel expenses가 돼요.

name.in_report는 목차 번호를 포함해 재무제표에 적힌 그대로의 레이블을 유지해요. 표시와 원본 대조에 쓰세요. 금액, 순서, 구조는 재무제표에서 그대로 가져와요.

어떤 줄을 통일된 항목에 매핑하지 않으면 name.en이 없고 name.de가 인쇄된 레이블을 그대로 써요. 그래서 name.en으로 그 줄에 통일된 이름이 있는지 알 수 있어요.

모든 회사에 같은 방식으로 계산한 KPI는 재무 KPI를 쓰세요. 재무제표가 어떤 기준으로 작성되었는지는 재무제표에 감사 의견이 있으면 연간 재무제표의 audit.accounting_framework에 나와요.

재무상태표

balance_sheet_accounts 기능은 각 회계연도의 재무상태표를 모든 항목과 함께 반환해요. 항목은 재무제표처럼 구성된 트리를 이뤄요. 이름은 정규화해요. 자세한 내용은 회계 기준에 있어요.

루트는 Aktivseite(자산)와 Passivseite(자본과 부채)예요. 루트와 알려진 모든 항목은 위치가 아니라 name.de로 알아보세요. 항목이 얼마나 깊이 있는지는 재무제표마다 다를 수 있어요. 그러니 트리 전체를 검색하세요.

항목의 자식을 더한다고 그 합계가 되지는 않아요. “Davon” 줄(“그중”)은 상위 값의 일부이지 추가분이 아니에요.

필드
필드	의미	예시	제공 빈도
balance_sheet_accountsarray	재무상태표: 회계연도마다 항목 하나, 최신순.비어 있는 경우: 회사가 재무상태표를 공개하지 않음`balance_sheet_accounts`	–	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
balance_sheet_accounts[].yearinteger	회계연도가 끝나는 역년.	`2023`	위와 같음
balance_sheet_accounts[].balance_sheet_accountsarray	루트가 Aktivseite와 Passivseite인 항목 트리. 각 노드에는 name, value, children이 있어요.	–	위와 같음
balance_sheet_accounts[].balance_sheet_accounts[].name.destring	연도, 회사, 회계 기준을 넘어 같은, 항목의 통일된 독일어 이름. 항목을 알아보는 데 쓰세요. 그 줄이 통일된 항목에 매핑되지 않으면 인쇄된 레이블이에요.	`"Aktivseite"`	위와 같음
balance_sheet_accounts[].balance_sheet_accounts[].name.enstring	항목의 통일된 영어 이름. 키가 없으면 그 줄은 통일된 항목에 매핑되지 않은 거예요.	`"Assets"`	위와 같음
balance_sheet_accounts[].balance_sheet_accounts[].name.in_reportstring\|null	목차 번호를 포함해 재무제표에 인쇄된 그대로의 레이블. 표시와 원본 대조용이에요.	`"Aktiva"`	위와 같음
balance_sheet_accounts[].balance_sheet_accounts[].valuenumber\|null	유로 단위 항목 금액. 재무제표에 금액이 인쇄되어 있지 않으면 자식의 합계예요.	`397093655.67`	위와 같음
balance_sheet_accounts[].balance_sheet_accounts[].childrenarray	인쇄된 순서의 하위 항목, 같은 구조. 비어 있을 수 있어요.	–	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
balance_sheet_accounts[]._provenanceobject	재무상태표의 출처인 재무제표, 재무 KPI와 같은 필드.	–	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
balance_sheet_accounts[].activity_statementsarray	에너지 공급사의 활동 보고서(§ 6b EnWG). 각 활동에는 de, en, in_report가 담긴 activity.name, 재무상태표 트리, statement_type이 Tätigkeitsabschluss인 _provenance가 있어요. 재무제표에 활동 보고서가 있을 때만.`balance_sheet_accounts` · Max부터	–	드묾

Max 플랜에서는 에너지 공급사의 활동 보고서도 추가 비용 없이 받아요. 에너지 공급사가 § 6b EnWG에 따라 규제 대상 활동마다 공개하는 별도의 재무상태표예요. activity_statements에 있으며, 각각 activity.name, 트리, _provenance가 있어요. 활동은 대개 회사의 일부만 다뤄요. 그러니 더하지 말고 회사 합계와 비교하지도 마세요.

Hetzner Online GmbH 예시에서 2023년 재무상태표의 시작 부분, 자산 쪽 첫 가지로 축약:

1{2  "balance_sheet_accounts": [3    {4      "year": 2023,5      "balance_sheet_accounts": [6        {7          "name": {8            "de": "Aktivseite",9            "en": "Assets",10            "in_report": "Aktiva"11          },12          "value": 397093655.67,13          "children": [14            {15              "name": {16                "de": "Anlagevermögen",17                "en": "Fixed Assets",18                "in_report": "A. Anlagevermögen"19              },20              "value": 316193205.41,21              "children": [22                {23                  "name": {24                    "de": "Immaterielle Vermögensgegenstände",25                    "en": "Intangible Assets",26                    "in_report": "I. Immaterielle Vermögensgegenstände"27                  },28                  "value": 18788946.41,29                  "children": [30                    {31                      "name": {32                        "de": "Entgeltlich erworbene Konzessionen",33                        "en": "Purchased Concessions",34                        "in_report": "1. entgeltlich erworbene Konzessionen, gewerbliche Schutzrechte und ähnliche Rechte und Werte sowie Lizenzen an solchen Rechten und Werten"35                      },36                      "value": 13879378,37                      "children": []38                    },39                    {40                      "name": {41                        "de": "Geleistete Anzahlungen",42                        "en": "Advance Payments",43                        "in_report": "2. geleistete Anzahlungen"44                      },45                      "value": 4909568.41,46                      "children": []47                    }48                  ]49                }50              ]51            }52          ]53        }54      ],55      "_provenance": {56        "statement_type": "Jahresabschluss",57        "period_start": "2023-01-01",58        "period_end": "2023-12-31",59        "exempt_subsidiary": false,60        "parent_organization": null61      }62    }63  ]64}

예시 응답: Hetzner Online GmbH의 balance_sheet_accounts 발췌

손익계산서

profit_and_loss_account 기능은 각 회계연도의 손익계산서를 반환해요. 노드 구조는 재무상태표와 같고, 여기서는 목록을 profit_and_loss_accounts라고 불러요.

최상위에는 항목과 인쇄된 소계, 예를 들어 매출총이익이나 당기순이익이 나란히 있어요. 그러니 더하지 말고 인쇄된 결과를 쓰세요.

중형과 대형 회사는 손익계산서를 공개해요. 중형 회사는 매출총이익부터 시작할 수 있으며, 그러면 매출이 별도 줄로 없어요.

필드
필드	의미	예시	제공 빈도
profit_and_loss_accountarray	손익계산서: 회계연도마다 항목 하나, 최신순. 각 항목은 `profit_and_loss_accounts` 아래에 줄을 담아요.비어 있는 경우: 회사가 손익계산서를 공개하지 않음, 예: 소형 회사`profit_and_loss_account`	–	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
profit_and_loss_account[].yearinteger	회계연도가 끝나는 역년.	`2023`	위와 같음
profit_and_loss_account[].profit_and_loss_accountsarray	인쇄된 순서의 손익계산서 줄, 재무상태표처럼 트리로. 최상위에는 항목과 소계가 나란히 있어요.	–	위와 같음
profit_and_loss_account[].profit_and_loss_accounts[].name.destring	연도, 회사, 회계 기준을 넘어 같은, 항목의 통일된 독일어 이름. 그 줄이 통일된 항목에 매핑되지 않으면 인쇄된 레이블이에요.	`"Umsatzerlöse"`	위와 같음
profit_and_loss_account[].profit_and_loss_accounts[].name.enstring	항목의 통일된 영어 이름. 키가 없으면 그 줄은 통일된 항목에 매핑되지 않은 거예요.	`"Revenue"`	위와 같음
profit_and_loss_account[].profit_and_loss_accounts[].name.in_reportstring\|null	재무제표에 인쇄된 그대로의 레이블. 표시와 원본 대조용이에요.	`"1. Umsatzerlöse"`	위와 같음
profit_and_loss_account[].profit_and_loss_accounts[].valuenumber\|null	유로 단위 금액. 비용은 재무제표의 부호를 따라요.	`538151607.13`	위와 같음
profit_and_loss_account[].profit_and_loss_accounts[].childrenarray	같은 구조의 하위 줄. 비어 있을 수 있어요.	–	위와 같음
profit_and_loss_account[]._provenanceobject	손익계산서의 출처인 재무제표, 재무 KPI와 같은 필드.	–	위와 같음
profit_and_loss_account[].activity_statementsarray	에너지 공급사의 활동별 손익계산서(§ 6b EnWG): activity.name, profit_and_loss_accounts의 줄, _provenance. 재무제표에 활동 보고서가 있을 때만.`profit_and_loss_account` · Max부터	–	드묾

여기서도 Max 플랜은 에너지 공급사의 활동 보고서를 activity_statements에 반환하며, 각 활동의 손익계산서는 profit_and_loss_accounts 아래에 있어요. 한 활동의 재무상태표와 손익계산서는 activity.name.de로 짝지어요.

연간 재무제표

annual_financial_statements와 annual_financial_statements__html 기능은 공개된 재무제표를 전문으로 반환해요. 회사가 공개한 범위에서 재무상태표, 손익계산서, 주석, 경영 보고서가 포함돼요.

Markdown 버전은 주로 AI 에이전트용이에요. HTML보다 훨씬 간결해 토큰을 아껴요. 원본은 구조가 깔끔하지 않은 경우가 많아요. 그래서 일반적인 Markdown 렌더러는 추가 처리 없이는 텍스트를 깔끔하게 표시하지 못해요. 표가 있는 화면 표시에는 HTML 버전을 쓰세요. 두 버전의 필드는 같고, 텍스트만 document_md 또는 document_html에 있어요.

financial_years가 없으면 최근 재무제표 다섯 건을 받아요. financial_years=3이면 최근 세 회계연도의 모든 재무제표를 받아요. 재무제표는 매우 길 수 있어요. 특히 HTML 버전은 연도가 많으면 커져요.

필드
필드	의미	예시	제공 빈도
annual_financial_statementsarray	Markdown으로 된 공개 재무제표 전문, 최신순.비어 있는 경우: 회사가 재무제표를 공개하지 않음`annual_financial_statements`	–	대부분: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
annual_financial_statements[].document_typestring	재무제표의 종류.값: `Jahresabschluss` 개별 재무제표, `Konzernabschluss` 그룹의 재무제표	`"Jahresabschluss"`	위와 같음
annual_financial_statements[].document_titlestring	회계연도가 포함된 공고 제목.	`"Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum…"`	위와 같음
annual_financial_statements[].document_datestring	공고 날짜.	`"2025-06-25"`	위와 같음
annual_financial_statements[].yearinteger	회계연도가 끝나는 역년.	`2023`	위와 같음
annual_financial_statements[].languagestring	재무제표의 언어를 독일어 이름으로, 예: Deutsch 또는 Englisch. 코드가 아니라 텍스트예요.	`"Deutsch"`	위와 같음
annual_financial_statements[].document_mdstring	공개된 범위의 재무상태표, 손익계산서, 주석, 경영 보고서가 담긴 Markdown 전문. AI 에이전트용으로 간결하며, 표시용으로는 document_html을 쓰세요.	`"Firma\nInformation\nBezeichnung \nHetzner Online GmbH, G…"`	위와 같음
annual_financial_statements__htmlarray	같은 재무제표를 표가 포함된 HTML로, 표시용. 각 항목의 필드는 같고, 텍스트는 document_md 대신 document_html에 있어요.비어 있는 경우: 회사가 재무제표를 공개하지 않음`annual_financial_statements__html`	–	위와 같음

감사

재무제표에 감사 의견이 있으면 audit이 감사를 설명해요: 누가, 어떤 기준으로 감사했고 의견에 언제 서명했는지. 의견이 없으면 audit은 null이에요.

필드
필드	의미	예시	제공 빈도
annual_financial_statements[].auditobject\|null	감사 의견이 있을 때 재무제표의 감사. 기능 가격에 포함돼요.비어 있는 경우: 재무제표에 감사 의견이 없음`annual_financial_statements`	–	일부: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, eG 드묾: KG, OHG, e.K. 없음: PartG
annual_financial_statements[].audit.kindstring	보고서의 종류.값: `AUDIT_REPORT` 감사 의견(Bestätigungsvermerk)	`"AUDIT_REPORT"`	위와 같음
annual_financial_statements[].audit.subjectstring	감사한 재무제표.값: `OWN` 회사 자체의 재무제표, `OWN_GROUP` 회사 자체의 연결 재무제표	`"OWN"`	위와 같음
annual_financial_statements[].audit.auditedboolean	재무제표가 감사를 받았으면 true.	`true`	위와 같음
annual_financial_statements[].audit.accounting_frameworkstring\|null	감사한 재무제표의 기준.값: `HGB` 독일 상법(Handelsgesetzbuch), `IFRS_EU` EU에서 채택한 IFRS, `PUBLG` 독일 공시법(Publizitätsgesetz)	`"HGB"`	위와 같음
annual_financial_statements[].audit.auditor.namestring	감사 법인 이름.	`"WP Koehler GmbH Wirtschaftsprüfungsgesellschaft"`	위와 같음
annual_financial_statements[].audit.auditor.typestring	감사인의 종류.값: `FIRM` 감사 법인(Wirtschaftsprüfungsgesellschaft), `COOP_ASSOCIATION` 협동조합 감사 협회	`"FIRM"`	위와 같음
annual_financial_statements[].audit.auditor.entity_idstring\|null	감사 법인의 entity_id, fetch-organization의 q로 쓸 수 있어요.비어 있는 경우: 이름으로 회사를 고유하게 식별할 수 없음	`null`	위와 같음
annual_financial_statements[].audit.auditor.networkobject\|null	key와 name이 담긴 감사 네트워크, 예: PwC.비어 있는 경우: 법인이 알려진 네트워크에 속하지 않음	–	위와 같음
annual_financial_statements[].audit.auditor.signatoriesarray	name, academic_title, qualification이 담긴 서명 감사인, 예: Wirtschaftsprüfer(독일 공인회계사)를 뜻하는 WP.	–	위와 같음
annual_financial_statements[].audit.signedobject\|null	감사 의견의 장소(place)와 날짜(date).	–	위와 같음

예시 요청 당시 Hetzner Online GmbH의 최신 재무제표, 텍스트 축약:

1{2  "annual_financial_statements": [3    {4      "document_type": "Jahresabschluss",5      "document_date": "2025-06-25",6      "document_title": "Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum 31.12.2023",7      "language": "Deutsch",8      "year": 2023,9      "audit": {10        "kind": "AUDIT_REPORT",11        "subject": "OWN",12        "audited": true,13        "accounting_framework": "HGB",14        "auditor": {15          "name": "WP Koehler GmbH Wirtschaftsprüfungsgesellschaft",16          "type": "FIRM",17          "entity_id": null,18          "network": null,19          "signatories": [20            {21              "name": "Reiner Musterwald",22              "academic_title": null,23              "qualification": "WP"24            }25          ]26        },27        "signed": {28          "place": "Seeheim-Jugehein",29          "date": "2024-06-10"30        }31      },32      "document_md": "Firma
Information
Bezeichnung 
Hetzner Online GmbH, Gunzenhausen
Rechnungslegung / Finanzberichte
Unternehmensregister
Jahresabschluss zum Geschäftsjahr vom 01.01.2023 bis zum 31.12.2023
 
Datum: 25.06.2025
Sprache:
Deutsch
| |
| --- |
| He…"33    }34  ]35}

예시 응답: Hetzner Online GmbH의 annual_financial_statements 발췌

재무 KPI 분석 여러 해의 KPI 가져오기, 개별 또는 연결 재무제표 선택. fetch-organization 엔드포인트의 모든 파라미터와 기능. 데이터 제공 범위 각 법적 형태와 규모 등급이 공개해야 하는 것. search-organizations 매출, 직원 수, 총자산으로 회사 찾기.

재무

규칙