优惠券-全部汇总统计
优惠券 - 获取优惠券汇总统计
接口信息
- 接口地址:
{your-site-url}/api/skill/coupon/get-all-statistics - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com/apimanager666 - 请求方式:
GET - 说明: 此接口用于获取所有优惠券的汇总统计数据（将所有优惠券的数据合并计算后的总体数据）。
认证
请求头中需要携带 skill-access-token：
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数 (Query String)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
created_at_begin |
string | 否 | 统计时间区间 - 开始时间，格式 YYYY-MM-DD。用于筛选订单召回时间和优惠券使用时间 |
created_at_end |
string | 否 | 统计时间区间 - 结束时间，格式 YYYY-MM-DD。用于筛选订单召回时间和优惠券使用时间 |
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/coupon/get-all-statistics?created_at_begin=2026-05-05&created_at_end=2026-06-04' \
--header 'skill-access-token: {your-skill-access-token}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"coupon_order_count": 2,
"coupon_order_count_rate": "3.64",
"coupon_order_amount": "2728.25",
"coupon_order_amount_rate": "16.26",
"average_unit_amount": "1364.13",
"average_product_count": "3.00"
},
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码，200 表示成功 |
message |
String | 执行结果的文字描述 |
data.coupon_order_count |
int | 使用了优惠券的订单总个数（查询时间段内的已召回订单） |
data.coupon_order_count_rate |
string | 使用了优惠券的订单量占比（%）。= 使用了优惠券的订单量 ÷ 总订单量 |
data.coupon_order_amount |
string | 使用了优惠券的订单总金额（基础货币） |
data.coupon_order_amount_rate |
string | 使用了优惠券的订单成交额占比（%）。= 使用了优惠券的订单成交额 ÷ 总订单成交额 |
data.average_unit_amount |
string | 客单价。= 使用了优惠券的订单成交额 ÷ 使用了优惠券的订单个数 |
data.average_product_count |
string | 连带率。= 使用了优惠券的订单商品件数 ÷ 使用了优惠券的订单个数 |
注意事项
- 该接口将所有优惠券的数据汇总后进行统计，不同于 优惠券-营销统计详细 是针对单个优惠券的统计
created_at_begin/created_at_end的时间范围作用于两个维度：- 订单召回时间：顾客提交订单完成的时间（在线支付成功、线下支付订单客服审批通过等），用于查询时间段内已支付的订单
- 优惠券使用时间：顾客在结账页面填写优惠券码并提交的时间
- 系统通过该时间段筛选符合条件的所有订单和优惠券使用记录，然后进行汇总计算
- 各类金额均为基础货币