매출인식월을 기준으로 지급 확정/예정된 내역을 확인합니다.
Path
GET
/v2/providers/marketplace_openapi/apis/api/v1/settlement-histories
Example Endpoint
https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/settlement-histories?revenueRecognitionYearMonth=2019-10
Request Parameters
Query String Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| revenueRecognitionYearMonth | O | String |
매출인식월
형식 : YYYY-MM
|
||||
Request Example
not require body
Response Message
| Name | Type | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| settlementType | String |
정산유형
|
||||||||||||||
| settlementDate | String |
정산(예정)일
|
||||||||||||||
| revenueRecognitionYearMonth | String |
매출인식월
|
||||||||||||||
| revenueRecognitionDateFrom | String |
매출인식시작일
|
||||||||||||||
| revenueRecognitionDateTo | String |
매출인식종료일
|
||||||||||||||
| totalSale | Number |
총판매액
=판매액+판매배송료-(취소액+취소배송료+할인쿠폰)
|
||||||||||||||
| serviceFee | Number |
판매수수료
=판매수수료+우대수수료 환급액
|
||||||||||||||
| settlementTargetAmount | Number |
정산대상액
=총판매액-판매수수료
|
||||||||||||||
| settlementAmount | Number |
지급액
|
||||||||||||||
| lastAmount | Number |
최종액 ( 유보성격의 금액 )
주정산 30% 유보금액
|
||||||||||||||
| pendingReleasedAmount | Number |
보류(해제)금액
보류가 해제 되면서 이번 지급에 포함될 금액 |
||||||||||||||
| sellerDiscountCoupon | Number |
판매자 할인쿠폰 (즉시할인쿠폰)
|
||||||||||||||
| downloadableCoupon | Number |
판매자 할인쿠폰 (다운로드쿠폰)
|
||||||||||||||
| dedicatedDeliveryAmount | Number |
전담택배비
사용안함
|
||||||||||||||
| sellerServiceFee | Number |
판매자서비스이용료(서버이용료)
|
||||||||||||||
| couranteeFee | Number |
쿠런티이용료
|
||||||||||||||
| couranteeCustomerReward | Number |
쿠런티보상금
|
||||||||||||||
| deductionAmount | Number |
정산차감
|
||||||||||||||
| debtOfLastWeek | Number |
전주채권
전주에 발생한 손실 관련 차감액 |
||||||||||||||
| finalAmount | Number |
최종지급액 or 지급예정액
(최종적으로 셀러에게 입금될 금액) =지급액+보류(해제)금액 -(전담택배비+판매자서비스이용료+정산차감+전주채권+쿠런티이용료+쿠런티보상금+판매자할인쿠폰+스토어이용료할인금액) |
||||||||||||||
| bankAccountHolder | String |
예금주
|
||||||||||||||
| bankName | String |
은행명
|
||||||||||||||
| bankAccount | String |
정산대금 입금 계좌번호
**뒤 4자리 마스킹 처리
|
||||||||||||||
| status | String |
지급 상태
|
||||||||||||||
| storeFeeDiscount | Number |
셀러 스토어 이용료 할인 금액
|
||||||||||||||
Response Example
[
{
"settlementType": "DAILY",
"settlementDate": "2019-10-10",
"revenueRecognitionYearMonth": "2019-10",
"revenueRecognitionDateFrom": "2019-10-01",
"revenueRecognitionDateTo": "2019-10-01",
"totalSale": ***58150,
"serviceFee": ***8782,
"settlementTargetAmount": ***39368,
"settlementAmount": ***39368,
"lastAmount": 0,
"pendingReleasedAmount": 0,
"sellerDiscountCoupon": 0,
"downloadableCoupon": 0,
"dedicatedDeliveryAmount": 0,
"sellerServiceFee": 0,
"couranteeFee": 0,
"couranteeCustomerReward": 0,
"deductionAmount": 0,
"debtOfLastWeek": 0,
"finalAmount": ***39368,
"bankAccountHolder": "*********",
"bankName": "**",
"bankAccount": "100560****",
"status": "DONE",
"storeFeeDiscount": 0
}
]Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) |
Invalid revenueRecognitionYearMonth format (yyyy-MM) |
매출인식월을 올바른 형식으로 입력했는지 확인합니다. |
| 400 (요청변수확인) |
해당월까지만 조회할 수 있습니다. |
매출인식월을 당월 이후로 입력했는지 확인합니다. |
URL API Name
SETTLEMENT_HISTORIES