商机列表
最后更新:2025/02/07企业可通过此接口查询商机
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/crm/saleOpportunity/page
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"user_ids": null,
"target_type": "",
"target_ids": [],
"phase_ids": [],
"created_time_start": null,
"created_time_end": null,
"field_map": {},
"current_index": 1,
"page_size": 10
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
current_index | int | 是 | 当前页,默认值为1 |
page_size | int | 是 | 每页大小,默认值为20 |
user_ids | string[] | 否 | 创建人ID列表 |
target_type | string | 否 | 对象类型 |
target_ids | string[] | 否 | 目标对象ID列表 |
phase_ids | string[] | 否 | 商机阶段ID列表 |
created_time_start | string | 否 | 创建时间-开始,格式为yyyy-MM-dd HH:mm:ss |
created_time_end | string | 否 | 创建时间-结束,格式为yyyy-MM-dd HH:mm:ss |
field_map | map | 否 | 自定义字段筛选 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"total": 1,
"records": [
{
"id": "1887707880627376897",
"name": "商机名称",
"remark": "商机备注",
"amount": 3998,
"discount": null,
"priority": "高",
"intention": "高",
"competitor": "竞争对手名称",
"endTime": "1970-01-01 08:00:00",
"reason": null,
"user_id": "woDkH9EAAALaUpfS5UqkDUOvLLkBu1Dg",
"contact_id": "1887687526362172930",
"company_id": "1887687525284236801",
"discount_amount": 1999,
"phase_id": "1866308619805444291",
"phase_name": "需求确定",
"phase_time": "2025-02-07 11:40:05",
"expected_time": "2025-02-19 00:00:00",
"reason_id": null,
"field_map": {
"mf_opportunity_2": "55555555",
"mf_opportunity_54": [
{
"name": "分类2",
"id": "1866383356501969923"
}
],
"mf_opportunity_53": [
{
"name": "选项1",
"id": "1866383356128676865"
},
{
"name": "选项2",
"id": "1866383356128676866"
}
],
"mf_opportunity_1": "22222222222",
"mf_opportunity_101": "2025-02-13",
"mf_opportunity_102": "2025-02-28 00:00:00",
"mf_opportunity_52": [
{
"name": "选项2",
"id": "1866383355507919874"
}
],
"mf_opportunity_51": "231"
},
"create_time": "2025-02-07 11:40:06",
"follow_time": "2025-02-07 11:39:58"
}
]
},
"sub_code": "00000"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | object | 结果 |
total | long | 总条数 |
records | object[] | 商机信息 |
id | string | 商机ID |
user_id | string | 员工ID |
contact_id | string | 联系人ID |
company_id | string | 企业ID |
name | string | 商机名称 |
remark | string | 商机备注 |
amount | long | 商机金额 |
discount_amount | long | 折后价 |
discount | string | 折扣 |
phase_id | string | 商机阶段ID |
phase_name | string | 商机阶段名称 |
phase_time | string | 阶段变更时间 |
priority | string | 优先级 |
intention | string | 意向度 |
expected_time | string | 预计成交日期 |
competitor | string | 竞争对手 |
end_time | string | 结束时间 |
reason_id | string | 原因ID |
reason | string | 输单原因 |
field_map | map | 自定义字段 |
create_time | string | 创建时间 |
follow_time | string | 商机变更时间 |