@portone/mcp-server 0.13.0

package/assets/docs/help/admin-console/pg-settlement/content30.md

@@ -0,0 +1,352 @@
+---
+title: PG 거래대사 가이드
+category: 관리자콘솔 (관리자콘솔 사용 가이드) > PG 거래대사 > PG 거래대사
+seo:
+  title: PG 거래대사 가이드
+  description: >-
+    거래데이터와 정산데이터를 매핑하여 한 번에 정보를 확인하실 수 있는 포트원의 통합조회 서비스를 소개합니다. PG사와 간편결제사로부터
+    정산받는 금액과 상세내역 등을 포트원 관리자콘솔에서 한 번에 조회 및 다운로드하실 수 있습니다.
+  keywords:
+    - PG 거래대사
+    - 결제사 정산
+    - 관리자콘솔
+tags:
+  - PG거래대사
+pgCompanies:
+  - KG이니시스
+  - 나이스페이먼츠
+  - NHN KCP
+  - 토스페이먼츠
+  - 헥토파이낸셜
+  - 토스페이
+  - 다날
+  - 엑심베이
+  - 페이코
+  - 네이버페이(결제형)
+  - 카카오페이
+searchTags:
+  - 거래건별조회
+  - 거래정산
+  - 건별 조회
+  - 거래조회
+  - 거래내역
+  - PG정산
+  - 결제사 정산
+  - PG 거래대사
+  - 거래대사
+  - 정산데이터
+  - 정산내역
+  - 결제정산
+  - 정산
+---
+
+## **PG 거래대사**
+
+### **0.서비스 소개**
+
+> PG 거래대사 서비스에서는 포트원을 통해 연동된 아래 15개의 PG사 내역을 조회할 수 있습니다.
+
+- KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, UPLUS((구)토스페이먼츠), 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜, KSNET, KPN, 하이픈, 페이팔
+
+> 대사 서비스를 사용하기 위해 결제 연동 시 <Highlight text="임의 데이터가 아닌 실제 사용하는 주문번호로 연동" />이 필요합니다.
+
+> 정산 조회 동의를 한 이후부터 서비스를 이용하실 수 있습니다.
+
+> 네이버페이 정산 데이터를 확인하기 위해서는 정산 API 키 등록이 필요합니다.
+
+- **정산 API 키 등록 방법**\
+  1\) [네이버페이센터](https://admin.pay.naver.com/) → 내정보 → 가입정보 변경 메뉴에서 정산 API 인증키 정보 확인\
+  2\) [포트원 콘솔](https://admin.portone.io/auth/signin) → 결제 연동 → 연동 정보 → 네이버페이 선택 후 정산용 사이트 키(API Key) 입력
+
+
+
+### **1. 기능 소개**
+
+#### **거래 대사**
+
+<Indent level="1">
+
+- 포트원을 통해 연동된 고객사 주문 데이터와 PG사의 결제 정보를 자동 비교 / 대사하여 거래 이상 건수 및 금액을 쉽게 확인할 수 있습니다.
+  - 거래일 기준으로 포트원 거래 데이터와 PG사 거래 데이터를 자동 대사합니다.
+  - 다양한 PG사와 결제수단, 통화를 통합하여 일관된 기준으로 거래 및 정산 데이터를 제공합니다.
+
+</Indent>
+
+#### **정산 내역 확인**
+
+<Indent level="1">
+
+- 정산금의 상세 내역을 확인할 수 있는 자료를 제공합니다.
+  - 정산일 기준으로 정산 금액이 어떤 거래 데이터들로 이루어져 있는지 쉽게 확인할 수 있습니다.
+  - 미래 정산금액 / 일자를 확인하여 현금 흐름 예측에 활용할 수 있습니다.
+
+</Indent>
+
+### **2. 메뉴별 기능 상세 설명**
+
+### **2.1 거래 정산내역**
+
+포트원에 적재된 거래일 기준 고객사 거래데이터, 혹은 정산일 기준 정산데이터를 확인할 수 있습니다.
+
+<Indent level="1">
+
+- “거래내역”에서는 거래일 기준으로 데이터가 조회됩니다.\[**` PG 어드민 기준`]**
+- “정산내역”에서는 정산일 기준으로 데이터가 조회됩니다.
+
+</Indent>
+
+#### **거래 내역 서비스 설명**
+
+**포트원에 적재된 고객사 거래 데이터와 PG 거래 데이터를 비교하여 (거래 대사) 이상 거래 건에 대한 요약 정보를 확인할 때 용이합니다**
+
+<Callout icon="💡" title="참고사항" content="대사상태 : **대사 일치, 대사 불일치, 대사 불능**" />
+
+<Highlight url="#10_3.-부연-설명" text="대사 상태 관련 개념 보러가기 ↓" />
+
+
+
+<Highlight text="① 조회 기간 설정 " />
+
+- 시작일과 종료일을 직접 입력하여 조회할 수 있습니다.
+- 캘린더를 통해서도 직접 조회 기간 설정할 수 있습니다.
+
+
+
+- 조회 기간은 최대 6개월까지 조회가 가능합니다.
+- 날짜 Preset 버튼을 눌러 원하는 조회 기간 범위를 쉽게 설정할 수 있습니다.
+  - 오늘 / 어제 / 지난주 / 지난달 / 이번달 / 3개월
+
+<Highlight text="② 요약대시보드  " />: 조회한 거래 결과의 요약을 확인할 수 있습니다.
+
+- 조회기간, 상점 아이디, PG 고객 식별아이디의 필터가 결과값에 반영됩니다
+- 외화의 경우, 통화를 선택하여 통화별로 확인하실 수 있습니다.
+  - 외화는 KRW(원화)로 환산하지 않으며 모든 통화에 대해서 지원합니다.
+
+<Highlight text="③ 표 설정  " /> : 표에서 확인할 항목을 커스터마이징 할 수 있습니다.
+
+- 기본 설정은 모두 선택이 되어 있는 상태입니다.
+- 선택 가능한 설정 값 : 거래일, 대사상태, 상점아이디, PG 고객 식별아이디, 거래건 수, 거래 금액, 대사 불일치 건수, 대사 불일치 금액, 대사 불능 건수, 대사 불능 금액
+
+<Highlight text="④ 부가세 참고 자료 다운로드 " />
+
+
+
+- 부가세 신고시, 참고 자료로 활용할 수 있는 엑셀 자료를 다운받을 수 있습니다.
+- 거래일 기준으로 조회 기간 내에 발생한 거래 데이터를 MID별로 선택하여 엑셀을 다운받을 수 있습니다.
+
+<Highlight text="⑤ 필터 초기화 " /> : 각 칼럼별로 존재하는 필터를 설정한 이후에 일괄 초기화할 수 있는 버튼입니다.
+
+<Highlight text="⑥ 데이터 테이블 " /> : 거래일 기준으로 데이터를 조회할 수 있습니다.
+
+- 거래일 : PG 거래 데이터의 거래 일자를 기준으로 확인 가능하며, 동일한 거래 일자에 PG 고객 식별아이디로 하위 그룹핑된 데이터들을 함께 확인할 수 있습니다.
+
+
+
+<Indent level="1">
+
+a. 상위 & 하위 항목을 클릭할 경우 해당 일자의 모든 거래건 혹은, 개별 PG식별아이디에 대한 상세 내역을 `거래 건별 조회 메뉴로 이동`하여 `거래일 기준`으로 상세 거래 내역 확인이 가능합니다.
+
+b. 거래일자가 같더라도 통화가 다를 경우 열을 구분하여 표시합니다.
+
+</Indent>
+
+- 대사상태 : 포트원에 연동된 고객사 주문 데이터와 PG사의 결제 정보를 대사한 상태값을 의미합니다.
+
+<Indent level="1">
+
+a. 거래이상 : 대사불일치나 대사불능이 1건이라도 있는 경우
+
+b. 대사일치 : 모든 거래 데이터가 대사 일치하는 경우
+
+</Indent>
+
+- 상점 아이디 : 포트원을 사용하기 위해 설정한 상점을 구분하기 위한 값을 의미합니다.
+- PG 고객 식별아이디 : PG 사에서 고객을 구분하기 위해 생성하는 고유한 값을 의미합니다.
+- 거래건 수 : 해당 거래일자에 취소를 포함하여 발생한 총 거래건 수를 의미합니다.
+- 거래 금액 : 해당 거래일자에 취소를 포함하여 발생한 총 거래 금액을 의미합니다.
+- 대사 불일치 건수 : 해당 거래일자에 발생한 총 대사 불일치 건수를 의미합니다.
+- 대사 불일치 금액 : 해당 거래일자에 발생한 총 대사 불일치 금액을 의미합니다.
+- 대사 불능 건수 : 해당 거래일자에 발생한 총 대사 불능 건수를 의미합니다.
+- 대사 불능 금액 : 해당 거래일자에 발생한 총 대사 불능 금액을 의미합니다.
+
+<Highlight text="※ 거래 이상 : 대사불일치, 대사불능인 거래를 의미합니다." />
+
+<Highlight text="⑦ 상세" /> : 상세 버튼을 누르면 해당 일자 및 PG 고객 식별 아이디 기준에 따른 모든 거래 데이터들을 건별로 조회할 수 있는거래 건별 조회 메뉴로 이동합니다.
+
+#### **정산 내역 서비스 설명**
+
+PG 정산 데이터를 바탕으로 포트원에 적재된 고객사 거래 데이터를 맵핑하여정산 받은 금액이 어떤 거래 건으로 이루어져있는지 확인하거나 미래에 받을 정산 금액 확인을 할 때 유용하게 사용 가능합니다.
+
+<Callout icon="💡" title="참고사항" content="당일 정산 데이터의 경우 정산 예정으로 표시됩니다. " />
+
+
+
+<Highlight text="① 요약대시보드" /> : 조회한 거래 결과의 요약을 확인할 수 있습니다.
+
+- 조회기간, 상점 아이디, PG 고객 식별아이디의 필터가 결과값에 반영됩니다.
+- 총 정산건수와 총 정산금액 : 설정한 조건으로 조회한 총 정산 건수와 정산 금액을 확인할 수 있습니다.
+- 총 정산 예정 건수와 총 정산 금액 : 설정한 조건으로 조회한 총 정산 예정 건수와 정산 예정 금액을 확인할 수 있습니다.
+- 외화의 경우, 통화를 선택하여 통화별로 확인하실 수 있습니다.
+  - 외화는 KRW(원화)로 환산하지 않으며 모든 통화에 대해서 지원합니다.
+  - KRW로 환산하지 않기 때문에 거래일자가 같더라도 통화가 다를 경우 열을 구분하여 표시합니다.
+
+<Highlight text="② 데이터 테이블" />
+
+- 정산일 : PG 정산 데이터의 정산 일자를 기준으로 확인 가능하며, 동일한 정산일자에 PG 고객 식별아이디로 하위 그룹핑된 데이터들을 함께 확인할 수 있습니다.
+
+
+
+<Indent level="1">
+
+a.상위 & 하위 항목을 클릭할 경우 해당 일자의 모든 거래건 혹은, 개별 PG식별아이디에 대한 상세 내역을 거래 건별 조회 메뉴로 이동하여 정산일 기준으로 상세 거래 내역 확인이 가능합니다.
+
+</Indent>
+
+- 상점 아이디 : 포트원을 사용하기 위해 설정한 상점을 구분하기 위한 값을 의미합니다.
+- PG 고객 식별아이디 : PG 사에서 고객을 구분하기 위해 생성하는 고유한 값을 의미합니다.
+- 정산건 수 : 해당 정산일자에 입금되어야하는 총 정산건 수를 의미합니다.
+- 정산 금액 : 해당 정산일자에 입금되어야하는 총 정산 금액을 의미합니다.
+- 취소건 수 : 해당 정산일자에 발생한 총 취소건 수를 의미합니다.
+- 취소 금액 : 해당 정산일자에 발생한 총 취소 금액을 의미합니다.
+- PG 수수료 : 해당 정산일자에 부과되는 총 PG 수수료 금액을 의미합니다.
+- PG 수수료 부가세 : 해당 정산일자에 부과되는 총 PG 수수료 부과세 금액을 의미합니다.
+
+<Highlight text="③ 부가세 참고 자료 다운로드" />
+
+
+
+- 부가세 신고시, 참고 자료로 활용할 수 있는 엑셀 자료를 다운받을 수 있습니다.
+- 정산일 기준으로 조회 기간 내에 발생한 거래 데이터를 MID별로 선택하여 엑셀을 다운받을 수 있습니다.
+
+### **2.2 거래 건별 조회**
+
+포트원에 적재된 고객사 거래정산데이터 상세내역을 확인할 수 있으며\
+1\) 거래 대사 이후 각 이상 거래 건에 대한 자세한 정보 확인이 필요하거나\
+2\) 일정 기간 동안 정산 받은 금액이 어떤 거래 건으로 이루어져있는지 확인이 필요한 경우에\
+유용하게 사용 가능합니다.
+
+
+
+<Highlight text="① 검색" /> : 검색하고자 하는 내용과 정확히 일치하는 입력값을 입력해야 검색이 가능합니다.
+
+- 검색 가능 조건
+  - 주문명
+  - PG 거래 번호
+  - 고객사 거래 번호
+  - 포트원 거래 번호
+
+<Highlight text="② 조회 기준일" /> : 거래일/정산일을 선택할 수 있습니다.
+
+<Highlight text="③ 데이터 테이블" />
+
+- \*\*확인 가능한 데이터 \*\*: 대사상태 / 거래구분 / 거래일 / 정산일 / 상점 아이디 / PG 고객 식별아이디 / 고객사 주문번호 / PG 결제번호 / 포트원 결제번호 / 거래유형 / 거래 금액 / 공급가액 / 면세가액 / 부가세 / PG 수수료 / PG 수수료 부가세 / 정산 금액 / 거래 이상 금액 / 에스크로
+- **대사상태** : 대사일치 / 대사불일치 / 대사불능 / 수집전거래
+- **거래구분** : 승인 / 취소 / 부분취소 / 기타취소 / 정산후보정
+
+<Callout icon="💡" content="기타 취소 : 전체 취소인지 부분취소인지 식별할 수 없는 취소 건(unclassified cancel)
+정산후보정 : 승인/취소와 별개로 정산금액 수정사항을 반영한 건
+1) KCP - 매입반송/해제 
+2) 페이코 - 쿠폰 광고 수수료" title="참고사항" />
+
+- 거래유형 : 카드 / 간편결제 / 간편결제 충전 / 계좌이체 / 가상계좌 / 모바일 / 상품권 / ARS / 기타
+
+<Highlight text="※ 거래 유형에 따라 표시되는 상세 정보 확인 보러가기 ↗" url="https://help.portone.io/category/admin-console/pg-settlement#11_%EA%B1%B0%EB%9E%98-%EC%9C%A0%ED%98%95-%EC%83%81%EC%84%B8-%EC%A0%95%EB%B3%B4" />
+
+- 거래 금액(PG) - 거래 금액(포트원)
+
+
+
+<Indent level="1">
+
+a. 대사 불능 : 데이터가 없는 경우에 노란색 글씨로 표시
+
+b. 대사 불일치 : PG 데이터를 원천 데이터로 보고 금액의 차이를 거래 금액(포트원)에 표시
+
+- PG 거래 데이터 금액(1,000)원 - 포트원 거래 데이터 금액(500원)인 경우
+  - 거래 금액 (포트원)에 차이나는 만큼 금액 +/- 표시 (-500)
+- PG 거래 데이터 금액(500)원 - 포트원 거래 데이터 금액(1,000원)인 경우
+  - 거래 금액 (포트원)에 차이나는 만큼 금액 +/- 표시 (+500)
+
+</Indent>
+
+### **3. 부연 설명**
+
+<Callout icon="💡" content="각 칼럼에 표시되는 데이터의 수식을 확인하실 수 있습니다." title="참고사항" />
+
+#### **거래 유형 상세 정보**
+
+##### 거래 유형에 마우스오버시 카드 형태로 상세 정보가 보여집니다.
+
+<Indent level="1">
+
+- 카드  :  발급사, 매입사, 카드 승인번호, 카드 할부개월수
+- 상품권 : 타입, 승인번호
+- 계좌이체 : 은행이름, 승인번호
+- 가상계좌 : 은행이름, 승인번호
+- 간편결제 : 간편결제사 이름
+- 모바일 결제 : 통신사
+- 기타 : 기타
+
+</Indent>
+
+#### **대사 상태값 정리**
+
+<Indent level="1">
+
+- 대사 일치 : 대사하였을 때 PG 거래 데이터와 고객사 거래 데이터의 차이가 없이 일치하는 경우를 의미합니다.
+- 대사 불능 : 대사하였을 때 PG사나 고객사 중 어느 한 쪽의 데이터가 없어서 비교할 수 없는 경우를 의미합니다.
+- 수집전거래 : 오래된 거래 건이 늦게 정산되어, PG사에서 수집 가능한 거래정보가 없는 경우를 의미합니다.
+  (PG 거래 데이터 ↔ PG 정산 데이터 비교 후 거래 데이터가 누락되어 있는 경우)
+- 대사 불일치 : 대사 불일치의 경우는 아래와 같이 정리할 수 있습니다.
+
+</Indent>
+
+<Indent level="2">
+
+<대사 불일치 상태값 사유 및 설명>
+
+- 결제 금액 불일치 : 두 원장의 결제 금액이 불일치합니다.\
+  (금액 차이가 있으면 무조건 불일치로 표시)
+- 면세 금액 불일치 :  두 원장의 면세금액이 불일치합니다. \
+  (금액 차이가 있으면 무조건 불일치로 표시)
+- 부가세 금액 불일치 : 두 원장의 부가세 금액이 불일치합니다. \
+  (금액 차이가 있으면 무조건 불일치로 표시)
+- 에스크로 여부 불일치 : 두 원장에서 에스크로(안전결제)여부가 불일치합니다. (Y/N 다르면 불일치 표시)
+- 할부 개월 수 불일치 : 두 원장의 카드 할부개월 수가 불일치합니다. \
+  (할부개월수 다르면 불일치 표시)
+- 결제일자 불일치 :두 원장의 결제일시가 불일치합니다. 시스템으로 인해 차이날 수 있는 근소한 차이의 경우는 일치로 처리합니다. \
+  (두 원장의 결제일시가 다른 일자에 일어나면 불일치 표시)\
+  (자정 기점으로 PG<>포트원 전송시간에 의해 거래일자가 변경되는 경우도 다른 일자일 경우 불일치 표시)
+
+</Indent>
+
+#### **각 테이블별 계산 수식**
+
+<Indent level="1">
+
+- 거래 건수 : 조회기간 내 (승인) 건수
+- 거래 금액 : 조회기간 내 (승인) 금액
+- 취소 건수 : 조회기간내 (취소) + (부분취소) + (기타취소) 건수
+- 취소 금액 : 조회기간 내 (취소 금액) + (부분취소) + (기타취소) 금액
+- 정산건수 : 조회기간 내 거래건수 - 취소건수 + 기타정산건(수집이전거래건수; 승인과 취소, 부분 취소 데이터가 없는 정산 데이터)
+- 정산금액 : 조회기간 내 거래금액 - 취소금액 - PG 수수료 - PG 수수료 VAT
+- 공급가액 : 거래 금액 - 할인 금액 - 면세가액 - 부가세 \
+  (과세사업자 면세가액=0)
+- 부가세 :  (거래 금액-면세가액)/11 후 반올림
+  (과세사업자 면세가액=0)
+- 거래 이상금액 : 거래불일치 금액 절대값 + 거래대사 불능금액
+- PG 수수료 부가세 : PG사에서 값을 주지 않을 경우 PG수수료/10 후 반올림
+
+</Indent>
+
+<Callout icon="💡" title="FAQ" content="1. 과거 데이터 조회 기준은 ?
+→ 최대 6개월까지 가능합니다.
+
+2. 실시간 데이터 업데이트가 가능한가요? 아니면 일별 업데이트인가요?
+→ PG 사 마감 데이터를 가져와야 하므로 전날 기준 거래, 정산데이터를 가져와서 일별 업데이트를 진행하고 있습니다.
+
+3. 복합 결제(예: 신용카드+포인트)의 경우, 데이터 처리는 어떻게 이루어지나요?
+→ 별도로 구분되지 않고 간편결제로 표시됩니다.
+
+4. 환불, 부분 취소 등의 예외 케이스는 어떻게 처리되나요?
+→ 거래 상태값에 부분취소, 취소로 처리되고 있습니다." />

package/assets/docs/help/admin-console/platform-settlement/content33-1.md

@@ -0,0 +1,201 @@
+---
+title: 파트너 정산 자동화 서비스 가이드 2
+category: 관리자콘솔 (관리자콘솔 사용 가이드) > 파트너 정산 자동화 > 파트너 정산 자동화
+seo:
+  title: 파트너 정산 자동화 가이드
+  description: >-
+    재무, 개발 공수를 획기적으로 줄여주는 포트원의 파트너정산 자동화 서비스를 소개합니다. 간단한 API 연동과 관리자 콘솔을 통해 고객사
+    자체 개발에 드는 많은 비용과 시간의 절감이 가능합니다.
+  keywords:
+    - 관리자콘솔
+    - 파트너정산자동화
+    - 파트너정산
+tags:
+  - 공통
+  - 파트너 정산 자동화
+pgCompanies:
+  - 공통
+searchTags:
+  - 파트너계약
+  - 정산정책
+  - 할인수수료정책
+  - 할인수수료
+  - 수수료등록
+  - 추가수수료정책
+  - 수식관리
+  - 파트너관리
+  - 파트너추가
+  - 정산내역
+  - 할인분담금
+  - 할인정책
+  - 파트너분담률
+  - 하위정산
+  - 정산자동화
+  - pg지급이체
+  - 지급이체
+  - 매출정산자동화
+  - 파트너정산
+  - 파트너 정산
+  - 정산
+  - 파트너 정산 자동화
+datetime: 2025-06-18T07:47:13.455Z
+---
+
+### **서비스 소개**
+
+#### **1. 요약**
+
+파트너 정산 자동화 서비스는 플랫폼, 마켓 플레이스, 커머스 사업을 위한 포트원만의 재무 서비스 모듈로 국내 최초로 개발되었습니다. 파트너에게 지급되어야 하는 정산 금액을 자동으로 계산하고 세금계산서, 송금(지급이체)까지 자동화함으로써 재무팀과, 운영팀, 개발팀 모두의 리소스를 획기적으로 절감할 수 있습니다. API 연동 및 포트원 관리자 콘솔을 통한 노코드 연동 모두 지원됩니다.
+
+#### **2. 핵심 기능**
+
+1. 개인 및 사업자 유형에 따라 다양한 정산 정책을 등록하고 관리할 수 있습니다.
+2. 파트너를 대량으로 등록하고 손쉽게 관리할 수 있습니다.
+3. 파트너별 정산 정책을 자동으로 매칭시켜서 정산 주기에 맞게 정산금을 자동으로 계산합니다.
+4. 사업자 대상 세금계산서 역발행 요청 기능을 제공합니다.
+5. 계산된 정산금을 클릭 한 번으로 송금 및 이체 처리할 수 있습니다.
+6. 가상계좌의 입출금 내역을 실시간으로 확인할 수 있습니다.
+
+#### **3. 용어 설명**
+
+- 정산 서비스 이용에 참고하실 수 있는 [용어별 설명 가이드 보러가기↗](https://developers.portone.io/platform/guides/dictionary)를 안내드립니다.
+
+### 상세 이용 가이드
+
+
+
+#### 1. 정산정책관리
+
+<Tag text="계약관리" />
+
+**자동으로 정산데이터가 생성될 수 있도록 계약을 추가해주세요.**
+
+- **중개수수료 설정**
+  - 정률 (%) / 정액 (₩) 선택하여 설정가능
+  - 부가세를 파트너에서 부담할지 설정가능
+- **정산주기 설정**
+  - 지체일 : 매출 1일, 정산 2일
+    - 매출(결제)이 발생된 이후 홀드하고 있어야 하는 기간
+  - 정산일 주기 설정
+    - 매월 / 매주 / 매일 / 매년
+    - N일 정산
+  - **기준일 설정**
+    - 전 영업일 / 후 영업일 / 달력일 중 선택가능
+  - **아이디 생성 및 메모**
+    - 아이디 생성 : 설정하신 계약에 대한 아이디를 부여합니다. 원하는 아이디로 설정하거나, 난수의 식별번호로 생성하실 수도 있습니다.
+    - 메모 : 계약에 대한 메모 설정
+
+<Tag text="할인 분담 정책" />
+
+정산 처리 시 진행하고 있는 프로모션 할인 비율을 적용할 수 있습니다.
+
+- 할인 정책 아이디 : 설정할 할인정책을 구분할 아이디를 설정해주세요.
+- 파트너 분담률 : 포인트 및 쿠폰으로 인한 할인금액에 대해서 파트너가 부담하기로 한 비율입니다.
+- 메모 등록
+
+<Tag text="추가 수수료 정책" />
+
+**정산 건에 추가 수수료가 적용될 경우 등록하신 아이디를 전달해주셔야 합니다**
+
+- 추가 수수료 아이디 : 추가하실 수수료 정책을 구분할 아이디를 설정해주세요.
+- 추가 수수료 정보 : 정률(%) / 정액(₩)
+- 부가세 분담 주체 : 파트너 부담 or 우리 회사 부담
+- 메모 등록
+
+<Tag text="계산관리" />
+
+**아래 수식은 API 호출을 통해서 사용이 가능합니다.**
+
+- 플랫폼 중개 수수료 수식
+  - 사용가능 변수: 주문금액, 결제금액, 결제금액부가세, 결제금액부가세 부담금, 할인금액, 할인부담금, 정액(정액 플랫폼 중개 수수료), 정률(정률 플랫폼 중개 수수료)
+- 할인 분담금 수식
+  - 사용가능 변수: 할인금액, 정률(할인 분담률)
+- 추가 수수료 수식
+  - 사용가능 변수: 주문금액, 결제금액, 결제금액부가세, 결제금액부가세 부담금, 할인금액, 할인부담금, 플랫폼중개수수료, 플랫폼중개수수료부가세 부담금, 정액(정액 추가 수수료), 정률(정률 추가 수수료)
+- 사용자 정의 수식
+  - 플랫폼 정책에 맞는 맞춤형 정산 수식 작성 가능
+- 수식 테스트
+  - 실제 적용 전 예상 정산금액 미리 검증 가능
+- 전체 수식 계산식
+  - 정산 금액 = 주문 금액 - 결제금액부가세 부담금 -중개 수수료- 중개수수료부가세 부담금 -추가 수수료 - 추가수수료부가세 부담금 - 할인 부담금
+
+#### 2. 파트너 관리
+
+**정산이 이루어질 파트너를 등록합니다.**
+
+
+
+<Tag text="파트너 추가" />
+
+파트너 추가 기능은 포트원 관리자콘솔에서 수동처리 및 API 호출로 가능합니다.
+
+- 정산 대상 설정
+  - 사업자 정보 및 이름을 입력합니다.
+  - 원천징수 대상자/비대상자 유형을 선택합니다.
+  - 과세 유형을 설정합니다. (일반과세, 간이과세, 면세사업자)
+- 계좌정보
+  - 정산데이터가 생성될 정산받을 대상의 계좌정보를 설정합니다.
+  - 이 때 1번에 등록한 계약 건과 연동합니다.
+  - 예금주 조회를 통한 계좌 유효성을 자동 검증합니다.
+- 사업자 검증
+  - 휴폐업 상태를 자동 조회 할 수 있습니다.
+- 국세청 연동
+  - 세금계산서 발행을 위한 국세청 연동 상태 관리 기능을 지원합니다.
+  - 국세청 연동 시 세금계산서 발행을 위해 파트너사 \[팝빌] 자동 회원가입을 진행합니다.
+- 메모등록
+  - 파트너에 대한 메모를 입력합니다.
+- 태그등록
+  - 우리 회사 내부적으로 쓰고 있는 규칙이 있다면 자유롭게 태그를 등록 그룹으로 만들어보세요. 이후에 필터 / 검색 시 활용할 수 있습니다.
+- 아이디 생성
+  - 정산 api에 사용될 아이디를 발급합니다. 원하는 아이디로 설정하거나, 난수의 식별번호로 생성하실 수 있습니다.
+- 일괄 등록 기능
+  - CSV 파일로 파트너를 대량등록 하실 수 있습니다.
+- 사용자 정의 속성 관리
+
+#### 3. 정산 상세  조회
+
+- 정산 API를 호출하여 정산일에 맞게 생성된 주문 정산, 주문 취소 정산 내역을 조회할 수 있습니다.
+- 수기로 정산 내역 조정이 필요한 경우 음수 정산 / 양수 정산 건을 생성하여 예외적인 정산 케이스를 관리할 수 있습니다.
+- 정산 상세 내역을 CSV 파일로 다운로드하여 정산 명세서를 손쉽게 작성하고 관리할 수 있습니다.
+- 수기 정산건 등록 시 즉시 정산내역 관리에 반영되어 실시간 확인이 가능합니다.
+
+
+
+#### 4. **정산 내역 관리하기**
+
+- 정산 내역 관리는 1시간마다 배치를 통해 동기화됩니다. 등록한 정산 상세 내역 중 \[정산일]이 도래한 정산 건은 자동 취합되며, 정산 내역 관리 페이지에서 조회할 수 있습니다.
+- 이미 생성된 정산 내역이 있더라도 API 혹은 콘솔의 수기 정산 기능으로 해당 정산일에 추가 정산 내역을 등록하면, 정산 금액은 합산됩니다.
+- 다만 기존의 정산 건이 지급실패/지급보류 상태로 변경된 경우, 추가 정산 내역을 등록하더라도 정산 금액은 합산되지 않고 새로운 정산 건이 별도로 생성됩니다.
+- 송금대행 일괄지급은 기존에 즉시 지급만 가능하였으나, 이번 업데이트로 즉시 지급과 예약지급을 선택 하여 지급을 실행할 수 있습니다. 내부 정책에 맞게 지급 일시를 유연하게 관리해보세요. 
+- 기본 통장메모를 일괄 설정하면 송금대행 일괄지급 시 자동으로 적용되어 반복 기입할 필요가 없습니다.
+
+
+
+#### 5. **송금대행 일괄지급**
+
+- \[정산내역 관리] 페이지에서 총 10개의 정산일자를 선택하여 원하는 정산내역을 선택하여 \[송금대행 일괄지급] 을 실행할 수 있습니다.
+- 송금대행 일괄지급 서비스를 신청하는 경우, 전용 가상계좌가 부여됩니다.
+- 예약지급과 즉시지급이 가능하며 즉시지급 선택 시 실시간으로 지급이 실행됩니다.
+
+
+
+#### 6. **일괄지급 내역 관리**
+
+- \[일괄지급 내역 관리]에서 일괄 지급 현황을 실시간으로 확인할 수 있습니다. 지급 오류를 방지하기 위해 지급은 시스템에서 차례로 진행되며, 2개 이상의 일괄지급을 동시에 진행할 수 없습니다.
+- 정보 오기입 등의 사유로 송금대행 일괄 지급 중단이 필요하신 경우 \[중단] 버튼을 이용하여 즉시 지급을 중단할 수 있습니다. 지급중단 처리는 준비완료, 진행 중 상태일 때 가능합니다.
+
+
+
+#### 7. **지급내역 관리**
+
+- 지급 내역 관리 페이지에서 진행 중인 지급 현황을 확인할 수 있습니다.
+- 지급이 실패한 경우, 실패 사유를 확인할 수 있습니다. 지급 실패 건에 대해 지급을 재시도하고자 하는 경우, \[정산 내역 관리] 페이지의 ‘지급실패’ 상태 탭에서 해당 지급 건을 확인한 뒤 새롭게 일괄지급을 실행할 수 있습니다.
+
+
+
+#### **8. 세금계산서 역발행**
+
+- 세금계산서 역발행 페이지에서 공급받는자가 공급자 대신 세금계산서를 작성하여 발행 요청할 수 있습니다.
+- 공급자는 이메일로 발행 요청을 받은 후 세금계산서 내용을 확인하고 승인 또는 거부할 수 있습니다.
+- 세금계산서를 단건으로 작성하거나 CSV 파일을 통해 일괄 등록할 수 있습니다. 이메일 재발송 기능을 통해 공급자가 이메일을 놓친 경우에도 다시 발행 요청을 보낼 수 있습니다.
+

package/assets/docs/help/api-sdk-2024-12-19.md

@@ -0,0 +1,64 @@
+---
+title: '[릴리즈노트] 2024-12-19 원 페이먼트 인프라 업데이트'
+category: 업데이트
+tags:
+  - OPI
+  - 업데이트
+searchTags:
+  - 일괄재전송
+  - 웹훅일괄 재전송
+  - 웹훅
+  - 업데이트
+  - 통합결제내역
+  - 결제내역
+datetime: 2025-03-13T08:58:36.837Z
+---
+
+<Callout title="2024년 12월 19일 원 페이먼트 인프라 업데이트 소식을 안내드립니다." />
+
+
+
+<Callout content="안녕하세요 원 페이먼트 인프라팀입니다.
+
+24년 12월 19일, 서비스 업데이트 사항 안내드립니다
+이번 업데이트에서는 아래 3가지 개선으로 보다 좋은 사용성을 제공합니다.
+
+1. 통합 결제 내역 - 상점별 내역 조회 기능이 추가되었습니다.
+2. 통합 결제 내역 - 일괄 웹훅 재전송 기능이 추가되었습니다.
+3. 통합 결제 내역 - 필터 사용성을 개선하였습니다." />
+
+## **주요 업데이트 사항**
+
+✔️ 통합 결제 내역 - 상점별 내역 조회
+
+- 상점별 내역 조회 \
+  전체 또는 하위 상점별로 나누어 통합 결제 내역을 확인할 수 있습니다.
+
+이를 통해, 기존에 전체 내역에서 수동으로 분류해서 확인해야 하는 번거로움을 대폭 줄이고 쉽게 상점별로 결제 내역을 조회할 수 있게 되었습니다.
+
+
+
+✔️ **통합 결제 내역 - 일괄 웹훅 재전송**
+
+- **웹훅 일괄 재전송**
+  - 웹훅 수신에 실패한 결제 건들에 대해 일괄로 웹훅을 재전송할 수 있도록 기능이 추가되었습니다.
+  - 조회된 기간 내에 웹훅 수신에 실패한 결제 건 수를 한 번에 파악할 수 있습니다.
+- **상점별 구분 발송**
+  - 전체 또는 하위 상점별로 나누어 웹훅 일괄 재전송 기능을 사용할 수 있습니다.
+
+이를 통해, 기존에 웹훅 재전송을 개별 건마다 적용하던 불편함을 개선하고 웹훅 재전송을 일괄적으로 빠르게 적용할 수 있게 되었습니다.
+
+
+
+✔️ **통합 결제 내역 - 필터 사용성 개선**
+
+- **옵션 배열 방식 변경**
+  - 선택 항목이 많은 경우, 기존 **horizontal 배열**에서 **vertical 배열**로 변경하여 가독성과 사용성을 개선하였습니다.
+- **“전체 선택” 기능 확장**
+  - 기존 “전체 선택” 기능이 일괄 적용만 가능했던 점을 개선하여, 각 항목 별로도 “전체 선택” 기능을 추가했습니다. 이를 통해 더 세부적으로 선택 및 해제가 가능하도록 했습니다.
+
+이를 통해, 기존에 비해 한눈에 옵션을 확인할 수 있어 선택 과정이 간소화되었고 필요한 옵션만 빠르고 정확하게 설정할 수 있도록 편의성을 향상 시켰습니다.
+
+
+
+##### [\[원 페이먼트 인프라 릴리즈노트\] 2024-12-19업데이트 보러가기↗](https://developers.portone.io/release-notes/api-sdk/2024-12-19)