@portone/mcp-server 0.15.0-alpha.5 → 0.16.0

package/assets/docs/platform/ko/guides/dictionary.md

@@ -32,6 +32,10 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
 
 ## **공통 용어**
 
+### 정산
+
+포트원 콘솔에서는 '정산'을 '파트너에게 지급할 금액을 산출하는 과정'으로 정의합니다.
+
 ### 고객사 / 파트너
 
 고객사는 포트원의 결제서비스를 이용하고 있는 포트원의 고객을 의미합니다.
@@ -52,6 +56,18 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
 
 </div>
 
+### 전 영업일
+
+선택한 날짜가 공휴일인 경우, 그 이전의 가장 가까운 영업일을 의미합니다.
+
+### 후 영업일
+
+선택한 날짜가 공휴일인 경우, 그 이후의 가장 가까운 영업일을 의미합니다.
+
+### 달력일
+
+영업일과 관계없이 선택한 날짜를 의미합니다. 주말과 공휴일도 포함됩니다.
+
 ---
 
 ## **정산금 계산 자동화 용어**
@@ -69,6 +85,32 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
 
 소득자(개인 파트너)가 자신의 세금을 직접 납부하지 않고, 원천징수 대상소득을 지급하는 원천징수 의무자(플랫폼사)가 그 금액을 미리 떼어서 대신 납부하는 세금입니다. 원천 징수세는 계약 등록에서 미리 설정할 수 있습니다.
 
+### 정산 파라미터
+
+정산 금액을 계산하기 위해 시스템에 전달되는 데이터 변수들을 의미합니다. 정산 파라미터는 플랫폼 프로모션, 수수료율 등 다양한 요소를 포함할 수 있으며, 이를 기반으로 정산금 계산식을 만들 수 있습니다.
+
+### 정산 시작일
+
+정산 주기를 계산하기 위한 기점이 되는 날짜입니다. 일반적으로 결제 완료 시점 또는 구매 확정 시점으로 설정합니다.
+
+### 정산일
+
+정산금 지급이 가능해지는 시점입니다.
+
+<div class="hint" data-style="Info">
+
+정산일 = 정산 시작일 + 보류일
+
+</div>
+
+### 부가세 부담 주체
+
+플랫폼에서 부과하는 중개 수수료에 대한 부가세의 부담 주체를 의미합니다.
+
+**파트너 부담** : 중개 수수료에 부가세를 별도로 청구합니다. 파트너 정산 금액에서 중개수수료에 대한 부가세를 자동 차감 후 지급합니다.
+
+**우리 회사 부담** : 중개 수수료에 부가세를 포함하여 정산합니다. 즉, 파트너 정산 금액에 영향을 미치지 않습니다.
+
 ---
 
 ## **지급대행 서비스 용어**
@@ -88,6 +130,7 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
 ### 즉시지급(바로지급)과 예약지급
 
 **즉시지급**은 지급 요청 즉시 실시간으로 송금이 실행되는 지급 방식입니다.
+
 **예약지급**은 미래의 특정 시점에 지급이 실행되도록 예약하는 지급 방식입니다. 예약지급은 주말과 공휴일도 포함시켜 달력일로 예약할 수 있습니다.
 
 <div class="hint" data-style="warning">
@@ -138,3 +181,7 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
 - 공급받는자는 지연 수취 가산세로 공급가액의 0.5%가 부과됩니다.
 
 </div>
+
+### 발행 마감일
+
+전자세금계산서법에 따라 세금계산서를 반드시 발행해야 하는 법적 기한입니다. 일반적으로 거래가 발생한 달의 다음 달 10일까지 국세청에 전송되어야 합니다.

package/assets/docs/release-notes/api-sdk/2023-07-03.md

@@ -19,8 +19,8 @@ iOS13 이후 아이패드 기기에서 결제 요청 시 PC 환경의 결제창
 
 ## 기타 수정사항
 
-### ✔️ KG모빌리언스를 통해 신용카드 결제를 이용할 수 있습니다
+### ✔️ KG파이낸셜을 통해 신용카드 결제를 이용할 수 있습니다
 
-KG모빌리언스와 계약을 통해 새로운 결제수단으로 신용카드를 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다.
+KG파이낸셜과 계약을 통해 새로운 결제수단으로 신용카드를 이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이 안내드리겠습니다.
 
-본 기능 설정을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ KG모빌리언스](https://developers.portone.io/docs/ko/pg/payment-gateway/kg)
+본 기능 설정을 위한 자세한 내용은 관련 연동가이드를 확인 바랍니다. [→ KG파이낸셜](https://developers.portone.io/docs/ko/pg/payment-gateway/kg)

package/assets/docs/release-notes/platform/2023-08-31.md

@@ -9,8 +9,8 @@ writtenAt: 2023-09-01T00:00:00.000Z
 
 플랫폼 및 마켓플레이스 사업자가 손쉽게 하위정산 할 수 있는 파트너정산 서비스가 런칭 되었습니다.
 파트너(셀러) 등록, 계약 등록, 정산등록 과 같은 정산의 세밀한 모든 부분을 관리자 콘솔로 관리하세요!
-해당 서비스는 유료 서비스입니다. 문의를 원하시면 신청(<https://platform.contact.portone.io/>)하시면
+해당 서비스는 유료 서비스입니다. 문의를 원하시면 신청(<https://inquiry.portone.io/fs>하시면
 영업일 2일안에 연락드리겠습니다.
 
-[→ 파트너 정산 자동화 서비스 소개](https://portone.io/korea/ko/service/platform)
+[→ 파트너 정산 자동화 서비스 소개](https://portone.io/platform)
 [→ 파트너 정산 자동화 연동가이드 확인하기](https://developers.portone.io/platform/ko/readme)

package/assets/docs/release-notes/platform/2024-08-22.md

@@ -26,17 +26,17 @@ writtenAt: 2024-08-22T00:00:00.000Z
 
 **주문 정산건 생성 요청**
 
-- **`discounts`:[\[CreatePlatformOrderTransferBodyDiscount\[\]\]](/api/rest-v2/type-def#CreatePlatformOrderTransferBodyDiscount)** 할인 정보에 면세 할인 금액 필드가 추가되었습니다.
+- **`discounts`:[\[CreatePlatformOrderTransferBodyDiscount\[\]\]](/api/rest-v2/platform.transfer#CreatePlatformOrderTransferBodyDiscount)** 할인 정보에 면세 할인 금액 필드가 추가되었습니다.
   - **`taxFreeAmount?: integer`** 면세 할인 금액
 
 **주문 취소 정산건 생성 요청**
 
-- **`discounts`:[\[CreatePlatformOrderCancelTransferBodyDiscount\[\]\]](/api/rest-v2/type-def#CreatePlatformOrderCancelTransferBodyDiscount)** 할인 정보에 면세 할인 금액 필드가 추가되었습니다.
+- **`discounts`:[\[CreatePlatformOrderCancelTransferBodyDiscount\[\]\]](/api/rest-v2/platform.transfer#CreatePlatformOrderCancelTransferBodyDiscount)** 할인 정보에 면세 할인 금액 필드가 추가되었습니다.
   - **`taxFreeAmount?: integer`** 면세 할인 금액
 
 **주문 정산건 생성, 주문 취소 정산건 생성 응답**
 
-- **`amount`:[\[PlatformOrderSettlementAmount\]](/api/rest-v2/type-def#PlatformOrderSettlementAmount)** 정산 금액 정보에 필드가 추가되었습니다.
+- **`amount`:[\[PlatformOrderSettlementAmount\]](/api/rest-v2/platform.transfer#PlatformOrderSettlementAmount)** 정산 금액 정보에 필드가 추가되었습니다.
   - **`paymentTaxFree: integer`** 결제 면세 금액
     - 기존 `taxFree`를 대체하는 필드입니다. `taxFree`를 사용하고 계셨다면 `paymentTaxFree`를 대신 사용해 주세요
 
@@ -49,13 +49,13 @@ writtenAt: 2024-08-22T00:00:00.000Z
 
   - **`discountShareTaxFree: integer`** 면세 할인 분담 금액
 
-- **`discounts`:[\[PlatformOrderTransferDiscount\[\]\]](/api/rest-v2/type-def#PlatformOrderTransferDiscount)** 정산 금액 계산 시 사용된 할인 정보에 필드가 추가되었습니다.
+- **`discounts`:[\[PlatformOrderTransferDiscount\[\]\]](/api/rest-v2/platform.transfer#PlatformOrderTransferDiscount)** 정산 금액 계산 시 사용된 할인 정보에 필드가 추가되었습니다.
   - **`taxFreeAmount: integer`** 면세 할인 금액
   - **`shareTaxFreeAmount: integer`** 면세 할인 분담 금액
 
 **정산 상세 내역 다운로드 필드 추가**
 
-- **`fields?`:[\[PlatformTransferSheetField\[\]\]](/api/rest-v2/type-def#PlatformTransferSheetField)** 다운로드 할 시트 필드가 추가되었습니다.
+- **`fields?`:[\[PlatformTransferSheetField\[\]\]](/api/rest-v2/platform.transfer#PlatformTransferSheetField)** 다운로드 할 시트 필드가 추가되었습니다.
   - **`SETTLEMENT_PAYMENT_SUPPLY_AMOUNT`**: 결제 공급가액
     - 기존 `SETTLEMENT_SUPPLY_AMOUNT`를 대체하는 필드입니다. `SETTLEMENT_SUPPLY_AMOUNT`를 사용하고 계셨다면 `SETTLEMENT_PAYMENT_SUPPLY_AMOUNT`를 대신 사용해 주세요
 

package/assets/docs/release-notes/platform/2024-10-21.md

@@ -40,32 +40,32 @@ writtenAt: 2024-10-21T00:00:00.000Z
 
 일괄 지급 내역 다건 조회 응답값이 수정되었습니다.
 
-- **`items`: [PlatformBulkPayout\[\]](/api/rest-v2/type-def#PlatformBulkPayout)** 일괄 지급 내역에 필드가 추가되었습니다.
+- **`items`: [PlatformBulkPayout\[\]](/api/rest-v2/platform.bulkPayout#PlatformBulkPayout)** 일괄 지급 내역에 필드가 추가되었습니다.
   - **`scheduledAt?: string`** 일괄지급 예정일시
-  - **`status`: [PlatformBulkPayoutStatus](/api/rest-v2/type-def#PlatformBulkPayoutStatus)** 일괄지급 상태에 `SCHEDULED` (예약됨) 상태가 추가되었습니다.
+  - **`status`: [PlatformBulkPayoutStatus](/api/rest-v2/platform.bulkPayout#PlatformBulkPayoutStatus)** 일괄지급 상태에 `SCHEDULED` (예약됨) 상태가 추가되었습니다.
 
-- **`counts`: [PlatformBulkPayoutStatusStats](/api/rest-v2/type-def#PlatformBulkPayoutStatusStats)** 일괄지급 상태별 통계에 `scheduled`상태인 일괄지급 건 수가 추가되었습니다.
+- **`counts`: [PlatformBulkPayoutStatusStats](/api/rest-v2/platform.bulkPayout#PlatformBulkPayoutStatusStats)** 일괄지급 상태별 통계에 `scheduled`상태인 일괄지급 건 수가 추가되었습니다.
   - **`scheduled: integer`** 예약된 일괄지급 건 수
 
 #### ✔️ 지급 내역 다건 조회
 
 지급 내역 다건 조회 응답값이 수정되었습니다.
 
-- **`items`: [PlatformPayout\[\]](/api/rest-v2/type-def#PlatformPayout)** 지급 내역에 필드가 추가되었습니다.
+- **`items`: [PlatformPayout\[\]](/api/rest-v2/platform.payout#PlatformPayout)** 지급 내역에 필드가 추가되었습니다.
   - **`scheduledAt?: string`** 지급 예정일시
-  - **`status`: [PlatformPayoutStatus](/api/rest-v2/type-def#PlatformPayoutStatus)** 지급 상태에 `SCHEDULED` (예약됨) 상태가 추가되었습니다.
+  - **`status`: [PlatformPayoutStatus](/api/rest-v2/platform.payout#PlatformPayoutStatus)** 지급 상태에 `SCHEDULED` (예약됨) 상태가 추가되었습니다.
 
-- **`counts`: [PlatformPayoutStatusStats](/api/rest-v2/type-def#PlatformPayoutStatusStats)** 지급 상태별 통계에 `scheduled` 상태인 지급 건 수가 추가되었습니다.
+- **`counts`: [PlatformPayoutStatusStats](/api/rest-v2/platform.payout#PlatformPayoutStatusStats)** 지급 상태별 통계에 `scheduled` 상태인 지급 건 수가 추가되었습니다.
   - **`scheduled: integer`** 예약된 지급 건 수
 
 #### ✔️ 정산 내역 다건 조회
 
 정산 내역 다건 조회 응답값이 수정되었습니다.
 
-- **`items`: [PlatformPartnerSettlement\[\]](/api/rest-v2/type-def#PlatformPartnerSettlement)** 정산 내역에 필드가 추가되었습니다.
-  - **`status`: [PlatformPartnerSettlementStatus](/api/rest-v2/type-def#PlatformPartnerSettlementStatus)** 정산 상태에 `PAYOUT_SCHEDULED` (지급 예약) 상태가 추가되었습니다.
+- **`items`: [PlatformPartnerSettlement\[\]](/api/rest-v2/platform.partnerSettlement#PlatformPartnerSettlement)** 정산 내역에 필드가 추가되었습니다.
+  - **`status`: [PlatformPartnerSettlementStatus](/api/rest-v2/platform.partnerSettlement#PlatformPartnerSettlementStatus)** 정산 상태에 `PAYOUT_SCHEDULED` (지급 예약) 상태가 추가되었습니다.
 
-- **`counts`: [PlatformPartnerSettlementStatusStats](/api/rest-v2/type-def#PlatformPartnerSettlementStatusStats)** 정산 상태별 통계에 payoutScheduled 상태인 정산 내역 건 수가 추가되었습니다.
+- **`counts`: [PlatformPartnerSettlementStatusStats](/api/rest-v2/platform.partnerSettlement#PlatformPartnerSettlementStatusStats)** 정산 상태별 통계에 payoutScheduled 상태인 정산 내역 건 수가 추가되었습니다.
   - **`payoutScheduled: integer`** 지급 예약된 정산 내역 건 수
 
 ---

package/assets/docs/release-notes/platform/2025-02-10.md

@@ -55,8 +55,8 @@ writtenAt: 2025-02-10T00:00:00.000Z
 
 > 영향 API : [정산건 조회](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#get%20%2Fplatform%2Ftransfers%2F%7Bid%7D), [주문 정산건 생성](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#post%20%2Fplatform%2Ftransfers%2Forder), [주문 취소 정산건 생성](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#post%20%2Fplatform%2Ftransfers%2Forder-cancel), [정산건 다건 조회](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#get%20%2Fplatform%2Ftransfer-summaries)
 
-- 사용자 정의 함수 :  [PlatformOrderTransfer](https://developers.portone.io/api/rest-v2/type-def?v=v2#PlatformOrderTransfer).amount.**userDefinedFormulas**
-- 정산 파라미터 : [PlatformOrderTransfer](https://developers.portone.io/api/rest-v2/type-def?v=v2#PlatformOrderTransfer).**parameters**
+- 사용자 정의 함수 :  [PlatformOrderTransfer](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#PlatformOrderTransfer).amount.**userDefinedFormulas**
+- 정산 파라미터 : [PlatformOrderTransfer](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#PlatformOrderTransfer).**parameters**
 
 더 궁금한 점이 있다면 고객 지원팀에 문의해 주세요! 🚀
 

package/assets/docs/release-notes/platform/2026-02-19.md

@@ -0,0 +1,55 @@
+---
+releasedAt: 2026-02-19T00:00:00.000Z
+writtenAt: 2026-02-19T00:00:00.000Z
+---
+
+안녕하세요, 파트너 정산 자동화 팀입니다.
+
+이번 업데이트에서는 세금 계산서 메뉴가 개편되고, 사용성을 대폭 개선하는 거래처 관리 기능을 새롭게 제공합니다. 또한 헬프센터 자주 묻는 질문에 세금계산서 카테고리가 신설되어 관련 안내를 보다 쉽게 찾으실 수 있습니다.
+
+---
+
+## 거래처 관리 기능 신규 제공
+
+세금계산서 정발행·역발행 시 활용할 수 있는 거래처 관리 기능이 추가되었습니다.
+
+"거래처 관리" 메뉴에서 거래처의 사업자 정보를 등록하고 관리할 수 있으며, CSV 또는 엑셀 파일로 일괄 등록도 가능합니다.
+
+일괄 등록 시 사업자 정보 조회 및 휴폐업 상태 조회 실행 여부를 선택할 수 있습니다.
+
+(이미지 첨부: 거래처 관리 화면)
+
+---
+
+## 세금계산서 작성에 따른 연동
+
+세금계산서 작성 시 거래처 검색으로 공급받는자 정보를 간편하게 설정할 수 있습니다. 정발행 시 공급받는자가 거래처로 자동 등록되며, 역발행은 사전에 거래처 등록 및 국세청 연동이 필요합니다. 세금계산서 내역은 거래처 단위 또는 사업자등록번호 기준으로 검색할 수 있고, 일괄 등록 시 거래처 아이디로 자동 매핑됩니다.
+
+(이미지 첨부: 세금계산서 작성 페이지 하단)
+
+---
+
+## 세금계산서 단독 고객사 메뉴 개편
+
+세금계산서 단독 이용 고객사의 관리자 콘솔 메뉴가 아래와 같이 개편되었습니다.
+
+세금계산서 > 세금계산서 작성 / 세금계산서 관리 / 거래처 관리
+
+기존에 파트너 정산 자동화 탭에 있던 세금계산서 관련 기능이 독립 메뉴로 분리되어, 보다 직관적으로 접근할 수 있습니다.
+
+(이미지 첨부: 포트원 관리자 콘솔 메뉴)
+
+---
+
+## 자주 묻는 질문에 세금계산서 탭 신설
+
+헬프센터 자주 묻는 질문에 세금계산서 카테고리가 신설되었습니다. 거래처 관리, 정발행·역발행, 국세청 연동 등 세금계산서 관련 FAQ를 한 곳에서 확인하실 수 있습니다. 기존 파트너 정산 자동화 탭에 있던 세금계산서 관련 FAQ가 새로운 세금계산서 탭으로 이동되었습니다.
+
+(이미지 첨부: 포트원 헬프센터 자주 묻는 질문)
+
+---
+
+작성일자: **2026년 2월 19일**
+
+- 일반 문의: <cs@portone.io> / 채널톡
+- 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널

package/assets/docs/release-notes/platform/2026-03-06.md

@@ -0,0 +1,198 @@
+---
+releasedAt: 2026-03-06T00:00:00.000Z
+writtenAt: 2026-03-06T00:00:00.000Z
+---
+
+안녕하세요, 포트원 파트너 정산 자동화팀 입니다.
+
+파트너 정산 자동화 제품에 대한 전반적인 사용성 개선과 안정화에 대한 업데이트가 진행됨에 따라 업데이트 사항을 안내해 드립니다.
+
+---
+
+## 정산 상세 내역의 상태 라벨 개선
+
+정산 상세 내역에서 상태의 명칭이 불명확한 부분을 개선하였습니다.
+
+|기존     |신규     |설명                                                            |
+|---------|---------|----------------------------------------------------------------|
+|정산 예정|정산 예정|정산 시작일에 도래하지 않아 아직 금액 및 정산일 확정이 안된 경우|
+|정산 중  |정산 중  |정산 시작일을 지나 정산 금액 및 정산일이 확정된 상태            |
+|정산 완료|정산 확정|정산일이 지나 지급 가능한 상태                                  |
+|N/A      |지급 확정|특정 지급건에 집계되어 이체 가능한 상태                         |
+|이체 중  |지급 중  |지급이 예약되어 있거나 지급이 진행중인 상태                     |
+|이체 완료|지급 완료|지급 및 정산이 완료된 상태                                      |
+
+(이미지 첨부: 정산 상세 내역 상태 라벨 개선 화면)
+
+---
+
+## 정산 상세 내역 및 정산 내역 삭제 기능 지원
+
+정산 내역 및 정산 상세 내역에 특정 상태인 데이터 삭제가 콘솔 및 API로 제공됩니다.
+
+### 삭제 가능한 상태
+
+- 정산 상세 내역(주문/수기 정산건): **정산 예정, 정산 중, 정산 확정**
+- 정산 내역: **지급 예정, 지급 보류, 지급 취소, 지급 제외**
+
+### 유의 사항
+
+- 삭제된 데이터에 대한 복원은 불가능합니다.
+- 정산 내역 건별 삭제 시 연관된 정산 상세 내역(주문/수기정산건)이 삭제 가능하다면 함께 삭제됩니다.
+
+(이미지 첨부: 정산 내역/상세 내역 삭제 기능 (1))
+
+(이미지 첨부: 정산 내역/상세 내역 삭제 기능 (2))
+
+---
+
+## 정산 내역 지급 예정 상태로 복원 시 오류 해결
+
+기존 지급 보류/지급 실패 상태에서 지급 예정 상태로 변경 시 오류가 발생하였으나 해당 부분이 해결되었습니다.
+
+위 오류는 상태 변경 과정에서 같은 집계 조건의 지급 예정 상태의 내역이 추가 생성된 경우 발생하는 오류로, 현재는 지급 예정 상태의 내역을 **중복 적재 가능**하게 개선하였습니다.
+
+(이미지 첨부: 지급 예정 복원 오류 개선)
+
+---
+
+## 비활성화 가상 계좌 노출 지원
+
+더즌 계좌 변경 안내에 따라서 신규 계좌 발급이 완료되었습니다. 다만 기존 계좌의 내역 조회를 지속 지원해드리기 위해 비활성 상태로 계좌 노출이 지원됩니다.
+
+### 안내 사항
+
+- 비활성 계좌도 이전 입출금 내역에 대해 확인하실 수 있습니다.
+- 비활성 계좌는 출금/지급 시 활용할 수 없으며, 잔액 조회가 불가합니다.
+
+(이미지 첨부: 비활성화 가상 계좌 노출)
+
+---
+
+## 출금 시 입금 계좌 예금주 저장
+
+기존 예치금 출금 시 조회된 입금 계좌 예금주가 이체 내역에 반영되지 않던 부분을 개선하였습니다. 배포 이후로 진행되는 모든 출금 건들에 대해서 입금 대상 계좌에 대한 예금주 정보가 저장됩니다.
+
+---
+
+## 이체 속도 개선
+
+현재 이체 프로세스를 개선하여 기존보다 **3배 더 많은 이체 건**들을 병렬 처리할 수 있게 되었습니다.
+
+(이미지 첨부: 이체 속도 개선)
+
+---
+
+## 정산 내역 ‘지급 제외’ 상태 추가
+
+정산 내역 중 영구적으로 지급을 제외할 데이터를 관리하기 위한 “지급 제외” 상태를 추가합니다.
+
+- 지급 보류/취소/예정 상태와 별개로 정산 내역에 “지급 제외” 상태가 추가됩니다.
+- “지급 제외” 상태는 지급이 불가능한 상태입니다. (지급 내역 확정 시 자동 제외됩니다.)
+- “지급 제외” 상태는 “지급 보류 / 지급 예정” 상태로 변경할 수 있습니다.
+- “지급 보류 / 취소 / 예정” 상태에서 “지급 제외” 상태로 변경할 수 있습니다.
+
+(이미지 첨부: 정산 내역 ‘지급 제외’ 상태)
+
+---
+
+## 세금계산서 기능 개선
+
+- 거래처 관리 엑셀 다운로드 시 주소/업태/업종 데이터가 추가됩니다.
+- ‘요청’ 상태의 세금계산서를 회수 없이 메일 주소만 변경하여 재전송 가능하도록 개선됩니다.
+- 세금계산서 메뉴에서 상태값 외 다른 항목(예: 발행일, 금액 등)으로도 필터 및 정렬(오름/내림차순) 가능하도록 개선됩니다.
+- 세금계산서 내역 관리에서 체크박스 일괄 ‘발행취소, 삭제, 재전송’ 기능이 가능하도록 개선됩니다.
+
+---
+
+## API 변경 사항 안내
+
+### A. 정산 내역 삭제 API 제공
+
+오등록되거나 재등록이 필요한 정산 데이터를 삭제하기 위해서 정산 내역 단위 삭제 API가 제공됩니다.\
+해당 정산 내역을 삭제하시게 되면 연관된 정산 상세 내역 데이터와 함께 삭제가 진행되므로 유의하여 활용해주시길 바랍니다.
+
+```http
+POST /platform/partner-settlements/delete?test=false
+Content-Type: application/json
+
+{
+  "partnerSettlementIds": []
+}
+```
+
+- _해당 API는 unstable 입니다._
+
+---
+
+### B. 정산 내역 일괄 지급 처리 API 제공
+
+외화 정산 내역의 경우에는 현재 지급 대행 등이 제공되지 않아 지급 건을 수기 보정 요청주시던 부분에 대해서 직접 보정이 가능하도록 API를 제공합니다.
+해당 API를 활용하시면 자동적으로 일괄 지급 / 지급 내역 등을 생성하여 지급 완료 상태로 데이터가 보정됩니다.
+
+```http
+POST /platform/partner-settlements/complete-payout?test=false
+Content-Type: application/json
+
+{
+  "bulkPayoutId": "",
+  "name": "",
+  "partnerSettlementIds": [],
+  "completeAt": "2026-02-01"
+}
+```
+
+- _해당 API는 unstable 입니다._
+
+---
+
+### C. 주문 정산 / 주문 취소 정산 / 수기 정산 등록 시 id 직접 지정 가능
+
+중복 등록 방지 및 고객사 자체 아이디 매핑을 위해 주문/주문 취소/수기 정산 등록 시 id 필드를 직접 지정할 수 있습니다.
+id 필드가 지정되지 않은 경우에는 자동 생성되며 기존과 같이 활용하실 수 있습니다.
+
+```http
+POST /platform/transfers/manual
+POST /platform/transfers/order
+POST /platform/transfers/order-cancel
+
+Content-Type: application/json
+
+{
+  "id": "custom-id"
+  // ... 기존 API 명세
+}
+```
+
+참고: order-cancel 의 경우 transfer\_id 와 id 가 동시에 존재하는데, transfer\_id 는 기존과 같이 취소 대상 원본 주문 정산 건에 대한 식별자입니다.
+
+---
+
+### D. 정산 상세 다건 조회 API 사용자 정의 속성 검색 지원 및 성능 개선
+
+정산 상세 내역 조회 시 사용자 정의 속성에 대한 지원이 추가됩니다. 접두사 일치로 검색이 지원됩니다.
+
+```http
+POST /platform/transfer-summaries
+Content-Type: application/json
+
+{
+  "filter": {
+    "userDefinedProperty": {
+      "key": "USER DEFINED KEY",
+      "value": "exact match"
+    }
+  }
+  // ...
+}
+```
+
+또한 정산 상세 다건 조회 시 파트너 정보 조회 비용을 최적화하여 조회 성능을 개선하였습니다.
+P50 기준 내부 테스트 결과 **60% 이상의 latency 감소**가 확인되었습니다.
+
+---
+
+작성일자: **2026년 3월 3일**
+
+- 일반 문의: <cs@portone.io> / 채널톡
+- 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널