Admin APIAdmin Campaign API
정산 시트 다운로드
캠페인의 정산 정보를 Excel/CSV로 다운로드합니다.
정산 시트 다운로드
캠페인의 선정된 크리에이터 정산 정보를 Excel 또는 CSV 파일로 다운로드합니다.
개인 크리에이터는 3.3% 원천징수 세금이 자동 계산되며, 사업자는 세금/입금액이 빈칸으로 처리됩니다.
아래 컬럼·세금 규칙은 한국 캠페인 기준입니다. 시트 레이아웃은 캠페인 운영 국가에서 파생된 계약 언어를 따라 자동으로 갈립니다.
| 캠페인 운영 국가 | 레이아웃 | 파일명 |
|---|---|---|
| 그 외 (한국 등) | 한국 (아래 문서) | settlement_{campaignNo}_{날짜} |
| 일본 | 일본 계약서 › 정산 시트 | settlement_jp_{campaignNo}_{날짜} |
| 미국 | 영문 계약서 › 정산 시트 | settlement_us_{campaignNo}_{날짜} |
해외 레이아웃에는 세금·입금액 컬럼이 없습니다. 3.3% 원천징수는 한국 세법이고, 해외 계약은 세금 신고·납부를 크리에이터 거주국 법에 따라 크리에이터 본인이 부담하기 때문입니다.
HTTP 요청
GET /ai/admin/campaigns/{campaignNo}/settlement-export?format=excelPath Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
campaignNo | Integer | 예 | 캠페인 번호 |
Query Parameters
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
format | String | 아니오 | excel | 파일 형식 (excel 또는 csv) |
조회 조건
CampaignApplication.selectionStatus = SELECTED(선정된 크리에이터만)- 최신
ApplicationContract(SIGNED 상태)
엑셀 컬럼
| # | 컬럼명 | 설명 |
|---|---|---|
| 1 | 크리에이터명 | 계약서의 활동명 또는 실명 |
| 2 | 연락처 | 인플루언서 전화번호 |
| 3 | 이메일 | 인플루언서 이메일 |
| 4 | 계약금액 (세전) | 계약서 variableValues.광고대금 |
| 5 | 추가금 | 크리에이터 지급 예정 추가금 합계 (TB_CREATOR_ADDON_FEE). 없으면 빈칸 |
| 6 | 총액 | 계약금액 + 추가금 |
| 7 | 세금 | 개인: 총액 x 3.3% / 사업자: 빈칸 |
| 8 | 입금액 (세후) | 개인: 총액 - 세금 / 사업자: 빈칸 |
| 9 | 사업자 여부 | "개인" 또는 "사업자" |
| 10 | 계좌번호 | 계약서 계좌번호 |
| 11 | 입금자명 | 계약서 예금주명 |
| 12 | 은행 | 계약서 은행명 |
| 13 | 신분증번호 | 계약서 등록번호 |
| 14 | 계약서 PDF | 서명된 계약서 PDF URL |
| 15 | 신분증/사업자등록증 | 첨부 서류 URL |
세금 계산 규칙
원천징수 과세표준은 지급총액이므로 계약금액이 아닌 총액(계약금액 + 추가금) 기준으로 계산합니다.
| 유형 | 판단 기준 | 세금 | 입금액 |
|---|---|---|---|
| 개인 | 등록번호 10자리 아님 | 총액 x 3.3% | 총액 - 세금 |
| 사업자 | 등록번호 10자리 | 빈칸 (수동 처리) | 빈칸 (수동 처리) |
예) 계약금액 150,000 + 추가금 70,000 → 총액 220,000, 세금 7,260, 입금액 212,740
크리에이터 지급 예정 추가금
유료 검수로 발생한 크리에이터 추가 지급액입니다. 관리자가 검수의 검수(승인/반려) 화면에서
건별 승인/거절 시 입력하며, 신청(크리에이터) 단위로 합산되어 추가금 컬럼에 반영됩니다.
해외 캠페인은 정산 시트 구조가 다릅니다 — 3.3%는 한국 세법이라 세금·입금액 컬럼이 없습니다.
다만 추가금·총액 컬럼은 일본·미국 시트에도 있으며, 계약 광고대금과 같은 통화(엔·달러)로 취급됩니다.
일본은 JapaneseSettlementExportService, 미국은 EnglishSettlementExportService 로 분기됩니다.
응답
성공 응답 (200 OK)
파일 다운로드 (바이너리)
Excel:
- Content-Type:
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet - 파일명:
settlement_{campaignNo}_{날짜}.xlsx
CSV:
- Content-Type:
text/csv; charset=UTF-8 - 파일명:
settlement_{campaignNo}_{날짜}.csv