---
releasedAt: 2025-08-13T00:00:00.000Z
writtenAt: 2025-08-13T00:00:00.000Z
---

안녕하세요, 파트너 정산 자동화 팀입니다.

2025년 8월 13일 업데이트 사항을 확인해 보세요.

---

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

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

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

**발신자/수신자 설정**: 발신자 이메일 설정은 필수이며, 도메인 인증을 통해 도메인을 활용한 발신이 가능합니다. 인증 완료된 도메인이 없는 경우, 기본 메일 <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일**

- 일반 문의: <cs@portone.io> / 채널톡
- 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
