Repository: portone-io/developers.portone.io
Pull request #851: 파트너 정산 릴리즈 노트 2025-04-08
Author: login: jude-jung
Created: 2025-04-08T09:34:11Z | Merged: 2025-04-08T10:50:14Z



Diff:
diff --git a/src/routes/(root)/release-notes/(note)/platform/2025-04-08.mdx b/src/routes/(root)/release-notes/(note)/platform/2025-04-08.mdx
new file mode 100644
index 000000000..2675f7406
--- /dev/null
+++ b/src/routes/(root)/release-notes/(note)/platform/2025-04-08.mdx
@@ -0,0 +1,125 @@
+---
+releasedAt: 2025-04-08
+writtenAt: 2025-04-08
+---
+
+import Figure from "~/components/Figure";
+
+import Image1 from "./_assets/2025-04-08/screenshot1.png";
+import Image2 from "./_assets/2025-04-08/screenshot2.jpg";
+import Image3 from "./_assets/2025-04-08/screenshot3.jpg";
+
+안녕하세요, 파트너 정산 자동화팀입니다.<br />
+파트너에게 지급할 금액을 계산할 때, **정산금액을 어떤 기준으로 해석할지** 선택할 수 있는 기능이 새롭게 추가되었습니다.<br />
+이번 개선을 통해 **공급가액 기준 또는 합계금액 기준** 중 선택하여, 더욱 유연하고 명확한 지급 기준을 설정할 수 있습니다.<br />
+또한, **일괄지급 시 통장 메모(적요)** 기능이 더 눈에 잘 띄고 쉽게 설정되도록 **UI가 개선**되었습니다.<br />
+자주 사용하는 통장 메모는 한 번만 등록해두면, 지급 시 자동으로 적용되니 한번 설정해보시는 것 어떨까요? <br />
+
+⚠️ **\[중요] 업데이트**로 인한 **API 변경사항**도 하단에서 꼭 확인해주세요.
+
+---
+
+## 🔍 주요 기능 안내
+
+### 1. **정산 세부 금액 확인 가능 (공급가액 / 면세금액 / 부가세액)**
+
+지난 업데이트에서 지원된 면세금액을 활용하여 공급가액 / 면세금액 / 부가세액을 분리하여 확인 확정할 수 있습니다.
+
+정산금액은 다음 세 가지 항목으로 구분되어 확인 가능합니다:
+
+- **공급가액**: 과세 대상 금액(세전)
+- **면세금액**: 면세 대상 금액
+- **부가세액**: 공급가액 기준으로 자동 계산된 세금
+
+> 이 정보를 기반으로, 지급 금액 계산의 기준을 선택할 수 있습니다.
+
+### 2. **지급금액 산정 기준 선택 가능 (정산금액 취급 기준 설정)**
+
+정산정책 등록 시 지급금액을 계산할 때 어떤 기준으로 정산금액을 사용할지 선택할 수 있습니다.
+
+|설정값               |**설명**                                                                           |**지급금액 계산 방식**                 |
+|---------------------|-----------------------------------------------------------------------------------|---------------------------------------|
+|**합계금액** (기본값)|정산금액을 `공급가액 + 면세금액 + 부가세`로 간주하여 지급                          |지급금액 = 정산금액                    |
+|**공급가액**         |정산금액을 `공급가액 + 면세금액`으로 간주하고, <br /> 부가세는 별도로 계산되어 지급|지급금액 = 정산금액 × 1.1 (부가세 별도)|
+
+---
+
+## ✅ 화면 변경 안내
+
+### 1. 정산 규칙 **설정 페이지 리뉴얼**
+
+- 기존의 **정산 정책 관리 > 정산 규칙 탭**이 **‘설정’ 탭**으로 변경되었습니다.
+- 구조: **정산 정책 설정** / **지급 금액 설정** 으로 구성
+- **정산 금액 취급 기준** 설정이 추가되어, 정산 금액 계산 시 **부가세 포함 여부**를 설정할 수 있습니다.
+
+<Figure src={Image1} caption="" />
+
+### 2. **지급 내역 관리 - 테이블 항목 추가**
+
+- 지급 내역 테이블에 아래 항목들이 추가되어 설정 탭에서 선택한 **지급 기준**을 한눈에 확인할 수 있습니다.
+  - `원천징수세액 차감 여부`: 차감 / 미차감
+  - `정산 금액 취급 기준`: 합계 금액 / 공급가액
+
+<Figure src={Image2} caption="" />
+
+---
+
+### 3. **일괄지급 기본 설정 UI 개선**
+
+- 일괄지급 시 **통장 적요 메모**를 미리 등록하면, 매번 자동으로 적용됩니다.
+- 이 편리한 기능의 활용도를 높이기 위해 UI 디자인이 개선되었습니다.
+
+> ✨ 한 번만 설정해두면, 반복 작업 없이 간편하게 지급 메모가 적용됩니다.
+
+<Figure src={Image3} caption="" />
+
+---
+
+## ⚠️ API 변경 안내
+
+사전 고지된 deprecated 속성들이 삭제되었습니다.
+
+### \[중요] 정산 다건 조회 API
+
+> GET /platform/partner-settlements
+
+- `items.type` 이 `ORDER` 혹은 `ORDER_CANCEL` 인 경우 `amount` 객체 내에
+  - `supply` 가 삭제되었습니다. `paymentSupply` 로 대체 사용해주시길 바랍니다.
+  - `taxFree` 가 삭제되었습니다. `paymentTaxFree` 로 대체 사용해주시길 바랍니다.
+
+### \[중요] 정산 상세 관련 API
+
+> **관련 API**
+>
+> \- GET /platform/transfer-summaries
+>
+> \- GET /platform/transfers/\{id}
+>
+> \- POST /platform/transfers/order
+>
+> \- POST /platform/transfers/order-cancel
+
+- `type` 이 `ORDER` 혹은 `ORDER_CANCEL` 인 경우 `amount` 객체 내에
+  - `supply` 가 삭제되었습니다. `paymentSupply` 로 대체 사용해주시길 바랍니다.
+  - `taxFree` 가 삭제되었습니다. `paymentTaxFree` 로 대체 사용해주시길 바랍니다.
+
+### 지급 다건 조회 API
+
+> GET /platform/payouts
+
+- 200 응답 시  `items` 배열 객체 내
+  - 지급 금액 계산 관련 옵션
+    - `deductWht` 원천징수세액 차감 여부 추가되었습니다.
+    - `failReason` 지급실패사유 추가되었습니다.
+    - `settlementAmountType` 정산금액 취급 기준이 추가되었습니다.
+
+  - 확정 세부 금액
+    - `supplyAmount` 확정 공급가액 추가되었습니다.
+    - `vatAmount` 확정 부가세액 추가되었습니다.
+    - `taxFreeAmont` 확정 면세금액 추가되었습니다.
+
+---
+
+감사합니다.
+
+파트너정산 자동화 팀 드림
diff --git a/src/routes/(root)/release-notes/(note)/platform/_assets/2025-04-08/screenshot1.png b/src/routes/(root)/release-notes/(note)/platform/_assets/2025-04-08/screenshot1.png
new file mode 100644
index 000000000..4082d1da3
Binary files /dev/null and b/src/routes/(root)/release-notes/(note)/platform/_assets/2025-04-08/screenshot1.png differ
diff --git a/src/routes/(root)/release-notes/(note)/platform/_assets/2025-04-08/screenshot2.jpg b/src/routes/(root)/release-notes/(note)/platform/_assets/2025-04-08/screenshot2.jpg
new file mode 100644
index 000000000..f4f61bdbe
Binary files /dev/null and b/src/routes/(root)/release-notes/(note)/platform/_assets/2025-04-08/screenshot2.jpg differ
diff --git a/src/routes/(root)/release-notes/(note)/platform/_assets/2025-04-08/screenshot3.jpg b/src/routes/(root)/release-notes/(note)/platform/_assets/2025-04-08/screenshot3.jpg
new file mode 100644
index 000000000..a59fb27c4
Binary files /dev/null and b/src/routes/(root)/release-notes/(note)/platform/_assets/2025-04-08/screenshot3.jpg differ


Reviews:
user: login: gemini-code-assist[bot]
body: Hello @jude-jung, I'm Gemini Code Assist[^1]! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

## Summary of Changes
This pull request adds a release note for the partner settlement automation team, dated 2025-04-09. The release note details new features, UI improvements, and API changes related to partner settlement calculations and payouts. Key updates include the ability to select the basis for settlement amount interpretation (supply price or total amount), UI enhancements for batch payment memo settings, and API changes related to settlement and payout data.

### Highlights
* **Settlement Amount Basis Selection**: Partners can now choose whether settlement amounts are interpreted based on supply price or total amount, providing more flexibility in payment criteria.
* **Batch Payment Memo UI Improvement**: The UI for setting bank memo (description) during batch payments has been improved for better visibility and ease of use. Once set, the memo is automatically applied during payments.
* **API Changes**: Deprecated attributes in settlement and payout APIs have been removed, and new attributes related to payment calculation options and confirmed detailed amounts have been added.

### Changelog
* **src/routes/(root)/release-notes/(note)/platform/2025-04-09.mdx**
  * Added a new release note file for partner settlement updates on 2025-04-09.
  * Introduced the ability to select the settlement amount interpretation basis (supply price or total amount).
  * Improved the UI for setting bank memo during batch payments.
  * Documented API changes, including the removal of deprecated attributes and the addition of new attributes related to payment calculation options and confirmed detailed amounts.


<details>

<summary><b>Using Gemini Code Assist</b></summary>
<br>

The full guide for Gemini Code Assist can be found on our [documentation page](https://developers.google.com/gemini-code-assist/docs/review-github-code), here are some quick tips.

<b>Invoking Gemini</b>

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either `/gemini <command>` or `@gemini-code-assist <command>`. Below is a summary of the supported commands.

Feature | Command | Description
--- | --- | ---
Code Review | `/gemini review` | Performs a code review for the current pull request in its current state.
Pull Request Summary | `/gemini summary` | Provides a summary of the current pull request in its current state.
Comment | @gemini-code-assist | Responds in comments when explicitly tagged, both in issue comments and review comments.
Help | `/gemini help` | Displays a list of available commands.

<b>Customization</b>

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a `.gemini/` folder in the base of the repository. Detailed instructions can be found [here](https://developers.google.com/gemini-code-assist/docs/customize-gemini-behavior-github).

<b>Limitations & Feedback</b>

Gemini Code Assist is currently in preview and may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with :thumbsup: and :thumbsdown: on @gemini-code-assist comments to provide feedback.

</details>

<b>You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the [Gemini Code Assist IDE Extension](https://cloud.google.com/products/gemini/code-assist).</b>


[^1]: Review the [Privacy Notices](https://policies.google.com/privacy), [Generative AI Prohibited Use Policy](https://policies.google.com/terms/generative-ai/use-policy), [Terms of Service](https://policies.google.com/terms), and learn how to configure Gemini Code Assist in GitHub [here](https://developers.google.com/gemini-code-assist/docs/review-github-code). Gemini can make mistakes, so double check it and [use code with caution](https://support.google.com/legal/answer/13505487).

---

> A release note's tale,
> Of features new, without fail,
> UI's brightened face,
> API's changed embrace,
> Partners' payments set to sail.


state: COMMENTED
author_association: NONE
submitted_at: 2025-04-08T09:34:19Z
user: login: gemini-code-assist[bot]
body: ## Code Review
This pull request adds a release note for the 2025-04-09 partner settlement update. The release note is well-written and clearly explains the changes.  However, there are some minor issues with formatting and consistency that should be addressed before merging.

### Merge Readiness
The release note is well-written and informative.  The minor formatting and consistency issues identified in the review comments should be addressed before merging.  I cannot approve this pull request; other reviewers must also review and approve the code before merging.
state: COMMENTED
author_association: NONE
submitted_at: 2025-04-08T09:36:00Z
user: login: CirnoV
state: COMMENTED
author_association: MEMBER
submitted_at: 2025-04-08T10:14:31Z
user: login: CirnoV
state: COMMENTED
author_association: MEMBER
submitted_at: 2025-04-08T10:15:01Z
user: login: jude-jung
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-08T10:34:25Z
user: login: CirnoV
state: APPROVED
author_association: MEMBER
submitted_at: 2025-04-08T10:34:57Z

Review comments:
diff_hunk: @@ -0,0 +1,120 @@
+---
+releasedAt: 2025-04-09
+writtenAt: 2025-04-09
+---
+
+import Figure from "~/components/Figure";
+
+import Image1 from "./_assets/2025-04-09/screenshot1.png";
+import Image2 from "./_assets/2025-04-09/screenshot2.jpg";
+import Image3 from "./_assets/2025-04-09/screenshot3.jpg";
+
+안녕하세요, 파트너 정산 자동화팀입니다.
+
+파트너에게 지급할 금액을 계산할 때, **정산금액을 어떤 기준으로 해석할지** 선택할 수 있는 기능이 새롭게 추가되었습니다. 이번 개선을 통해 **공급가액 기준 또는 합계금액 기준** 중 선택하여, 더욱 유연하고 명확한 지급 기준을 설정할 수 있습니다.
path: src/routes/(root)/release-notes/(note)/platform/2025-04-09.mdx
user: login: gemini-code-assist[bot]
body: ![medium](https://img.shields.io/badge/priority-medium-yellow)

Consider rephrasing for better clarity and conciseness.  For example, instead of "정산금액을 어떤 기준으로 해석할지", you could use "정산 금액 기준 선택 기능 추가".

```
파트너에게 지급할 금액을 계산할 때, **정산 금액 기준 선택 기능**이 새롭게 추가되었습니다. 이번 개선을 통해 **공급가액 기준 또는 합계금액 기준** 중 선택하여, 더욱 유연하고 명확한 지급 기준을 설정할 수 있습니다.
```
created_at: 2025-04-08T09:36:00Z
author_association: NONE
diff_hunk: @@ -0,0 +1,120 @@
+---
+releasedAt: 2025-04-09
+writtenAt: 2025-04-09
+---
+
+import Figure from "~/components/Figure";
+
+import Image1 from "./_assets/2025-04-09/screenshot1.png";
+import Image2 from "./_assets/2025-04-09/screenshot2.jpg";
+import Image3 from "./_assets/2025-04-09/screenshot3.jpg";
+
+안녕하세요, 파트너 정산 자동화팀입니다.
+
+파트너에게 지급할 금액을 계산할 때, **정산금액을 어떤 기준으로 해석할지** 선택할 수 있는 기능이 새롭게 추가되었습니다. 이번 개선을 통해 **공급가액 기준 또는 합계금액 기준** 중 선택하여, 더욱 유연하고 명확한 지급 기준을 설정할 수 있습니다.
+
+또한, **일괄지급 시 통장 메모(적요)** 기능이 더 눈에 잘 띄고 쉽게 설정되도록 **UI가 개선**되었습니다.
path: src/routes/(root)/release-notes/(note)/platform/2025-04-09.mdx
user: login: gemini-code-assist[bot]
body: ![medium](https://img.shields.io/badge/priority-medium-yellow)

Similar to the previous comment, consider simplifying the phrasing.  "일괄지급 시 통장 메모(적요) 기능 UI 개선" would be more direct.

```
또한, **일괄 지급 시 통장 메모(적요) 기능 UI**가 개선되었습니다.
```
created_at: 2025-04-08T09:36:00Z
author_association: NONE
diff_hunk: @@ -0,0 +1,120 @@
+---
+releasedAt: 2025-04-09
+writtenAt: 2025-04-09
+---
+
+import Figure from "~/components/Figure";
+
+import Image1 from "./_assets/2025-04-09/screenshot1.png";
+import Image2 from "./_assets/2025-04-09/screenshot2.jpg";
+import Image3 from "./_assets/2025-04-09/screenshot3.jpg";
+
+안녕하세요, 파트너 정산 자동화팀입니다.
+
+파트너에게 지급할 금액을 계산할 때, **정산금액을 어떤 기준으로 해석할지** 선택할 수 있는 기능이 새롭게 추가되었습니다. 이번 개선을 통해 **공급가액 기준 또는 합계금액 기준** 중 선택하여, 더욱 유연하고 명확한 지급 기준을 설정할 수 있습니다.
+
+또한, **일괄지급 시 통장 메모(적요)** 기능이 더 눈에 잘 띄고 쉽게 설정되도록 **UI가 개선**되었습니다.
+자주 사용하는 통장 메모는 한 번만 등록해두면, 지급 시 자동으로 적용되니 한번 설정해보시는 것 어떨까요?
+
+⚠️ **\[중요] 업데이트**로 인한 **API 변경사항**도 하단에서 꼭 확인해주세요.
+
+---
+
+## 🔍 주요 기능 안내
+
+### 1. **정산 세부 금액 확인 가능 (공급가액 / 면세금액 / 부가세액)**
+
+지난 업데이트에서 지원된 면세금액을 활용하여 공급가액 / 면세금액 / 부가세액을 분리하여 확인 확정할 수 있습니다. 정산금액은 다음 세 가지 항목으로 구분되어 확인 가능합니다:
+
+- **공급가액**: 과세 대상 금액(세전)
+- **면세금액**: 면세 대상 금액
+- **부가세액**: 공급가액 기준으로 자동 계산된 세금
path: src/routes/(root)/release-notes/(note)/platform/2025-04-09.mdx
user: login: gemini-code-assist[bot]
body: ![medium](https://img.shields.io/badge/priority-medium-yellow)

For consistency, use the same formatting for all bullet points.  Consider using consistent spacing and capitalization.

```
- 공급가액: 과세 대상 금액(세전)
- 면세금액: 면세 대상 금액
- 부가세액: 공급가액 기준으로 자동 계산된 세금
```
created_at: 2025-04-08T09:36:00Z
author_association: NONE
diff_hunk: @@ -0,0 +1,120 @@
+---
+releasedAt: 2025-04-09
+writtenAt: 2025-04-09
+---
+
+import Figure from "~/components/Figure";
+
+import Image1 from "./_assets/2025-04-09/screenshot1.png";
+import Image2 from "./_assets/2025-04-09/screenshot2.jpg";
+import Image3 from "./_assets/2025-04-09/screenshot3.jpg";
+
+안녕하세요, 파트너 정산 자동화팀입니다.
+
+파트너에게 지급할 금액을 계산할 때, **정산금액을 어떤 기준으로 해석할지** 선택할 수 있는 기능이 새롭게 추가되었습니다. 이번 개선을 통해 **공급가액 기준 또는 합계금액 기준** 중 선택하여, 더욱 유연하고 명확한 지급 기준을 설정할 수 있습니다.
+
+또한, **일괄지급 시 통장 메모(적요)** 기능이 더 눈에 잘 띄고 쉽게 설정되도록 **UI가 개선**되었습니다.
+자주 사용하는 통장 메모는 한 번만 등록해두면, 지급 시 자동으로 적용되니 한번 설정해보시는 것 어떨까요?
+
+⚠️ **\[중요] 업데이트**로 인한 **API 변경사항**도 하단에서 꼭 확인해주세요.
+
+---
+
+## 🔍 주요 기능 안내
+
+### 1. **정산 세부 금액 확인 가능 (공급가액 / 면세금액 / 부가세액)**
+
+지난 업데이트에서 지원된 면세금액을 활용하여 공급가액 / 면세금액 / 부가세액을 분리하여 확인 확정할 수 있습니다. 정산금액은 다음 세 가지 항목으로 구분되어 확인 가능합니다:
+
+- **공급가액**: 과세 대상 금액(세전)
+- **면세금액**: 면세 대상 금액
+- **부가세액**: 공급가액 기준으로 자동 계산된 세금
+
+> 이 정보를 기반으로, 지급 금액 계산의 기준을 선택할 수 있습니다.
+
+### 2. **지급금액 산정 기준 선택 가능 (정산금액 취급 기준 설정)**
+
+정산정책 등록 시 지급금액을 계산할 때 어떤 기준으로 정산금액을 사용할지 선택할 수 있습니다.
+
+|설정값               |**설명**                                                                           |**지급금액 계산 방식**                 |
+|---------------------|-----------------------------------------------------------------------------------|---------------------------------------|
+|**합계금액** (기본값)|정산금액을 `공급가액 + 면세금액 + 부가세`로 간주하여 지급                          |지급금액 = 정산금액                    |
+|**공급가액**         |정산금액을 `공급가액 + 면세금액`으로 간주하고, <br /> 부가세는 별도로 계산되어 지급|지급금액 = 정산금액 × 1.1 (부가세 별도)|
path: src/routes/(root)/release-notes/(note)/platform/2025-04-09.mdx
user: login: gemini-code-assist[bot]
body: ![medium](https://img.shields.io/badge/priority-medium-yellow)

The table could benefit from more consistent formatting.  Ensure consistent spacing and alignment.

```
| 설정값               | 설명                                                                           | 지급금액 계산 방식                 |
|---------------------|-----------------------------------------------------------------------------------|---------------------------------------|
| **합계금액** (기본값) | 정산금액을 `공급가액 + 면세금액 + 부가세`로 간주하여 지급                          | 지급금액 = 정산금액                    |
| **공급가액**         | 정산금액을 `공급가액 + 면세금액`으로 간주하고, <br /> 부가세는 별도로 계산되어 지급 | 지급금액 = 정산금액 × 1.1 (부가세 별도) |
```
created_at: 2025-04-08T09:36:00Z
author_association: NONE
diff_hunk: @@ -0,0 +1,124 @@
+---
+releasedAt: 2025-04-08
+writtenAt: 2025-04-08
+---
+
+import Figure from "~/components/Figure";
+
+import Image1 from "./_assets/2025-04-08/screenshot1.png";
+import Image2 from "./_assets/2025-04-08/screenshot2.jpg";
+import Image3 from "./_assets/2025-04-08/screenshot3.jpg";
+
+안녕하세요, 파트너 정산 자동화팀입니다.
+
+파트너에게 지급할 금액을 계산할 때, **정산금액을 어떤 기준으로 해석할지** 선택할 수 있는 기능이 새롭게 추가되었습니다.
+
+이번 개선을 통해 **공급가액 기준 또는 합계금액 기준** 중 선택하여, 더욱 유연하고 명확한 지급 기준을 설정할 수 있습니다.
+
+또한, **일괄지급 시 통장 메모(적요)** 기능이 더 눈에 잘 띄고 쉽게 설정되도록 **UI가 개선**되었습니다.
+자주 사용하는 통장 메모는 한 번만 등록해두면, 지급 시 자동으로 적용되니 한번 설정해보시는 것 어떨까요?
+
+⚠️ **\[중요] 업데이트**로 인한 **API 변경사항**도 하단에서 꼭 확인해주세요.
+
+---
+
+## 🔍 주요 기능 안내
+
+### 1. **정산 세부 금액 확인 가능 (공급가액 / 면세금액 / 부가세액)**
+
+지난 업데이트에서 지원된 면세금액을 활용하여 공급가액 / 면세금액 / 부가세액을 분리하여 확인 확정할 수 있습니다.
+
+정산금액은 다음 세 가지 항목으로 구분되어 확인 가능합니다:
+
+- **공급가액**: 과세 대상 금액(세전)
+- **면세금액**: 면세 대상 금액
+- **부가세액**: 공급가액 기준으로 자동 계산된 세금
+
+> 이 정보를 기반으로, 지급 금액 계산의 기준을 선택할 수 있습니다.
+
+### 2. **지급금액 산정 기준 선택 가능 (정산금액 취급 기준 설정)**
+
+정산정책 등록 시 지급금액을 계산할 때 어떤 기준으로 정산금액을 사용할지 선택할 수 있습니다.
+
+|설정값               |**설명**                                                                           |**지급금액 계산 방식**                 |
+|---------------------|-----------------------------------------------------------------------------------|---------------------------------------|
+|**합계금액** (기본값)|정산금액을 `공급가액 + 면세금액 + 부가세`로 간주하여 지급                          |지급금액 = 정산금액                    |
+|**공급가액**         |정산금액을 `공급가액 + 면세금액`으로 간주하고, <br /> 부가세는 별도로 계산되어 지급|지급금액 = 정산금액 × 1.1 (부가세 별도)|
+
+---
+
+## ✅ 화면 변경 안내
+
+### 1. 정산 규칙 **설정 페이지 리뉴얼**
+
+- 기존의 **정산 정책 관리 > 정산 규칙 탭**이 **‘설정’ 탭**으로 변경되었습니다.
+- 구조: **정산 정책 설정** / **지급 금액 설정** 으로 구성
+- **정산 금액 취급 기준** 설정이 추가되어, 정산 금액 계산 시 **부가세 포함 여부**를 설정할 수 있습니다.
+
+<Figure src={Image1} caption="" />
+
+### 2. **지급 내역 관리 - 테이블 항목 추가**
+
+- 지급 내역 테이블에 아래 항목들이 추가되어 설정 탭에서 선택한 **지급 기준**을 한눈에 확인할 수 있습니다.
+  - `원천징수세액 차감 여부`: 차감 / 미차감
+  - `정산 금액 취급 기준`: 합계 금액 / 공급가액
+
+<Figure src={Image2} caption="" />
+
+---
+
+### 3. **일괄지급 기본 설정 UI 개선**
+
+- 일괄지급 시 **통장 적요 메모**를 미리 등록하면, 매번 자동으로 적용됩니다.
+- 이 편리한 기능의 활용도를 높이기 위해 UI 디자인이 개선되었습니다.
+
+> ✨ 한 번만 설정해두면, 반복 작업 없이 간편하게 지급 메모가 적용됩니다.
+
+<Figure src={Image3} caption="" />
+
+---
+
+## ⚠️ API 변경 안내
+
+사전 고지된 deprecated 속성들이 삭제되었습니다.
+
+### \[중요] 정산 다건 조회 API
+
+> GET /platform/partner-settlements
+
+- `items.type` 이 `ORDER` 혹은 `ORDER_CANCEL` 인 경우 `amount` 객체 내에
+  - `supply` 가 삭제되었습니다. `paymentSupply` 로 대체 사용해주시길 바랍니다.
+  - `taxFree` 가 삭제되었습니다. `paymentTaxFree` 로 대체 사용해주시길 바랍니다.
+
+### \[중요] 정산 상세 관련 API
+
+> **관련 API**  <br />
+> \- GET /platform/transfer-summaries <br />
+> \- GET /platform/transfers/\{id} <br />
+> \- POST /platform/transfers/order <br />
+> \- POST /platform/transfers/order-cancel
path: src/routes/(root)/release-notes/(note)/platform/2025-04-08.mdx
user: login: CirnoV
body: ```suggestion
> GET /platform/transfer-summaries
>
> GET /platform/transfers/\{id}
>
> POST /platform/transfers/order
>
> POST /platform/transfers/order-cancel
```
created_at: 2025-04-08T10:12:04Z
author_association: MEMBER
diff_hunk: @@ -0,0 +1,124 @@
+---
+releasedAt: 2025-04-08
+writtenAt: 2025-04-08
+---
+
+import Figure from "~/components/Figure";
+
+import Image1 from "./_assets/2025-04-08/screenshot1.png";
+import Image2 from "./_assets/2025-04-08/screenshot2.jpg";
+import Image3 from "./_assets/2025-04-08/screenshot3.jpg";
+
+안녕하세요, 파트너 정산 자동화팀입니다.
+
+파트너에게 지급할 금액을 계산할 때, **정산금액을 어떤 기준으로 해석할지** 선택할 수 있는 기능이 새롭게 추가되었습니다.
+
+이번 개선을 통해 **공급가액 기준 또는 합계금액 기준** 중 선택하여, 더욱 유연하고 명확한 지급 기준을 설정할 수 있습니다.
+
+또한, **일괄지급 시 통장 메모(적요)** 기능이 더 눈에 잘 띄고 쉽게 설정되도록 **UI가 개선**되었습니다.
+자주 사용하는 통장 메모는 한 번만 등록해두면, 지급 시 자동으로 적용되니 한번 설정해보시는 것 어떨까요?
+
+⚠️ **\[중요] 업데이트**로 인한 **API 변경사항**도 하단에서 꼭 확인해주세요.
+
+---
+
+## 🔍 주요 기능 안내
+
+### 1. **정산 세부 금액 확인 가능 (공급가액 / 면세금액 / 부가세액)**
+
+지난 업데이트에서 지원된 면세금액을 활용하여 공급가액 / 면세금액 / 부가세액을 분리하여 확인 확정할 수 있습니다.
+
+정산금액은 다음 세 가지 항목으로 구분되어 확인 가능합니다:
+
+- **공급가액**: 과세 대상 금액(세전)
+- **면세금액**: 면세 대상 금액
+- **부가세액**: 공급가액 기준으로 자동 계산된 세금
+
+> 이 정보를 기반으로, 지급 금액 계산의 기준을 선택할 수 있습니다.
+
+### 2. **지급금액 산정 기준 선택 가능 (정산금액 취급 기준 설정)**
+
+정산정책 등록 시 지급금액을 계산할 때 어떤 기준으로 정산금액을 사용할지 선택할 수 있습니다.
+
+|설정값               |**설명**                                                                           |**지급금액 계산 방식**                 |
+|---------------------|-----------------------------------------------------------------------------------|---------------------------------------|
+|**합계금액** (기본값)|정산금액을 `공급가액 + 면세금액 + 부가세`로 간주하여 지급                          |지급금액 = 정산금액                    |
+|**공급가액**         |정산금액을 `공급가액 + 면세금액`으로 간주하고, <br /> 부가세는 별도로 계산되어 지급|지급금액 = 정산금액 × 1.1 (부가세 별도)|
+
+---
+
+## ✅ 화면 변경 안내
+
+### 1. 정산 규칙 **설정 페이지 리뉴얼**
+
+- 기존의 **정산 정책 관리 > 정산 규칙 탭**이 **‘설정’ 탭**으로 변경되었습니다.
+- 구조: **정산 정책 설정** / **지급 금액 설정** 으로 구성
+- **정산 금액 취급 기준** 설정이 추가되어, 정산 금액 계산 시 **부가세 포함 여부**를 설정할 수 있습니다.
+
+<Figure src={Image1} caption="" />
+
+### 2. **지급 내역 관리 - 테이블 항목 추가**
+
+- 지급 내역 테이블에 아래 항목들이 추가되어 설정 탭에서 선택한 **지급 기준**을 한눈에 확인할 수 있습니다.
+  - `원천징수세액 차감 여부`: 차감 / 미차감
+  - `정산 금액 취급 기준`: 합계 금액 / 공급가액
+
+<Figure src={Image2} caption="" />
+
+---
+
+### 3. **일괄지급 기본 설정 UI 개선**
+
+- 일괄지급 시 **통장 적요 메모**를 미리 등록하면, 매번 자동으로 적용됩니다.
+- 이 편리한 기능의 활용도를 높이기 위해 UI 디자인이 개선되었습니다.
+
+> ✨ 한 번만 설정해두면, 반복 작업 없이 간편하게 지급 메모가 적용됩니다.
+
+<Figure src={Image3} caption="" />
+
+---
+
+## ⚠️ API 변경 안내
+
+사전 고지된 deprecated 속성들이 삭제되었습니다.
+
+### \[중요] 정산 다건 조회 API
+
+> GET /platform/partner-settlements
+
+- `items.type` 이 `ORDER` 혹은 `ORDER_CANCEL` 인 경우 `amount` 객체 내에
+  - `supply` 가 삭제되었습니다. `paymentSupply` 로 대체 사용해주시길 바랍니다.
+  - `taxFree` 가 삭제되었습니다. `paymentTaxFree` 로 대체 사용해주시길 바랍니다.
+
+### \[중요] 정산 상세 관련 API
+
+> **관련 API**  <br />
+> \- GET /platform/transfer-summaries <br />
+> \- GET /platform/transfers/\{id} <br />
+> \- POST /platform/transfers/order <br />
+> \- POST /platform/transfers/order-cancel
path: src/routes/(root)/release-notes/(note)/platform/2025-04-08.mdx
user: login: CirnoV
body: 이렇게 하면 좀 더 일관성 있게 보여질 것 같아요
created_at: 2025-04-08T10:15:01Z
author_association: MEMBER
diff_hunk: @@ -0,0 +1,124 @@
+---
+releasedAt: 2025-04-08
+writtenAt: 2025-04-08
+---
+
+import Figure from "~/components/Figure";
+
+import Image1 from "./_assets/2025-04-08/screenshot1.png";
+import Image2 from "./_assets/2025-04-08/screenshot2.jpg";
+import Image3 from "./_assets/2025-04-08/screenshot3.jpg";
+
+안녕하세요, 파트너 정산 자동화팀입니다.
+
+파트너에게 지급할 금액을 계산할 때, **정산금액을 어떤 기준으로 해석할지** 선택할 수 있는 기능이 새롭게 추가되었습니다.
+
+이번 개선을 통해 **공급가액 기준 또는 합계금액 기준** 중 선택하여, 더욱 유연하고 명확한 지급 기준을 설정할 수 있습니다.
+
+또한, **일괄지급 시 통장 메모(적요)** 기능이 더 눈에 잘 띄고 쉽게 설정되도록 **UI가 개선**되었습니다.
+자주 사용하는 통장 메모는 한 번만 등록해두면, 지급 시 자동으로 적용되니 한번 설정해보시는 것 어떨까요?
+
+⚠️ **\[중요] 업데이트**로 인한 **API 변경사항**도 하단에서 꼭 확인해주세요.
+
+---
+
+## 🔍 주요 기능 안내
+
+### 1. **정산 세부 금액 확인 가능 (공급가액 / 면세금액 / 부가세액)**
+
+지난 업데이트에서 지원된 면세금액을 활용하여 공급가액 / 면세금액 / 부가세액을 분리하여 확인 확정할 수 있습니다.
+
+정산금액은 다음 세 가지 항목으로 구분되어 확인 가능합니다:
+
+- **공급가액**: 과세 대상 금액(세전)
+- **면세금액**: 면세 대상 금액
+- **부가세액**: 공급가액 기준으로 자동 계산된 세금
+
+> 이 정보를 기반으로, 지급 금액 계산의 기준을 선택할 수 있습니다.
+
+### 2. **지급금액 산정 기준 선택 가능 (정산금액 취급 기준 설정)**
+
+정산정책 등록 시 지급금액을 계산할 때 어떤 기준으로 정산금액을 사용할지 선택할 수 있습니다.
+
+|설정값               |**설명**                                                                           |**지급금액 계산 방식**                 |
+|---------------------|-----------------------------------------------------------------------------------|---------------------------------------|
+|**합계금액** (기본값)|정산금액을 `공급가액 + 면세금액 + 부가세`로 간주하여 지급                          |지급금액 = 정산금액                    |
+|**공급가액**         |정산금액을 `공급가액 + 면세금액`으로 간주하고, <br /> 부가세는 별도로 계산되어 지급|지급금액 = 정산금액 × 1.1 (부가세 별도)|
+
+---
+
+## ✅ 화면 변경 안내
+
+### 1. 정산 규칙 **설정 페이지 리뉴얼**
+
+- 기존의 **정산 정책 관리 > 정산 규칙 탭**이 **‘설정’ 탭**으로 변경되었습니다.
+- 구조: **정산 정책 설정** / **지급 금액 설정** 으로 구성
+- **정산 금액 취급 기준** 설정이 추가되어, 정산 금액 계산 시 **부가세 포함 여부**를 설정할 수 있습니다.
+
+<Figure src={Image1} caption="" />
+
+### 2. **지급 내역 관리 - 테이블 항목 추가**
+
+- 지급 내역 테이블에 아래 항목들이 추가되어 설정 탭에서 선택한 **지급 기준**을 한눈에 확인할 수 있습니다.
+  - `원천징수세액 차감 여부`: 차감 / 미차감
+  - `정산 금액 취급 기준`: 합계 금액 / 공급가액
+
+<Figure src={Image2} caption="" />
+
+---
+
+### 3. **일괄지급 기본 설정 UI 개선**
+
+- 일괄지급 시 **통장 적요 메모**를 미리 등록하면, 매번 자동으로 적용됩니다.
+- 이 편리한 기능의 활용도를 높이기 위해 UI 디자인이 개선되었습니다.
+
+> ✨ 한 번만 설정해두면, 반복 작업 없이 간편하게 지급 메모가 적용됩니다.
+
+<Figure src={Image3} caption="" />
+
+---
+
+## ⚠️ API 변경 안내
+
+사전 고지된 deprecated 속성들이 삭제되었습니다.
+
+### \[중요] 정산 다건 조회 API
+
+> GET /platform/partner-settlements
+
+- `items.type` 이 `ORDER` 혹은 `ORDER_CANCEL` 인 경우 `amount` 객체 내에
+  - `supply` 가 삭제되었습니다. `paymentSupply` 로 대체 사용해주시길 바랍니다.
+  - `taxFree` 가 삭제되었습니다. `paymentTaxFree` 로 대체 사용해주시길 바랍니다.
+
+### \[중요] 정산 상세 관련 API
+
+> **관련 API**  <br />
+> \- GET /platform/transfer-summaries <br />
+> \- GET /platform/transfers/\{id} <br />
+> \- POST /platform/transfers/order <br />
+> \- POST /platform/transfers/order-cancel
path: src/routes/(root)/release-notes/(note)/platform/2025-04-08.mdx
user: login: jude-jung
body: 수정했습니다!

created_at: 2025-04-08T10:34:25Z
author_association: CONTRIBUTOR

PR comments:
user: login: vercel[bot]
created_at: 2025-04-08T09:34:15Z
body: [vc]: #qf7YAmkzj/LkFgFY2Tkur4dC8GFDgcQgbCnd9HNfTX4=:eyJpc01vbm9yZXBvIjp0cnVlLCJ0eXBlIjoiZ2l0aHViIiwicHJvamVjdHMiOlt7Im5hbWUiOiJkZXZlbG9wZXJzIiwiaW5zcGVjdG9yVXJsIjoiaHR0cHM6Ly92ZXJjZWwuY29tL3BvcnRvbmUvZGV2ZWxvcGVycy9IaENhU3NLRUpLb0RoeHhpeTdzQ0haUkU3OHdUIiwicHJldmlld1VybCI6ImRldmVsb3BlcnMtZ2l0LWZlYXQtcGxhdGZvcm0tcmVsZWFzZS1ub3RlLXBvcnRvbmUudmVyY2VsLmFwcCIsIm5leHRDb21taXRTdGF0dXMiOiJERVBMT1lFRCIsImxpdmVGZWVkYmFjayI6eyJyZXNvbHZlZCI6MCwidW5yZXNvbHZlZCI6MCwidG90YWwiOjAsImxpbmsiOiJkZXZlbG9wZXJzLWdpdC1mZWF0LXBsYXRmb3JtLXJlbGVhc2Utbm90ZS1wb3J0b25lLnZlcmNlbC5hcHAifSwicm9vdERpcmVjdG9yeSI6bnVsbH1dfQ==
**The latest updates on your projects**. Learn more about [Vercel for Git ↗︎](https://vercel.link/github-learn-more)

| Name | Status | Preview | Comments | Updated (UTC) |
| :--- | :----- | :------ | :------- | :------ |
| **developers** | ✅ Ready ([Inspect](https://vercel.com/portone/developers/HhCaSsKEJKoDhxxiy7sCHZRE78wT)) | [Visit Preview](https://developers-git-feat-platform-release-note-portone.vercel.app) | 💬 [**Add feedback**](https://vercel.live/open-feedback/developers-git-feat-platform-release-note-portone.vercel.app?via=pr-comment-feedback-link) | Apr 8, 2025 10:50am |


author_association: NONE
user: login: sonarqubecloud[bot]
created_at: 2025-04-08T10:33:58Z
body: ## [![Quality Gate Passed](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/checks/QualityGateBadge/qg-passed-20px.png 'Quality Gate Passed')](https://sonarcloud.io/dashboard?id=portone-io_developers.portone.io&pullRequest=851) **Quality Gate passed**  
Issues  
![](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/common/passed-16px.png '') [0 New issues](https://sonarcloud.io/project/issues?id=portone-io_developers.portone.io&pullRequest=851&issueStatuses=OPEN,CONFIRMED&sinceLeakPeriod=true)  
![](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/common/accepted-16px.png '') [0 Accepted issues](https://sonarcloud.io/project/issues?id=portone-io_developers.portone.io&pullRequest=851&issueStatuses=ACCEPTED)

Measures  
![](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/common/passed-16px.png '') [0 Security Hotspots](https://sonarcloud.io/project/security_hotspots?id=portone-io_developers.portone.io&pullRequest=851&issueStatuses=OPEN,CONFIRMED&sinceLeakPeriod=true)  
![](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/common/passed-16px.png '') [0.0% Coverage on New Code](https://sonarcloud.io/component_measures?id=portone-io_developers.portone.io&pullRequest=851&metric=new_coverage&view=list)  
![](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/common/passed-16px.png '') [0.0% Duplication on New Code](https://sonarcloud.io/component_measures?id=portone-io_developers.portone.io&pullRequest=851&metric=new_duplicated_lines_density&view=list)  
  
[See analysis details on SonarQube Cloud](https://sonarcloud.io/dashboard?id=portone-io_developers.portone.io&pullRequest=851)


author_association: NONE