创建商机
最后更新:2025/02/07企业可通过此接口创建商机
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/crm/saleOpportunity/create
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"user_id": "woDkH9EAAALaUpfS5UqkDUOvLLkBu1Dg",
"target_type": "customer",
"target_id": "1887687526362172930",
"name": "商机名称",
"remark": "商机备注",
"goods_list": [
{
"goods_type": 1,
"mall_goods": {
"goods_id": 1866048739286752450,
"name": "测试商品好看的短袖上衣2234234",
"pic_urls": [
"https://pubres-test.wshoto.com/mall-8e83ef9e-8716-4c2a-84c6-eeaf600e7206.jpeg"
],
"sku_id": "1866048739341278402",
"select_attr_val": "颜色: 红色",
"price": 1999,
"count": 2
},
"custom_goods": null
}
],
"amount": 1999,
"discount_amount": 1999,
"discount": "100",
"phase_id": "1866308619805444291",
"priority": "高",
"intention": "高",
"expected_time": "2025-02-19",
"competitor": "竞争对手名称",
"reason_id": "",
"reason": "",
"field_map": {
"mf_opportunity_1": "22222222222",
"mf_opportunity_52": [
"1866383355507919874"
],
"mf_opportunity_53": [
"1866383356128676865",
"1866383356128676866"
],
"mf_opportunity_54": [
"1866383356501969923"
],
"mf_opportunity_101": "2025-02-13",
"mf_opportunity_102": "2025-02-28 00:00:00"
}
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
user_id | string | 是 | 创建人ID |
target_type | string | 否 | 对象类型 |
target_id | string | 否 | 对象ID |
name | string | 否 | 商机名称 |
remark | string | 否 | 商机备注 |
goods_list | object[] | 是 | 商品列表 |
goods_type | int | 否 | 商品类型:1 商城商品 2 自定义商品 |
mall_goods | object | 否 | 商城商品 |
goods_id | long | 否 | 商城商品ID |
name | string | 是 | 商城商品名称 |
pic_urls | string[] | 否 | 商城商品图片 |
sku_id | string | 否 | 商城skuId |
select_attr_val | string | 否 | 商城商品规格描述 |
price | long | 是 | 商城商品价格 |
count | int | 是 | 商城商品数量 |
custom_goods | object | 否 | 自定义服务 |
name | string | 是 | 自定义服务名称 |
price | long | 是 | 商城商品价格 |
content | string | 否 | 自定义服务内容 |
files | object[] | 否 | 自定义服务附件 |
material_id | string | 否 | 素材ID |
amount | long | 否 | 商机金额 |
discount_amount | long | 是 | 折后价,必传 |
discount | string | 否 | 折扣,参考 |
phase_id | string | 否 | 商机阶段ID |
priority | string | 否 | 优先级 |
intention | string | 否 | 意向度 |
expected_time | string | 否 | 预计成交日期,yyyy-MM-dd |
competitor | string | 否 | 竞争对手 |
reason_id | string | 否 | 原因id |
reason | string | 否 | 输单原因 |
field_map | map | 否 | 自定义字段内容 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": 1111
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | long | id |