查询销售机会列表
POST https://qw-openapi-tx.dustess.com/saleChance/v2/saleChanceList?accessToken=
Content-Type: application/json| 字段 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| accessToken | String | accessToken | 是 |
注意：入参ids字段有值时，其他筛选条件均不生效
| 字段 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| page_size | Int | 分页尺码，默认500、最大500 | 否 |
| ids | String[] | 销售机会的ids，该字段有值时，下列筛选条件均不生效 | 否 |
| start | Int | 销售机会创建开始时间 | 否 |
| end | Int | 销售机会创建结束时间。时间最大跨度一个月 | 否 |
| cf_ts | Int | 返回大于此值的数据 | 否 |
| cate_id | String | 类型id | 否 |
| cid | String | 联系人id | 否 |
| name | String | 销售机会名称（精确） | 否 |
| state | String | 销售机会状态：active(正常)/closed(已关闭)，不传入默认为active | 否 |
{
"page_size": 100,
"ids": ["a46cf15d-1111-1111-1111-eea1dc02cbae"] , // 传入该字段，其他筛选条件均不生效
"start": 1636007832,
"end": 1636009144,
"cf_ts": 1170371173750423600,
"cate_id": "a46cf15d-1111-1111-1111-eea1dc02cbae",
"cid": "a46cf15d-1111-1111-1111-eea1dc02cbae",
"name": "",
"state": "active"
}| 响应参数名 | 类型 | 说明 |
|---|---|---|
| success | Bool | 请求状态，true:成功，false:失败 |
| code | Int | 响应代码，错误时存在 |
| msg | String | 消息提示 |
| data | Object[] | 数据信息 |
| data.count | Int | 满足条件的总数量 |
| data.list | Object[] | 数据结构题 |
| data.list._id | String | 销售机会id |
| data.list.name | String | 销售机会名称 |
| data.list.price | Int | 金额，单位是分 |
| data.list.cid | String | 关联联系人id |
| data.list.corpID | String | 关联企业ID |
| data.list.cate_id | String | 销售机会类型id |
| data.list.quotation_id | String | 报价单id |
| data.list.product_type | String[] | 意向商品类型ids |
| data.list.success_time | Int | 预计成交时间 |
| data.list.completion_time | Int | 真实成单时间 |
| data.list.current_stage | String | 当前阶段id |
| data.list.stage_change_time | Int | 阶段变更时间 |
| data.list.remark | String | 备注 |
| data.list.create_uid | String | 创建员工id |
| data.list.director | String | 负责员工id |
| data.list.update_user | String | 最近更新员工id |
| data.list.fail_reason | String | 丢单原因id |
| data.list.fail_time | Int | 丢单时间 |
| data.list.create_time | Int | 创建时间 |
| data.list.last_time | Int | 最近更新时间 |
| data.list.opponent | String[] | 竞争对手ids |
| data.list.opponent_desc | String | 竞争对手描述 |
| data.list.opponent_name | String[] | 竞争对手名称 |
| data.list.cf_ts | Int | 递增id |
| data.list.dept | Int | 所属部门id |
| data.list.teamwork_info | Object[] | 协同角色信息 |
| data.list.teamwork_info.role_id | String | 协同角色id |
| data.list.teamwork_info.uid | String | 协同员工uid |
| data.list.udf | Object | 销售机会用户自定义字段 |
| data.list.udf.model_data | Object[] | 销售机会用户自定义字段数据集 |
| data.list.udf.model_data[].key | String | 字段业务ID |
| data.list.udf.model_data[].value | String | 字段值：单行文本、多行文本、日期、日期时间类型值为字符串；数字、附件获取附件URL访问签名、单多选、多级联选单多选的值为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"] |
| data.list.quotation_items | Object[] | 报价单商品 |
| data.list.quotation_items._id | String | 报价单详情id |
| data.list.quotation_items.quotationId | String | 报价单id |
| data.list.quotation_items.skuId | String | 商品规格id |
| data.list.quotation_items.goodsId | String | 商品id |
| data.list.quotation_items.num | Int | 商品数量 |
| data.list.quotation_items.desc | String | 商品描述 |
| data.list.quotation_items.numerator | Int | 标准价格，单位为分 |
| data.list.quotation_items.denominator | Int | 实际金额，单位为分 |
| data.list.order_ids | String[] | 销售机会所关联的订单列表 |
| data.list.state | String | 销售机会状态: "active"(正常), "closed"(已关闭) |
| data.list.sourceDetail | Object | 销售机会来源明细 |
| data.list.sourceDetail.sourceCode | String | 销售机会来源ID |
| data.list.sourceDetail.extra | Object[] | 来源明细详情内容 |
| data.list.sourceDetail.extra.type | String | 源明细详情内容对象的类型 外联盟：externalPartner 会员：member |
| data.list.sourceDetail.extra.value | String | 源明细详情内容对象的值， 例如 外联盟则为 ID |
{
"success": true,
"msg": "",
"data": {
"count": 1,
"list": [
{
"_id": "0e095fb4-1111-1111-1111-32744f0cd90d",
"name": "机会",
"price": 500,
"cid": "a4f962b0-1111-1111-1111-4e92cfd314bd",
"corpID": "5212521-1111-1111-1111-5215254854785",
"cate_id": "b5a4af2a-1111-1111-1111-5b970095cd19",
"quotation_id": "a4230668-1111-1111-1111-3218c3768ca7",
"product_type": [
"68418f90-1111-1111-1111-c2d2e74e88c2",
"b20b1b08-1111-1111-1111-acbc32a9494d"
],
"order_ids": [
"68d259fa-9988-422e-87a3-ed9297258c9f"
],
"success_time": 1631721599,
"completion_time": 0,
"current_stage": "49c2eb14-1111-1111-1111-f285b9cf4ac7",
"stage_change_time": 1636083900,
"remark": "",
"create_uid": "1831",
"director": "1831",
"update_user": "877",
"fail_reason": "",
"fail_time": 1631774893,
"create_time": 1631701875,
"last_time": 1636095185,
"opponent": [],
"opponent_desc": "",
"cf_ts": 1152310680976637952,
"dept": 1,
"teamwork_info": [
{
"role_id": 60018,
"uid": "66"
}
],
"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\"]"
}
]
},
"opponent_name": [],
"quotation_items": [
{
"_id": "a44cfc54-1111-1111-1111-3218c3768ca7",
"quotationId": "a4230668-1111-1111-1111-3218c3768ca7",
"skuId": "b368a9aa-1111-1111-1111-060ba2f49039",
"goodsId": "b368a915-1111-1111-1111-060ba2f49039",
"num": 2,
"desc": "",
"numerator": 2200,
"denominator": 2200
}
],
"state": "active",
"sourceDetail": {
"sourceCode": "05j",
"extra": [
{
"type": "externalPartner",
"value": "331028508958531584"
}
]
}
}
]
}
}修改于 2024-11-28 06:54:13