文档
测试

新增修改客户基本信息

POST
请求地址/router

系统相关界面

"界面路径:【交易】----【出库单】"

请求地址

|环境|服务地址(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|非法参数!|检查参数类型等是否合法 |