创建商机接口
最后更新:2023/06/25企业可通过此接口创建商机接口
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/crm/work/opportunity/create?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"customer_id": "fake_data",
"user_id": "fake_data",
"goods_list": [
{
"goods_type": 1,
"goods_id": "16312312355341",
"goods_name": "商品名称",
"pic_urls": [
"fake_data"
],
"sku_id": "1689342344323234",
"select_attr_val": "fake_data",
"goods_price": 123,
"count": 200,
"goods_content": "fake_data",
"goods_file": [
{
"file_url": "fake_data",
"file_name": "fake_data",
"file_format": "fake_data",
"file_size": "fake_data"
}
],
"self_map": {
"fake_data": "fake_data"
}
}
],
"amount": 100,
"discount_price": 80,
"discount": 20,
"discount_amount": 50,
"opportunity_name": "fake_data",
"phase_id": 165324323423342,
"win_reason_id": "3453533",
"win_reason": "fake_data",
"loss_reason_id": "234353435",
"loss_reason": "fake_data",
"expected_time": 1653343431,
"competitor": "fake_data",
"priority": "高",
"intention": "中",
"remark": "描述",
"field_map": {
"customField": "自定义字段"
}
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
customer_id | str | 是 | 客户id |
user_id | str | 是 | 创建人 |
goods_list | obj[] | 是 | 商品列表 |
goods_type | int | 是 | 商品类型:1 商城商品 2 自定义商品 |
goods_id | str | 否 | 商城商品id |
goods_name | str | 是 | 商品名称 |
pic_urls | int | 否 | 商城商品图片 |
sku_id | str | 否 | 商城skuId |
select_attr_val | str | 否 | 商品规格描述 |
goods_price | long | 否 | 商品价格 |
count | int | 否 | 数量 |
goods_content | str | 否 | 商品/服务内容 |
goods_file | obj[] | 否 | 自定义商品的附件列表 |
file_url | str | 否 | 图片地址 |
file_name | str | 否 | 图片名称 |
file_format | str | 否 | 文件格式 |
file_size | str | 否 | 文件大小 |
self_map | map | 否 | 自定义商品的自定义字段集合 |
amount | long | 是 | 商机原总价 |
discount_price | long | 否 | 优惠金额 |
discount | float | 否 | 折扣 |
discount_amount | long | 是 | 折后总价 |
opportunity_name | string | 是 | 商机名称 |
phase_id | long | 是 | 商机阶段id |
win_reason_id | string | 否 | 赢单原因选择id |
win_reason | string | 否 | 赢单其他原因 |
loss_reason_id | string | 否 | 输单原因选择id |
loss_reason | string | 否 | 输单其他原因 |
expected_time | long | 否 | 预计成交时间 |
competitor | string | 否 | 竞争对手 |
priority | string | 否 | 优先级: 高 中 低 |
intention | string | 否 | 意向度: 高 中 低 |
remark | string | 否 | 备注 |
field_map | map | 否 | 自定义字段,当自定义字段为必填时,该字段必填; 当必填字段为单选,多选,级联等字段时,需要入参字段id和字段值的id 当必填字段为单行文本,多行文本等字段时,入参字段id和对应的值即可 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": 168232949353434,
"sub_code": "00000"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | long | 线索id |
sub_code | string | 业务异常码 |