@portone/mcp-server 0.13.0

package/assets/docs/help/faq/platform-faq/platform_tax_setting_guide.md

@@ -0,0 +1,108 @@
+---
+title: 지급금액 계산 시 세금(부가세, 원천징수세)은 어떻게 설정하나요?
+category: 자주 묻는 질문 (일반 문의) > 파트너정산자동화 > 파트너정산자동화
+seo:
+  title: ''
+tags:
+  - 파트너정산자동화
+  - 부가세
+  - "\b원천징수세"
+pgCompanies:
+  - 공통
+searchTags:
+  - 원천징수세
+  - 부가가치세
+  - 부가세
+  - 세금계산
+  - 플랫폼정산
+  - 파트너정산
+  - 정산 시스템
+datetime: 2025-04-07T15:00:00.000Z
+---
+
+<Callout content="파트너에게 지급할 금액을 계산하기 위해 제공되는
+각종 설정(원천징수세액, 정산금액 취급기준)을 설명합니다." title="" />
+
+### 지급금액 계산식
+
+- 지급금액은 정산정책, 수수료, 세금(면세액, 부가세, 원천징수세) 등을 모두 고려하여, <Highlight text="셀러에게 최종으로 지급되는 금액" />입니다. 지급금액 계산식은 아래와 같습니다.
+
+#### 💡 <Highlight text="지급금액" /> = <Highlight text="지급예상금액" /> - <Highlight text="원천징수세액" />
+
+- <Highlight text="지급예상금액" /> = 과세 공급가액 + 면세금액 + 부가가치세(VAT)
+- <Highlight text="원천징수세액" /> = 소득세(3%) + 지방소득세(0.3%)   \* 원천징수 대상자만 해당
+
+![](/uploads/지급예상금액.jpg)
+
+### 부가세 및 원천징수세를 매번 계산해야 하나요?
+
+- 고객사마다 부가세 및 원천징수세를 적용하는 **시점과 방식**이 다를 수 있어, 포트원 파트너정산자동화 에서는 각 사의 정책에 맞게 설정할 수 있는 기능을 제공합니다.
+- **초기 한 번 설정**해두면, 이후에는 설정한 기준에 따라 자동으로 부가세와 원천징수세가 계산되어 정산금액에 반영됩니다.
+- 설정 경로: `정산정책관리 > 설정 > 지급금액 설정 `![](</uploads/image (9).png>)
+
+### 지급금액 설정하기
+
+- ‘지급금액 설정’은 파트너에게 지급될 최종 금액(지급금액)을 결정할 때 사용하는 정산금액 기준 및 원천징수 처리 방식을 설정하는 항목입니다.
+
+#### 1) 정산 금액 취급 기준
+
+- 설정 경로: `정산정책관리 > 설정 > 지급금액 설정 > 정산 금액 취급 기준`
+- 이 설정은 정산금액에 부가가치세(VAT)를 포함할지 여부를 결정합니다.
+- 즉, 지급금액을 계산할 때 기준이 되는 정산금액을 공급가액 기준으로 취급할지, 부가세가 포함된 합계금액으로 볼지를 선택하는 것입니다.
+
+| 설정값  | 정산금액 구성                | 지급금액 계산 방식                         |
+| ---- | ---------------------- | ---------------------------------- |
+| 합계금액 | 공급가액 + 면세금액 + 부가세(VAT) | 지급금액 계산 시 VAT 별도 계산 없이 정산금액 그대로 사용 |
+| 공급가액 | 공급가액 + 면세금액            | 지급금액 계산 시 VAT 별도로 계산 (정산금액 × 1.1)  |
+
+⚠️ '간이•과세 사업자' 파트너에 한해 적용됩니다.
+
+#### 2) 원천징수세액 정산금 차감 여부
+
+- 설정 경로: `정산정책관리 > 설정 > 지급금액 설정 > 원천징수세액 정산금 차감 여부`
+- 이 설정은 원천징수 대상자에**게 3.3%의 원천징수세액**을 정산금에서 차감할지 여부를 결정합니다. 해당 세금은 플랫폼이 국세청에 대신 납부하며, 하위 파트너에게는 차감 후 금액이 지급됩니다.
+
+| 설정값 | 지급금액 계산 방식                                                   |
+| --- | ------------------------------------------------------------ |
+| 차감  | 정산 금액에서 원천징수세액(3.3%)을 차감하여 지급 금액을 계산합니다. 정산 금액과 지급 금액이 다릅니다. |
+| 미차감 | 원천징수세액을 별도로 차감하지 않습니다. 이 경우 정산 금액과 지급 금액은 동일합니다.             |
+
+⚠️ ‘원천징수 대상자’ 파트너에 한해 적용됩니다.
+
+### 상황별 시나리오
+
+| 시나리오 | 정산금액           | 원징세 차감 방식 | 지급금액 계산식                  |
+| ---- | -------------- | --------- | ------------------------- |
+| ①    | 합계금액 (VAT 포함)  | 차감        | 지급금액 = 정산금액 × 0.967       |
+| ②    | 공급가액 (VAT 미포함) | 차감        | 지급금액 = 정산금액 × 1.1 × 0.967 |
+| ③    | 합계금액 (VAT 포함)  | 미차감       | 지급금액 = 정산금액               |
+| ④    | 공급가액 (VAT 미포함) | 미차감       | 지급금액 = (정산금액 × 1.1)       |
+
+💡 참고
+
+- 3.3%는 원천징수세율로, 소득세(3%)와 지방소득세(0.3%)를 포함한 비율입니다.\
+  1.1배 계산은 부가가치세(VAT) 10%를 포함하기 위한 산식입니다.
+- 각 시나리오에서 정산금액은 기본적으로 공급가액 + 면세금액 기준으로 산정됩니다.\
+  다만, 부가세(VAT) 포함 여부 설정에 따라 지급금액 계산 시 부가세가 포함될지 결정됩니다.
+- 공급가액 정산금액 설정은 부가세(VAT) 부과 시점의 차이를 반영하기 위한 기능입니다.\
+  \- `공급가액` 설정: 정산금액에 부가세(VAT) 포함되어 있으므로, 지급시점에 별도 계산 없음.\
+  \- `합계금액` 설정: 정산금액에 부가세(VAT) 미포함 되었으므로, 지급시점에 부가세 10% 추가해 지급.
+- 관리자(Owner, Admin)는 정산정책관리 > 설정에서 본 설정값을 선택하고, 지급내역 생성 및 일괄지급 시점에 해당 설정이 어떻게 반영됐는지 확인할 수 있습니다.
+
+### 예시 (정산금액 = 1,000,000원)
+
+- 아래는 설정 조합에 따라 지급금액이 어떻게 계산되는지를 예시로 보여줍니다.
+
+| 시나리오 | 설정            | 정산금액       | 부가세(VAT) | 원천징수세액 | 지급금액       | 지급 금액 계산식                            |
+| ---- | ------------- | ---------- | -------- | ------ | ---------- | ------------------------------------ |
+| ①    | 합계금액, 원징세 차감  | 1,000,000원 | 정산금액에 포함 | 차감     | 967,000원   | 1,000,000 × 0.967 = 967,000원         |
+| ②    | 공급가액, 원징세 차감  | 1,000,000원 | 100,000원 | 차감     | 1,063,700원 | 1,000,000 × 1.1 × 0.967 = 1,063,700원 |
+| ③    | 합계금액, 원징세 미차감 | 1,000,000원 | 정산금액에 포함 | 미차감    | 967,000원   | 1,000,000 = 1,000,000원               |
+| ④    | 공급가액, 원징세 미차감 | 1,000,000원 | 100,000원 | 미차감    | 1,100,000원 | 1,000,000 × 1.1 = 1,100,000원         |
+
+### 서비스에 관심이 있으시다면?
+
+문의를 남겨주시면 영업일 기준 2일 내로 담당자가 연락 드릴 예정입니다.\
+언제든지 편히 문의 사항을 남겨주세요.
+
+<Callout title="서비스 문의 남기러 가기 ↗" />

package/assets/docs/help/faq/platform-faq/taxinvoice_guide.md

@@ -0,0 +1,107 @@
+---
+title: 세금계산서 역발행 기능은 어떻게 이용할 수 있나요?
+category: 자주 묻는 질문 (일반 문의) > 파트너정산자동화 > 파트너정산자동화
+seo:
+  title: ''
+tags:
+  - 세금계산서 역발행
+  - 기본 가이드
+pgCompanies:
+  - 공통
+searchTags:
+  - 역발행
+  - 세금계산서
+  - 회원가입
+  - 팝빌
+  - 세금계산서역발행
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="플랫폼사가 공급받는자로서 파트너정산 서비스에서 역발행 세금계산서를 작성 후 요청할 수 있습니다. 
+공급자는 제휴사 사이트에 별도로 회원가입을 하지 않아도 자동으로 가입 처리가 진행됩니다. " title="" />
+
+### 세금계산서 역발행이란?
+
+- 세금계산서 발행 주체인 \[공급자]가 아니라, \[공급받는자]가 공급자 대신 세금계산서를 작성하여 \[공급자]에 발행 요청하는 기능입니다.
+- 플랫폼사가 파트너에게 지급할 정산대금 정보를 정확히 세금계산서 작성 시 기입하고, 해당 내용을 바탕으로 공급자는 이메일을 수취하여 승인할 수 있는 구조이기 때문에 공급받는자와 공급자의 소통 비용을 줄이고 빠르고 효율적으로 세금계산서를 발행할 수 있도록 도울 수 있습니다.
+
+### 역발행 기본 절차가 궁금해요!
+
+<Callout content="공급받는자 (플랫폼사) " />
+
+#### STEP 1. 공급받는자 국세청 연동 (최초 1회)
+
+- \[세금계산서] 페이지 우측 최상단 \[세금계산서 연동 관리] 버튼을 눌러주세요.
+- 사업자 정보, 담당자 정보를 기입하고 공동인증서를 등록해 주세요.
+- 공동인증서는 최초 1회 등록 시 필요하며, 1년간 정보가 저장됩니다.
+
+#### STEP 2. 공급자 국세청 연동 (최초 1회)
+
+- 공급자의 기본 정보를 \[파트너 관리] 페이지에서 등록해주세요.
+- \[파트너 관리] 페이지에서 \[국세청 연동] 버튼을 눌러서 제휴사를 통해 국세청과 통신할 수 있도록 연결해주세요. (최초 1회 진행)
+  - 사업자 정보가 유효한 경우 즉시 연동이 완료되고 서비스 이용을 위한 제휴사에 가입됩니다. 가입 완료 시, 공급자에게 제휴사 팝빌의 회원가입 완료 이메일이 자동 발송됩니다.
+  - 사업자 정보가 변경되면, 국세청 연동을 해제하고 정보를 수정한 뒤 다시 국세청에 연동해야 합니다.
+  - 공급자도 공동인증서를 등록해야 국세청과 통신할 수 있습니다. 다만 공급받는자가 세금계산서 발행 요청 이메일을 보내면, 세금계산서 조회 페이지를 통해 손쉽게 등록할 수 있습니다.
+
+#### STEP 3. 세금계산서 작성
+
+- \[세금계산서 작성] 혹은 \[세금계산서 일괄등록] 기능을 클릭하고 역발행 세금계산서 문서를 작성해주세요.
+  - 세금계산서 문서는 1개씩 작성할 수 있고, 대량으로 일괄 작성할 수 있습니다.
+  - 임시 저장 기능을 이용할 수 있습니다.
+- 이 때 공급자는 국세청에 연동된 파트너여야만 합니다.
+
+#### STEP 4. 발행 요청
+
+- \[발행 요청] 버튼을 눌러 공급자에게 세금계산서 승인 요청 이메일을 보냅니다.
+- 이메일은 즉시 발송됩니다.
+
+<Callout content="공급자 (파트너/하위셀러/입점사)" />
+
+#### STEP 1. 공급받는자가 보낸 이메일 확인
+
+- 공급자가 기재한 \[담당자 정보] 이메일 주소로 세금계산서가 도착합니다.
+
+#### STEP 2. 세금계산서 조회
+
+- 이메일 본문을 확인하고, \[전자세금계산서 조회] 버튼을 클릭합니다.
+- 전자세금계산서 내용을 확인하기 위해 \[사업자등록번호]를 입력합니다. 입력 즉시 세금계산서 내용을 확인할 수 있습니다.
+
+#### STEP 3. 공동인증서 등록 (최초 1회)
+
+- 세금계산서를 발행 승인하거나 발행 거부하려면 최초 1회 공동인증서 등록이 필요합니다.
+  - 법인용 공동인증서, 전자세금계산서용 공동인증서를 등록해야 합니다.
+  - 공동인증서 등록은 최초 1회만 필요하며, 등록된 공동인증서는 1년간 정보가 저장됩니다.
+  - 공동인증서 정보가 바뀌거나 만료되면, 공동인증서를 재등록 해야합니다.
+- 공동인증서 등록 완료 후, 세금계산서 조회 페이지로 돌아가서 새로고침을 해주세요.
+
+#### STEP 4. 세금계산서 발행 승인
+
+- 이제 공급자는 세금계산서를 발행 승인하거나 발행 거부할 수 있습니다.
+- 공급자가 발행 승인 시, 익일 3시에 국세청에 세금계산서가 일괄 전송됩니다.
+- 발행을 승인한 뒤, 국세청에 세금계산서가 전송되기 전까지는 발행 취소가 가능합니다. (공급자에 의한 발행 취소)
+
+### 어떤 제휴사와 연동되어 있나요?
+
+- 파트너 정산 자동화 서비스의 \[세금계산서 역발행] 기능을 제공하는 제휴사는 (주)링크허브이며, 서비스명은 \[팝빌]입니다.
+- 세금계산서 기능을 이용하려면 공급자와 공급받는자 모두 올바른 사업자/담당자 정보를 완료해야하며, 포트원 파트너정산 서비스를 통해서 \[팝빌] 서비스에 가입 연동되어야 합니다.
+
+### 서비스 이용을 위해서 제휴사에 사이트에 가입해야 할까요?
+
+- 아니오, 포트원은 팝빌 서비스 연동을 API를 통해서 진행하고 있습니다.
+- 따라서 공급자와 공급받는자가 팝빌 서비스에 스스로 회원가입을 할 필요가 없고, 포트원 서비스 내의 \[국세청 연동] 을 완료하면 자동으로 회원가입이 완료됩니다.
+- 팝빌 서비스에 회원가입이 완료되는 즉시, 입력한 담당자 이메일로 팝빌 회원가입 완료 이메일이 발송됩니다.
+
+### 개인정보 처리에는 문제가 없나요? 우리 회사가 미리 준비해서 고지할 내용은 없나요?
+
+- 파트너 정산 자동화 서비스의 \[송금대행 일괄지급], \[세금계산서 역발행] 등의 기능을 제공하기 위해 주식회사 코리아 포트원은 등록된 파트너의 개인정보를 제휴사에 (재)위탁하고 있습니다.
+- (주)코리아포트원의 개인정보 처리방침은 [이 링크](https://portone.notion.site/f756e6b1a20d42e1af4dc887c9f8f420)를 참고해 주세요.
+- 고객사는 서비스를 이용하기 위해 정산 대상자 \[파트너] 에게 개인정보 처리방침을 안내할 의무가 있습니다. 개인정보 위탁 및 재위탁에 대한 내용을 작성하여 파트너에게 안내해 주세요.
+- 개인정보 처리방침 작성 가이드는 [이 링크](https://help.portone.io/content/platform_infosec "파트너정산 고객사 개인정보처리방침 작성 가이드 ")를 참고해 주세요.
+
+### 서비스 이용에 관심이 있으시다면?
+
+도입 문의를 남겨주시면 영업일 2일 이내 담당자가 연락 드립니다.
+
+<Callout content="서비스 이용 문의 →" title="" />
+
+###

package/assets/docs/help/faq/platform-faq/taxinvoice_signupemail.md

@@ -0,0 +1,67 @@
+---
+title: '세금계산서 역발행 기능을 이용하려면, 제휴사에 가입해야 하나요? '
+category: 자주 묻는 질문 (일반 문의) > 파트너정산자동화 > 파트너정산자동화
+seo:
+  title: '세금계산서 제휴사 [팝빌] 자동 가입 이메일 안내 '
+  description: >-
+    포트원의 세금계산서 역발행 기능은 공급자와 공급받는자 모두 제휴사 [팝빌]에 회원가입을 완료해야 이용할 수 있습니다. 포트원 서비스
+    내에서 [국세청 연동] 시 제휴사 팝빌에 자동으로 가입되며, 가입 완료 시 회원가입 이메일이 전송됩니다. 
+tags:
+  - 세금계산서 역발행
+  - 정보보안
+pgCompanies:
+  - 공통
+searchTags:
+  - 개인정보위수탁
+  - 정보보안
+  - 개인정보처리방침
+  - 파트너정산자동화
+datetime: 2024-01-25T15:00:00.000Z
+---
+
+<Callout content="제휴사 사이트에 별도로 회원가입을 하지 않아도 자동으로 가입 처리가 진행됩니다. 
+가입 즉시 제휴사 회원가입 이메일이 발송됩니다. " title="" />
+
+### 세금계산서 역발행이란?
+
+- 세금계산서 발행 주체인 \[공급자]가 아니라, \[공급받는자]가 공급자 대신 세금계산서를 작성하여 \[공급자]에 발행 요청하는 기능입니다.
+- 플랫폼사가 파트너에게 지급할 정산대금 정보를 정확히 세금계산서 작성 시 기입하고, 해당 내용을 바탕으로 공급자는 이메일을 수취하여 승인할 수 있는 구조이기 때문에 공급받는자와 공급자의 소통 비용을 줄이고 빠르고 효율적으로 세금계산서를 발행할 수 있도록 도울 수 있습니다.
+
+### 제휴사 회원가입이 필요한가요?
+
+- 포트원의 세금계산서 역발행 기능은 공급자와 공급받는자 모두 제휴사에 회원가입을 완료해야 이용할 수 있습니다.
+- 다만 포트원 서비스 내에서 \[국세청 연동] 시 제휴사에 자동으로 가입되며, 가입 완료 시 회원가입 이메일이 전송됩니다.
+
+### 어떤 제휴사와 연동되어 있나요?
+
+- 파트너 정산 자동화 서비스의 \[세금계산서 역발행] 기능을 제공하는 제휴사는 (주)링크허브이며, 서비스명은 \[팝빌]입니다.
+- 세금계산서 기능을 이용하려면 공급자와 공급받는자 모두 올바른 사업자/담당자 정보를 완료해야하며, 포트원 파트너정산 서비스를 통해서 \[팝빌] 서비스에 가입 연동되어야 합니다.
+
+### 서비스 이용을 위해서 제휴사에 가입해야 할까요?
+
+- 아니오, 포트원은 팝빌 서비스 연동을 API를 통해서 진행하고 있습니다.
+- 따라서 공급자와 공급받는자가 팝빌 서비스에 스스로 회원가입을 할 필요가 없고, \
+  포트원 서비스 내의 \[국세청 연동] 을 완료하면 자동으로 회원가입이 완료됩니다.
+- 팝빌 서비스에 회원가입이 완료되는 즉시, 입력한 담당자 이메일로 팝빌 회원가입 완료 이메일이 발송됩니다.
+
+### 개인정보 처리에는 문제가 없나요?
+
+- 파트너 정산 자동화 서비스의 \[송금대행 일괄지급], \[세금계산서 역발행] 등의 기능을 제공하기 위해 주식회사 코리아 포트원은 등록된 파트너의 개인정보를 제휴사에 (재)위탁하고 있습니다.
+- (주)코리아포트원의 개인정보 처리방침은 [이 링크](https://portone.notion.site/f756e6b1a20d42e1af4dc887c9f8f420)를 참고해 주세요.
+
+### 개인정보 처리방침, 우리 회사는 어떻게 준비해야 할까요?
+
+<Callout content="개인정보 처리방침, 어렵지 않아요. 아래 내용을 참고하여 작성해주세요.
+" />
+
+- 고객사는 서비스를 이용하기 위해 정산 대상자 \[파트너] 에게 개인정보 처리방침을 안내할 의무가 있습니다. 개인정보 위탁 및 재위탁에 대한 내용을 작성하여 파트너에게 안내해 주세요.
+- 개인정보 처리방침 작성 가이드는 [이 링크](https://help.portone.io/content/platform_infosec "파트너정산 고객사 개인정보처리방침 작성 가이드 ")를 참고해 주세요.
+
+### 추가 질문이 있으시다면?
+
+아래 연락처로 언제든지 편히 문의해주세요.
+
+<Callout content="기술 문의 지원 이메일
+b2b.support@portone.io" />
+
+###

package/assets/docs/help/holidays.md

@@ -0,0 +1,29 @@
+---
+title: '[공지] 추석연휴 휴무공지'
+category: 공지사항
+tags:
+  - 공지사항
+datetime: 2024-09-13T09:02:24.352Z
+---
+
+안녕하세요, 포트원 고객지원팀입니다.
+
+이번 한 해도 변함없이 포트원을 사랑해주셔서 무한한 감사를 전해드리며,
+
+이번 추석을 맞이하여 고객지원센터 휴무 일정을 안내 드립니다.
+
+####  🍂 **추석 연휴 고객센터 운영 안내**
+
+- **내용 : 추석연휴로 인한 휴무 일정 공지**
+- **기간 : 2024년 9월 16일(월) \~ 09월 18일(수)**
+
+---
+
+연휴 기간은 고객센터 상담 및 PG가입 접수건 진행이 불가능한 점 양해 부탁드리며,
+문의 사항이 있을 경우 이메일 및 톡 상담(카카오톡, 채널톡)으로 남겨주시면 09월 19일(목)부터 순차적으로 빠른 답변드리겠습니다.
+
+모두 건강하고 풍요로운 한가위 보내시고, 오가는 귀향길 안전운전하시기 바랍니다.
+
+감사합니다.
+
+포트원 드림

package/assets/docs/help/notice-kakaopay-2025-06-30.md

@@ -0,0 +1,47 @@
+---
+title: '[공지][카카오페이] 인터넷 연동망 구조개선 및 내부 인프라 고도화 작업에 따른 서비스 중지 안내 '
+category: 공지사항
+tags:
+  - 카카오페이
+  - 공지사항
+pgCompanies:
+  - null
+  - 카카오페이
+searchTags:
+  - 카카오페이 서비스 이용불가
+  - 시스템 고도화
+  - 카카오페이 고도화작업
+  - 카카오페이 서비스 중지
+  - 공지사항
+  - 카카오페이공지
+  - 카카오페이
+datetime: 2025-06-30T06:03:59.497Z
+---
+
+**카카오페이 인터넷 연동망 구조개선 및 내부 인프라 고도화 작업에 따른 서비스 중지 예정이 공지되어 안내드립니다.**\
+**관련하여 보다 자세한 내용은 아래 본문 혹은 카카오페이를 통해 확인하여주시기 바랍니다.**
+
+<Callout title="[카카오페이] 인터넷 연동망 구조개선 및 내부 인프라 고도화 작업에 따른 서비스 중지 안내" content="안녕하세요, 
+카카오페이 입니다.
+
+당사에서 서비스의 안정성 확보를 위해 인터넷 연동망 구조개선 및 내부 인프라 고도화 작업을 진행할 예정입니다.
+작업 간 당사 서비스가 중단될 예정이기에 사전 공유 드립니다.
+
+가. 작업내용
+- 카카오페이 외부 인터넷 연동망(ISP) 구조 개선
+- 카카오페이 내부 네트워크 및 보안 시스템 고도화
+
+나. 작업일시
+- 2025년 7월 5일(토) 01:00 ~ 07:30 (6시간 30분)
+- 작업 진행 상황에 따라서 종료 시간이 변경될 수 있습니다.
+
+다. 서비스 영향
+- 작업 시간 동안 카카오페이 전체 서비스 이용 불가
+ㄴ 카카오페이 앱 사용 불가
+ㄴ 온라인/오프라인 결제 및 송금서비스 불가
+
+부득이한 작업으로 인해 불편을 끼쳐 드리는 점 양해 부탁 드립니다.
+관련하여 필요한 사항 혹은 문의 사항 있으시면 언제든지 말씀 부탁 드립니다.
+
+
+감사합니다." />

package/assets/docs/help/platform-2024-11-07.md

@@ -0,0 +1,73 @@
+---
+title: '[릴리즈노트] 2024-11-07 파트너 정산 자동화 업데이트'
+category: 업데이트
+tags:
+  - 파트너정산
+  - 업데이트
+searchTags:
+  - 파트너관리
+  - 휴폐업
+  - 일괄등록
+  - 파트너 일괄 등록
+  - 파트너정산
+datetime: 2025-02-20T07:15:41.551Z
+---
+
+<Callout title="2024년 11월 07일 파트너 정산 자동화 업데이트 소식을 안내드립니다." />
+
+
+
+<Callout content="안녕하세요 파트너 정산 자동화팀입니다.
+24년 11월 7일, 서비스 업데이트 사항 안내드립니다.
+이번 업데이트에서는 파트너 등록 기능과 유효성 검증 기능을 고도화했습니다.
+
+1. 파트너 일괄 등록을 지원합니다.
+2. 휴폐업 상태, 예금주 검증 상태를 파트너 관리 테이블에서 조회할 수 있습니다." />
+
+## **주요 업데이트 사항**
+
+✔️ 파트너 일괄 등록 기능
+
+
+
+- \[파트너 관리] 페이지에서 파트너 정보를 대량으로 등록하는 기능이 신설되었습니다.
+- 포트원이 제공하는 CSV 양식을 다운로드하여 데이터를 업로드하면 자동으로 콘솔에 반영됩니다.
+- 파트너 일괄 등록 시 일괄 휴폐업 조회, 일괄 예금주 조회를 진행합니다.
+- 예금주 검증 상태에 따라 예금주가 존재하는 경우 정확한 예금주로 정보를 치환하여 자동 저장할 수 있습니다.
+
+✔️ 파트너 휴폐업 조회 상태, 예금주 검증 상태 조회
+
+
+
+- 파트너가 국세청에 등록된 사업자라면 휴폐업 상태를 \[파트너 관리] 테이블에서 손쉽게 조회할 수 있습니다.
+- 계좌번호 정보가 있다면 예금주 검증 상태를 \[파트너 관리] 테이블에서 조회할 수 있습니다.
+
+✔️ 휴폐업 조회 상태, 예금주 검증 상태 필터 기능
+
+
+
+- \[필터] 기능을 통해 휴폐업 상태와 예금주 검증 상태별 파트너 데이터를 조회할 수 있습니다.
+
+#### **API 변경사항**
+
+✔️ 파트너
+
+계좌 상태 코드 변경
+
+- 신설 VERIFY\_ERROR : 계좌 인증 오류
+- 제거 VERIFYING : 해당 에러는 미사용 코드로 제거되었습니다.
+- 제거 EXPIRED : 해당 에러는 미사용 코드로 제거되었습니다.
+
+휴폐업 상태 코드 변경
+
+- 변경 VERIFY\_FAILED → VERIFY\_ERROR : 조회 오류
+- 제거 VERIFYING : 해당 에러는 미사용 코드로 제거되었습니다.
+
+파트너 다건 조회 - 필터 조건 추가
+
+파트너 내역을 검색 및 조회 시에 파트너의 계좌 상태, 사업자 상태를 기반하여 조회가 가능합니다.
+
+- filter.accountStatus : 파트너 계좌 상태
+- filter.businessStatuses : 파트너 사업자 상태
+
+##### [\[파트너정산 릴리즈노트\] 2024-11-07 업데이트 보러가기↗](https://developers.portone.io/release-notes/platform/2024-11-07)

package/assets/docs/help/platform-2024-11-25.md

@@ -0,0 +1,91 @@
+---
+title: '[릴리즈노트] 2024-11-25 파트너 정산 자동화 업데이트'
+category: 업데이트
+tags:
+  - 파트너정산
+  - 업데이트
+searchTags:
+  - 국세청 연동
+  - 세금계산서
+  - '파트너 다수 '
+  - '대량 '
+  - 세금계산서 발행
+datetime: 2025-03-04T02:46:19.360Z
+---
+
+<Callout title="2024년 11월 25일 파트너 정산 자동화 업데이트 소식을 안내드립니다." />
+
+
+
+<Callout content="안녕하세요 파트너 정산 자동화팀입니다.
+
+24년 11월 25일, 서비스 업데이트 사항 안내드립니다.
+이번 업데이트에서는 세금계산서 역발행 신규 기능을 제공합니다.
+
+1. 파트너 다수에게 대량으로 세금계산서 발행 승인 요청을 보낼 수 있어 일일이 작업하는 노고를 줄여 드립니다.
+2. 국세청 사이트에 방문하지 않고도 세금계산서 발행 및 수정 세금계산서 작성이 가능합니다." />
+
+## **주요 업데이트 사항**
+
+✔️ **국세청 연동**
+
+- 콘솔 우측 최상단 \[세금계산서 연동관리]에서 공동인증서를 1회만 연동 완료하면, 손쉽게 역발행 세금계산서를 작성/관리 할 수 있습니다.
+
+
+
+✔️**세금계산서 작성**
+
+- 세금계산서를 작성 중 임시저장 할 수 있습니다.
+
+
+
+- 국세청에서 제공하는 전자세금계산서 양식으로 편리하게 사용할 수 있습니다.
+
+
+
+✔️ **세금계산서 일괄 등록**
+
+- 포트원에서 제공하는 양식에 맞추어 csv 파일 작성 완료 후 콘솔에 업데이트 하면, 자동으로 데이터가 입력됩니다.
+
+
+
+- 세금계산서의 역발행 승인 요청 / 발행 / 국세청 전송 상태를 간편하게 확인할 수 있습니다.
+
+
+
+✔️ **파트너 국세청 연동 및 세금계산서 조회/승인/거부**
+
+- 공급자는 이메일에서 최초 1회 공동인증서를 연동 완료 한 후, 세금계산서 조회/승인/거부할 수 있습니다.
+
+
+
+✔️ **수정 세금계산서 작성**
+
+- 세금계산서를 국세청에 전송한 이후에 수정이 필요한 경우,국세청 홈페이지 방문 없이 포트원 콘솔에서 수정 세금계산서 작성이 가능합니다.
+
+
+
+#### **API 변경사항**
+
+✔️ **파트너 관련 API**
+
+파트너 다건 조회 요청 본문이 수정되었습니다.
+
+- `PlatformPartnerFilterInput` 파트너 필터 입력 정보에 필드가 추가되었습니다.
+  - `types` : PlatformPartnerTypeName 파트너 유형 필터가 추가되었습니다.
+  - `taxationTypes` : PlatformPartnerTaxationType 파트너 과세 유형 필터가 추가되었습니다.
+  - `memberCompanyConnectionStatuses` : PlatformPartnerMemberCompanyConnectionStatus 파트너 연동 사업자 연결 상태 필터가 추가되었습니다.
+
+파트너 관련 API들의 응답 본문이 수정되었습니다.
+
+- `PlatformPartnerTypeBusiness` 파트너 사업자 정보에 필드가 추가되었습니다.
+  - `memberCompanyConnectionStatus` : PlatformPartnerMemberCompanyConnectionStatus 파트너 연동 사업자 연결 상태가 추가되었습니다.
+  - `memberCompanyConnectionFailedReason?`: String 연동사업자 연결 실패 사유가 추가되었습니다.
+
+✔️ **사업자 조회**
+
+- 사업자 조회 API가 추가 되었습니다.
+
+
+
+##### [\[파트너정산 릴리즈노트\] 2024-11-25업데이트 보러가기↗](https://developers.portone.io/release-notes/platform/2024-11-25)

package/assets/docs/help/platform-2024-12-10.md

@@ -0,0 +1,71 @@
+---
+title: '[릴리즈노트] 2024-12-10 파트너 정산 자동화 업데이트'
+category: 업데이트
+tags:
+  - 업데이트
+  - 파트너정산
+searchTags:
+  - 일괄지급
+  - 송금대행
+  - 통장메모
+  - 엑셀 다운로드
+  - 파트너 엑셀 다운로드
+  - 파트너정산
+datetime: 2025-03-13T08:58:36.837Z
+---
+
+<Callout title="2024년 12월 10일 파트너 정산 자동화 업데이트 소식을 안내드립니다." />
+
+
+
+<Callout content="안녕하세요 파트너 정산 자동화팀입니다.
+
+24년 12월 10일, 서비스 업데이트 사항 안내드립니다.
+이번 업데이트에서는 아래 5가지 개선으로 보다 좋은 사용성을 제공합니다.
+
+1. **파트너 엑셀 다운로드** 기능을 지원합니다.
+2. **기본 통장메모 일괄 설정**을 제공하여 한 번 설정해두면, 송금대행 일괄지급 시 **반복 기입할 필요가 없습니다.**
+3. 기존 1건만 제공되던 **송금대행 일괄지급 예약을 10건**까지 제공합니다.
+4. 일괄지급 선택 페이지에서 파트너별 정산 상계 금액 확인이 가능합니다.
+5. 상세 조회 페이지에서 **보다 편리하게** 디자인이 개선되었습니다." />
+
+## **주요 업데이트 사항**
+
+✔️ **파트너 엑셀 다운로드**
+
+- \[파트너 관리] 에서 조회한 파트너를 **csv 파일로 다운로드** 할 수 있습니다.
+
+
+
+✔️기본 통장메모 일괄 설정
+
+- \[정산 내역 관리]의 우상단 \[일괄지급 기본 설정]을 클릭하여 기본 통장메모를 일괄 설정할 수 있습니다.
+- 보내는 이와 받는 이에게 노출되는 통장메모 입력 후 1회만 저장하면, 이후 송금대행 일괄지급 실행 시 통장메모가 자동으로 적용되어 노출됩니다.
+
+
+
+✔️ 송금대행 일괄지급 예약 10건까지 생성 가능
+
+- 송금대행 일괄지급 예약 시, 기존에는 1건만 예약이 가능했으나 총 10건까지 예약할 수 있도록 개선되었습니다.
+
+
+
+✔️ 파트너별 정산 상계 금액 확인
+
+- \[송금대행 일괄지급 선택] 에서 정산 상계 금액을 자동계산해 노출합니다.
+- 정산내역이 파트너별로 정렬되며, 파트너별 최종 지급예정 금액이 마이너스인 금액을 빨간색으로 표기해 정정 대상에 대한 가시성을 높였습니다.
+
+
+
+✔️ 정산 상세 조회 디자인 업데이트
+
+- \[정산 상세 조회] 에서 표 설정이 추가되었습니다.
+- 원하는 조건으로 보다 편하게 정산 상세 내역을 조회할 수 있습니다
+
+
+
+- 테이블 가독성을 증대하고, 보다 편리한 필터 사용이 가능하도록 디자인을 개선하였습니다.
+
+
+
+##### [\[파트너정산 릴리즈노트\] 2024-12-10업데이트 보러가기↗](https://developers.portone.io/release-notes/platform/2024-12-10)

package/assets/docs/help/platform-2025-03-04.md

@@ -0,0 +1,54 @@
+---
+title: '[릴리즈노트] 2025-03-04 파트너 정산 자동화 업데이트'
+category: 업데이트
+tags:
+  - 파트너정산
+  - 업데이트
+searchTags:
+  - 미연동 사업자번호
+  - '국세청 사업자번호 '
+  - 정산내역
+  - 릴리즈노트
+  - 업데이트
+  - 파트너정산
+  - 수기정산
+datetime: 2025-06-10T05:56:46.664Z
+---
+
+<Callout title="2025년 03월 04일 파트너 정산 자동화 업데이트 소식을 안내드립니다." />
+
+
+
+<Callout content="안녕하세요 파트너 정산 자동화팀입니다.
+
+25년 3월 4일 업데이트 사항 공유드립니다. 
+
+1. 수기정산건 등록 시 즉시반영
+2. 국세청 미연동 사업자번호 세금계산서 발행 제한
+
+" />
+
+## **주요 업데이트 사항**
+
+#### **✔️수기정산건 등록 시 즉시반영**
+
+- 기존: 정산 완료 상태의 수기 정산건 등록 후 10분 후 정산내역 관리에 반영
+- 변경: 정산 완료 상태의 수기 정산건 등록 시 즉시 정산내역 관리에 반영
+  - 수기 정산건 등록 후, 정산 내역 관리 페이지에서 수기 정산건에 등록한 정산일이 포함된 기간으로 조회하면 수기 정산건이 반영된 정산 내역을 즉시 확인 가능
+- 경로: 정산 상세 조회 > 수기 정산 등록 > 정산 내역 관리 페이지에서 확인 가능
+
+
+
+
+
+#### **✔️국세청 미연동 사업자번호 세금계산서 발행 제한**
+
+- 기존: 국세청 연동되지 않은 사업자번호도 세금계산서 발행 요청 가능 → 공급자가 발행 페이지에서 오류 확인
+- 변경: 국세청 미연동 사업자번호의 세금계산서 발행 요청이 실패하도록 개선 → 파트너의 오류 경험을 사전에 방지
+- 경로:
+  - 세금계산서 > 세금계산서 작성 > 일괄등록 (단건등록은 기존에도 국세청 미연동자 세금계산서 발행 제한)
+  - 세금계산서 > 세금계산서 목록 > 요청실패
+
+
+
+##### [\[파트너정산 릴리즈노트\] 2025-03-04업데이트 보러가기↗](https://developers.portone.io/release-notes/platform/2025-03-04)