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

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

시작하기 전에

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

명세서 다운로드

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

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

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

즉시 다운로드

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

대용량 명세서 처리

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

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

받게 되는 파일

다운로드되는 파일은 다음 항목이 들어 있는 ZIP 압축 파일입니다.

CSV 파일(내보내기 용량이 커서 분할된 경우에는 여러 개의 CSV 파일)
COLUMNS.txt: 파일의 모든 열을 설명한 일반 텍스트 참고 파일

생성된 내보내기 파일은 24시간 동안 보관됩니다. 그 사이에 같은 계정·기간·그룹화 조건으로 다시 요청하면 파일을 새로 만들지 않고 이미 만들어 둔 파일을 그대로 받게 됩니다.

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`

수익 열

아래 예시에서는 일반 스트리밍 줄과 UGC 줄을 함께 보여 줍니다.

열	설명	스트리밍 줄	UGC 줄
`gross_usd`	해당 줄의 총수익(USD)이며, LabelGrid 수수료를 차감하기 전 금액입니다	`18.09000000`	`4.63000000`

LabelGrid 수수료 열

열	설명	스트리밍 줄	UGC 줄
`platform_fee_rate`	회원님 요금제의 플랫폼 수수료율	`0.05000000` (5%)	`0.00000000`
`platform_fee_usd`	플랫폼 수수료 금액(음수로 표시)	`-0.90450000`	`0.00000000`
`ugc_fee_rate`	회원님 요금제의 UGC / Content ID 수수료율	`0.00000000`	`0.20000000` (20%)
`ugc_fee_usd`	UGC / Content ID 수수료 금액(음수로 표시)	`0.00000000`	`-0.92600000`
`total_labelgrid_fee`	두 수수료를 더한 금액(음수)	`-0.90450000`	`-0.92600000`
`net_revenue_usd`	모든 LabelGrid 수수료를 뺀 최종 수익	`17.18550000`	`3.70400000`

기술 사양

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

항목	값
인코딩	UTF-8
구분자	쉼표(`,`)
인용 문자	큰따옴표(`"`)
이스케이프 문자	백슬래시(`\`)
줄바꿈	LF(`\n`)
헤더 행	항상 첫 행에 존재
전체 열 수	23개(고정 순서, 위 열 설명 참고)
제공 형식	CSV 파일과 `COLUMNS.txt` 참고 파일이 함께 담긴 ZIP 압축 파일

데이터 유형과 정밀도

열 그룹	유형	정밀도
`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%)
그 외 모든 열	문자열	가변 길이

수익 계산식

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

수수료가 음수이므로 총액에서 차감됩니다. 아래는 플랫폼 수수료 5%가 적용된 샘플 파일의 스트리밍 줄 하나를 단계별로 분해한 것입니다.

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

플랫폼 수수료와 UGC 수수료는 별개 항목이며 중첩 적용되지 않습니다

이 내보내기 파일을 기준으로 장부를 만든다면 이 부분을 정확히 이해해 두는 것이 특히 중요합니다.

두 수수료율 모두 같은 금액에 적용됩니다.
어느 한쪽 수수료가 다른 쪽 수수료를 뺀 나머지에 부과되는 일은 없습니다. UGC 수수료는 플랫폼 수수료를 뺀 나머지에 적용되지 않고, 플랫폼 수수료도 UGC 수수료를 뺀 나머지에 적용되지 않습니다.
두 금액은 서로 더해집니다: total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.

한 명세서에 두 종류의 수수료가 모두 들어간 줄을 예로 들어 보겠습니다. 같은 $100.00000000에 플랫폼 수수료율 5%와 UGC 수수료율 20%가 적용되는 경우입니다.

계산	올바른 방식(합산)	잘못된 방식(중첩)
플랫폼 수수료	-$5.00000000	-$5.00000000
UGC / Content ID 수수료	-$20.00000000($100.00의 20%)	-$19.00000000($95.00의 20%)
LabelGrid 수수료 합계	-$25.00000000	-$24.00000000

장부가 맞아떨어지는 쪽은 왼쪽입니다. 플랫폼 수수료율 5%와 UGC 수수료율 20%를 합하면 그 금액의 25%가 공제됩니다. 한 수수료율을 다른 수수료를 뺀 나머지에 적용해 나오는 24%가 아닙니다.

각 수수료가 적용되는 경우

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

수수료율은 명세서 단위로 결정되므로 대부분의 줄은 한쪽 수수료율만 값이 있고 다른 쪽은 0으로 표시됩니다. 명세서 하나에는 보통 한 종류의 수익만 담기기 때문입니다. 한 명세서에 두 종류가 모두 담긴 경우에는 그 명세서의 모든 줄에 두 수수료율이 함께 표시되며, 위의 합산 규칙이 그대로 적용됩니다. 두 수수료율 열 가운데 하나만 0이 아닐 것이라고 가정하지 마시고, 값이 들어 있는 열을 모두 읽어 더하세요.

수수료 포함 안내

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

명세서 API의 수수료

CSV 내보내기 대신 공개 API로 명세서를 조회하는 경우, 명세서 엔드포인트는 동일한 분류를 세 개의 추가 필드로 반환합니다.

필드	설명
`platform_fee_usd`	해당 명세서에 부과된 기본 유통 수수료
`ugc_fee_usd`	해당 명세서에 부과된 UGC / Content ID 수수료
`labelgrid_ugc_rate`	명세서가 생성된 시점에 적용되던 UGC / Content ID 수수료 요율

두 금액 모두 음수이며 합계는 labelgrid_fee입니다. 수수료는 해당 명세서에서 정산되는 총액을 기준으로 부과되고 여기에는 이전 기간에서 이월된 잔액도 포함되므로, 요율에 해당 기간의 수익만 곱한 값이 금액과 항상 일치하지는 않습니다. 금액을 기준 값으로 사용하세요.

세 필드는 각각 null일 수 있으며, 대부분은 분류가 기록되기 전에 생성된 명세서입니다. 세 필드가 항상 함께 움직이지는 않습니다.

platform_fee_usd와 ugc_fee_usd는 항상 둘 다 값이 있거나 둘 다 null입니다. 하나만 있는 경우는 없습니다.
labelgrid_ugc_rate는 별도로 저장되며 이 두 필드와 무관하게 결정됩니다. 두 금액이 모두 있는 명세서에서도 null일 수 있고, 두 금액이 모두 null인 명세서에서도 값이 있을 수 있습니다.

한 필드에서 다른 필드를 유추하지 말고 각 필드를 따로 확인하세요. null은 0이 아니라 ‘분류 없음’으로 처리하고, 어떤 경우에도 수수료 합계로는 labelgrid_fee를 계속 사용하세요.

샘플 CSV 다운로드

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

샘플 CSV 다운로드

샘플에는 여러 플랫폼과 지역에 걸친 일반적인 명세 항목이 예시 데이터로 들어 있으며, 위에서 설명한 23개 열 구성을 따릅니다. 모든 행이 이 문서의 계산식을 그대로 만족하므로, 파서를 개발할 때 테스트 데이터로 활용할 수 있습니다.

데이터 활용 팁

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월 이후 명세 기간에만 제공됩니다. 그 이전 기간에는 수수료 분류 없이 수익 데이터만 표시됩니다.