灵工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. 自由职业者佣金结算

佣金结算服务费预计算(SFT0501)

POST
/open/api/gateway.do
代付管理
计算服务费

请求参数

Body 参数application/json
apiCode
string 
接口编码:SFT0501
必需
merchantNo
string 
商户号
必需
requestNo
string 
请求流水
必需
timestamp
string 
时间戳
必需
version
string 
版本号,固定2.0
必需
sign
string 
签名
必需
bizModel
object 
必需
acctNo
string 
存管账号
必需
deductionMethod
string 
服务费扣款方式
可选
1:企业承担 2:个人承担, 需要运营配置支持, 如配置一个可不传
projectCode
string 
项目编码
可选
项目为空会以存管账户归属服务商取用工企业默认的最新项目
orderList
object 
必需
示例
{
    "apiCode": "SFT0501",
    "bizModel": "{\"acctNo\":\"206610026101800006\",\"orderList\":[{\"outOrderNo\":\"O2024011100001\",\"payeeAcctNo\":\"6225882014306068\",\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"431024198904060611\",\"payeeMobileNo\":\"15814488937\",\"payeeName\":\"周亮飞\",\"payeeType\":\"BANK\",\"payerAmount\":200,\"remark\":\"佣金\"},{\"outOrderNo\":\"O2024011100002\",\"payeeAcctNo\":\"622588201222222\",\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"510722197212037066\",\"payeeMobileNo\":\"15800000001\",\"payeeName\":\"张三\",\"payeeType\":\"BANK\",\"payerAmount\":1000,\"remark\":\"佣金\"}]}",
    "sign": "RexV1W6oTou8k8OPHAoku1viXN5rmY/O0ZjgzuPqw+gpSV9b6CxQ1NB3t1yYErGWlcyUMhxfSIqayOyZrJ0LI5xsm9m9oZgc8WpFYUY0Vcab9qeUQHgv8GC8JizT/bqAmXi9MmEVYQlKlNwS4jtJPLTv2p2fVY/Cg7EFrJhXw0c=",
    "requestNo": "f16276e4-678e-49cb-9f0e-d18849e2964a",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240111150040"
}

示例代码

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": "SFT0501",
    "bizModel": "{\"acctNo\":\"206610026101800006\",\"orderList\":[{\"outOrderNo\":\"O2024011100001\",\"payeeAcctNo\":\"6225882014306068\",\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"431024198904060611\",\"payeeMobileNo\":\"15814488937\",\"payeeName\":\"周亮飞\",\"payeeType\":\"BANK\",\"payerAmount\":200,\"remark\":\"佣金\"},{\"outOrderNo\":\"O2024011100002\",\"payeeAcctNo\":\"622588201222222\",\"payeeBankName\":\"招商银行\",\"payeeCertNo\":\"510722197212037066\",\"payeeMobileNo\":\"15800000001\",\"payeeName\":\"张三\",\"payeeType\":\"BANK\",\"payerAmount\":1000,\"remark\":\"佣金\"}]}",
    "sign": "RexV1W6oTou8k8OPHAoku1viXN5rmY/O0ZjgzuPqw+gpSV9b6CxQ1NB3t1yYErGWlcyUMhxfSIqayOyZrJ0LI5xsm9m9oZgc8WpFYUY0Vcab9qeUQHgv8GC8JizT/bqAmXi9MmEVYQlKlNwS4jtJPLTv2p2fVY/Cg7EFrJhXw0c=",
    "requestNo": "f16276e4-678e-49cb-9f0e-d18849e2964a",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240111150040"
}'

返回响应

🟢200OK
application/json
Body
code
integer 
响应码,200:成功
必需
msg
string 
响应消息
必需
acctNo
string 
存管账号
必需
deductionMethod
string 
服务费扣款方式
必需
1:企业承担 1 2:个人承担
projectCode
string 
项目编码
必需
totalCount
string 
总笔数
必需
totalAmount
string 
总金额
必需
元,2位小数
successCount
string 
成功笔数
必需
successAmount
string 
成功金额
必需
元,2位小数
successServiceAmount
string 
成功服务费
必需
元,2位小数
failCount
string 
失败笔数
必需
failAmount
string 
失败金额
必需
元,2位小数
orderList
object 
订单列表
必需
示例
{
    "code": 200,
    "msg": "成功",
    "acctNo": "206610026101800006",
    "deductionMethod": 1,
    "projectCode": "20220623050002",
    "totalCount": 2,
    "totalAmount": 1200,
    "successCount": 1,
    "successAmount": 200,
    "successServiceAmount": 12,
    "failCount": 1,
    "failAmount": 1000,
    "orderList": [
        {
            "payeeName": "周亮飞",
            "payeeCertNo": "431024198904060611",
            "payeeType": "BANK",
            "payeeBankName": "招商银行",
            "payeeAcctNo": "6225882014306068",
            "payeeMobileNo": "15814488937",
            "payerAmount": 200,
            "payeeAmount": 200,
            "serviceAmount": 12,
            "remark": "佣金",
            "failMsg": null
        },
        {
            "payeeName": "张三",
            "payeeCertNo": "510722197212037066",
            "payeeType": "BANK",
            "payeeBankName": "招商银行",
            "payeeAcctNo": "622588201222222",
            "payeeMobileNo": "15800000001",
            "payerAmount": 1000,
            "payeeAmount": 1000,
            "serviceAmount": null,
            "remark": "佣金",
            "failMsg": "银行卡号错误"
        }
    ]
}
🟢201Created
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
修改于 2024-01-16 09:37:38
上一页
提现订单详情(SFT0413)
下一页
佣金结算(SFT0502)
Built with