马蜂窝开放平台

店铺交易数据拉取

店铺（整体）交易数据拉取

注意：
自然周：每周周一到周日。开始日期不为周一情况，则取开始日期的下个周一为开始日期。结束日期不为周日情况，则取结束日期的上个周日为结束日期。

自然月：每月1号到月末最后一天。开始日期不为1号时，则取开始日期的下个月1号为开始日期。结束日期不为月末时，则取结束日期当月最后一天。

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.shop.trade.get

请求参数

参数名称	参数类型	必填	示例	描述
start_time	date	是	2018-01-01	查询开始日期
end_time	date	是	2018-02-02	查询结束时间
type	int	是	1	汇总周期类型：“3-自然天”／“1-自然周”／“2-自然月”
page_no	int	是	1	当前页数
page_size	int	否	20	单页条数（最大值20）

响应参数

参数名称	参数类型	示例	描述
total	int	1
list	array	[]
{}	object	0
└ start_date	date	2018-01-01	开始日期
└ end_date	date	2018-02-02	结束日期
└ online_prd_num	int	1	统计周期内，在线产品数量
└ prd_uv	int	1	统计周期内，所有产品详情页的访客数去重
└ prd_pv	int	1	统计周期内，所有产品详情页的浏览流累计
└ paid_uid_num	int	1	统计周期内，所有支付订单的用户去重后的支付人数
└ paid_ord_num	int	1	支付订单数：统计周期内，支付订单总数
└ paid_stock_num	int	1	支付件数：统计周期内，所有支付订单的支付祝库存件数累计
└ paid_gmv	number	1.00	支付金额：统计周期内，所有支付订单的订单金额累计（包含订单优惠金额及退款金额）
└ avg_uid_gmv	number	1.00	客单价：统计周期内，支付订单金额/支付人数
└ avg_ord_gmv	number	1.00	均单价：统计周期内，支付订单金额/支付订单数
└ avg_stock_gmv	number	1.00	库存单价：统计周期内，支付订单金额/支付件数
└ reduce_mfw	number	1.00	马蜂窝优惠金额：统计周期内，支付订单的马蜂窝优惠金额累计（马蜂窝补贴）
└ reduce_sum	number	1.00	优惠金额：统计周期内，支付订单的优惠金额累计
└ reduce_ota	number	1.00	商家优惠金额：统计周期内，支付订单的商家优惠金额累计（商家自补贴）
└ refund_sum	number	1.00	退款总额：统计周期内，所有产生退款订单的退款金额累计

响应示例

{
    "total":"1",
    "list":[
        {
            "start_date":"2018-01-01",
            "end_date":"2018-02-02",
            "online_prd_num":"1",
            "prd_uv":"1",
            "prd_pv":"1",
            "paid_uid_num":"1",
            "paid_ord_num":"1",
            "paid_stock_num":"1",
            "paid_gmv":"1.00",
            "avg_uid_gmv":"1.00",
            "avg_ord_gmv":"1.00",
            "avg_stock_gmv":"1.00",
            "reduce_mfw":"1.00",
            "reduce_sum":"1.00",
            "reduce_ota":"1.00",
            "refund_sum":"1.00"
        }
    ]
}

异常错误码

异常码	异常信息
10080008	请求失败，请稍后再试
10080007	数据统计暂未完成
10080006	数据统计暂未开始
10080005	周期类型不正确
10080004	最多可查询31天数据
10080003	开始日期不能大于结束日期
10080002	开始日期或结束日期不能为空
10080001	商家ID不正确