← 콩시스트 도구함 미국공시 수집기

미국공시 수집기 문제 해결

SEC XBRL 의 fy · fp 로 기간을 거르면 틀리는 이유

작성

SEC XBRL API 결과에는 fy(fiscal year)와 fp(fiscal period) 열이 있습니다. 이름만 보면 「이 값의 회계연도·분기」 같아서 fy = 2025 AND fp = Q3 처럼 거르기 쉽습니다. 그런데 이 두 열은 그 값이 실린 보고서의 회계연도·분기입니다.

애플 매출로 보면

애플은 9월 결산이라 2025-03-30 ~ 2025-06-28 은 2025 회계연도 3분기입니다. 미국공시 수집기로 매출 태그를 중복 제거 없이 받아 기간 끝 2025-06-28 로 걸러 보면, 같은 분기 값에 fy2025 인 줄과 2026 인 줄이 함께 있습니다.

애플 매출 결과를 2025-06-28 로 걸러 본 표. 맨 아래 줄의 end 2025-06-28 과 fy 2026 fp Q3 에 붉은 원 표시가 있다.
맨 아래 줄: 기간 끝은 2025-06-28 인데 fy 2,026 · fp Q3. 2026 회계연도 3분기 10-Q 에 비교치로 실린 값입니다.

그래서 fy = 2026 AND fp = Q3 로 거르면 2026년 3분기 매출과 2025년 3분기 매출이 섞여 나옵니다. fy = 2025 AND fp = Q3 도 마찬가지입니다. 같은 자료를 기간 끝 2024-06-29 로 걸러 보면 2024 회계연도 3분기 매출 85,777,000,000 달러 줄에도 fy 2,025 가 붙은 비교치가 있어, 2025년 3분기(94,036,000,000)와 2024년 3분기(85,777,000,000)가 한꺼번에 걸립니다.

기간은 start · end 로

  • 기간을 고를 때는 start · end 를 씁니다. 시점 값(자산 같은 것)은 end 만 있습니다.
  • 분기 값과 누적 값을 가르려면 start ~ end 의 길이를 봅니다. 위 표에서 2024-09-29 ~ 2025-06-28 은 9개월 누적, 2025-03-30 ~ 2025-06-28 은 3개월입니다.
  • 같은 기간이 여러 줄이면 중복 신고분입니다. 합계가 두 배가 될 때를 참고하세요.

fy · fp 는 「이 값을 어느 보고서에서 가져왔나」 를 확인하는 용도로만 쓰는 편이 안전합니다.