订单查询接口

阅读时间约 3 分钟

广告主需将多麦渠道的订单提供给多麦联盟查询,多麦联盟会定期读取该接口同步订单数据。

接口说明

  • 支持时间粒度查询为秒
  • 支持订单更新时间维度查询与排序
  • 白名单 ip 请联系多麦技术人员
  • 可加签名验证,由广告主提供秘钥 (需提供接口签名文档)

默认查询频率

如有要求可调整频率

  • 3 分钟一次查询前 5 分钟数据
  • 1 小时一次查询前 1 小时数据
  • 1 天一次查询前 15 天数据

接口示例

广告主可参考以下示例提供接口,如已有接口与格式,需要提供接口文档给多麦

https://www.yourdomain.com/cps/orders?union=duomai&stime=1373414581&etime=1373415181

参数参数值示例参数类型参数说明
unionduomaistring区分查询的是哪一个 cps 联盟的订单,同接入接口的 union 参数值
union_idduomaistring区分查询的是哪一个 cps 联盟的订单,同接入接口的 union_id 参数值
stime1373414581时间戳查询订单数据的起始时间(2013-07-10 08:03:10),建议使用订单更新时间
etime1373415181时间戳查询订单数据的结束时间(2013-07-10 08:13:10),建议使用订单更新时间
sn201303031111string订单编号

接口返回格式示例

含义对应参数(区分大小写)必选类型示例值详细解释说明
接入接口传入的网站主标识euidstring100261230dGVzdA0接入接口传入的 euid 参数值
接入接口传入的网站主的网站 IDmidstring10026接入接口传入的 mid 参数值
订单编号order_snstring2013060412779
子订单编号suborder_snstring050601
下单时间order_timedatetime2013-06-04 12:05:00用户在贵商家网站下单的时间
点击时间click_timedatetime2013-06-04 11:23:00用户进入接入接口的时间
订单金额orders_pricefloat200.00用户实际支付的金额(去掉使用优惠券/现金券/快递费 等不计算佣金的那部分金额)请勿使用 19,999 表示法
订单状态order_statusstring例如:有效、无效、未付款、已付款、已发货等状态商家系统存在的订单状态描述,返回中文
下单渠道channelint10 表示 pc 端, 1 表示 wap 端,3 表示 ROI 订单,其它值待扩展,也可由商家自行决定值
是否是新顾客is_new_customstring1是新客:1 非新客:0
来源链接refererstringhttp://c.duomai.com/track.php?sid=10010&aid=123&euid=&t=http://www.yourdomain.com/跳转到接入接口的流量来源 URL
货币代码currency非人民币时必选stringCNY标准的货币代码参见:http://zh.wikipedia.org/zh/ISO_4217
时区代码timezone非北京时间时必选stringUTC+8标准的时区代码参见: http://zh.wikipedia.org/zh/%E6%97%B6%E5%8C%BA%E5%88%97%E8%A1%A8
是否测试数据testint1 或 0当传递 test=1 时,请求后会反馈详细的推送报告,并将数据发送到多麦 cps 联盟的测试订单库,但是数据不会返回到正式订单库
商品编号goods_idstring87154715商品 SKUid
商品名称goods_namestring新款一字领荷叶袖蕾丝衫
商品数量goods_taint2
商品单价goods_priceint110
商品总价(净金额)totalPriceint200行商品实付总价,需要去除优惠券、运费等金额,此件商品优惠了 20 元,那么此值为 110*2-20=200
商品佣金金额commissionfloat24.00商品产生的佣金
商品佣金比例ratefloat0.12商品佣金和商品金额的比例
商品佣金类别commission_typestringA双方合同规定的佣金分类
商品分类编号goods_catestring104
商品分类名称goods_cate_namestring服装
商品详情detailsarray多商品时,可将商品数据放在该字段, 单条数据对象包含上述商品字段goodsid, goodsname, ......, goods_cate_name等信息