订单推送

阅读时间约 1 分钟

主动推送渠道订单，会让推广流量主更快感知订单数据返回，提高推广积极性。在roi合作中，也能高效的获得数据反馈，及时更新投放策略。

推送要求

只提供订单推送，不提供订单查询的广告主需收到ack响应后确保推送成功。
多次重复推送只保留一次

推送地址

code与hash 请联系对应营销顾问获取。

自定义格式订单推送地址，请联系多麦技术人员，或提供推送地址修改保存入口。

https://platform.duomai.com/apis/cps.service.order/ads/push/{code}

推送格式

如有自定义格式，需提供对应文档

接口推送请求为 POST(x-www-form-urlencoded)格式，请注意。

含义	对应参数(区分大小写)	必选	详细描述
认证,电商身份标识	hash	必选	推送订单的hash值
联盟传递给电商的网站主标识	euid	必选	接入接口传入的euid 参数值。此值最长在200个字符左右，希望贵方预留足够长度的字段存储此值。
订单编号	order_sn	必选
子订单编号	suborder_sn	可选
下单时间	order_time	必选	用户下单时间，未传递采用当前时间，时间格式为2012-04-04 03:23:09
点击时间	click_time	可选	用户点击进入cps接入接口的时间，时间格式为2012-04-04 02:09:09
订单金额	orders_price	必选	用户实际支付的现金金额，即订单总价减去使用优惠券/现金券/快递费等不计算佣金的那部分金额
是否新客	is_new_custom	可选	1为新客,0为老客,不分新老客传0
订单状态	order_status	必选	商家系统存在的订单状态描述，返回中文
货币代码	currency	可选	默认为人民币(CNY)，其它币种请传入标准的货币代码，http://zh.wikipedia.org/zh/ISO_4217
时区代码	timezone	可选	默认为北京时间(UTC+8)，其它时区请传入标准的时区代码， http://zh.wikipedia.org/zh/%E6%97%B6%E5%8C%BA%E5%88%97%E8%A1%A8
商品编号	goods_id	必选	如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
商品名称	goods_name	必选	如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
商品单价	goods_price	必选	如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
商品数量	goods_ta	必选	默认为 1，如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
商品分类编号	goods_cate	必选	如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
商品分类名称	goods_cate_name	必选	如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
商品总净金额	total_price	必选	行商品实付总价，需要去除优惠券、运费等金额，如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
商品的佣金比例	rate	必选	如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
商品的佣金金额	commission	必选	如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
佣金分类	commission_type	可选	如果一次同时推送同一订单内的多件商品信息，各个商品属性之间采用竖线拼接，并注意去掉参数值最后面的一个竖线
字符编码	encoding	可选	如果此次推送的数据包含中文且非UTF8编码，请设置相应的编码值。如：推送的为gbk 数据 encoding=gbk;如果数据默认为 UTF8 编码则无需设置此值

推送返回ack

成功返回

{
  status:"OK"
}

错误返回

{
    "error": {
        "code": 401,
        "message": "无权限"
    }
}

查看推送结果

GET请求推送地址，后面加上hash即可查看最近50条推送数据

例：https://platform.duomai.com/apis/cps.service.order/ads/push/{code}?hash=DASDWFSAX

多麦联盟