开放接口API说明-客户帐号接口

查询客户帐号

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/smOuterUser/v1/querySmOuterUser/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
  "user_code": "13218014444"
} 

参数说明:

参数 类型 必填 说明
user_code VARCHAR(100) 根据客户帐号精确查询
user_name VARCHAR(100) 根据客户账号的姓名模糊查询
create_date CHAR(10) 根据创建日期查询用户,格式:“yyyy-MM-dd”
modify_date CHAR(10) 根据修改日期查询用户,格式:“yyyy-MM-dd”

返回结果:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "cm_code": "0000000003",
        "last_use_time": "2019-02-26 17:20:23",
        "type_name": "经销商B",
        "create_time": "2018-05-31 14:23:19",
        "is_main": "1",
        "cm_name": "up",
        "linkman_mobile": "13218014444",
        "linkman_id": "5879291146458501371",
        "operate_name": "系统自动创建",
        "linkman": "up主",
        "certification": 0,
        "status": "1"
    },
    {
        "cm_code": "CUS000012",
        "last_use_time": "2019-02-27 15:48:15",
        "type_name": "a1",
        "create_time": "2018-06-12 14:22:08",
        "is_main": "1",
        "cus_acc_roles": "4847172605794894550:员工(门店),4847172605794894550:老板(门店)",
        "cm_name": "down",
        "linkman_mobile": "13218014444",
        "linkman_id": "7493309492298543266",
        "operate_name": "系统自动创建",
        "linkman": "down老板",
        "certification": 0,
        "status": "1"
    }   
]

参数说明:

参数 类型 必填 说明
linkman_id VARCHAR(32) 联系人ID
linkman_mobile VARCHAR(32) 联系人手机号码
linkman VARCHAR(100) 联系人姓名
is_main VARCHAR(1) 是否主联系人,1是、0否
cus_acc_roles VARCHAR(500) 客户账号角色[ID1:名称1,ID2:名称2...]
cm_code CHAR(1) 客户编码
cm_name VARCHAR(12) 客户名称
type_name VARCHAR(13) 客户类型
create_time VARCHAR(20) 开通时间,格式:“yyyy-MM-dd HH:mm:ss”
operate_name VARCHAR(20) 最近操作人
last_use_time CHAR(10) 最近登录时间,格式:“yyyy-MM-dd HH:mm:ss”
certification VARCHAR(500) 该客户账号是否实名认证
status VARCHAR(100) 状态,1正常、0删除

推送客户账号数据

推送客户账号数据

外勤365平台在客户账号基础信息发生变化时向第三方系统推送数据接口

请求方式: 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,各注册企业在外勤365中对应的唯一ID
digest 数据签名,md5(data
dataType sm_outer_user 客户账号
data <<请求数据体>> , 说明:格式为JSON格式数据

请求数据体:

[
  {
          "cm_code": "0000000003",
          "last_use_time": "2019-02-26 17:20:23",
          "type_name": "经销商B",
          "create_time": "2018-05-31 14:23:19",
          "is_main": "1",
          "cus_acc_roles": "4847172605794894550:员工(门店),4847172605794894550:老板(门店)",
          "cm_name": "up",
          "linkman_mobile": "13218014444",
          "linkman_id": "5879291146458501371",
          "operate_name": "系统自动创建",
          "linkman": "up主",
          "certification": 0,
          "status": "1"
      },
      {
          "cm_code": "CUS000012",
          "last_use_time": "2019-02-27 15:48:15",
          "type_name": "a1",
          "create_time": "2018-06-12 14:22:08",
          "is_main": "1",
          "cm_name": "down",
          "linkman_mobile": "13218014444",
          "linkman_id": "7493309492298543266",
          "operate_name": "系统自动创建",
          "linkman": "down老板",
          "certification": 0,
          "status": "1"
      }   
]

参数说明:

参数 类型 必填 说明
linkman_id VARCHAR(32) 联系人ID
linkman_mobile VARCHAR(32) 联系人手机号码
linkman VARCHAR(100) 联系人姓名
is_main VARCHAR(1) 是否主联系人,1是、0否
cus_acc_roles VARCHAR(500) 客户账号角色[ID1:名称1,ID2:名称2...]
cm_code CHAR(1) 客户编码
cm_name VARCHAR(12) 客户名称
type_name VARCHAR(13) 客户类型
create_time VARCHAR(20) 开通时间,格式:“yyyy-MM-dd HH:mm:ss”
operate_name VARCHAR(20) 最近操作人
last_use_time CHAR(10) 最近登录时间,格式:“yyyy-MM-dd HH:mm:ss”
certification VARCHAR(500) 该客户账号是否实名认证
status VARCHAR(100) 状态,1正常、0删除

返回结果:

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

参数说明:

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