订单查询接口
广告主需将多麦渠道的订单提供给多麦联盟查询,多麦联盟会定期读取该接口同步订单数据。
接口说明
- 支持时间粒度查询为秒
- 支持订单更新时间维度查询与排序
- 白名单 ip 请联系多麦技术人员
- 可加签名验证,由广告主提供秘钥 (需提供接口签名文档)
默认查询频率
如有要求可调整频率
- 3 分钟一次查询前 5 分钟数据
- 1 小时一次查询前 1 小时数据
- 1 天一次查询前 15 天数据
接口示例
广告主可参考以下示例提供接口,如已有接口与格式,需要提供接口文档给多麦
https://www.yourdomain.com/cps/orders?union=duomai&stime=1373414581&etime=1373415181
参数 | 参数值示例 | 参数类型 | 参数说明 |
---|---|---|---|
union | duomai | string | 区分查询的是哪一个 cps 联盟的订单,同接入接口的 union 参数值 |
stime | 1373414581 | 时间戳 | 查询订单数据的起始时间(2013-07-10 08:03:10),建议使用订单更新时间 |
etime | 1373415181 | 时间戳 | 查询订单数据的结束时间(2013-07-10 08:13:10),建议使用订单更新时间 |
sn | 201303031111 | string | 订单编号 |
接口返回格式示例
含义 | 对应参数(区分大小写) | 必选 | 类型 | 示例值 | 详细解释说明 |
---|---|---|---|---|---|
接入接口传入的网站主标识 | euid | 是 | string | 100261230dGVzdA0 | 接入接口传入的 euid 参数值 |
接入接口传入的网站主的网站 ID | mid | 否 | string | 10026 | 接入接口传入的 mid 参数值 |
订单编号 | order_sn | 是 | string | 2013060412779 | |
子订单编号 | suborder_sn | 否 | string | 050601 | |
下单时间 | order_time | 是 | datetime | 2013-06-04 12:05:00 | 用户在贵商家网站下单的时间 |
点击时间 | click_time | 否 | datetime | 2013-06-04 11:23:00 | 用户进入接入接口的时间 |
订单金额 | orders_price | 是 | float | 200.00 | 用户实际支付的金额(去掉使用优惠券/现金券/快递费 等不计算佣金的那部分金额)请勿使用 19,999 表示法 |
订单状态 | order_status | 是 | string | 例如:有效、无效、未付款、已付款、已发货等状态 | 商家系统存在的订单状态描述,返回中文 |
下单渠道 | channel | 否 | int | 1 | 0 表示 pc 端, 1 表示 wap 端,3 表示 ROI 订单,其它值待扩展,也可由商家自行决定值 |
是否是新顾客 | is_new_custom | 否 | string | 1 | 是新客:1 非新客:0 |
来源链接 | referer | 否 | string | http://c.duomai.com/track.php?sid=10010&aid=123&euid=&t=http://www.yourdomain.com/ | 跳转到接入接口的流量来源 URL |
货币代码 | currency | 非人民币时必选 | string | CNY | 标准的货币代码参见:http://zh.wikipedia.org/zh/ISO_4217 |
时区代码 | timezone | 非北京时间时必选 | string | UTC+8 | 标准的时区代码参见: http://zh.wikipedia.org/zh/%E6%97%B6%E5%8C%BA%E5%88%97%E8%A1%A8 |
是否测试数据 | test | 否 | int | 1 或 0 | 当传递 test=1 时,请求后会反馈详细的推送报告,并将数据发送到多麦 cps 联盟的测试订单库,但是数据不会返回到正式订单库 |
商品编号 | goods_id | 是 | string | 87154715 | 商品 SKUid |
商品名称 | goods_name | 是 | string | 新款一字领荷叶袖蕾丝衫 | |
商品数量 | goods_ta | 是 | int | 2 | |
商品单价 | goods_price | 是 | int | 110 | |
商品总价(净金额) | totalPrice | 是 | int | 200 | 行商品实付总价,需要去除优惠券、运费等金额,此件商品优惠了 20 元,那么此值为 110*2-20=200 |
商品佣金金额 | commission | 是 | float | 24.00 | 商品产生的佣金 |
商品佣金比例 | rate | 是 | float | 0.12 | 商品佣金和商品金额的比例 |
商品佣金类别 | commission_type | 否 | string | A | 双方合同规定的佣金分类 |
商品分类编号 | goods_cate | 是 | string | 104 | |
商品分类名称 | goods_cate_name | 是 | string | 服装 | |
商品详情 | details | 否 | array | 多商品时,可将商品数据放在该字段, 单条数据对象包含上述商品字段goodsid, goodsname, ......, goods_cate_name等信息 |