查询竞争对手 - 尘锋SCRM开放平台

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

Content-Type: application/json

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

Query:

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

Body:

名称	类型	是否必须	备注	其他信息
saleChanceEditList	`Object[]`	非必须		item 类型: object
saleChanceEditList.cateId	`String`	必须	类型id
saleChanceEditList.cid	`String`	非必须	客户ID
saleChanceEditList.corpId	`String`	非必须	关联企业ID
saleChanceEditList.currentStage	`String`	必须	当前跟进阶段
saleChanceEditList.customFields	`Object[]`	非必须	销售机会自定义字段	item 类型: object
customFields.array_value	`Object[]`	非必须		item 类型: object
customFields.files_value	`Object[]`	非必须		item 类型: object
files_value.file_type	`String`	非必须	文件类型
files_value.name	`String`	非必须	文件名
files_value.size	`Int`	非必须	文件大小(单位byte)
files_value.url	`String`	非必须	存储绝对路径
customFields.float_value	`Float`	非必须	字段类型为：number（数字）时使用此字段
customFields.id	`String`	非必须	字段id
customFields.string_value	`String`	非必须	字段类型为：radio（单选），date（日期），datetime（日期时间），text（单行文本），textarea（多行文本）,cascader(级联选择)时使用此字段
customFields.type	`String`	非必须	自定义字段类别 (目前仅用于销售机会)
saleChanceEditList.dept	`Int`	必须	部门id
saleChanceEditList.failReason	`String`	非必须	丢单原因
saleChanceEditList.id	`String`	必须	销售机会ID
saleChanceEditList.name	`String`	必须	名称
saleChanceEditList.opponent	`String[]`	非必须	竞争对手ids	item 类型: string
saleChanceEditList.opponentDesc	`String`	非必须	竞争对手描述
saleChanceEditList.ownType	`Int`	必须	归属类型 1.个人，2.企业
saleChanceEditList.price	`Int`	非必须	金额
saleChanceEditList.productType	`String[]`	非必须	商品类别	item 类型: string
saleChanceEditList.remark	`String`	非必须	备注（限制200字）
saleChanceEditList.successTime	`String`	非必须	预计成交时间
uid	`String`	非必须	操作人
示例:

{

    "uid": "297",
    "saleChanceEditList": [
        {
            "cid": "",
            "thirdCid": "1000000000000222222",
            "externalCid":"",
            "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

        }
    ]
}

成功响应:

名称	类型	备注
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"
}