Skip to content

新增、编辑客户 ​

Request ​

Url ​
text
[POST] : https://eapi.paiago.com/ZKGJ/Intercourse/Customer/Add/?access_token={access_token}
Rule ​
  • 单次最多支持操作 100 条客户数据
请求参数: ​
参数类型必填描述示例
idstring否客户id编辑客户时,请传入合同id
编辑时需要传入所有字段信息,包含不需要编辑的,漏传会将数据置空
customer_namestring是客户名称
customer_numberstring是客户编号
custom_naturestring是客户性质1:个人
2:企业
3:政府事业单位
industry_idstring是行业id名称
add_userstring是创建人id
provincestring否省
citystring否市
areastring否区
leaderarray(object)否负责人
 leader_idstring是负责人id
billingarray(object)否开票信息
  invoice_headerstring是发票抬头
  identifierstring是统一社会信用代码
  bank_namestring否银行名称
  bank_numberstring否银行账号
  addressstring否地址
  telstring否联系电话
  is_defaultnumber是是否默认0:否
1: 是
mailingarray(object)否邮寄信息
  provincestring是省
  citystring是市
  areastring是区
  mail_addressstring是邮寄地址
  recipientstring是联系人
  telephonestring是联系方式
  is_defaultnumber是是否默认0:否
1: 是
自定义字段名称1string否自定义字段值1
自定义字段名称2string否自定义字段值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"
}