로열티 명세서를 CSV로 내보내기

로열티 명세서를 CSV 파일로 다운로드하면 스프레드시트에서 수익을 분석하고, 세무 신고를 준비하고, 상세한 재무 기록을 보관할 수 있습니다.

시작하기 전에

정산이 완료된 로열티 명세서가 최소 하나 있어야 합니다(명세서는 첫 정산이 처리된 후에 나타납니다)
CSV 파일을 열 수 있는 Excel, Google Sheets, Numbers 같은 스프레드시트 프로그램이 필요합니다

명세서 다운로드

기본 메뉴에서 로열티로 이동합니다
명세서 탭으로 이동합니다
다운로드할 명세 기간을 찾습니다
명세서 옆의 다운로드 버튼(화살표 아이콘)을 클릭합니다

CSV 파일이 생성됩니다. 명세서 규모가 작으면 다운로드가 즉시 시작됩니다. 규모가 큰 경우에는 파일을 준비하는 동안 진행 표시가 나타납니다.

내보내기 과정에서 일어나는 일

즉시 다운로드

대부분의 명세서는 CSV가 즉시 준비됩니다. 파일을 저장할 수 있는 다운로드 버튼이 있는 창이 나타납니다.

대용량 명세서 처리

명세 항목이 많은 명세서는 백그라운드에서 내보내기가 처리됩니다.

“내보내기 준비 중” 창이 나타납니다
시스템이 파일을 생성합니다(잠시 시간이 걸릴 수 있습니다)
준비가 끝나면 다운로드 버튼이 나타납니다
다운로드를 클릭해 파일을 저장합니다

CSV 열 설명

CSV의 각 행은 로열티 명세서의 명세 항목 하나를 나타냅니다. 각 열의 의미는 다음과 같습니다.

기본 열

열	설명	예시
`pay_period`	YYYYMM 형식의 정산 기간	`202601`
`label`	회원님의 레이블명	`Midnight Records`
`retailer`	플랫폼명	`Spotify`
`territory`	국가 또는 지역 코드	`US`, `GB`, `DE`
`type`	거래 유형	`Stream`, `Download`, `UGC`
`cat`	카탈로그 번호	`MR-2026-001`
`upc`	릴리스 UPC 바코드	`840123456789`
`release`	릴리스 제목	`Neon Skyline`
`isrc`	트랙 ISRC 코드(각 트랙의 고유 식별자)	`USRC12400001`
`track_artist`	아티스트명	`Luna Rivera`
`track_title`	트랙 제목	`Golden Hour`
`track_version`	버전 또는 리믹스 정보(없으면 공란)	`Acoustic Version`
`track_count`	트랙 수	`1`
`purchase_qty`	스트리밍 또는 판매 횟수	`4523`
`dsp_transaction_date`	플랫폼에서 발생한 거래일	`2026-01-15`
`dsp_statement_id`	명세서 참조 ID	`SP-2026-0001`

수익 열

열	설명	예시
`gross_usd`	총수익(USD, 명세 제공자 수수료 차감 후)	`18.09000000`

LabelGrid 수수료 열

열	설명	예시
`platform_fee_rate`	회원님 요금제 기준 LabelGrid 플랫폼 수수료율	`0.05000000` (5%)
`platform_fee_usd`	LabelGrid 플랫폼 수수료 금액(음수로 표시)	`-0.90450000`
`ugc_fee_rate`	UGC 플랫폼에 적용되는 사용자 제작 콘텐츠 수수료율	`0.20000000` (20%)
`ugc_fee_usd`	UGC 플랫폼 수수료 금액(음수로 표시)	`-1.74400000`
`total_labelgrid_fee`	전체 LabelGrid 수수료 합계(음수)	`-2.18000000`
`net_revenue_usd`	모든 수수료를 제한 최종 수익	`17.18550000`

기술 사양

이 CSV를 회계 소프트웨어나 재무 백엔드에 연동한다면, 정확한 형식 세부 사항은 다음과 같습니다.

항목	값
인코딩	UTF-8
구분자	쉼표(`,`)
인용 문자	큰따옴표(`"`)
이스케이프 문자	백슬래시(`\`)
줄바꿈	LF(`\n`)
헤더 행	항상 첫 행에 존재
전체 열 수	23개(고정 순서, 위 열 설명 참고)

데이터 유형과 정밀도

열 그룹	유형	정밀도
`pay_period`	문자열	`YYYYMM`(6자)
`dsp_transaction_date`	문자열	`YYYY-MM-DD`(10자)
`purchase_qty`	정수	정수값
`gross_usd`, `*_fee_usd`, `net_revenue_usd`	소수	소수점 이하 최대 8자리
`platform_fee_rate`, `ugc_fee_rate`	소수	소수점 이하 최대 8자리(예: `0.05000000` = 5%)
그 외 모든 열	문자열	가변 길이

수익 계산식

platform_fee_usd  = -1 × platform_fee_rate × gross_usd
ugc_fee_usd       = -1 × ugc_fee_rate × gross_usd
total_labelgrid_fee = platform_fee_usd + ugc_fee_usd
net_revenue_usd   = gross_usd + total_labelgrid_fee

자동 파싱 시 유의사항

빈 필드: track_version과 cat은 비어 있을 수 있습니다(쉼표 두 개가 연달아 나옵니다)
텍스트 인용: 쉼표나 따옴표가 포함된 필드는 큰따옴표로 감쌉니다. 필드 값 안의 큰따옴표는 내보내기 과정에서 제거됩니다.
대용량 내보내기: 150MB가 넘는 내보내기는 여러 개의 CSV 파일(각 파일마다 헤더 행 포함)로 분할되어 ZIP 압축 파일로 제공됩니다
정렬: 행은 pay_period 내림차순, 그다음 dsp_transaction_date 내림차순으로 정렬됩니다

CSV의 수수료 이해하기

순수익 계산 방법

net_revenue_usd = gross_usd + total_labelgrid_fee

수수료가 음수이므로 총액에서 차감됩니다. 예를 들면 다음과 같습니다.

	금액
총수익	$18.09000000
플랫폼 수수료(5%)	-$0.90450000
UGC 수수료	$0.00000000
순수익	$17.18550000

UGC 플랫폼 수수료

UGC 수수료는 YouTube, TikTok, SoundCloud 같은 사용자 제작 콘텐츠 플랫폼에만 적용됩니다. Spotify나 Apple Music 같은 일반 스트리밍 플랫폼에서는 ugc_fee_rate와 ugc_fee_usd 열에 0.00이 표시됩니다.

수수료 포함 안내

수수료는 2024년 10월 명세 기간부터 CSV 내보내기에 포함됩니다. 그 이전 명세서에는 수수료 분류 열 없이 수익 데이터만 표시됩니다.

샘플 CSV 다운로드

직접 다운로드하기 전에 내보내기 결과가 어떤 모습인지 확인하고 싶으신가요? 샘플 파일을 다운로드해 보세요.

샘플 CSV 다운로드

샘플에는 여러 플랫폼과 지역에 걸친 일반적인 명세 항목을 보여주는 예시 데이터가 들어 있습니다.

데이터 활용 팁

Google Sheets에서 열기

Google Sheets로 이동합니다
파일 → 가져오기를 클릭합니다
CSV 파일을 업로드합니다
구분 기준으로 “쉼표”를 선택합니다
데이터 가져오기를 클릭합니다

Excel에서 열기

Excel을 엽니다
파일 → 열기를 클릭하고 CSV 파일을 선택합니다
Excel이 쉼표 구분 형식을 자동으로 인식합니다

자주 쓰는 분석 아이디어

소매업체(retailer)로 필터링해 플랫폼별 수익 확인
지역(territory) 피벗 테이블로 가장 강한 시장 파악
net_revenue_usd 합계로 전체 명세 금액 검증
purchase_qty 정렬로 가장 많이 스트리밍된 트랙 찾기
릴리스(release)별 그룹화로 앨범 성과 비교

문제 해결

내보내기가 너무 오래 걸립니다

명세 항목이 많은 대용량 명세서는 생성에 더 오래 걸릴 수 있습니다. 시스템은 최대 5분 동안 상태를 확인합니다. 내보내기가 시간 초과되면 다음과 같이 하세요.

창을 닫습니다
몇 분 기다립니다
다시 다운로드를 시도합니다

”내보내기 진행 중” 오류

내보내기는 한 번에 하나만 처리할 수 있습니다. 진행 중인 내보내기가 끝날 때까지 기다린 후 다시 시도하세요.

CSV에 이상한 문자가 보입니다

가져올 때 스프레드시트 프로그램의 인코딩을 UTF-8로 설정했는지 확인하세요. 그래야 특수 문자가 포함된 아티스트명과 트랙 제목이 올바르게 표시됩니다.

수수료 열이 없습니다

수수료 열(platform_fee_rate, platform_fee_usd 등)은 2024년 10월 이후 명세 기간에만 제공됩니다. 그 이전 기간에는 수수료 분류 없이 수익 데이터만 표시됩니다.