首页 > 云鼎 > 云鼎数据推送使用手册

云鼎数据推送使用手册

1. 概述

许多卖家和ISV在采用API获取订单、商品、退款等主要的信息的时候,由于网络、服务器、开发技术水平等影响,常常会出现数据重复、数据漏单或者是获取不了数据的现象,这使得卖家尤其是在应对大促的时候束手无策,只能眼睁睁的看着生意溜走或者被投诉,如何才能让卖家再也不用为这些事情烦恼呢?云鼎推出了数据同步服务,通过使用云鼎中的云数据库,实现将京东的交易、商品、退款等主要数据直接实时、准确地推送给用户,让用户再也不用为这些数据而烦恼!

2. 数据推送功能使用

数据推送服务需先申请开通,并做设置后才能使用,详细参考如下操作步骤:

2.1. 数据推送服务开通

ISV服务商/自研商家向商务运营人员申请开通数据推送服务权限。

申请流程

发送邮件到:yunding@jd.com

邮件标题:数据推送开通申请+公司名称

邮件正文:

1.业务场景描述

2.申请原因

3.申请人信息(如下表)

公司名称账号服务名称服务编码类目APPKEY联系人联系电话邮箱申请原因
          
          


审核规则

(1)订单推送服务更适用订单处理类服务,其它类型服务如需开通,请提供详细的产品说明(如MRD,PRD等),以供进一步审核。
(2)申请应用或服务需符合入鼎基本标准:应用布署到云主机,数据库布署到云数据库
注:目前数据推送功能仅支持华北数据中心,开通此功能,请将应用及数据库部署到华北数据中心。

审核不通过原因

(1)服务未发布或应用未上线
(2)类目不符合要求
(3)不符合入鼎基本标准

2.2. 数据推送服务设置

数据推送服务权限开通后,您可在数据推送服务页面进行服务配置,该页面可以设置数据库信息、设置同步内容、选择商家,进行启用,详细如下描述。

注意:启用服务时,要求数据库信息不为空、商家数不为空,才能启用成功,否则启用失败。



2.2.1. 设置数据库
设置同步到哪个数据库实例,选择同步的实例名称右箭头添加,数据库较多可通过筛选条件缩小范围。

设置中:



设置完成:



2.2.2. 设置同步内容
用户可以自定义系统推送的类目及返回字段。
点击设置同步内容后弹出编辑窗口,选中需要推送的数据,点击确定。
设置中:

设置完成:

2.2.3. 设置同步商家
点击选择商家后弹出编辑窗口,输入商家的名称,点击搜索,选中某一个商家,点击右箭头添加或左箭头删除已选用户,点击确定完成。
设置中:

设置完成:

2.2.4. 启用/禁用服务
1. 点击启用按钮后,该服务启用,按钮变为禁用;
2. 点击禁用按钮后,该服务禁用,按钮变为启用。

2.3. 数据推送服务表结构

数据推送服务数据推送到默认库jcloud_yunding_db_push,该库中包含交易jd_pop_order等表。数据推送表结构设计为:关键字段+Text大字段,其中关键字段的命名和API返回字段是一致的。业务字段增加,只增加到Text大字段里。而关键字段一旦确定,就不会再改变。
1. 表名称:jd_pop_order

2. 表结构如下

序号名称数据类型可否为空总长度描述
1vender_idbigint不可以
商家ID
2pushModifieddatetime可以
数据推送的修改时间
3pinvarchar可以50下单帐号
4orderIdbigint不可以
订单Id
5statevarchar可以50订单状态
6orderTypevarchar可以
订单类型
7createddatetime可以
交易创建时间
8modifieddatetime可以
交易修改时间
9pushCreateddatetime可以
数据推送的创建时间
10responseJsontext可以

API返回的整个JSON字符串

(参看jingdong.pop.order.get
11hashcodevarchar可以128用来做数据校验的字段


3. 返回示例


{
"chineseErrCode": "",
"englishErrCode": "",
"numberCode": ,
"success":
},
"orderInfo": {
"balanceUsed": "",
"consigneeInfo": {
"city": "",
"cityId": "",
"county": "",
"countyId": "",
"fullAddress": "",
"fullname":
"mobile": "",
"province": "",
"provinceId": "",
"telephone": "",
"town": "",
"townId": ""
},
"couponDetailList": [
{

}
],
"deliveryType": "",
"freightPrice": "",
"invoiceInfo": "",
"itemInfoList": [
{
"giftPoint": "",
"itemTotal": "",
"jdPrice": "",
"outerSkuId": "",
"productNo": "",
"skuId": "",
"skuName": "",
"wareId": ""
}
],
"logisticsId": "",
"modified": "",
"orderEndTime": "",
"orderId": "",
"orderPayment": "",
"orderRemark": "",
"orderSellerPrice": "",
"orderSign": "",
"orderSource": "",
"orderStartTime": "",
"orderState": "",
"orderStateRemark": "",
"orderTotalPrice": "",
"orderType": "",
"outBoundDate": "",
"payType": "",
"paymentConfirmTime": "",
"pin": "",
"returnOrder": "",
"sellerDiscount": "",
"storeOrder": "",
"venderId": "",
"venderRemark": "",
"waybill": ""
}
}