客户（含联系人）新增/编辑

异常码	异常消息	异常解决方案
404	Not Found Resource	检查传入company_id是否有误
404	No Privilege	检查传入user_id是否是私海客户的跟进人

请求参数

Header 参数

Body 参数application/json

示例

{
    "company_id": 0,//新建时不需要传递，或者传0
    "user_id": 11858713,//跟进人ID
    "batch_user_ids": [
        0
    ],//批量增加跟进人ID
    "remove_user_id": [
        0
    ],//移除跟进人ID
    "is_public": 0,
    "serial_id": "O1234",//客户编号
    "name": "小满科技0310",//客户名称
    "short_name": "客户简称",//客户简称
    "country": "CN",
    "province": "陕西省",
    "city": "西安市",
    "tel_area_code": "86",//区号
    "tel": "1233435",
    "fax": "2345445",//传真
    "group_id": 0,//客户分组ID
    "pool_id": 0,//公海分组ID
    "origin_list": [14],//来源ID列表
    "trail_status": 0,//客户阶段ID
    "biz_type": 2,//客户类型 来自客户枚举接口
    "cus_tag": [
        0
    ],//客户标签 来自客户枚举接口
    "address": "地址",//详细地址
    "remark": "备注",//客户备注
    "homepage": "asdfasdft.com",
    "star": 4,//客户星级 来自客户枚举接口
    "intention_level": 1,//采购意向 来自客户枚举接口
    "annual_procurement": 0,//年采购额 来自客户枚举接口
    "timezone": 5,//时区 来自客户枚举接口
    "scale_id": 2,//规模 来自客户枚举接口
    "image_list": [
    ],
    "next_follow_up_time": "2025-03-03 00:00:00",//下次跟进时间
    "category_ids": [
        [
            3
        ]
    ],//主营产品ID
    "product_group_ids": [
        5005524937
    ],//产品分组ID
    "customers": [
        {
            "customer_id": 0,///新建时不需要传递，或者传0
            "name": "联系人昵称0310",//联系人名称
            "email": "lianxirennicheng303@163.com",//联系人邮箱
            "tel": "12323242345",
            "tel_area_code": "86",
            "post_grade": 2,//职级
            "post": "职位",//职位
            "qq": "234354346",
            "linkedin": "345346457",
            "skype": "436456657",
            "whatsapp": "23463457567",
            "facebook": "sadfery34546",
            "wechat": "wer647",
            "twitter": "striwwe56ng",
            "birth": "2025-03-13",
            "gender": 1,//性别 男1 女
            "remark": "联系人备注",//联系人备注
            "main_customer_flag": 0,//是否是主联系人 1:是 0:否
            "image_list": [
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-sandbox.xiaoman.cn/v1/company/pushCompanyAndCustomers' \
--header 'Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMWMxMzU5NmRlMGJjYzM1MzRlYTIxMWEyMTE0MTdjODcxZjMzZGVjNjVmMzE1MDcxM2EwMTE5N2I0NGJlODY2NDM0YWFmYjczZmI0ZWIwYiIsImp0aSI6ImU4MjllNmU5N2FjOWE0ZmQxYjdmOTQ4ZmMwOTE0ZTZkMjkxZWU4Zjg5NjczYzk0NDEyMWE5NjVhNTAxZDdkMmM5NTVmZTBiMzdlMjUyM2Y4IiwiaWF0IjoxNjg2ODAyNDI1LjMwMzk3MiwibmJmIjoxNjg2ODAyNDI1LjMwMzk3MywiZXhwIjoxNjg2ODMxMjI1LjI5MzgwOSwic3ViIjoiIiwic2NvcGVzIjpbInByb2R1Y3QiLCJjb21wYW55IiwiaW52b2ljZXMiLCJsZWFkIiwib3Bwb3J0dW5pdHkiLCJ1c2VyIiwic3VwcGxpZXIiLCJ3YXJlaG91c2UiLCJyZXBvcnQiXX0.jllCo8AVbZuMumrSAHkiL7a3QBhagiHWn_CjLbGhz60WOhGQytZ5xsWZ04z34vgT1bW5LJvnpWQ90c4Tyk4smzXAL6KfabQUTl8_RAnrKpNXdxPQOuQWjqxHzNdtf8VR0TjSNw0yHVmL5MN_XoCQvl_a2PfW7MbcoUJJld7yrxMbFQhl5-ct0QfavvBNifJ-jIp_O7w9PjJ8V7FoV-OmogFhC-YwBxPZBOePVT-OoAmgLtdbWXh-PasrXvd7lusB8o7tUcDyaBpkfgOwP8L6k7oNn-OjOnR6iXQzRRvlXxIfs6v3CiV75WVBINs5lgyCQ8ZOTJbnXYBgCOW5iLDfZw' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "company_id": 0,//新建时不需要传递，或者传0
    "user_id": 11858713,//跟进人ID
    "batch_user_ids": [
        0
    ],//批量增加跟进人ID
    "remove_user_id": [
        0
    ],//移除跟进人ID
    "is_public": 0,
    "serial_id": "O1234",//客户编号
    "name": "小满科技0310",//客户名称
    "short_name": "客户简称",//客户简称
    "country": "CN",
    "province": "陕西省",
    "city": "西安市",
    "tel_area_code": "86",//区号
    "tel": "1233435",
    "fax": "2345445",//传真
    "group_id": 0,//客户分组ID
    "pool_id": 0,//公海分组ID
    "origin_list": [14],//来源ID列表
    "trail_status": 0,//客户阶段ID
    "biz_type": 2,//客户类型 来自客户枚举接口
    "cus_tag": [
        0
    ],//客户标签 来自客户枚举接口
    "address": "地址",//详细地址
    "remark": "备注",//客户备注
    "homepage": "asdfasdft.com",
    "star": 4,//客户星级 来自客户枚举接口
    "intention_level": 1,//采购意向 来自客户枚举接口
    "annual_procurement": 0,//年采购额 来自客户枚举接口
    "timezone": 5,//时区 来自客户枚举接口
    "scale_id": 2,//规模 来自客户枚举接口
    "image_list": [
    ],
    "next_follow_up_time": "2025-03-03 00:00:00",//下次跟进时间
    "category_ids": [
        [
            3
        ]
    ],//主营产品ID
    "product_group_ids": [
        5005524937
    ],//产品分组ID
    "customers": [
        {
            "customer_id": 0,///新建时不需要传递，或者传0
            "name": "联系人昵称0310",//联系人名称
            "email": "lianxirennicheng303@163.com",//联系人邮箱
            "tel": "12323242345",
            "tel_area_code": "86",
            "post_grade": 2,//职级
            "post": "职位",//职位
            "qq": "234354346",
            "linkedin": "345346457",
            "skype": "436456657",
            "whatsapp": "23463457567",
            "facebook": "sadfery34546",
            "wechat": "wer647",
            "twitter": "striwwe56ng",
            "birth": "2025-03-13",
            "gender": 1,//性别 男1 女
            "remark": "联系人备注",//联系人备注
            "main_customer_flag": 0,//是否是主联系人 1:是 0:否
            "image_list": [
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "message": "success",
    "now": "2025-03-05 17:20:53",
    "data": {
        "company_id": 5203222129,
        "customers": [
            {
                "customer_id": 5203222125,
                "name": "李四",
                "email": "lisi@163.com"
            }
        ]
    }
}