合同订单新版SDK
更新于 2023-01-18调用本接口新增或编辑合同订单。
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 支持 | 金智CRM数据管理权限 | API Explorer |
| 第三方企业应用 | 支持 | 金智CRM数据管理权限 | API Explorer |
| 第三方个人应用 | 暂不支持 | 金智CRM数据管理权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
x-acs-dingtalk-access-token | String | 是 | 调用该接口的访问凭证。
|
Body参数
名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
datatype | Long | 是 | 数据类型，固定填写150。 |
stamp | Long | 是 | 时间戳。 |
msgid | Long | 否 | 数据ID。 说明
值为0或不填时，为新增数据。 |
data | Object | 否 | 编辑数据。 |
data_userid | String | 是 | 创建人。 |
ht_customerid | String | 是 | 对应客户。 |
ht_date | String | 是 | 签单日期。 |
ht_preside | String | 是 | 所有者。 |
ht_state | String | 是 | 状态，取值。
|
ht_summoney | String | 是 | 总金额。 |
ht_order | String | 是 | 单据类型，取值。
|
ht_title | String | 否 | 主题。 |
ht_number | String | 否 | 合同单号。 |
ht_lxrid | String | 否 | 对应联系人。 |
ht_lxrinfo | String | 否 | 联系方式。 |
ht_xshid | String | 否 | 对应机会。 |
ht_type | String | 否 | 自定义分类。 |
ht_paymode | String | 否 | 付款方式。 |
ht_begindate | String | 否 | 开始日期。 |
ht_cusub | String | 否 | 客户签约人。 |
ht_wesub | String | 否 | 我方签约人。 |
ht_moneyzhekou | String | 否 | 优惠折扣率。 |
ht_kjmoney | String | 否 | 优惠抹零金额。 |
ht_fjmoneylx | String | 否 | 附加费用分类。 |
ht_fjmoney | String | 否 | 附加费用金额。 |
ht_summemo | String | 否 | 外币备注。 |
ht_deliplace | String | 否 | 交付地点。 |
ht_enddate | String | 否 | 最晚发货日。 |
ht_wuliutype | String | 否 | 发货方式。 |
ht_yunfeimoney | String | 否 | 预计运费。 |
fahuoaddressid | String | 否 | 收货地址。 |
ht_contract | String | 否 | 合同正文。 |
ht_remark | String | 否 | 备注。 |
child_mx | String | 否 | 产品明细，json格式。 |
返回参数
名称 | 类型 | 描述 |
|---|---|---|
time | String | 响应时间。 |
msgid | Long | 编辑数据的ID。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | saveFail | 保存数据发生错误 | 保存数据发生错误 |
400 | invalidRequestMethod | 请求方式错误，必须为post请求！ | 请求方式错误，必须为post请求！ |
400 | invalidParameter | 请求参数缺失或无效！ | 请求参数缺失或无效！ |
400 | invalidSeCretKey | 无效的SeCretKey | 无效的SeCretKey |
400 | invalidSign | 签名无效 | 签名无效 |
