新增修改客户基本信息
系统相关界面
"界面路径：【交易】----【出库单】"
请求地址
| 环境 | 服务地址(HTTP/HTTPS) |
|---|---|
| V2正式环境（推荐） | https://gw.superboss.cc/router |
2022年4月1日以后申请的APP Key，统一使用V2正式环境的请求地址：https://gw.superboss.cc/router
公共参数
调用任何一个API都必须传入的参数，目前支持的公共参数有：
| 参数名称 | 参数类型 | 是否必须 | 参数描述 |
|---|---|---|---|
| method | string | 是 | API接口名称 |
| appKey | string | 是 | 分配给应用的AppKey |
| timestamp | string | 是 | 时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 |
| format | string | 否 | 响应格式。默认为json格式，可选值：json |
| version | string | 是 | API协议版本 可选值：1.0 |
| sign_method | string | 否 | 签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。 |
| sign | string | 是 | 签名 |
| session | string | 是 | 授权会话信息 （即access_token，由系统分配） |
请求头
参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded;charset=UTF-8
必填
API接口地址
参数名
类型
描述
必填
method
string
erp.customer.create
必填
请求参数
参数名
类型
描述
必填
customerId
Long
客户id(修改的时候必传)
cmCode
string
客户编码 唯一
cmNick
string
客户昵称 唯一
cmName
string
客户公司全名 唯一
type
integer
客户类型
typeCode
integer
客户类型
typeMsg
String
客户类型
invoiceTitle
String
发票抬头
qqNumber
String
qq号
email
String
邮箱地址
fax
String
传真号
url
String
网址
taxNumber
String
税号
province
String
省
city
String
市
area
String
区
address
String
详细地址（街道）
bankName
String
开户行
bankAccount
String
开户账号
remark
String
备注
zipCode
String
邮编
importRowNum
Integer
导入的行号
paymentMethod
Integer
结算方式 0 现付 1 记账
discountRate
String
折扣率百分比 99.99 -> 99.99%
level
Integer
等级
levelMsg
String
等级描述
receivers
List
收货地址
id
Long
主键id(修改的时候传)
receiver
String
收货人
tel
String
手机号
phone
String
固定电话
zipCode
String
邮编
province
String
省
city
String
市
area
String
区
address
String
详细地址（街道）
receiverDetailAddress
String
拼接省市区的详细收货地址
discountRate
String
折扣率
contacts
List
联系人
id
Long
主键id(修改的时候传)
contact
String
联系人
tel
String
手机号
phone
String
固定电话
province
String
省
city
String
市
area
String
区
address
String
详细地址（街道）
remark
String
备注
type
Integer
联系人类型（0 客户基础信息联系人 1 其它联系人）
defaultContact
List
默认联系人
id
Long
主键id
contact
String
联系人
tel
String
手机号
phone
String
固定电话
province
String
省
city
String
市
area
String
区
address
String
详细地址（街道）
remark
String
备注
type
Integer
联系人类型（0 客户基础信息联系人 1 其它联系人）
cmNick
String
昵称
请求示例
示例一：
{
"pageNo":"1",
"pageSize":"10"
}
响应参数
参数名
类型
描述
必填
traceId
string
示例：2010790044167299285
必填
success
boolean
示例：true
必填
customer
object
数据字典
必填
cmName
string
示例：11111asda
必填
discountRate
string
示例：90
必填
zipCode
string
示例：1dasdas51
必填
city
string
示例：9dsad1
必填
remark
string
示例：14dasdas1
必填
bankName
string
示例：1dasdas21
必填
qqNumber
string
示例：31da11dasdassda
必填
type
int
示例：1
必填
province
string
示例：81das
必填
receivers
array
数据列表
必填
area
string
示例：测试aaaaaaaaa
必填
discountRate
string
示例：测试aaaaaaaaa
必填
zipCode
string
示例：12daaaaaaaa1
必填
address
string
示例：测试收货aaaaaa
必填
receiver
string
示例：测试收货人aaaaaaaaaaaa
必填
city
string
示例：测试aaaaaa
必填
province
string
示例：测试收货aaaaaaaaaa
必填
phone
string
示例：测试收货人电话aaaaaaaaa
必填
customerId
int
示例：506110604915200
必填
cmNick
string
示例：11111dasdas
必填
tel
string
示例：测试收货人手机号aaaaaaaaaa
必填
id
int
示例：158251
必填
customerId
int
示例：506110604915200
必填
fax
string
示例：51dasda
必填
invoiceTitle
string
示例：21dasdas
必填
email
string
示例：41dasdas
必填
area
string
示例：10dasda1
必填
bankAccount
string
示例：1dasdas31
必填
address
string
示例：11dasdsa1
必填
level
int
示例：2
必填
taxNumber
string
示例：71dasda
必填
url
string
示例：61dasdas
必填
defaultContact
object
数据字典
必填
area
string
示例：测试联系人区aaaaaaaaa
必填
address
string
示例：测试联系人详细地址aaaaaaa
必填
city
string
示例：测试联系人市aaaaaa
必填
remark
string
示例：测试联系人备注aaaaaaaaaa
必填
type
int
示例：0
必填
province
string
示例：测试联系人省aaaaaa
必填
phone
string
示例：测试联系人电话aaaaaaaaa
必填
contact
string
示例：测试2222联系人aaaaaaaa
必填
customerId
int
示例：506110604915200
必填
cmNick
string
示例：11111dasdas
必填
tel
string
示例：测试联系人手机号aaaaaaaaa
必填
id
int
示例：224201
必填
cmCode
string
示例：11dasdasdas
必填
cmNick
string
示例：11111dasdas
必填
paymentMethod
int
示例：0
必填
contacts
array
数据列表
必填
area
string
示例：联系 人区aaaaaaaa
必填
address
string
示例：联系人详细地址aaaaaaa
必填
city
string
示例：联系人市aaaaaaaa
必填
remark
string
示例：联系人备注aaaaaaaaaaa
必填
type
int
示例：1
必填
province
string
示例：联系人省aaaaaaaa
必填
phone
string
示例：联系人电话aaaaaa
必填
contact
string
示例：联系aaaaa
必填
customerId
int
示例：506110604915200
必填
cmNick
string
示例：11111dasdas
必填
tel
string
示例：联系人手aaaaaaa1
必填
id
int
示例：224200
必填
响应示例
异常示例
{
"code": "25",
"msg": "服务方法(erp.trade.outstock.list.query:1.0)的签名无效",
"success": false,
"trace_id": "3553483395423660"
}
错误码解释
| 错误码 | 错误信息 | 解决方案 |
|---|---|---|
| 400 | 资源异常,请联系管理员! | 检查参数是否合法 |
| 50 | 非法参数! | 检查参数类型等是否合法 |