Appearance
新增、编辑客户
Request
Url
text
[POST] : https://eapi.paiago.com/ZKGJ/Intercourse/Customer/Add/?access_token={access_token}Rule
- 单次最多支持操作
100条客户数据
请求参数:
| 参数 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|
| id | string | 否 | 客户id | 编辑客户时,请传入合同id 编辑时需要传入所有字段信息,包含不需要编辑的,漏传会将数据置空 |
| customer_name | string | 是 | 客户名称 | |
| customer_number | string | 是 | 客户编号 | |
| custom_nature | string | 是 | 客户性质 | 1:个人 2:企业 3:政府事业单位 |
| industry_id | string | 是 | 行业id名称 | |
| add_user | string | 是 | 创建人id | |
| province | string | 否 | 省 | |
| city | string | 否 | 市 | |
| area | string | 否 | 区 | |
| leader | array(object) | 否 | 负责人 | |
| leader_id | string | 是 | 负责人id | |
| billing | array(object) | 否 | 开票信息 | |
| invoice_header | string | 是 | 发票抬头 | |
| identifier | string | 是 | 统一社会信用代码 | |
| bank_name | string | 否 | 银行名称 | |
| bank_number | string | 否 | 银行账号 | |
| address | string | 否 | 地址 | |
| tel | string | 否 | 联系电话 | |
| is_default | number | 是 | 是否默认 | 0:否 1: 是 |
| mailing | array(object) | 否 | 邮寄信息 | |
| province | string | 是 | 省 | |
| city | string | 是 | 市 | |
| area | string | 是 | 区 | |
| mail_address | string | 是 | 邮寄地址 | |
| recipient | string | 是 | 联系人 | |
| telephone | string | 是 | 联系方式 | |
| is_default | number | 是 | 是否默认 | 0:否 1: 是 |
| 自定义字段名称1 | string | 否 | 自定义字段值1 | |
| 自定义字段名称2 | string | 否 | 自定义字段值2 |
请求示例:
json
[
{
"customer_name":"test-api-0",
"customer_number":"12345678901X-XX-XX-X",
"custom_nature":"2",
"industry_id":"WiiiJmSy0",
"province":"江西省",
"city":"南昌市",
"area":"青山湖区",
"custom_address":"北京东路",
"add_user":"WiiiJmSy0",
"add_date":"2021-04-23",
"leader":[
{
"leader_id":"WiiiJmSy0"
},
{
"leader_id":"WiiiJmSy0"
}
],
"billing":[
{
"invoice_header":"抬头1",
"identifier":"123456",
"bank_name":"开户银行1",
"bank_number":"996",
"address":"开户地址1",
"tel":"1827913",
"is_default":0
},
{
"invoice_header":"抬头2",
"identifier":"1234567",
"bank_name":"开户银行2",
"bank_number":"9966",
"address":"开户地址2",
"tel":"1827914",
"is_default":1
}
],
"mailing":[
{
"province":"江西省",
"city":"南昌市",
"area":"东湖区",
"mail_address":"东湖区地址",
"recipient":"收件人1",
"telephone":"1827915",
"is_default":0
},
{
"province":"江西省",
"city":"南昌市",
"area":"青山湖区",
"mail_address":"青山湖区地址",
"recipient":"收件人2",
"telephone":"1827916",
"is_default":1
}
],
"自定义字段名称1":"自定义字段值1",
"自定义字段名称2":"自定义字段值2"
}
]Response
响应参数
| 参数 | 描述 | 类型 | 示例 |
|---|---|---|---|
| errcode | 错误码 | int | |
| errmsg | 错误信息 | string |
json
{
"errcode":21003,
"errmsg":"第1条数据录入失败:系统已有该客户,请勿重复添加!",
"request_id":null,
"env":"zkgj-cs"
}