基础档案类

    customer/get


    目录

    1.接口说明

    1.1接口描述

         获取单个客户信息

    1.2适用版本

         支持U8V12.0 及更高版本

    2.使用场景

    基础数据同步或前端展示

    3.接口调用说明

    3.1请求说明

    url https://api.yonyouup.com/api/customer/get
    格式 JSON
    https请求方式 GET
    编码类型 UTF-8


    3.2url参数说明

    参数 是否必填 类型 描述
    from_account string 调用方id
    to_account string 提供方id
    app_key string 应用编码
    token string 全局访问唯一识别码
    ds_sequence number 数据源序号(默认取应用的第一个数据源)
    id string 客户编码

    3.3请求示例

    GET https://api.yonyouup.com/api/customer/get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&id=0000000017&ds_sequence=1


    3.4返回参数说明

    参数说明 类型 参数路径 描述
    errcode string   错误码,0 为正常。
    errmsg string   错误信息。
    code string 客户编码
    name string 客户名称
    abbrname string 客户简称
    sort_code string 所属分类码
    domain_code string 所属地区码
    industry string 所属行业
    address string 地址
    bank_open string 开户银行
    bank_acc_number string 银行账号
    contact string 联系人
    phone string 电话
    fax string 传真
    mobile string 手机
    devliver_site string 发货地址
    end_date date 停用日期
    memo string 备注
    ccusexch_name string 币种
    bcusdomestic string 国内
    bcusoverseas string 国外
    bserviceattribute string 服务
    ccusmngtypecode string 客户管理类型
    ccusmngtypename string 客户管理类型名称
    spec_operator string 专管业务员编码
    spec_operator_name string 专管业务员名称
    timestamp number 时间戳
    self_define1 string 自定义项1
    self_define2 string 自定义项2
    self_define3 string 自定义项3
    self_define4 string 自定义项4
    self_define5 string 自定义项5
    self_define6 string 自定义项6
    self_define7 string 自定义项7
    self_define8 string 自定义项8
    self_define9 string 自定义项9
    self_define10 string 自定义项10
    self_define11 string 自定义项11
    self_define12 string 自定义项12
    self_define13 string 自定义项13
    self_define14 string 自定义项14
    self_define15 string 自定义项15
    self_define16 string 自定义项16

    3.5正确返回示例

    JSON示例:

    application/json;charset=UTF-8
    {
    	"errmsg":"",
    	"errcode":"0",
    	"customer":{
    		"abbrname":"世纪天华",
    		"name":"世纪天华集团公司",
    		"domain_code":"01",
    		"code":"00000001",
    		"industry":"电子类",
    		"contact":"刘婷",
    		"sort_code":"03",
    		"mobile":13811388661
    	}
    }
    

    3.6错误返回示例

    application/json;charset=UTF-8
    {
    	"errcode" : "30021",
    	"errmsg" : "此应用未上线"
    } 

    4.API测试

    API测试 SDK下载