订单同步(不含分佣明细)
<p><strong>简要描述:</strong> </p>
<ul>
<li>作用:拉取在必应鸟授权的淘宝联盟/京东联盟/拼多多账号的订单,自行分析</li>
<li>若在必应鸟后台授权多个淘宝联盟/京东联盟/拼多多账号,会一起导出订单,需自行区分</li>
<li>请求的时间为订单的更新时间(updated_at),所以请求A时间段和B时间段的订单可能会有重复的订单,只是订单状态不同</li>
<li>建议:每个订单的ID是唯一的,判断返回的ID是否存在,不存在则保存,存在则覆盖原来的订单数据</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api/user/order_sync</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>GET </li>
</ul>
<p><strong>参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">start</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>开始时间,格式:2019-09-01 / 2019-09-01 13:00:00</td>
</tr>
<tr>
<td style="text-align: left;">end</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>结束时间,格式:2019-09-10 / 2019-09-01 14:00:00</td>
</tr>
<tr>
<td style="text-align: left;">min_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>最小ID,传入上一次请求返回的最大ID</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>订单类型:1-淘宝,2-拼多多,3-京东, 11-品牌券</td>
</tr>
<tr>
<td style="text-align: left;">order_no</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>订单号,淘宝(trade_id),拼多多(order_sn),京东(order_id)</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>页码,从1开始</td>
</tr>
<tr>
<td style="text-align: left;">page_size</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>每页数据量,默认20条</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"code": 0,
"msg": "success",
"data": {
"total_count": 14,
"total_page": 1,
"page": 1,
"data": [
{ //淘宝
"id": 31671,
"app_id": 970,
"taoke_id": 2,
"user_id": 0,
"out_user_id": "13697010690",
"user_ratios": null,
"created_at": "2020-05-26 11:54:19",
"updated_at": "2020-05-26 11:54:19",
"ali_id": 44, //阿里妈妈ID
"trade_parent_id": 2127119052264392711, //淘宝父订单号
"trade_id": 2092434166, //淘宝订单号
"num_iid": 0, //商品ID
"item_title": "青菜瘦肉粥等3件商品", //商品标题
"item_image": "https://cube.elemecdn.com/9/de/677120355e1ac60eaa48be8821662jpeg.jpeg", //商品图片
"item_num": 3, //商品数量
"item_price": "4.50", //商品原价,单位:元
"price": 0, //单价
"pay_price": 13.5, //实际支付金额
"seller_nick": "四季粥铺(紫金港店)", //卖家昵称
"seller_shop_title": "四季粥铺(紫金港店)", //卖家店铺名称
"commission": "0.81", //该订单全部的结算金额
"commission_rate": 1, //该订单的结算分成比率
"create_time": "2020-05-26 06:49:33", //淘客订单创建时间
"earning_time": "2020-05-26 07:44:40", //淘客订单结算时间
"tk_status": 3, //淘客订单状态,3:确认收货,12:订单付款, 13:订单失效,14:订单成功
"tk3rd_type": "", //第三方服务来源,没有第三方服务,取值为“--”
"tk3rd_pub_id": null, //第三方推广者ID
"order_type": "饿了么", //订单类型,如天猫,淘宝
"income_rate": 0.06, //收入比率,卖家设置佣金比率+平台补贴比率
"pub_share_pre_fee": "0.81", //预估佣金,付款金额*(佣金比率+补贴比率)*分成比率
"subsidy_rate": 0, //补贴比率
"subsidy_type": "--", //补贴类型,天猫:1,聚划算:2,航旅:3,阿里云:4
"terminal_type": "无线", //成交平台,PC:1,无线:2
"auction_category": "快餐便当", //类目名称
"site_id": 1285250460, //来源媒体ID
"site_name": "神犬集市", //来源媒体名称
"adzone_id": 110010000065, //广告位ID
"adzone_name": "神犬集市", //广告位名称
"alipay_total_price": 13.5, //付款金额
"total_commission_rate": 0.06, //佣金比率
"total_commission_fee": 0.81, //佣金金额
"subsidy_fee": 0, //补贴金额
"relation_id": 0, //渠道ID
"special_id": 0, //会员运营ID
"tb_paid_time": "2020-05-26 06:49:39", //订单在淘宝拍下付款的时间
"tk_paid_time": "2020-05-26 06:49:49", //订单付款的时间
"tk_order_role": 2, //二方:佣金收益的第一归属者; 三方:从其他淘宝客佣金中进行分成的推广者
"refund_tag": 0, //维权标签,0 含义为非维权 1 含义为维权订单
"alimama_share_fee": "0.08", //技术服务费=结算金额*收入比率*技术服务费率。推广者赚取佣金后支付给阿里妈妈的技术服务费用
"click_time": "2020-05-26 06:44:03", //通过推广链接达到商品、店铺详情页的点击时间
"pub_id": "204880197", //阿里妈妈ID
"tk_deposit_time": "--", //预售时期,用户对预售商品支付定金的付款时间,可能略晚于在淘宝付定金时间
"tb_deposit_time": "--", //预售时期,用户对预售商品支付定金的付款时间
"deposit_price": "0.00", //预售时期,用户对预售商品支付的定金金额
"app_key": null //开发者调用api的appkey
},
{ //拼多多
"id": 2973,
"app_id": 970,
"taoke_id": 2,
"user_id": 50048,
"out_user_id": "18597739618",
"user_ratios": null,
"created_at": "2020-05-10 00:01:15",
"updated_at": "2020-05-26 10:39:03",
"order_sn": "200509-686650327752542", //推广订单编号
"goods_id": 99367656204, //商品ID
"goods_name": "烟台红富士苹果山东新鲜水果整箱批发3斤/5斤/10斤脆甜冰糖心", //商品标题
"category": "海淘", //类目名称
"goods_thumbnail_url": "http://t00img.yangkeduo.com/goods/images/2020-03-27/34f1f827ccdadeda7c24695b80d07319.jpeg", //商品图片
"goods_quantity": 1, //购买商品的数量
"goods_price": 4456, //订单中sku单件价格(分)
"order_amount": 4456, //订单支付金额(分)
"p_id": "1031777_128279548", //PID
"promotion_rate": 10, //佣金比例(千分比)
"promotion_amount": "45", //佣金金额(分)
"order_status": 2, //订单状态: 0-已支付;1-已成团;2-确认收货;3-审核成功;4-审核失败(不可提现);5-已经结算;8-非多多进宝商品(无佣金订单)
"order_create_time": "2020-05-09 23:58:47", //订单生成时间
"order_pay_time": "2020-05-09 23:58:56", //支付时间
"order_receive_time": "2020-05-26 10:36:48", //订单收货时间
"order_settle_time": null, //订单结算时间
"order_group_success_time": "2020-05-10 13:33:43", //订单成团时间
"order_verify_time": null, //审核时间
"order_modify_at": "2020-05-26 10:38:28", //最后更新时间
"custom_parameters": null, //扩展参数
"type": 0 //订单类型
},
{ //京东
"id": 1727,
"app_id": 897,
"taoke_id": 1237,
"user_id": 7481,
"out_user_id": "18597739618",
"user_ratios": null,
"created_at": "2020-05-10 00:01:15",
"updated_at": "2020-05-26 10:39:03",
"order_id": "116922375794", //订单ID
"parent_id": "0", //父单ID
"plus": 0, //plus会员
"union_id": "1001899546", //授权账号的站长ID
"sku_id": "67786381484", //商品ID
"sku_name": "樟脑丸芳香去味家用衣柜防霉防虫衣服防潮木天然卫生球无毒清香型 3包装(约60粒)", //商品名称
"item_image": "http://img14.360buyimg.com/ads/jfs/t1/110371/5/11658/165308/5e8f0d0cE082c3c45/fa99575da39f6748.jpg", //商品图
"category": "家居日用", //商品类目
"sku_num": 1, //商品数量
"sku_return_num": 0, //商品已退货数量
"frozen_sku_num": 0, //商品售后中数量
"price": "5.90", //单价
"pay_price": "5.90", //实际支付金额
"commission_rate": "20.00", //佣金比例
"sub_side_rate": "90.00", //分成比例
"subsidy_rate": "0.00", //补贴比例
"final_rate": "90.00", //最终比例
"estimate_fee": "1.06", //预估佣金
"actual_fee": "0.00", //实际佣金
"valid_code": 15, //有效码(-1:未知,2.无效-拆单,3.无效-取消,4.无效-京东帮帮主订单,5.无效-账号异常,6.无效-赠品类目不返佣,7.无效-校园订单,8.无效-企业订单,9.无效-团购订单,10.无效-开增值税专用发票订单,11.无效-乡村推广员下单,12.无效-自己推广自己下单,13.无效-违规订单,14.无效-来源与备案网址不符,16.已付款,17.已完成,18.已结算)
"site_id": "1956965933", //网站ID
"finish_time": null, //订单完成时间
"order_time": "2020-05-26 11:53:32", //下单时间
"pay_month": null, //结算时间
"order_emt": 2, //下单设备(1:PC,2:无线)
"pop_id": "10230345", //商家ID
"pid": "", //联盟子站长身份标识,格式:子站长ID_子站长网站ID_子站长推广位ID
"position_id": "1948330389", //推广位ID,0代表无推广位
"sub_union_id": "1_1_7481", //子联盟ID(需要联系运营开放白名单才能拿到数据)
"union_tag": "0000000000000100" //联盟标签数据(整型的二进制字符串(32位),目前只返回8位
}
]
}
}</code></pre>
<p><strong>公共返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">total_count</td>
<td style="text-align: left;">int</td>
<td>总数据量</td>
</tr>
<tr>
<td style="text-align: left;">total_page</td>
<td style="text-align: left;">int</td>
<td>总页数</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">int</td>
<td>当前页码</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">array</td>
<td>订单列表</td>
</tr>
<tr>
<td style="text-align: left;">data.*.id</td>
<td style="text-align: left;">int</td>
<td>主键</td>
</tr>
<tr>
<td style="text-align: left;">data.*.app_id</td>
<td style="text-align: left;">int</td>
<td>应用ID</td>
</tr>
<tr>
<td style="text-align: left;">data.*.taoke_id</td>
<td style="text-align: left;">int</td>
<td>淘客ID</td>
</tr>
<tr>
<td style="text-align: left;">data.*.user_id</td>
<td style="text-align: left;">int</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">data.*.out_user_id</td>
<td style="text-align: left;">string</td>
<td>外部用户ID</td>
</tr>
<tr>
<td style="text-align: left;">data.*.user_ratios</td>
<td style="text-align: left;">string</td>
<td>分利信息</td>
</tr>
<tr>
<td style="text-align: left;">data.*.created_at</td>
<td style="text-align: left;">string</td>
<td>创建时间</td>
</tr>
<tr>
<td style="text-align: left;">data.*.updated_at</td>
<td style="text-align: left;">string</td>
<td>更新时间</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>订单类型不同,data 里的每一个object 返回的字段会不一样,这个关注一下;时间不填,默认是近两天的数据</li>
</ul>