灵工SAAS平台OpenAPI2.0文档
  1. 自由职业者佣金结算
灵工SAAS平台OpenAPI2.0文档
  • 灵活用工
    • 前言
    • 流程说明
    • 对接说明
    • 通知说明
    • 示例代码
    • 自由职业者
      • 实名认证(SFT0101)
      • 实名认证+合同综合接口(SFT0109)
      • 身份证照片上传(SFT0102)
      • 自由职业者信息查询(SFT0103)
      • 银行卡bin查询(SFT0202)
      • 银行卡列表(SFT0201)
      • 银行卡绑定(SFT0203)
      • 银行卡解绑(SFT0204)
      • 自由职业者身份证图片获取(SFT0110)
    • 电子合同
      • 合同预览(SFT0107)
      • 电子合同生成(SFT0104)
      • 电子合同授权签约(SFT0105)
      • 电子合同信息查询(SFT0106)
      • 电子合同上传(待开发)
      • 自由职业者电子合同查询(SFT0111)
    • 存管账户
      • 服务商列表(SFT0301)
      • 账户列表查询(SFT0302)
      • 账户余额查询(SFT0303)
      • 充值账户查询(SFT0304)
      • 企业银行账户列表(SFT0310)
      • 企业银行账户绑定(SFT0311)
      • 企业银行账户解绑(SFT0312)
      • 账户变动明细(SFT0305)
    • 充值
      • 充值记录查询(SFT0401)
      • 充值申请(待开发)
      • 充值订单查询(SFT0403)
      • 充值数据同步(SFT0404)
    • 用工企业提现
      • 提现订单列表(SFT0411)
      • 提现申请(SFT0412)
      • 提现订单详情(SFT0413)
    • 自由职业者佣金结算
      • 佣金结算服务费预计算(SFT0501)
        POST
      • 佣金结算(SFT0502)
        POST
      • 佣金结算批次查询(SFT0503)
        POST
      • 佣金结算批次订单查询(SFT0504)
        POST
      • 佣金结算订单查询(SFT0505)
        POST
      • 电子回单查询(SFT0506)
        POST
      • 佣金结算数据同步(SFT0510)
        POST
    • 退款
      • 退款订单查询(SFT0801)
      • 退款订单明细(SFT0802)
    • 开票
      • 开票类目查询(SFT0601)
      • 开票类型列表(SFT0602)
      • 可开票批次查询(SFT0603)
      • 开票申请(SFT0605)
      • 开票申请列表(SFT0606)
      • 开票申请详情(SFT0607)
      • 开票申请关联订单列表(SFT0608)
      • 开票额度账户列表(SFT0609)
      • 开票额度账户详情(SFT0610)
      • 开票申请撤销(SFT0611)
    • 项目
      • 项目列表(SFT0701)
      • 项目详情(SFT0702)
      • 项目新增(SFT0703)
      • 项目删除(SFT0704)
      • 项目确认单(SFT0705)
    • 完税凭证
      • 完税凭证记录(SFT1001)
    • 通知
      • 充值通知(1001)
      • 提现通知(2001)
      • 佣金结算通知(3001)
      • 佣金结算退票通知(5001)
      • 电子合同签约完成通知(8001)
      • 开票结果通知(9001)
    • 企业信息
      • 企业信息查询(SFT0901)
  • 营销金结算
    • 营销活动
      • 营销活动创建(SFT1101)
    • 结算
      • 营销金结算付款(SFT0502)
      • 营销金结算批次查询(SFT0503)
      • 营销金结算批次订单查询(SFT0504)
      • 营销金结算订单同步(SFT0510)
      • 营销金结算-微信收款信息获取(SFT0511)
      • 营销金结算-微信收款结果确认(SFT0512)
  1. 自由职业者佣金结算

佣金结算数据同步(SFT0510)

测试中
POST
/open/api/gateway.do
该接口为商户平台结算成功的佣金数据同步给我方平台,不实际走交易
注意:1.如果同步数据需要开票时,openInvoiceModel注意跟技术沟通确认
2. personId不为空时, 在收款人姓名、身份证号有填写时如不一致提示错误,未填写时,以personId的信息为准

请求参数

Body 参数application/json
apiCode
string 
接口编码:SFT0510
必需
merchantNo
string 
商户号
必需
requestNo
string 
请求流水
必需
timestamp
string 
时间戳
必需
version
string 
版本号,固定2.0
必需
sign
string 
签名
必需
bizModel
object (PaymentSyncModel) 
必需
outBatchNo
string 
外部批次号
必需
会校验商户下是否重复
taxBaseCode
string 
服务商编码
必需
busType
string 
业务类型
可选
非必填,默认灵活用工(1001:灵活用工;1007:营销返利)
projectCode
string 
项目编码
可选
灵活用工时,如果为空后台默认
deductionMethod
integer 
服务费承担方式
可选
企业承担:1 个人承担:2 默认:1
computeMode
string 
计算模式
可选
1 外扣模式、2 内扣模式 默认:1
payChannelCode
string 
交易通道
必需
3000001:支付宝 3000002:微信 3000003:招商银行 3000005:平安银行 3000007:兴业银行
openInvoiceModel
integer 
开票模式
必需
0:不可开票 1:订单开票 2:汇总开票 默认:0 如果设置1和2时,SFT0404接口该参数设置为0
serviceRate
number 
执行费率
可选
百分比*100
tradeTime
string <date-time>
交易时间
必需
yyyy-MM-dd HH:mm:ss, orderList下订单tradeTime字段优先
remark
string 
交易备注
可选
orderList
array [object {12}] 
必需
示例
{
    "apiCode": "SFT0510",
    "bizModel": "{\"orderList\":[{\"outOrderNo\":\"PO202402040000001215\",\"payeeAcctNo\":\"444422222333311144\",\"payeeAmount\":222,\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"431024198904060611\",\"payeeMobileNo\":\"18688835571\",\"payeeName\":\"胡三\",\"payerAmount\":222,\"remark\":\"2.0API测试\",\"serviceAmount\":21}],\"outBatchNo\":\"T202403040000002\",\"payChannelCode\":\"3000001\",\"taxBaseCode\":\"2000064001\",\"tradeTime\":1709541694167}",
    "sign": "iB2FvVgzsHA2MnH5zffFQ/st5VtycRpT5XNqaSLKiqRSvWZeupl8q3ZIspgoqWln/8SHNPOJkEph790hYpadY48qk3FXKsssug4dqw9p3149Bd0gc1yxFRvmtOPpK47mfPo9feuBP4SiUl2qmDNV/hfyotEPQSa70bx/KjE+jLo=",
    "requestNo": "62ff3844-e982-4a0d-8b1d-359250ffd417",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240304164135"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/open/api/gateway.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiCode": "SFT0510",
    "bizModel": "{\"orderList\":[{\"outOrderNo\":\"PO202402040000001215\",\"payeeAcctNo\":\"444422222333311144\",\"payeeAmount\":222,\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"431024198904060611\",\"payeeMobileNo\":\"18688835571\",\"payeeName\":\"胡三\",\"payerAmount\":222,\"remark\":\"2.0API测试\",\"serviceAmount\":21}],\"outBatchNo\":\"T202403040000002\",\"payChannelCode\":\"3000001\",\"taxBaseCode\":\"2000064001\",\"tradeTime\":1709541694167}",
    "sign": "iB2FvVgzsHA2MnH5zffFQ/st5VtycRpT5XNqaSLKiqRSvWZeupl8q3ZIspgoqWln/8SHNPOJkEph790hYpadY48qk3FXKsssug4dqw9p3149Bd0gc1yxFRvmtOPpK47mfPo9feuBP4SiUl2qmDNV/hfyotEPQSa70bx/KjE+jLo=",
    "requestNo": "62ff3844-e982-4a0d-8b1d-359250ffd417",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240304164135"
}'

返回响应

🟢200成功
application/json
Body
可选
Any of
code
integer 
响应码,200:成功
必需
msg
string 
响应消息
必需
status
string 
同步总状态
必需
1 同步成功
batchNo
string 
平台批次号号
必需
failCount
integer 
失败笔数
必需
明细中失败笔数
orderList
array[object (PaymentSyncOrderModel) {14}] 
订单明细
必需
示例
{
    "code": 500,
    "msg": "服务商编码不能为空"
}
修改于 2024-03-06 08:04:14
上一页
电子回单查询(SFT0506)
下一页
退款订单查询(SFT0801)
Built with