2024-08-22 파트너 정산 자동화 업데이트
2024년 8월 22일 파트너 정산 자동화 업데이트 소식을 안내드립니다.
안녕하세요 파트너 정산 자동화팀입니다.
24년 8월 22일, 서비스 업데이트 사항 안내드립니다.
정산 상세 API 중 주문 정산 등록 시 할인 금액 중 면세 금액(이하. 면세 할인 금액)을 지원합니다.
- 주문 정산, 주문 취소 정산 시 면세 할인 금액을 지정하여 정확한 주문 금액 중 면세금액과 결제 금액 중 면세금액을 지원합니다.
- 해당 주문 면세 금액과 결제 면세 금액, 할인 면세 금액에 대해서 정산 금액 결과에 반영되며 현재는 API 상에서 확인 가능합니다.
더불어 이체 내역 다건 조회 API가 추가되었습니다. 가상 계좌 내 충전, 파트너 정산 송금, 송금 이체 내역들을 조회할 수 있습니다.
주요 업데이트 사항
✔️ 면세 할인 금액 지원
주문 정산건과 주문 취소 정산건 생성 시 discounts
에 면세 할인 금액(taxFreeAmount
)을 지정하여 면세 주문 금액에서 면세 할인 금액을 차감하고, 면세 할인 분담 금액을 계산하실 수 있습니다.
현재는 콘솔에서 할인 면세 금액과 관련된 필드를 확인하실 수 없고 API를 통해서만 확인하실 수 있습니다. 추후 콘솔에서도 확인하실 수 있도록 업데이트될 예정입니다.
API 변경사항
주문 정산건 생성 요청
discounts
:[CreatePlatformOrderTransferBodyDiscount[]] 할인 정보에 면세 할인 금액 필드가 추가되었습니다.taxFreeAmount?: integer
면세 할인 금액
주문 취소 정산건 생성 요청
discounts
:[CreatePlatformOrderCancelTransferBodyDiscount[]] 할인 정보에 면세 할인 금액 필드가 추가되었습니다.taxFreeAmount?: integer
면세 할인 금액
주문 정산건 생성, 주문 취소 정산건 생성 응답
-
amount
:[PlatformOrderSettlementAmount] 정산 금액 정보에 필드가 추가되었습니다.-
paymentTaxFree: integer
결제 면세 금액- 기존
taxFree
를 대체하는 필드입니다.taxFree
를 사용하고 계셨다면paymentTaxFree
를 대신 사용해 주세요
- 기존
-
paymentSupply: integer
결제 공급가액- 기존
supply
를 대체하는 필드입니다.supply
를 사용하고 계셨다면paymentSupply
를 대신 사용해 주세요
- 기존
-
orderTaxFree: integer
면세 주문 금액 -
discountTaxFree: integer
면세 할인 금액 -
discountShareTaxFree: integer
면세 할인 분담 금액
-
-
discounts
:[PlatformOrderTransferDiscount[]] 정산 금액 계산 시 사용된 할인 정보에 필드가 추가되었습니다.taxFreeAmount: integer
면세 할인 금액shareTaxFreeAmount: integer
면세 할인 분담 금액
정산 상세 내역 다운로드 필드 추가
fields?
:[PlatformTransferSheetField[]] 다운로드 할 시트 필드가 추가되었습니다.-
SETTLEMENT_PAYMENT_SUPPLY_AMOUNT
: 결제 공급가액- 기존
SETTLEMENT_SUPPLY_AMOUNT
를 대체하는 필드입니다.SETTLEMENT_SUPPLY_AMOUNT
를 사용하고 계셨다면SETTLEMENT_PAYMENT_SUPPLY_AMOUNT
를 대신 사용해 주세요
- 기존
-
SETTLEMENT_PAYMENT_TAX_FREE_AMOUNT
: 결제 면세 금액- 기존
SETTLEMENT_TAX_FREE_AMOUNT
를 대체하는 필드입니다.SETTLEMENT_TAX_FREE_AMOUNT
를 사용하고 계셨다면SETTLEMENT_PAYMENT_TAX_FREE_AMOUNT
를 대신 사용해 주세요
- 기존
-
SETTLEMENT_ORDER_TAX_FREE_AMOUNT
: 면세 주문 금액 -
SETTLEMENT_DISCOUNT_TAX_FREE_AMOUNT
: 면세 할인 금액 -
SETTLEMENT_DISCOUNT_SHARE_TAX_FREE_AMOUNT
: 면세 할인 분담 금액
-
주문 정산건 생성 응답 에러 타입 추가 & 변경
-
에러 타입 추가
- PlatformSettlementAmountExceededError: 정산 가능한 금액을 초과한 경우 에러 타입이 추가되었습니다.
type: AmountExceededType
필드로 요청받은 금액과 초과한 금액의 타입을 알 수 있습니다.DISCOUNT_THAN_ORDER
: 할인금액이 주문금액을 초과DISCOUNT_TAX_FREE_THAN_DISCOUNT
: 면세 할인금액이 할인금액을 초과DISCOUNT_TAX_FREE_THAN_ORDER_TAX_FREE
: 면세 할인금액이 면세 주문금액을 초과PAYMENT_TAX_FREE_THAN_PAYMENT
: 면세 결제금액이 결제금액을 초과
- PlatformSettlementAmountExceededError: 정산 가능한 금액을 초과한 경우 에러 타입이 추가되었습니다.
-
에러 타입 변경
- PlatformDiscountExceededOrderAmountError: 할인 금액이 주문 금액을 초과한 경우
- PlatformTaxFreeAmountOverFlowError: 결제 면세 금액이 결제금액을 초과한 경우
- 위의 두 에러 타입이 제거되고 PlatformSettlementAmountExceededError 타입으로 통합되었습니다.
주문 취소 정산건 생성 응답 에러 타입 추가 & 변경
-
에러 타입 추가
- PlatformSettlementAmountExceededError: 정산 가능한 금액을 초과한 경우 에러 타입이 추가되었습니다.
type: AmountExceededType
필드로 요청받은 금액과 초과한 금액의 타입을 알 수 있습니다.DISCOUNT_THAN_ORDER
: 할인금액이 주문금액을 초과DISCOUNT_TAX_FREE_THAN_DISCOUNT
: 면세 할인금액이 할인금액을 초과DISCOUNT_TAX_FREE_THAN_ORDER_TAX_FREE
: 면세 할인금액이 면세 주문금액을 초과PAYMENT_TAX_FREE_THAN_PAYMENT
: 면세 결제금액이 결제금액을 초과
- PlatformSettlementAmountExceededError: 정산 가능한 금액을 초과한 경우 에러 타입이 추가되었습니다.
-
에러 타입 변경
- PlatformDiscountCancelExceededOrderCancelAmountError: 취소 할인 금액이 취소 주문 금액을 초과한 경우
- PlatformTaxFreeAmountOverFlowError: 결제 면세 금액이 결제금액을 초과한 경우
- 위의 두 에러 타입이 제거되고 PlatformSettlementAmountExceededError 타입으로 통합되었습니다.
✔️ 이체 내역 조회 지원
- 이체 내역 다건 조회 기능이 추가되었습니다. 가상 계좌 내 충전, 파트너 정산 송금, 송금 이체 내역들을 조회할 수 있습니다.
감사합니다.
파트너정산 자동화 팀 드림
작성일자 2024년 8월 22일
일반 문의 | cs@portone.io |
---|---|
기술지원 문의 | support@portone.io |