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"
}