新建合同
POST
/api/v3/contract/create
请求参数
Header 参数
appId
string
应用 appId
默认值:
{{appId}}
timestamp
string
请求时间戳
默认值:
{{timestamp}}
sign
string
请求消息签名值
默认值:
{{sign}}
appKey
string
应用 appKey
默认值:
{{appKey}}
Body 参数application/json
title
string
合同标题
customerId
number
探马客户id
amount
number
合同金额
departmentId
number
部门id
opportunityIds
array[number]
关联商机id集合
crmOrderIds
array[number]
关联订单id集合
salesId
number
负责人id(探马内销售id)
fields
array [object {2}]
自定义字段映射列表
alias
string
调用方合同字段映射别名
values
array[string]
字段value
示例
{
"title": "测试1118",
"customerId": 456684054755392,
"amount": 200,
"departmentId": 3765,
"salesId": 565323265652655,
"opportunityIds": [
289347932423
],
"crmOrderIds": [
923843242423
],
"fields": [
{
"alias": "合同类型",
"values": [
"多看看"
]
},
{
"alias": "合同开始日期",
"values": [
"2021-03-20"
]
},
{
"alias": "合同结束日期",
"values": [
"2021-03-30"
]
},
{
"alias": "多选项",
"values": [
"多选项一",
"多选项二",
"多选项三"
]
},
{
"alias": "合同状态",
"values": [
"3"
]
},
{
"alias": "合同附件",
"values": [
"{'name':'公海个人客户模板 (6).xlsx','fileId':'group3/M00/1B/24/rBHDsmI0heeAAxMkAAAoHXSy-T894.xlsx','size':10269,'url':'https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/24/rBHDsmI0heeAAxMkAAAoHXSy-T894.xlsx','type':'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet','uid':1647609320663,'status':'success'}",
"{'name':'rBHTwWIM5-6AJOe-AAARnRXiq3A12.xlsx','fileId':'group3/M00/90/41/rBHTdWI0hf6AQdRsAAARnU0vopE54.xlsx','size':4509,'url':'https://dev.tanmarket.cn/fdfsServer/group3/M00/90/41/rBHTdWI0hf6AQdRsAAARnU0vopE54.xlsx','type':'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet','uid':1647609344058,'status':'success'}"
]
}
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v3/contract/create' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"title":"测试1118",
"customerId":456684054755392,
"amount":200,
"departmentId":3765,
"salesId":565323265652655,
"opportunityIds":[
289347932423
],
"crmOrderIds":[
923843242423
],
"fields":[
{
"alias":"合同类型",
"values":[
"多看看"
]
},
{
"alias":"合同开始日期",
"values":[
"2021-03-20"
]
},
{
"alias":"合同结束日期",
"values":[
"2021-03-30"
]
},
{
"alias":"多选项",
"values":[
"多选项一",
"多选项二",
"多选项三"
]
},
{
"alias":"合同状态",
"values":[
"3"
]
},
{
"alias":"合同附件",
"values":[
"{'\''name'\'':'\''公海个人客户模板 (6).xlsx'\'','\''fileId'\'':'\''group3/M00/1B/24/rBHDsmI0heeAAxMkAAAoHXSy-T894.xlsx'\'','\''size'\'':10269,'\''url'\'':'\''https://dev.tanmarket.cn/fdfsServer/group3/M00/1B/24/rBHDsmI0heeAAxMkAAAoHXSy-T894.xlsx'\'','\''type'\'':'\''application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'\'','\''uid'\'':1647609320663,'\''status'\'':'\''success'\''}",
"{'\''name'\'':'\''rBHTwWIM5-6AJOe-AAARnRXiq3A12.xlsx'\'','\''fileId'\'':'\''group3/M00/90/41/rBHTdWI0hf6AQdRsAAARnU0vopE54.xlsx'\'','\''size'\'':4509,'\''url'\'':'\''https://dev.tanmarket.cn/fdfsServer/group3/M00/90/41/rBHTdWI0hf6AQdRsAAARnU0vopE54.xlsx'\'','\''type'\'':'\''application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'\'','\''uid'\'':1647609344058,'\''status'\'':'\''success'\''}"
]
}
]
}'
返回响应
🟢200成功
application/json
Body
code
integer
状态码
message
string
响应描述
data
object
响应数据
tanmaContractId
string
探马合同id
示例
{
"code": 0,
"message": "success",
"data": {
"tanmaContractId": "HT.212391023131",
"customerId": "EX.3781283192312"
}
}
🟢200失败
修改于 2023-04-11 12:18:06