API开发文档 - 道一云

开发说明
- 请求包体
- 请求参数说明

开发说明

功能说明：更新商机信息
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/crm/business/updateBusinessInfo.do?token=token&corpId=corpId

请求包体：

{
    "id":"9f18f306-f34c-4b42-bfc1-41a4bba7fa26",
    "businessStage":"2",
    "businessType":"12",
    "chargePersonId":"wx_mr_zhao",
    "clientId":"9a2fb91e1fef48b7a582a34968bd9925",
    "contactIds":"1bb3eeb54e2844598189272adbfd6d35,874a21aa4a4f423da64cb0c8a20f72d4",
    "content":"这是商机内容",
    "customFields":[
        {
            "fieldId":"ad3383676ae1090cf39bdc9e6fa20676",
            "fieldValue":"这是单行文本"
        },
        {
            "fieldId":"c1bec3b07dfc8f7e350afc8da30e5cb1",
            "fieldValue":"这是多行文本\n这是多行文本\n"
        },
        {
            "fieldId":"6cae2f16cd2a67b2b4613b3719527a47",
            "fieldValue":"1"
        },
        {
            "fieldId":"21e7c172cc7a1bec704b793d5e739beb",
            "fieldValue":"13312031200"
        },
        {
            "fieldId":"4e4eb8cba8a0d9e72a085f2f36d861a0",
            "fieldValue":"2019-12-03"
        },
        {
            "fieldId":"73504817cff862f1748b2735a852fbfe",
            "fieldValue":"100000"
        },
        {
            "fieldId":"bf459fb4837c9a6b161ddac72dd7c836",
            "fieldValue":"1000000.00"
        },
        {
            "fieldId":"5c8fe1262515a435e6eb004f540d1c5f",
            "fieldValue":"80%"
        },
        {
            "fieldId":"80cf88634c7b0e27f6d5d42badecca1f",
            "fieldValue":"必填自定义字段"
        }
    ],
    "estimatedDate":"2019-12-03",
    "estimatedSale":"100000000.0",
    "loseReasonId":"",
    "partnersIds":"33ee9ac3dc194d8ba7341ffbc16208df,1ea6a30f40014f8eb363afdb857ce710",
    "relativePersonsIds":"wx_miss_li,wx_mr_liu",
    "submitType":"1",
    "title":"这是商机标题",
    "seniorFields":[
        {
            "fieldId":"fod9e4acf33e9147128fd085e7712a50e3",
            "fieldName":"高级字段-单行文字",
            "fieldValue":"这是高级字段单行类型字段"
        },
        {
            "fieldId":"foab338de2db0b449fa46cf375e9d87e3f",
            "fieldName":"高级字段-邮箱",
            "fieldValue":"123456789@qq.com"
        },
        {
            "fieldId":"fo57b9b1ae81ad492c879050330d5eb3d6",
            "fieldName":"高级字段-数字",
            "fieldValue":"233"
        },
        {
            "fieldId":"fo498bd7a5a3574807a9010882b70c334f",
            "fieldName":"高级字段-电话",
            "fieldValue":"020 12031200"
        },
        {
            "fieldId":"fo62e8daa9b10f41848a1e264f7de4819b",
            "fieldName":"高级字段-手机",
            "fieldValue":"13312031200"
        },
        {
            "fieldId":"fo61fd1ef6f36d4e5084f9a331b3d65b91",
            "fieldName":"高级字段-多行文字",
            "fieldValue":"这是高级字段多行文字类型\n这是高级字段多行文字类型\n"
        },
        {
            "fieldId":"fo645321f1c7b9415dba84974cc3f39202",
            "fieldName":"高级字段-日期",
            "fieldValue":"2019-12-03"
        },
        {
            "fieldId":"fo54af86e5f2494bb38a4de1a9282d0ad6",
            "fieldName":"高级字段-时间",
            "fieldValue":"18:00"
        },
        {
            "fieldId":"fob0adb4f6a7fe440782995cf6426f9ad3",
            "fieldName":"高级字段-日期时间",
            "fieldValue":"2019-11-11 11:11"
        },
        {
            "fieldId":"fo3674959396384edc8817651605913ccc",
            "fieldName":"高级字段-单项选择",
            "fieldValue":"选项1"
        },
        {
            "fieldId":"fod9e4acf33e9147128fd085e7712a50e3",
            "fieldName":"高级字段-多项选择",
            "fieldValue":"选项1,选项2"
        },
        {
            "fieldId":"foe99290cf57f84bfc814b70909a93fc4b",
            "fieldName":"高级字段-下拉框",
            "fieldValue":"选项1"
        },
        {
            "fieldId":"foe779eae3b38d436c8c72ded5324ba8b0",
            "fieldName":"高级字段-评分",
            "fieldValue":"3"
        },
        {
            "fieldId":"fo9982aebbdd9b423383e7182fbd57740c",
            "fieldName":"高级字段-地理位置",
            "fieldValue":"广东省广州市天河区员村一横路3号"
        },
        {
            "fieldId":"fo6b8fdde86ec4472a972ec2b71edd7efa",
            "fieldName":"高级字段-省市区",
            "fieldValue":"广东省:广州市:天河区"
        },
        {
            "fieldId":"fo521f8244ba3e4d6785602d4aee23a07d",
            "fieldName":"高级字段-计算式",
            "fieldValue":"466"
        },
        {
            "fieldId":"fobb841af1252547b788d9c93c2baf27c3",
            "fieldName":"高级字段-两级下拉框",
            "fieldValue":"选项1:二级选项2"
        },
        {
            "fieldId":"foc95fc853e5984552a77dc582a68e8962",
            "fieldName":"高级字段-通讯录成员",
            "fieldValue":"zhangsan,lisi"
        },
        {
            "fieldId":"foa19a6a39b6d3402a870fc7987ae40e13",
            "fieldName":"高级字段-部门",
            "fieldValue":"一级部门A->二级部门B,一级部门B->二级部门C->三级部门D"
        }
    ]
}
// 自定义高级字段中的参数fieldName仅做展示用，实际调用不需要传。

请求参数说明：

businessInfo

参数	说明	类型	是否必填	备注
id	待更新的商机id	String	必填
businessStage	商机阶段	String	字段的isNecessary值为1是必填，0为非必填	填写获取商机字段接口返回choices中的选项值value 或者获取商机阶段接口返回的选项值value
businessType	商机类型	String	字段的isNecessary值为1是必填，0为非必填	填写获取商机字段接口返回choices中的选项值value 或者获取商机类型接口返回的选项值value
chargePersonId	负责人wxId	String	是	必须是存在于道一云通讯录中的账号；填写wxUserId；最多填写一个。
clientId	所属客户Id	String	字段的isNecessary值为1是必填，0为非必填	最多填写一个
contactIds	客户联系人Ids	String	字段的isNecessary值为1是必填，0为非必填	多个客户联系人用英文逗号分隔
content	商机内容	String	字段的isNecesary值为1是必填，0为非必填
customFields	自定义字段数组	JSON	根据自定义字段是否有isNecessary值为1的字段判断	如果自定义字段存在isNecessary为1的字段，则填写对应自定义字段customField信息。
estimatedDate	结算日期	String	字段的isNecessary值为1是必填，0为非必填	格式：yyyy-MM-dd
estimatedSale	销售额	String	字段的isNecessary值为1是必填，0为非必填	整数或浮点数
loseReasonId	输单原因ID	String	字段的isNecessary值为1是必填，0为非必填	填写获取商机字段接口的输单原因字段的choices中的optionId
partnersIds	商机合作伙伴	String	字段的isNecessary值为1是必填，0为非必填	多个商机合作伙伴用英文逗号隔开
relativePersonsIds	相关负责人wxId	String	否	必须是存在于道一云通讯录中的账号；填写wxUserId；多个相关负责人，可用英文逗号隔开
submitType	通知类型	String	否	默认发送给负责人， 1：为发送新建消息给CRM联系人的相关人
title	标题	String	字段的isNecessary值为1是必填，0为非必填
seniorFields	自定义高级字段	String	JSON

customField

参数	类型	类型	是否必填	备注
fieldId	自定义字段Id	String	字段的isNecessary值为1是必填，0为非必填	填写从获取商机字段接口返回的对应的自定义字段ID
fieldValue	自定义字段值	String	字段的isNecessary值为1是必填，0为非必填	Select类型数据填写对应choices的选项值value； Percent类型必须有百分号； Double类型必须精确到小数点后两位； DateTime类型只能是yyyy-MM-dd或者yyyy-MM-dd hh:mm:ss格式。

参数

类型

是否必填

备注

fieldId

自定义字段Id

String

字段的isNecessary值为1是必填，0为非必填

填写从获取商机字段接口返回的对应的自定义字段ID

fieldValue

自定义字段值

String

字段的isNecessary值为1是必填，0为非必填

Select类型数据填写对应choices的选项值value；

Percent类型必须有百分号；

Double类型必须精确到小数点后两位；

DateTime类型只能是yyyy-MM-dd或者yyyy-MM-dd hh:mm:ss格式。

seniorField

参数	说明	类型	是否必填	备注
fieldId	自定义高级字段ID	String	根据isNecessary填写	填写从获取客户字段接口返回的对应的自定义高级字段ID
fieldValue	fieldValue	String	根据isNecessary填写	各类型字段的填写根据下面的表格进行填写

自定义高级字段填写说明

类型	字段释义	填写说明
TextField	单行文本	最多2000字符
NumberField	数字	数字类型
EmailField	邮箱	邮箱格式
TelephoneField	电话	分隔用-或空格，国际电话加+
MobileField	手机	手机格式
TextArea	多行文本	最多2000字符
DateField	日期	yy-MM-dd
TimeField	时间	hh:mm
DateTimeField	日期时间	yy-MM-dd hh:mm
RadioButton	单项选择	选项名，如：选项一
CheckBox	多项选择	选项名，多个用英文逗号分隔。如：选项2，选项3
DropDown	下拉框	选项名，如：选项一
RatingField	评分	评分范围内的数字
GeoField	地理位置	地理位置
CityField	省市区	格式：xx省:xx市:xx区。英文冒号分隔
EquationField	计算式	根据设置的计算规则填写
CascadeDropDown	两级下拉框	填写获取字段接口返回结果里choices的某个选项的optionName。如：选项一:二级选项。
MEMBERCustomerField	通讯录成员	通信录成员的wxUserId，多个成员英文逗号分隔
DEPTCustomerField	部门	填写部门全称，层级用"->"链接，多个部门用英文逗号','分隔，如一级部门A->二级部门B,一级部门B->二级部门C->三级部门D

企业微信

更新商机

开发说明