文档
测试

合同新增接口

POST
/ykapi/contract/addContracts

接口描述

合同新增接口,二次调用接口会更新相同“项目名称”的合同中的其他字段信息(除:业务流水号、项目名称)

请求头

参数名
类型
描述
必填

请求参数

参数名
类型
描述
必填
appKey
String
唯一标识
必填
sign
String
唯一标识
必填
serialNumber
String
业务流水号 唯一标识
必填
contractNumber
String
合同编号
必填
project
String
项目名称唯一
必填
contractName
String
合同名称
必填
contractPartya
String
合同甲方名称 当是转包模式时,甲方信息是总包方信息
必填
contractPartyaInfo
String
甲方税号
必填
contractPartyaLegal
String
甲方法人
可选
taxAddress
String
税务地址
必填
mailingAddress
String
通信地址
可选
phone
String
电话
必填
bankOfDeposit
String
开户行
必填
account
String
账号
必填
partya1Name
String
甲方项目联系人
可选
partya1Position
String
项目联系人职位
可选
partya1Phone
String
项目联系人电话
可选
partya2Name
String
甲方财务联系人
必填
partya2Position
String
财务联系人职位
可选
partya2Phone
String
财务联系电话
必填
partyaAddress
String
发票收件地址
必填
contractPartyb
String
合同乙方名称
必填
partybRole
String
乙方项目角色
可选
projectFlow
String
项目流程描述
可选
signingDate
Date
签署日期
可选
businessType
String
服务内容(例:市场营销推广,多个内容以"、"隔开)
必填
settlementModelDesc
String
结算依据模型描述
可选
settlementBase
String
结算费率1基数 个人税前、税后金额、汇总代开
必填
settlementProportion
String
结算费率1(比例)
必填
settlementFixedvalue
String
结算费率2(固定值)
可选
remark
String
合同备注
可选
tenantId
String
平台提供的企业ID
必填
contractModelAttach
文件流
合同附件流(文件大小不应超过20M)
必填
projectCategory
String
项目分类
可选

响应参数

参数名
类型
描述
必填
retCode
String
返回状态码(详情参数见下面的状态码)
必填
retMsg
String
返回描述
必填
data
String
返回结果
必填

说明 / 示例

备注:项目分类对应值 |分类名称|属性值| |-|-|-| |地推、用户分享|1001| |共享经济|1002| |互联网营销|1003| |技能众包服务|1004| |其他|1005|

状态码

参数名
类型
描述
必填
0000
成功
必填
1001
appKey不能为空
必填
1002
sign不能为空
必填
1003
tenantId不能为空
必填
1004
contractNumber不能为空
必填
1005
contractName不能为空
必填
1006
合同附件上传异常
必填
1007
appAppsecret未分配
必填
1008
settlementBase不能为空
必填
1009
settlementProportion不能为空
必填
1010
project不能为空
必填
1011
contractPartyaInfo不能为空
必填
1012
项目分类值有误
必填
1013
serialNumber不能为空
必填
1014
contractPartya不能为空
必填
1015
contractPartyb不能为空
必填
1016
businessType不能为空
必填
1099
文件大小不应超过20M
必填
9999
签名验证失败
必填
1111
更新原有合同成功
必填
1112
更新原有合同失败
必填