编辑销售机会 - 尘锋SCRM开放平台

POST https://qw-openapi-tx.dustess.com/saleChance/v2/edit/batch?accessToken=

Content-Type: application/json

接口限制:每分钟调用600次;

Query:

字段	类型	描述	是否必须
accessToken	`String`	accessToken	是

Body:

名称	类型	是否必需	备注
saleChanceEditList	`Object[]`	非必须	item 类型: object
saleChanceEditList.currentStage	`String`	非必须	当前跟进阶段
saleChanceEditList.udf	`Object`	非必须	销售机会用户自定义字段
saleChanceEditList.udf.model_data	`Object[]`	非必须	销售机会用户自定义字段数据集
saleChanceEditList.udf.model_data[].key	`String`	非必须	字段业务ID
saleChanceEditList.udf.model_data[].value	`String`	非必须	字段值：单行文本、多行文本、日期、日期时间类型值为字符串；数字、附件、单多选、多级联选单多选的值为json序列化后的字符串；日期类型字符串格式：`2021-06-01`；日期时间类型字符串格式：`2006-01-02 15:04:05`；附件为object数组，格式：`[{"name":"企业列表.xlsx","url":"https://xxx/xxx.xlsx","size":11085,"type":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"}]`；单多选为字符串数组，格式：`["选项id"]`；多级联选单多选为字符串数组，格式：`["一级选项id/二级选项id"]`
saleChanceEditList.dept	`Int`	非必须	部门id
saleChanceEditList.failReason	`String`	非必须	丢单原因ID
saleChanceEditList.id	`String`	必须	销售机会ID
saleChanceEditList.name	`String`	非必须	名称
saleChanceEditList.opponent	`String[]`	非必须	竞争对手ids
saleChanceEditList.opponentDesc	`String`	非必须	竞争对手描述
saleChanceEditList.price	`Int`	非必须	金额
saleChanceEditList.productType	`String[]`	非必须	商品类别
saleChanceEditList.remark	`String`	非必须	备注（限制200字）
saleChanceEditList.successTime	`String`	非必须	预计成交时间
saleChanceEditList.sale_source_code	`String`	非必须	销售机会关联来源
saleChanceEditList.tags	`String[]`	非必须	销售机会关联标签
uid	`String`	非必须	操作人

示例:

{

    "uid": "297",
    "saleChanceEditList": [
        {
            "cid": "",
            "id":"5a1e3e2c-1111-1111-1111-feadf4d06d8d",
            "ownType": 1,
            "relationID": "",
            "cateId": "80c40d8a-1111-1111-1111-82e3b80a758d",
            "failReason": "",
            "name": "全量后编辑",
            "currentStage": "80da81b3-1111-1111-1111-a6526526da94",
            "productType": [],
            "price": 666,
            "opponentDesc": "",
            "successTime": "2022-03-28",
            "opponent": [],
            "remark": "",
            "dept": 62,
            "udf": {
                "model_data": [
                    // 不做修改的字段 不传入
                    {
                        "key": "f0ce66-lkroqp0e",
                        "value": null  // 代表空值，置空该字段的值
                    },
                    {
                        "key": "tqlcsb-ll4uqr23",
                        "value": "单行/多行传入值"  // 单多行文本的值
                    },
                    {
                        "key": "ytwhyh-ll4uqr23",
                        "value": "2023-08-12"  // 日期的值
                    },
                    {
                        "key": "wbwsja-ll4uqr23",
                        "value": "2023-08-15 14:00:00"  // 时间日期的值
                    },
                    {
                        "key": "c75noa-1h0hsvcb5",
                        "value": "99"  // 数字类型传入实例
                    },
                    {
                        "key": "60mdnv-lhen3uic",
                        "value": "[\"1\"]"  // 单多选传入实例，单选仅支持传入一个值，多选可传入多个值
                    },
                    {
                        "key": "75yey8-ljze44hq",
                        // 多级联选传入实例，单选仅支持传入一个值，多选可传入多个值；每个值需包含父级选项id，使用「/」分割选项id：一级选项id/二级选项id/三级选项id
                        "value": "[\"1679051431107665933/1679051431107665934\",\"1679051431107665933/1679051431107665934/1679051431107665935/1679051431107665940\"]"
                    },
                    {
                        "key": "ys8xs5-lk0vvuoy",
                        // 附件字段传入实例
                        "value": "[{\"name\":\"企业列表.xlsx\",\"url\":\"https://cdn-member-test.dustess.com/W00000000545/static/l/l/d/9/lld9nnx7p91692084131697.xlsx\",\"size\":11085,\"type\":\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\"]"
                    }
                ]
            },
            "sale_source_code": "001",
            "tags": []
        }
    ]
}

成功响应:

名称	类型	备注
code	`Int`
data	`Object`
data.fail	`Object[]`
fail.code	`Int`
fail.index	`Int`
success	`Object[]`
success.id	`String`
success.index	`Int`
msg	`String`
success	`Bool`
trace_id	`String`

成功响应示例:

{
    "success": true,
    "msg": "操作成功",
    "data":
    {
        "fail": [],
        "success": [
        {
            "id": "5a1e3e2c-1111-1111-1111-feadf4d06d8d",
            "index": 1
        }]
    },
    "trace_id": "9e8d5996-1111-1111-1111-6f0790746eb1"
}