Coupang Developer Center

API支持的买家用户地区：韩国

基于销售月份查看确认结算/预结算明细

路径

GET

/v2/providers/marketplace_openapi/apis/api/v1/settlement-histories

示例

https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/settlement-histories?revenueRecognitionYearMonth=2019-10

请求参数

Name

Required

Type

Description

revenueRecognitionYearMonth

String

销售月份

格式: YYYY-MM

请求体

无

返回消息

Name

Type

Description

settlementType

String

结算类型

Parameter Name	Status
MONTHLY	月结算明细
WEEKLY	周结算明细
ADDITIONAL	额外结算
RESERVE	最终结算金额

settlementDate

String

(预计) 结算日

revenueRecognitionYearMonth

String

销售月份

revenueRecognitionDateFrom

String

销售开始日

revenueRecognitionDateTo

String

销售结束日

totalSale

Number

总销售额

= 销售额 + 配送费 - (取消金额 + 取消配送费 + 折扣金额)

serviceFee

Number

销售手续费

=销售手续费 + 手续费优惠

settlementTargetAmount

Number

待结算金额

=总销售额 – 销售手续费

settlementAmount

Number

结算金额

Weekly settlement

待结算金额的70%

Monthly settlement

待结算金额的100%

lastAmount

Number

最终结算金额( 延期支付的金额);

周结算金额的30%延期支付

pendingReleasedAmount

Number

冻结(解除冻结) 的金额;

解除冻结后包含在此次支付中的金额

sellerDiscountCoupon

Number

卖家优惠券(立减优惠券)

downloadableCoupon

Number

卖家优惠券(满减优惠券)

dedicatedDeliveryAmount

Number

专属配送费;

未使用

sellerServiceFee

Number

卖家服务费(服务费)

couranteeFee

Number

Courantee使用费

couranteeCustomerReward

Number

Courantee赔偿金

deductionAmount

Number

结算扣除

debtOfLastWeek

Number

上周应付款;

上周损失的扣除金额

finalAmount

Number

最终结算金额或预结算金额(最终要支付给卖家的金额)

=结算金额 +冻结(解除冻结)的金额 - (专属配送费+ 卖家服务费 + 结算扣除 + 上周应付款+ Courantee使用费 + Courantee赔偿金 + 卖家优惠券 + Seller store使用优惠金额)

bankAccountHolder

String

银行账户名

bankName

String

银行名

bankAccount

String

收款银行账号;

**后4位被马赛克

status

String

结算状态

Parameter Name	Status
DONE	已支付
SUBJECT	待支付

storeFeeDiscount

Number

Seller store使用优惠金额

返回消息示例

[
    {
        "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
    }
]

错误信息

HTTP Status

Code (Error

Type)

Error Message

Solution

400 (Check

Request

Parameter)

无效收益时间格式(yyyy-MM)

查看销售月份格式的输入是否正确。

400 (Check

Request

Parameter)

您最多查看到本月。

查看您输入的销售月份是不是晚于本月。

接口名称

SETTLEMENT_HISTORIES

查看结算明细

简介

详细内容

路径

示例