API开放平台

TIP

# 推送客户销售区域数据

勤策平台客户销售区域发生变化时向第三方系统推送数据接口

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL
请求参数：

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本，如：001
dataFormat 数据格式：json
dataSource 数据来源。biz：业务功能产生，api：开放接口产生
timestamp 请求时间戳，如：1503276678552
status 数据同步状态。0：数据首次同步，2：数据失败同步
statusTime 上次同步失败时间。格式：yyyy-MM-dd HH:mm:ss
tenantId 企业ID，各注册企业在勤策中对应的唯一ID
digest 数据签名，md5(data|pushsecret|timestamp)
dataType custom_district
data <<请求数据体>> ，说明：格式为JSON格式数据

请求数据体：

{
    "id": "98000123465333545",
    "district_id": " D0001",
    "name": "南京区域",
    "parent_id": "7500041346654650",
    "parent_district_id": " D0002",
    "sequ ": 120,
    "remarks ": "南京大区",
    "status ": "1",
    "creator_id": "1520000034487354",
    "creator_emp_id": "EMP0001",
    "creator_name": "张三",
    "create_time": "2016-07-02 13:20:45",
    "modifyier_id": "1520000034487354",
    "modifyier_emp_id": "emp0002",
    "modifyier_name": "李四",
    "modify_time": "2016-07-02 13:20:45"
}

参数说明：

参数 类型 必填 说明
id int8 是 销售区域ID，勤策平台唯一ID
district_id varchar32 否 销售区域ID，来源第三方系统的唯一ID
name varchar32 是 销售区域名称
parent_id int8 是 销售区域上级，来源勤策平台唯一ID
parent_district_id varchar32 否 销售区域上级，来源第三方系统的唯一ID
sequ numeric(20,2) 否 排序号
status char1 是 状态。0：停用，1：启用
creator_id int8 是 创建人id，来源勤策员工唯一ID
creator_emp_id varchar32 否 创建人id，来源第三方系统的唯一ID
creator_name varchar32 是 创建人名称
create_time varchar32 是 创建时间。格式: yyyy-MM-dd HH:mm:ss
modifyier_id int8 否 修改人id，来源勤策员工唯一ID
modifyier_emp_id varchar32 否 修改人id，来源第三方系统的唯一ID
modifyier_name varchar32 否 修改人名称
modify_time varchar32 否 修改时间。格式: yyyy-MM-dd HH:mm:ss

响应示例：

{
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int 响应编码。0：成功，1：失败
return_msg String 响应说明

# 推送客户类型数据

勤策平台客户类型发生变化时向第三方系统推送数据

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL

请求参数：

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本，如：001
dataFormat 数据格式：json
dataSource 数据来源。biz：业务功能产生，api：开放接口产生
timestamp 请求时间戳，如：1503276678552
status 数据同步状态。0：数据首次同步，2：数据失败同步
statusTime 上次同步失败时间，格式：yyyy-MM-dd HH:mm:ss
tenantId 企业ID，各注册企业在勤策中对应的唯一ID
digest 数据签名，md5(data|pushsecret|timestamp)
dataType custom_type 客户类型
data <<请求数据体>> ， 说明：格式为JSON格式数据

请求数据体：

{
    "id": "98000123465333545",
    "type_id": "T0001",
    "name": "重点客户",
    "parent_id": "7500041346654650",
    "parent_code": "CODE",
    "parent_type_id": "T0002",
    "image": " ct-11",
    "sequ": 120,
    "trade_type": "1",
    "remarks": "重点客户分类",
    "status ": "1",
    "creator_id": "1520000034487354",
    "creator_emp_id": "EMP001",
    "creator_name": "勤策_1",
    "create_time": "2016-07-02 13:20:45",
    "modifyier_id": "1520000034487354",
    "modifyier_emp_id": " EMP002",
    "modifyier_name": "勤策_2",
    "modify_time": "2016-07-02 13:20:45"
}

参数说明：

参数 类型 必填 说明
id int8 是 勤策平台唯一ID
code varchar32 否 code类型编码，勤策平台类型编码
type_id varchar32 否 来源第三方系统的唯一ID
name varchar32 是 名称
parent_id int8 是 上级类型，来源勤策平台唯一ID
parent_code varchar32 否 上级code类型编码，勤策平台类型编码
parent_type_id varchar32 否 上级类型，来源第三方系统的唯一ID
sequ numeric(20,2) 否 排序号
status char1 是 状态。0：停用，1：启用
creator_id int8 是 创建人id，来源勤策员工唯一ID
creator_emp_id varchar32 否 创建人id，来源第三方系统的唯一ID
creator_name varchar32 是 创建人名称
create_time varchar32 是 创建时间。格式: yyyy-MM-dd HH:mm:ss
modifyier_id int8 否 修改人id，来源勤策员工唯一ID
modifyier_emp_id varchar32 否 修改人id，来源第三方系统的唯一ID
modifyier_name varchar32 否 修改人名称
modify_time varchar32 否 修改时间。格式: yyyy-MM-dd HH:mm:ss
trade_type CHAR(1) 是 客户分类。1：客户，2：经销商，3：门店
remarks CHAR(1) 是 备注

image

响应示例：

{
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int 响应编码。0：成功，1：失败
return_msg String 响应说明

# 推送客户数据

勤策平台客户、门店、经销商数据发生变化时向第三方系统推送数据

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL

请求参数：

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本，如：001
dataFormat 数据格式：json
dataSource 数据来源。biz：业务功能产生，api：开放接口产生
timestamp 请求时间戳，如：1503276678552
status 数据同步状态。0：数据首次同步，2：数据失败同步
statusTime 上次同步失败时间。格式：yyyy-MM-dd HH:mm:ss
tenantId 企业ID，各注册企业在勤策中对应的唯一ID
digest 数据签名，md5(data|pushsecret|timestamp)
dataType custom 客户
data <<请求数据体>> ，说明：格式为JSON格式数据

请求数据体：

{
    "id": "1200235510200010120",
    "cm_id": "CM0001",
    "cm_name": "苏果夫子庙店",
    "cm_code": "suguo_fzmd",
    "cm_manager": "王伟,张强,吴为",
    "cm_manager_id": "1200235510200010125, 1200235510200010126",
    "cm_manager_emp_id": "EMP001, -1",
    "cm_type": "2100235510200010120",
    "cm_type_id": "T001",
    "cm_district": "2100003150325415655",
    "cm_district_id": "D001",
    "cm_mss_province": "江苏省",
    "cm_mss_province_code": "320000",
    "cm_mss_city": "南京市",
    "cm_mss_city_code": "320100",
    "cm_mss_area": "秦淮区",
    "cm_mss_area_code": "320104",
    "cm_mss_street":"华侨路街道",
    "cm_mss_street_code":"320106002",
    "cm_addr": "南京市秦淮区大全福巷1号",
    "cm_delivery_addr": "南京市秦淮区大四福巷10号",
    "cm_cooperate_status": "1",
    "cm_uper_customer": "1200235510200010125",
    "cm_uper_customer_id": "CM0001",
    "cm_uper_customer_name": "苏果新街口店",
    "cm_level": "1200235510200010125",
    "cm_level_id": "L0001",
    "cm_level_name": "A级别",
    "cm_source": "老客户介绍",
    "cm_trade": "服务业",
    "cm_scale": "200人以上",
    "cm_tel": "02552416854",
    "cm_fax": "02552416854",
    "cm_post": "210010",
    "cm_type_code":"test2",
    "cm_district_code":"code03",
    "cm_remarks": "",
    "credit_no": "统一社会信用代码",
    "registration_no": "工商注册号信息",
    "cm_pictures": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "cm_liscence": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "liscence_name":"营业执照名称",
    "cm_sale_direct": "是",
    "linkmans": [
        {
            "cm_linkman_name": "张三",
            "cm_linkman_job": "店主",
            "cm_linkman_mobile": "13052125555",
            "cm_linkman_office_tel": "52365895",
            "cm_linkman_fax": "25758545",
            "cm_linkman_sex": "M",
            "cm_linkman_birthday": "1980-02-06",
            "cm_linkman_email": "abc@163.com",
            "cm_linkman_remarks": "",
            "cm_linkman_main": "1",
            "cm_linkman_qq": "qq",
            "cm_linkman_weixin": "微信",
            "cm_linkman_dept": "部门",
            "exts": [
                {
                    "cm_ext_key": "联系人",
                    "cm_ext_value": "四星"
                },
                {
                    "cm_ext_key": "主营商品",
                    "cm_ext_value": "食品,电器,日化用品"
                }
            ]
        },
        {
            "cm_linkman_name": "李四",
            "cm_linkman_job": "店员",
            "cm_linkman_mobile": "13022215212",
            "cm_linkman_office_tel": "58755254",
            "cm_linkman_fax": "",
            "cm_linkman_sex": "F",
            "cm_linkman_birthday": "1981-02-14",
            "cm_linkman_email": "",
            "cm_linkman_remarks": "",
            "cm_linkman_main": "0",
            "cm_linkman_qq": "qq",
            "cm_linkman_weixin": "微信",
            "cm_linkman_dept": "部门",
            "exts": [
                {
                    "cm_ext_key": "联系人",
                    "cm_ext_value": "四星"
                },
                {
                    "cm_ext_key": "主营商品",
                    "cm_ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ],
    "exts": [
        {
            "cm_ext_key": "级别",
            "cm_ext_value": "四星"
        },
        {
            "cm_ext_key": "主营商品",
            "cm_ext_value": "食品,电器,日化用品"
        }
    ],
    "status ": "1",
    "creator_id": "1520000034487354",
    "creator_emp_id": "EMP001",
    "creator_name": "勤策_1",
    "create_time": "2016-07-02 13:20:45",
    "modifyier_id": "1520000034487354",
    "modifyier_emp_id": "EMP002",
    "modifyier_name": "勤策_2",
    "modify_time": "2016-07-02 13:20:45",
    "cm_label_id": "5261717043611276089",
    "cm_label": "合格",
    "cm_assistant_id": "7737974938533767582,5973487364548349847",
    "cm_dept_id": "",
    "freq_visit": "",
    "waiqin365_upper_dealer_id": "",
    "autarky_dealer_name": "",
    "autarky_dealer_code": "",
    "autarky_waiqin365_dealer_id": "",
    "autarky_dealer_id": "",
    "return_pool_reason": "打回测试"

}

参数说明：

参数 类型 必填 说明
id int8 是 勤策平台唯一ID
trade_type CHAR(1) 是 客户分类。1：客户，2：经销商，3：门店
cm_id VARCHAR(32) 是 第三方系统同步的客户唯一ID
cm_name VARCHAR(100) 是 客户名称
cm_name_py VARCHAR(200) 是 客户名称拼音首字母
cm_code VARCHAR(32) 是 客户编码
cm_manager VARCHAR(4000) 否 客户经理,多个名称间以“,”分隔
cm_manager_id VARCHAR(4000) 否 客户经理ID(勤策),多个以“,”分隔
cm_manager_code VARCHAR(4000) 否 客户经理code，多个已“,”分隔
cm_manager_emp_id VARCHAR(4000) 否 客户经理ID(第三方),多个以“,”分隔
cm_manager_dept_id VARCHAR(4000) 否 客户经理所属部门id（第三方），多个以“,”分隔
cm_manager_dept_name VARCHAR(4000) 否 客户经理所属部门name，多个以“,”分隔
cm_manager_dept_code VARCHAR(4000) 否 客户经理所属部门code，多个以“,”分隔
cm_manager_dept_waiqinid VARCHAR(4000) 否 客户经理所属部门勤策id，多个以“,”分隔
dealer_name VARCHAR(4000) 否 所属经销商，多个以“,”分隔
waiqin365_dealer_id VARCHAR(4000) 否 所属经销商ID(勤策),多个以“,”分隔
dealer_code VARCHAR(4000) 否 所属经销商编码(勤策),多个以“,”分隔
dealer_id VARCHAR(4000) 否 所属经销商ID(第三方),多个以“,”分隔
cm_type int8 是 客户类型ID（勤策）
cm_type_id VARCHAR(32) 否 客户类型ID（第三方）
cm_type_name VARCHAR(100) 是 客户类型名称
cm_type_code VARCHAR(100) 是 客户类型编码
cm_district VARCHAR(32) 否 销售区域ID（勤策）
cm_district_id VARCHAR(32) 否 销售区域ID（第三方）
cm_district_name VARCHAR(100) 否 销售区域名称
cm_district_code VARCHAR(100) 否 销售区域编码
cm_district_parent VARCHAR(32) 否 销售区域上级ID（勤策）
cm_district_parent_id VARCHAR(32) 否 来源第三方的销售区域上级唯一标识
cm_district_parent_name VARCHAR(100) 否 销售区域上级名称
cm_district_level VARCHAR(100) 否 销售区域等级名称
cm_mss_province VARCHAR(32) 否 客户所属行政区域-省名称
cm_mss_province_code VARCHAR(32) 否 客户所属行政区域-省编码
cm_mss_city VARCHAR(32) 否 客户所属行政区域-市名称
cm_mss_city_code VARCHAR(32) 否 客户所属行政区域-市编码
cm_mss_area VARCHAR(32) 否 客户所属行政区域-县名称
cm_mss_area_code VARCHAR(32) 否 客户所属行政区域-县编码
cm_mss_street VARCHAR(32) 否 客户所属行政区域-乡镇/街道名称
cm_mss_street_code VARCHAR(32) 否 客户所属行政区域-乡镇/街道编码
cm_addr VARCHAR(4000) 否 地址
cm_delivery_addr VARCHAR(4000) 否 送货地址
cm_cooperate_status CHAR(1) 是 合作状态。0：终止合作，1：合作中，2：未合作，3：有意向
cm_uper_customer VARCHAR(32) 否 上级客户ID（勤策）
cm_uper_customer_id VARCHAR(32) 否 上级客户ID（第三方）
cm_uper_customer_name VARCHAR(100) 否 上级客户名称
cm_level VARCHAR(32) 否 客户级别ID（勤策）
cm_level_id VARCHAR(32) 否 客户级别ID（第三方）
cm_level_name VARCHAR(32) 否 客户级别名称
cm_source VARCHAR(32) 否 客户来源
cm_trade VARCHAR(32) 否 客户行业
cm_scale VARCHAR(32) 否 客户规模
cm_tel VARCHAR(32) 否 客户电话
cm_fax VARCHAR(32) 否 客户传真
cm_post VARCHAR(32) 否 客户邮编
cm_remarks VARCHAR(4000) 否 客户备注
cm_sale_direct VARCHAR(1) 否 是否直接交易客户。只能填写“是”、“否”
cm_ka_sys VARCHAR(32) 否 KA系统
cm_website VARCHAR(100) 否 客户的网址
cm_approval_status VARCHAR(10) 否 客户的审批状态。1：待审批，2：已打回，3：审批通过
tradingarea_big VARCHAR(100) 否 商圈等级
tradingarea VARCHAR(100) 否 商圈名称
credit_no VARCHAR(100) 否 统一社会信用代码
registration_no VARCHAR(100) 否 工商注册号
cm_pictures VARCHAR(100) 否 门头照图片，多个时以“,”分隔拼接
cm_liscence VARCHAR(100) 否 营业执照图片，多个时以“,”分隔拼接
liscence_name VARCHAR(100) 否 营业执照名称
operator VARCHAR(100) 否 经营者
registration_date VARCHAR(100) 否 注册日期
linkmans 联系人列表
linkmans.waiqin365_limkman_id VARCHAR(32) 否 勤策平台联系人唯一ID
linkmans.cm_linkman_name VARCHAR(100) 否 联系人名称
linkmans.cm_linkman_job VARCHAR(100) 否 联系人职务
linkmans.cm_linkman_mobile VARCHAR(100) 否 联系人手机
linkmans.cm_linkman_office_tel VARCHAR(100) 否 联系人固定电话
linkmans.cm_linkman_fax VARCHAR(100) 否 联系人传真
linkmans.cm_linkman_sex CHAR(1) 否 联系人性别。F：女性，M：男性
linkmans.cm_linkman_birthday VARCHAR(100) 否 联系人生日
linkmans.cm_linkman_email VARCHAR(100) 否 联系人电子邮件
linkmans.cm_linkman_remarks VARCHAR(4000) 否 联系人备注
linkmans.cm_linkman_main CHAR(1) 否 是否为主联系人。0：否，1：是
linkmans.cm_linkman_qq VARCHAR(100) 否 联系人qq
linkmans.cm_linkman_weixin VARCHAR(100) 否 联系人微信
linkmans.cm_linkman_dept VARCHAR(100) 否 联系人部门
linkmans.exts.linkman_ext_key VARCHAR(4000) 否 联系人信息扩展字段key值，客户联系人信息扩展字段需先在我方系统客户管理中创建
linkmans.exts.linkman_ext_value VARCHAR(4000) 否 联系人信息扩展字段value值对多个选项值，以“,”分隔拼接
exts.cm_ext_key VARCHAR(4000) 否 客户信息扩展字段key值,客户信息扩展字段需先在我方系统客户管理中创建
exts.cm_ext_value VARCHAR(4000) 否 客户信息扩展字段value值对多个选项值，以“,”分隔拼接
status CHAR(1) 是 状态。0：停用，1：启用
creator_id VARCHAR(32) 是 创建人id，来源勤策员工唯一ID
creator_emp_id VARCHAR(32) 否 创建人id，来源第三方系统的唯一ID
creator_name VARCHAR(32) 是 创建人名称
create_time VARCHAR(32) 是 创建时间。格式: yyyy-MM-dd HH:mm:ss
modifyier_id VARCHAR(32) 否 修改人id，来源勤策员工唯一ID
modifyier_emp_id VARCHAR(32) 否 修改人id，来源第三方系统的唯一ID
modifyier_name VARCHAR(32) 否 修改人名称
modify_time VARCHAR(32) 否 修改时间。格式: yyyy-MM-dd HH:mm:ss
cm_label_id VARCHAR(4000) 否 客户标签名称id。多客户标签id以“,”分隔
cm_label VARCHAR(4000) 否 客户标签名称。多客户标签名称以“,”分隔
cm_assistant_id VARCHAR(4000) 否 协助员ID，多个以“,”分隔
cm_dept_id VARCHAR(4000) 否 部门ID
freq_visit VARCHAR(4000) 否 拜访频率
waiqin365_upper_dealer_id VARCHAR(4000) 否 上级经销商ID，终端经销商模式下的经销商才有此字段
autarky_dealer_name VARCHAR(4000) 否 自营经销商名称，多个以英文','隔开，终端经销商模式下的终端门店才有此字段
autarky_dealer_code VARCHAR(4000) 否 自营经销商编码，多个以英文','隔开，终端经销商模式下的终端门店才有此字段
autarky_waiqin365_dealer_id VARCHAR(4000) 否 自营经销商勤策ID，多个以英文','隔开，终端经销商模式下的终端门店才有此字段
autarky_dealer_id VARCHAR(4000) 否 自营经销商第三方唯一标识，多个以英文','隔开，终端经销商模式下的终端门店才有此字段
return_pool_reason VARCHAR(4000) 否 退回原因

响应示例：

{
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int 响应编码。0：成功，1：失败
return_msg String 响应说明

# 推送客户经理数据

勤策平台在客户经理数据发生变化时向第三方系统推送数据

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL

请求参数：

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本，如：001
dataFormat 数据格式：json
dataSource 数据来源。biz：业务功能产生，api：开放接口产生
timestamp 请求时间戳，如：1503276678552
status 数据同步状态。0：数据首次同步，2：数据失败同步
statusTime 上次同步失败时间。格式：yyyy-MM-dd HH:mm:ss
tenantId 企业ID，各注册企业在勤策中对应的唯一ID
digest 数据签名，md5(data|pushsecret|timestamp)
dataType bas_cm_manager_change_event 客户经理变更
data <<请求数据体>> ，说明：格式为JSON格式数据

请求数据体：

{
    "cm_assign_list": [
        {
            "cm_waiqin365_id": "",
            "cm_id": "",
            "cm_code": "",
            "mangers": [
                {
                    "emp_id": "",
                    "emp_waiqin365_id": "",
                    "emp_code": "",
                    "emp_name": ""
                }
            ],
            "managers_before": [
                {
                    "emp_id": "",
                    "emp_code": "",
                    "emp_name": ""
                }
            ]
        }
    ],
    "modify_time": "",
    "user_id": "",
    "user_waiqin365_id": "",
    "user_name": ""
}

参数说明：

参数 类型 必填 说明
modify_time varchar32 是 修改时间。格式：YYYY-MM-dd HH:mm:ss
user_id varchar32 否 修改人第三方id
user_waiqin365_id int8 是 修改人勤策唯一id
user_name varchar200 是 修改人名称
cm_assign_list 客户经理列表
cm_assign_list.cm_waiqin365_id int8 是 客户勤策id
cm_assign_list.cm_id varchar100 否 客户第三方id
cm_assign_list.cm_code varchar100 否 客户编码
cm_assign_list.managers.emp_id varchar100 否 客户经理第三方id
cm_assign_list.managers.emp_waiqin365_id int8 否 客户经理勤策id
cm_assign_list.managers.emp_code varchar100 否 客户经理编码
cm_assign_list.managers.emp_name varchar200 否 客户经理姓名
cm_assign_list.managers_before.emp_id varchar100 否 变更之前客户经理第三方id
cm_assign_list.managers_before.emp_waiqin365_id int8 否 变更之前客户经理勤策id
cm_assign_list.managers_before.emp_code varchar100 否 变更之前客户经理编码
cm_assign_list.managers_before.emp_name varchar200 否 变更之前客户经理姓名

响应示例：

{
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int 响应编码。0：成功，1：失败
return_msg String 响应说明

# 推送客户等级数据

勤策平台在客户等级参数发生变化时向第三方系统推送数据

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL
请求参数：

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本，如：001
dataFormat 数据格式：json
dataSource 数据来源。biz：业务功能产生，api：开放接口产生
timestamp 请求时间戳，如：1503276678552
status 数据同步状态。0：数据首次同步，2：数据失败同步
statusTime 上次同步失败时间。格式：yyyy-MM-dd HH:mm:ss
tenantId 企业ID，各注册企业在勤策中对应的唯一ID
digest 数据签名，md5(data|pushsecret|timestamp)
dataType custom_level 客户等级
data <<请求数据体>> ，说明：格式为JSON格式数据

请求数据体：

{
  "level_name": "F",
  "level_remark": "FFFFFFF",
  "create_time": "2017-12-22 16:30:16",
  "level_status": "1",
  "modifyier_id": "",
  "waiqin_level_id": "6086844381783148370",
  "level_id": "",
  "modify_time": "",
  "creator_id": "7160523176840969887"
}

参数说明：

参数 类型 必填 说明
waiqin_level_id varchar32 是 勤策平台唯一ID
level_id varchar32 否 来源第三方系统的唯一ID
level_name varchar32 是 名称
level_remark varchar32 否 备注
level_status char1 是 状态。0：停用，1：启用
creator_id int8 是 创建人id，来源勤策员工唯一ID
create_time varchar32 是 创建时间。格式: yyyy-MM-dd HH:mm:ss
modifyier_id int8 否 修改人id，来源勤策员工唯一ID
modify_time varchar32 否 修改时间。格式: yyyy-MM-dd HH:mm:ss

响应示例：

{
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int
return_msg String

# 推送KA系统数据

勤策平台在KA系统参数发生变化时向第三方系统推送数据

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL

请求参数：

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本，如：001
dataFormat 数据格式：json
dataSource 数据来源。biz：业务功能产生，api：开放接口产生
timestamp 请求时间戳，如：1503276678552
status 数据同步状态。0：数据首次同步，2：数据失败同步
statusTime 上次同步失败时间，格式：yyyy-MM-dd HH:mm:ss
tenantId 企业ID，各注册企业在勤策中对应的唯一ID
digest 数据签名，md5(data|pushsecret|timestamp)
dataType property_kasys 客户层级
data <<请求数据体>> ，说明：格式为JSON格式数据

请求数据体：

{
  "id": "6664339980944368440",
  "property_type": "6",
  "property_value": "",
  "status": "1",
  "property_name": "GGGGGGGG",
  "sequence": "0.00",
  "create_time": "2017-12-22 16:42:18",
  "modifyier_id": "",
  "modify_time": "",
  "creator_id": "7160523176840969887"
}

参数说明：

参数 类型 必填 说明
id varchar32 是 勤策平台唯一ID
property_type varchar32 是 6：ka系统
property_value varchar32 否 属性值
status char1 是 状态。0：停用，1：启用
property_name varchar32 是 属性名称
sequence varchar32 否 顺序
creator_id int8 是 创建人id，来源勤策员工唯一ID,
create_time varchar32 是 创建时间。格式: yyyy-MM-dd HH:mm:ss
modifyier_id int8 否 修改人id，来源勤策员工唯一ID
modify_time varchar32 否 修改时间。格式: yyyy-MM-dd HH:mm:ss

响应示例：

{
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int 响应编码。0：成功，1：失败
return_msg String 响应说明

# 推送合作状态数据

勤策平台在合作状态参数发生变化时向第三方系统推送数据

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL
请求参数：

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本，如：001
dataFormat 数据格式：json
dataSource 数据来源。biz：业务功能产生，api：开放接口产生
timestamp 请求时间戳，如：1503276678552
status 数据同步状态。0：数据首次同步，2：数据失败同步
statusTime 上次同步失败时间，格式：yyyy-MM-dd HH:mm:ss
tenantId 企业ID，各注册企业在勤策中对应的唯一ID
digest 数据签名，md5(data|pushsecret|timestamp)
dataType property_cooperate 客户合作状态
data <<请求数据体>> ，说明：格式为JSON格式数据

请求数据体：

{
  "id": "1",
  "property_type": "5",
  "property_value": "0",
  "status": "1",
  "property_name": "终止合作",
  "sequence": "3.00",
  "create_time": "2017-05-26 10:27:23",
  "modifyier_id": "",
  "modify_time": "",
  "creator_id": "10"
}

参数说明：

参数 类型 必填 说明
id varchar32 是 勤策平台唯一ID
property_type varchar32 是 5：合作状态
property_value varchar32 否 属性值
status char1 是 状态。0，停用，1：启用
property_name varchar32 是 属性名称
sequence varchar32 否 顺序
creator_id int8 是 创建人id，来源勤策员工唯一ID,
create_time varchar32 是 创建时间。格式: yyyy-MM-dd HH:mm:ss
modifyier_id int8 否 修改人id，来源勤策员工唯一ID
modify_time varchar32 否 修改时间。格式: yyyy-MM-dd HH:mm:ss

响应示例：

{
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int 响应编码。0：成功，1：失败
return_msg String 响应说明

# 推送客户收货方关系数据

勤策平台客户收货方关系发生变化时向第三方系统推送数据接口

请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL
请求参数：

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本，如：001
dataFormat 数据格式：json
dataSource 数据来源。biz：业务功能产生，api：开放接口产生
timestamp 请求时间戳，如：1503276678552
status 数据同步状态。0：数据首次同步。2：数据失败同步
statusTime 上次同步失败时间，格式：yyyy-MM-dd HH:mm:ss
tenantId 企业ID，各注册企业在勤策中对应的唯一ID
digest 数据签名，md5(data|pushsecret|timestamp)
dataType cm_receive_info
data <<请求数据体>> ，说明：格式为JSON格式数据

请求数据体：

{
  
}

参数说明：

参数 类型 必填 说明
id varchar32 是 勤策平台唯一ID
property_type varchar32 是 5-合作状态
property_value varchar32 否 属性值
status char1 是 状态。0：停用，1：启用
property_name varchar32 是 属性名称
sequence varchar32 否 顺序
creator_id int8 是 创建人id，来源勤策员工唯一ID
create_time varchar32 是 创建时间。格式: yyyy-MM-dd HH:mm:ss
modifyier_id int8 否 修改人id，来源勤策员工唯一ID
modify_time varchar32 否 修改时间。格式: yyyy-MM-dd HH:mm:ss

响应示例：

{
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
return_code int 响应编码。0：成功，1：失败
return_msg String 响应说明

← 客户收货地址信息接口 →