---
title: '[릴리즈노트]2025-08-13 파트너 정산 자동화 업데이트'
category: 업데이트
tags:
  - 파트너정산
  - 업데이트
searchTags:
  - 파트너정산
  - 업데이트
  - 정산내역 템플릿
datetime: 2025-08-13T00:00:00.000Z
---

<Callout title="2025년 8월 13일 파트너  정산 자동화 업데이트 소식을 안내드립니다." />



<Callout content="안녕하세요 파트너 정산 자동화팀입니다.
2025년 8월 13일 업데이트 사항을 확인해 보세요.
업데이트 항목	
1. 정산 내역서 발송 기능 업데이트
2. 정산 내역서 템플릿 생성 및 수정
3. 지급 내역에서 정산 내역서의 상태를 확인
4. API 변경" />

### ✔️**정산 내역서 발송 기능 업데이트**

이제, 파트너 정산 콘솔에서 생성된 정산 내역을 기반으로, 파트너에게 정산 내역서를 보낼 수 있습니다.

일괄지급 내역 상세 및 지급 내역 관리 페이지에서 원하는 정산 내역을 단건, 혹은 다건으로 선택하여 한 번에 정산내역서 이메일을 발송할 수 있습니다.

발신자/수신자 설정: 발신자 이메일 설정은 필수이며, 도메인 인증을 통해 도메인을 활용한 발신이 가능합니다. 인증 완료된 도메인이 없는 경우, 기본 메일 <no-reply@portone.io>로 정산내역서를 발송할 수 있습니다.

수신자 이메일은 등록해 둔 파트너의 담당자 이메일로 지정되고, 담당자 이메일을 수정하는 것으로 수신자 이메일을 수정할 수 있습니다. 모든 설정을 완료하고, '정산내역서 발송' 버튼을 클릭하면 선택된 지급 내역의 파트너 전체에게 이메일이 차례대로 발송됩니다.

### ✔️**정산 내역서 템플릿 생성 및 수정**

정산 내역서 템플릿을 자유롭게 생성하고, 수정할 수 있습니다.

정산내역서 템플릿 관리 페이지에서 템플릿을 다양하게 만들어 관리할 수 있습니다. 지급 내역 생성 여부와 관계없이 템플릿을 생성할 수 있으며, 템플릿 목록 조회, 신규 생성 및 수정, 보관, 복원이 가능합니다. 템플릿 구성 항목의 포함 여부(on/off)를 관리할 수 있고, 구성 항목은 다음과 같습니다.

발신자 정보

- 우리 회사 상호

수신자(파트너) 정보

- 파트너 이름 및 법인명
- 파트너 유형
- 과세, 소득 유형
- 예금주명
- 은행정보 (계좌번호 및 은행명)

정산 기본 정보

- 정산 기간

정산 금액 정보

- 지급 금액 (필수값)
- 원천징수세액 (소득세, 지방 소득세)
- 정산 금액
- 확정 공급가액
- 확정 부가세액
- 정산 면세액
- 확정 면세액

### ✔️**지급 내역에서 정산 내역서의 상태를 확인**

지급 내역 페이지에서 정산 내역서 상태 컬럼이 추가되어 발송 상태를 확인할 수 있습니다.

지급 내역 페이지에 **정산내역서 상태**, **정산내역서 ID**, **정산내역서 발송 일시** 컬럼이 추가됩니다. 정산 내역서의 상태는 정산내역서가 아직 생성 및 발송되지 않은 상태인 **미발송**, 이메일이 수신자에게 성공적으로 전달된 **발송 완료**, 이메일 발송을 시도했으나, 주소 오류 등의 이유로 실패한 상태인 **발송 실패** 총 3개의 상태가 존재합니다.

### ✔️**API 변경 안내**

##### 지급내역 `PlatformPayout` 에 정산내역서 요약 정보가 추가되었고, 지급내역 다건 조회 시 정산내역서 정보를 기준으로 필터링할 수 있습니다.

##### **지급 내역 `PlatformPayout` 필드 추가**

##### 신규 필드: `settlementStatement`: `PlatformPayoutSettlementStatementSummary`

- `id` – 정산내역서 아이디
- `status` – 정산내역서 상태
- `issuedAt` – 정산내역서 발송 일시

##### **지급 내역 필터 `PlatformPayoutFilterInput` 옵션 추가**

- `settlementStatementStatuses` : 정산내역서 상태
- `criteria.settlementStatementIssuedTimestampRange` : 정산내역서 발송 일시 범위
- `criteria.settlementStatementId` : 정산내역서 아이디

[\[파트너 정산\] 2025-08-13 업데이트 지금 보러가기↗](https://developers.portone.io/release-notes/platform/2025-08-13)
