您可根据销售确认日期(确认收货日/配送完成+7天)查询详细的销售明细。
路径
GET
/v2/providers/openapi/apis/api/v1/revenue-history
示例
请求参数
|
Name |
Required |
Type |
Description |
|
vendorId |
O |
String |
卖家ID 酷澎提供给卖家的固有代码 例) A00012345 |
|
recognitionDateFrom |
O |
String |
销售确认开始日期 最多可输入31天 格式: YYYY-MM-dd |
|
recognitionDateTo |
O |
String |
销售确认结束日期 最多可输入31天 格式: YYYY-MM-dd |
|
token |
O |
String |
查询下一页所需的Token 值 调用下一页所需的Token 值 (查询第一页时只输入到”token=”即可) |
|
maxPerPage |
|
Number |
每页最多调用数量 默认值: 50; 最小值: 1; 最大值: 50 |
请求体
无
返回消息
|
Name |
Type |
Description |
||||||||
|
code |
Number |
服务器响应码 |
||||||||
|
message |
String |
详细信息 |
||||||||
|
data
|
Array |
结果列表 没有结果时返回为空表
|
||||||||
|
|
orderId |
Number |
订单号 |
|||||||
|
|
saleType |
String |
分类
|
|||||||
|
|
saleDate |
String |
付款日期 格式: YYYY-MM-dd |
|||||||
|
|
recognitionDate |
String |
销售确认日期 格式: YYYY-MM-dd “配送完成+ 7天“ 或 ”确认收货” |
|||||||
|
|
settlementDate |
String |
预计结算日 格式: YYYY-MM-dd |
|||||||
|
|
finalSettlementDate |
String |
保留金额预计支付日 格式: YYYY-MM-dd 仅在周结时使用 |
|||||||
|
|
deliveryFee |
Object |
配送费详细指南 |
|||||||
|
|
|
amount |
Number |
总配送费 总配送费: 基本配送费+偏远地区配送费 |
||||||
|
|
|
fee |
Number |
总配送手续费 |
||||||
|
|
|
feeVat |
Number |
总配送费附加税 |
||||||
|
|
|
feeRatio |
Number |
配送手续费率(%) |
||||||
|
|
|
settlementAmount |
Number |
配送费结算金额 结算金额：总配送费 - 配送手续费 - 配送费附加税 |
||||||
|
|
|
baseAmount |
Number |
基本配送费 |
||||||
|
|
|
baseFee |
Number |
基本配送手续费 |
||||||
|
|
|
baseFeeVat |
Number |
基本配送费附加税 |
||||||
|
|
|
remoteAmount |
Number |
偏远地区配送费 |
||||||
|
|
|
remoteFee |
Number |
偏远地区配送手续费 |
||||||
|
|
|
remoteFeeVat |
Number |
偏远地区配送费附加税 |
||||||
|
|
items |
Array |
各订单商品的结算金额明细 |
|||||||
|
|
|
taxType |
String |
是否收税 |
||||||
|
|
|
productId |
Number |
显示商品ID 此ID可随时修改(合并或分离), 不能作为结算时对账的关键数据 |
||||||
|
|
|
productName |
String |
显示商品名 |
||||||
|
|
|
vendorItemId |
Number |
属性ID 酷澎最小的商品单位(用于商品修改、退货) 此ID无法修改。因为是最小单位，所以被用作key |
||||||
|
|
|
vendorItemName |
String |
属性名 |
||||||
|
|
|
salePrice |
Number |
总售价 数量变更后的总售价 |
||||||
|
|
|
quantity |
Number |
数量 |
||||||
|
|
|
coupangDiscountCoupon |
Number |
酷澎专属优惠金额 |
||||||
|
|
|
discountCouponPolicyAgreement |
Boolean |
是否同意酷澎专属优惠券 |
||||||
|
|
|
saleAmount |
Number |
销售金额 销售金额= 销售额 – 酷澎专属优惠券 |
||||||
|
|
|
sellerDiscountCoupon |
Number |
卖家优惠券 |
||||||
|
|
|
downloadableCoupon |
Number |
下载优惠券 |
||||||
|
|
|
serviceFee |
Number |
服务使用费 |
||||||
|
|
|
serviceFeeVat |
Number |
服务使用附加税 |
||||||
|
|
|
serviceFeeRatio |
Number |
服务使用率(%, 不包括VAT) |
||||||
|
|
|
settlementAmount |
Number |
结算金额 结算金额= 销售金额 - (服务使用费+服务使用附加税) |
||||||
|
|
|
couranteeFeeRatio |
Number |
Courantee使用率(%) |
||||||
|
|
|
couranteeFee |
Number |
Courantee使用费(amount) |
||||||
|
|
|
couranteeFeeVat |
Number |
Courantee使用附加税 |
||||||
|
|
|
externalSellerSkuCode |
String |
卖家商品管理编号 |
||||||
|
|
|
storeFeeDiscount |
Number |
卖家店铺使用费折扣金额 |
||||||
|
|
|
storeFeeDiscountVat |
Number |
卖家店铺使用费附加税 |
||||||
|
hasNext |
Boolean |
下一页是否存在信息 |
||||||||
|
nextToken |
String |
查询下一页所需的Token值 |
||||||||
返回消息示例
{
"code": 200,
"message": "OK",
"data": [
{
"orderId": 28000048862315,
"saleType": "REFUND",
"saleDate": "2019-09-06",
"recognitionDate": "2019-10-02",
"settlementDate": "2019-11-21",
"finalSettlementDate": "2019-11-21",
"deliveryFee": {
"amount": 0,
"fee": 0,
"feeVat": 0,
"feeRatio": 3,
"settlementAmount": 0,
"baseAmount": 0,
"baseFee": 0,
"baseFeeVat": 0,
"remoteAmount": 0,
"remoteFee": 0,
"remoteFeeVat": 0
},
"items": [
{
"taxType": "TAX",
"productId": 294693352,
"productName": "gtest 테스트 비정품잉크",
"vendorItemId": 5307184135,
"vendorItemName": "gtest 테스트 비정품잉크, 1개, 블랙",
"salePrice": 300,
"quantity": 2,
"coupangDiscountCoupon": 0,
"discountCouponPolicyAgreement": false,
"saleAmount": 300,
"sellerDiscountCoupon": 0,
"downloadableCoupon": 0,
"serviceFee": 22,
"serviceFeeVat": 2,
"serviceFeeRatio": 7.0,
"settlementAmount": 276,
"couranteeFeeRatio": 0,
"couranteeFee": 0,
"couranteeFeeVat": 0,
"storeFeeDiscountVat": 0,
"storeFeeDiscount": 0,
"externalSellerSkuCode": ""
},
{
"taxType": "TAX",
"productId": 294692050,
"productName": "gtest 테스트 훈제란",
"vendorItemId": 5307179471,
"vendorItemName": "gtest 테스트 훈제란, 1개, 500g",
"salePrice": 100,
"quantity": 1,
"coupangDiscountCoupon": 0,
"discountCouponPolicyAgreement": false,
"saleAmount": 100,
"sellerDiscountCoupon": 0,
"downloadableCoupon": 0,
"serviceFee": 10,
"serviceFeeVat": 1,
"serviceFeeRatio": 10.0,
"settlementAmount": 89,
"couranteeFeeRatio": 0,
"couranteeFee": 0,
"couranteeFeeVat": 0,
"storeFeeDiscountVat": 0,
"storeFeeDiscount": 0,
"externalSellerSkuCode": ""
}
]
},
{
"orderId": 2000050175528,
"saleType": "SALE",
"saleDate": "2019-09-26",
"recognitionDate": "2019-10-03",
"settlementDate": "2019-11-21",
"finalSettlementDate": "2019-11-21",
"deliveryFee": {
"amount": 0,
"fee": 0,
"feeVat": 0,
"feeRatio": 3,
"settlementAmount": 0,
"baseAmount": 0,
"baseFee": 0,
"baseFeeVat": 0,
"remoteAmount": 0,
"remoteFee": 0,
"remoteFeeVat": 0
},
"items": [
{
"taxType": "TAX",
"productId": 290865426,
"productName": "쁘띠드엔 ㅇㅇ",
"vendorItemId": 5291775079,
"vendorItemName": "쁘띠드엔 ㅇㅇ, 남아, L(7호)",
"salePrice": 200,
"quantity": 1,
"coupangDiscountCoupon": 0,
"discountCouponPolicyAgreement": false,
"saleAmount": 200,
"sellerDiscountCoupon": 0,
"downloadableCoupon": 0,
"serviceFee": 21,
"serviceFeeVat": 2,
"serviceFeeRatio": 10.5,
"settlementAmount": 177,
"couranteeFeeRatio": 0,
"couranteeFee": 0,
"couranteeFeeVat": 0,
"storeFeeDiscountVat": 0,
"storeFeeDiscount": 0,
"externalSellerSkuCode": ""
}
]
},
{
"orderId": 0,
"saleType": "SALE",
"saleDate": "2019-10-31",
"recognitionDate": "2019-10-31",
"settlementDate": "2019-11-21",
"finalSettlementDate": "2019-11-21",
"deliveryFee": {
"amount": 0,
"fee": 0,
"feeVat": 0,
"feeRatio": 3,
"settlementAmount": 0,
"baseAmount": 0,
"baseFee": 0,
"baseFeeVat": 0,
"remoteAmount": 0,
"remoteFee": 0,
"remoteFeeVat": 0
},
"items": [
{
"taxType": "",
"productId": 0,
"productName": "",
"vendorItemId": 0,
"vendorItemName": "",
"salePrice": 0,
"quantity": 0,
"coupangDiscountCoupon": 0,
"discountCouponPolicyAgreement": false,
"saleAmount": 0,
"sellerDiscountCoupon": 0,
"downloadableCoupon": 0,
"serviceFee": 0,
"serviceFeeVat": 0,
"serviceFeeRatio": null,
"settlementAmount": 0,
"couranteeFeeRatio": 0,
"couranteeFee": 0,
"couranteeFeeVat": 0,
"storeFeeDiscountVat": 0,
"storeFeeDiscount": 0,
"externalSellerSkuCode": ""
}
]
}
],
"hasNext": false,
"nextToken": ""
}错误信息
|
HTTP状态代码(错误类型) |
错误信息 |
解决方案 |
|
400 (确认请求参数) |
Required String parameter 'vendorId' is not present |
请确认您输入的“vendorId”值是否正确。 |
|
400 (确认请求参数) |
The request is invalid: recognitionDateFrom: Invalid format. 请遵守格式: 'yyyy-MM-dd'. (示例) '2011-12-03' 用户输入值= **** |
请确认您输入的“recognitionDateFrom”值是否正确。 |
|
400 (确认请求参数) |
The request is invalid: recognitionDateTo: Invalid format. 请遵守格式: 'yyyy-MM-dd'. (示例) '2011-12-03' 用户输入值= **** |
请确认您输入的“recognitionDateTo”值是否正确。 |
|
400 (确认请求参数) |
Required String parameter 'token' is not present |
请确认您输入的token值是否正确。 |
|
400 (确认请求参数) |
The request is invalid: token: Invalid format. 查询第一页时无需输入。从第二页开始，使用上一页响应中包含的nextToken值。用户输入值 = * |
请确认您输入的token值是否正确。 |
接口名称
GET_REVENUE_HISTORY