卫瓴API文档

10.4 商机更新

POST

https://openapi.weiling.cn/openapi/business/edit

请求参数

Query 参数

access_token

string

接口调用凭证

必需

Body 参数application/json

business_id

string

商机id

必需

business_name

string

商机名称

可选

except_amount

number

预计赢单金额

可选

except_date

string

可选

预计赢单日期(yyyy-MM-dd)

stage

integer

可选

商机阶段码值(请参考10.2或者10.9接口)

fail_reason

integer

可选

商机丢单原因，商机阶段更新为丢单时（stage = 99时）必填

fail_reason_desc

string

可选

丢单原因描述，商机阶段更新为丢单且商机丢单原因 = 99时必填

op_user_id

string

操作人id

必需

process_id

string

可选

商机流程id(请参考10.9接口)

winning_amount

number

可选

赢单金额(stage为100时不为空)

winning_date

string

可选

赢单日期(yyyy-MM-dd)((stage为100时不为空))

business_custom

object

可选

用户自定义字段(不传则不做修改)
(key为apiName , value为传参 ;
若apiName是文本类型: 长度<50 ;
是长文本类型: 长度<200 ;
是日期类型: 13位时间戳 ;
是单选类型: 选项的label值（number） ;
是多选类型: 选项的label值的集合（Array of number） )

示例

{
  "business_id": "string",
  "business_name": "string",
  "except_amount": 0,
  "except_date": "string",
  "stage": 0,
  "fail_reason": 0,
  "fail_reason_desc": "string",
  "op_user_id": "string",
  "process_id": "string",
  "winning_amount": 0,
  "winning_date": "string",
  "business_custom": {}
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.weiling.cn/openapi/business/edit?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "business_id": "string",
    "business_name": "string",
    "except_amount": 0,
    "except_date": "string",
    "stage": 0,
    "fail_reason": 0,
    "fail_reason_desc": "string",
    "op_user_id": "string",
    "process_id": "string",
    "winning_amount": 0,
    "winning_date": "string",
    "business_custom": {}
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

返回结果码值-0:请求成功 500 系统错误

msg

string

返回结果信息

必需

示例

{
  "code": "string",
  "msg": "string"
}

修改于 2024-09-26 05:52:38

10.3 商机新增-新版

10.5 商机变更归属人