入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

订单数据(Ecommerce Order)

V1.1

loading


本节将为您介绍订单数据(Ecommerce Order)相关接口。获取订单数据接口用于查询指定账户在指定日期产生的枫页落地页订单数据。更新订单状态接口用于更新枫页落地页的状态和快递单号。


获取订单

ecommerce_order/get

GET

*为必填项
名称 类型 描述
account_id*
integer 广告主帐号 id,对订单有所有权的直客帐号或子客帐号
filtering
struct[] 过滤条件,若此字段不传,或传空则视为无限制条件,详见 [过滤条件]
数组最小长度 1,最大长度 2
field*
string 过滤字段
可选值:{ ecommerce_order_id, ecommerce_order_status }
operator*
enum 操作符
当 field 取值 ecommerce_order_id 时,枚举列表:{ EQUALS, IN }
当 field 取值 ecommerce_order_status 时,枚举列表:{ EQUALS, IN }
values*
string[] 字段取值,values 数组的个数限制与 operator 的取值相关,详见 [过滤条件]
当 field 取值 ecommerce_order_id 时,
字段长度最大 120 字节

当 field 取值 ecommerce_order_id 且 operator 取值 IN 时,
字段长度最大 120 字节

当 field 取值 ecommerce_order_status 时,
枚举列表:{ AWAITING_ORDER, SHIPPING_SOON, SHIPPED, DELIVERED, RETURNED }

当 field 取值 ecommerce_order_status 且 operator 取值 IN 时,
枚举列表:{ AWAITING_ORDER, SHIPPING_SOON, SHIPPED, DELIVERED, RETURNED }
date_range*
struct 日期范围,最多支持查询 90 天内的数据查询
start_date*
string 开始日期,日期格式:YYYY-MM-DD
字段长度为 10 字节
end_date*
string 结束日期,日期格式:YYYY-MM-DD
字段长度为 10 字节
page
integer 页数,默认值:1
page_size
integer 分页大小,默认值:20

curl -G 'https://api.e.qq.com/v1.1/ecommerce_order/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"ecommerce_order_id","operator":"EQUALS","values":["B503186974486037"]},{"field":"ecommerce_order_status","operator":"IN","values":["SHIPPED","DELIVERED"]}]' \
-d 'date_range={"start_date":"2017-09-10","end_date":"2017-10-10"}' \
-d 'page=1' \
-d 'page_size=20' 
					
名称 类型 描述
list
struct[] 订单列表
account_id
integer 广告主帐号 id,对订单有所有权的直客帐号或子客帐号
ecommerce_order_id
string 订单 id
customized_page_name
string 页面名称
commodity_package_detail
string 套餐明细
quantity
integer 数量
price
integer 单价,单位为分
total_price
integer 总价,单位为分
ecommerce_order_time
string 下单时间
ecommerce_order_status
enum 订单状态,[枚举详情]
user_name
string 姓名
user_phone
string 手机号码
user_province
string 下单省份
user_city
string 下单城市
user_area
string 下单地区
user_address
string 收货地址
user_ip
string 下单 IP
user_message
string 留言
destination_url
string 落地页 url
adgroup_id
integer 广告组 id
adgroup_name
string 广告组名称
from_account_id
integer 来源账户 id,订单的来源广告所对应的广告主账户 id
delivery_spec
struct 物流详情
delivery_tracking_number
string 快递单号
express_company
enum 快递公司,快递公司和快递单号两个参数必须同时存在,[枚举详情]
delivery_info_list
struct[] 快递详情,包含快递地点及进度等信息
delivery_update_time
string 日期,查询日期,日期格式:YYYY-MM-DD hh:ii:ss,支持两年内的数据查询
delivery_detail
string 快递详情
page_info
struct 分页信息
page
integer 页数
page_size
integer 分页大小
total_number
integer 总行数
total_page
integer 总页数
{
    "code": 0,
    "message": "",
    "message_ch": "",
    "data": {
        "list": [
            {
                "adgroup_id": "123345",
                "adgroup_name": "微信广告",
                "from_account_id": "123456",
                "ecommerce_order_id": "B503186974486037",
                "quantity": 1,
                "price": 9900,
                "total_price": 9900,
                "user_name": "张三",
                "user_phone": "13800138000",
                "user_province": "黑龙江省",
                "user_city": "大庆市",
                "user_area": "肇源县",
                "user_address": "黑龙江省大庆市肇源县阿瓦尔瓦尔",
                "user_ip": "10.41.79.52",
                "ecommerce_order_time": "2018-05-03 11:38:17",
                "user_message": "",
                "account_id": "123456",
                "ecommerce_order_status": "DELIVERED",
                "customized_page_name": "营销组件-商品购物页",
                "destination_url": "http://ec.flzhan.cn/?r_id=134545034_7223c337c&pagetype=SINGLE&_bid=2759",
                "commodity_package_detail": "营销组件-商品购物页;产品一:蓝色,34;",
                "delivery_spec": {
                    "delivery_tracking_number": "123456",
                    "express_company": "ZTO",
                    "delivery_info_list": [
                        {
                            "delivery_update_time": "2019-06-28 10:40:17",
                            "delivery_detail": "货物已由本人签收,感谢您选择 xxx 物流!"
                        },
                        {
                            "delivery_update_time": "2019-06-28 08:40:34",
                            "delivery_detail": "配送员开始配送,请您准备收货,配送员,xxx,手机号,xxx"
                        },
                        {
                            "delivery_update_time": "2019-06-28 07:59:18",
                            "delivery_detail": "货物已分配,等待配送"
                        },
                        {
                            "delivery_update_time": "2019-06-28 07:59:17",
                            "delivery_detail": "货物已到达【北京角门营业部】"
                        },
                        {
                            "delivery_update_time": "2019-06-28 02:46:30",
                            "delivery_detail": "货物已完成分拣,离开【北京通州分拣中心】"
                        },
                        {
                            "delivery_update_time": "2019-06-27 23:31:28",
                            "delivery_detail": "货物已到达【北京通州分拣中心】"
                        },
                        {
                            "delivery_update_time": "2019-06-26 17:37:31",
                            "delivery_detail": "货物已完成分拣,离开【武汉外单分拣中心】"
                        },
                        {
                            "delivery_update_time": "2019-06-25 22:12:30",
                            "delivery_detail": "货物已完成分拣,离开【揭阳分拨中心】"
                        },
                        {
                            "delivery_update_time": "2019-06-24 19:27:29",
                            "delivery_detail": "货物已交付 xxx 物流"
                        },
                        {
                            "delivery_update_time": "2019-06-24 19:27:29",
                            "delivery_detail": "配送员 xxx 已经揽收完成"
                        }
                    ]
                }
            },
            {
                "adgroup_id": "123345",
                "adgroup_name": "微信朋友圈",
                "from_account_id": "123456",
                "ecommerce_order_id": "B503190359103349",
                "quantity": 1,
                "price": 9900,
                "total_price": 9900,
                "user_name": "李四",
                "user_phone": "13800138000",
                "user_province": "河北省",
                "user_city": "承德市",
                "user_area": "平泉县",
                "user_address": "河北省承德市平泉县温热污染",
                "user_ip": null,
                "ecommerce_order_time": "2018-05-03 11:43:55",
                "user_message": "",
                "account_id": "20345",
                "ecommerce_order_status": "AWAITING_ORDER",
                "customized_page_name": "营销组件-商品购物页",
                "destination_url": "https://0d493661.fyeds5.com/?r_id=134545195_f3fe56c3a&pagetype=SINGLE&_bid=2759",
                "commodity_package_detail": "营销组件-商品购物页;产品一:蓝色,34;",
                "delivery_spec": []
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 20,
            "total_number": 2,
            "total_page": 1
        }
    }
}


更新订单

ecommerce_order/update

POST

*为必填项
名称 类型 描述
account_id*
integer 广告主帐号 id,对订单有所有权的直客帐号或子客帐号
ecommerce_order_id*
string 订单 id
字段长度最小 1 字节,长度最大 20 字节
delivery_tracking_number
string 快递单号,快递公司和快递单号两个参数必须同时存在
字段长度最小 1 字节,长度最大 200 字节
express_company
enum 快递公司,快递公司和快递单号两个参数必须同时存在,[枚举详情]
枚举列表:{ UNKNOWN, SF_EXPRESS, STO, YTO, ZTO, BEST_EXPRESS, YUNDA_EXPRESS, TTK_EXPRESS, EMS, CHINA_POST_EXPRESS, JUST_IN_TIME, JD_EXPRESS, DEPPON_EXPRESS }

curl 'https://api.e.qq.com/v1.1/ecommerce_order/update?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'ecommerce_order_id=B326518663301826' \
-d 'delivery_tracking_number=VB40977313484' \
-d 'express_company=ZTO' 
					
{
    "code": 0,
    "message": "",
    "message_ch": ""
}