文档
测试

结算单新增接口

POST
/ykapi/orderdetail/addOrderDetail

接口描述

结算单新增 (更新附件,需要填写和新增一样的字段,附件改成需要修改后的文件就可以)

请求头

参数名
类型
描述
必填

请求参数

参数名
类型
描述
必填
appKey
String
唯一标识
必填
sign
String
唯一标识
必填
settlementOrderno
String
结算流水号,唯一标识
必填
tenantId
String
企业ID
必填
settlementBatch
String
结算批次号
必填
project
String
项目名称,与合同新增接口中项目名称一致。
必填
name
String
姓名
必填
phone
String
电话
必填
identityCard
String
身份证号
必填
account
String
收款账号
必填
personalsettlementTime
Date
个人结算日期
必填
paymentChannel
String
支付通道(在线支付/线下支付)
必填
orderFlag
String
订单标识(值为2,已结算)
必填
caltaxFlag
String
计税方法标识(新计税方法值为2)
必填
aftertaxAmount
BigDecimal
税后金额(与个人税前保证至少有一项不空)
可选
personalPretax
BigDecimal
个人税前(与税后金额保证至少有一项不空)
可选
js
String
技术合同标识(涉及印花税,值为2)
可选
settlementVoucherAttach
文件流
个人结算凭证(附件流)
必填
personalFinishAttachAttr
文件流
个人交付附件(与2.5的企业验收凭证任意传1个)
必填
theServiceFee
BigDecimal
总包服务费(价税合计)
必填
serviceContent
String
服务内容(这条结算单的开票项目,例:互联网营销推广)
必填
picture
String
工作场景照片或者视频(文件地址)
可选

响应参数

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

说明 / 示例

更新附件,需要的字段和新增一样,附件修改成更新后的附件就可以更新

状态码

参数名
类型
描述
必填
1000
成功
必填
1001
appKey不能为空
必填
1002
sign不能为空
必填
1003
tenantId不能为空
必填
1004
settlementOrderno不能为空
必填
1005
settlementBatch不能为空
必填
1006
project不能为空
必填
1007
name不能为空
必填
1008
phone不能为空
必填
1009
identityCard不能为空
必填
1010
account不能为空
必填
1011
个人结算日期不能为空
必填
1012
paymentChannel不能为空
必填
1013
税后金额和个人税前不可同时为空
必填
1014
总包服务费不能为空
必填
1015
服务内容不能为空
必填
2001
appAppsecret未分配
必填
1099
文件大小不应超过20M
必填
9999
签名验证失败
必填
1111
插入失败
必填
1112
结算流水号重复
必填
1113
无对应合同信息
必填
1114
对应多条合同信息
必填
1115
合同信息中结算费率1基数信息有误
必填
1116
合同信息中结缺少结算费率1基数或比例
必填
1117
时间格式化异常
必填
1118
应收单插入异常
必填
1119
个人结算凭证上传异常
必填
1120
个人交付附件上传异常
必填
1121
无对应会员信息
必填
1122
当前结算单用户传输过快请稍后在试!(数据传输过快,上一条正在存储中,最好同一个人的每一条结算单记录间隔5秒时间)
必填
1123
该结算单上传的项目对应合同,包含敏感词,停止上传,请联系客服了解详情
必填
1124
该人员的结算单涉及风控,停止上传,请联系客服了解详情
必填
1125
附件更新成功
必填
8888
附件更新失败(两个附件不能都为空)
必填