灵工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)
      • 佣金结算(SFT0502)
      • 佣金结算批次查询(SFT0503)
      • 佣金结算批次订单查询(SFT0504)
      • 佣金结算订单查询(SFT0505)
      • 电子回单查询(SFT0506)
      • 佣金结算数据同步(SFT0510)
    • 退款
      • 退款订单查询(SFT0801)
      • 退款订单明细(SFT0802)
    • 开票
      • 开票类目查询(SFT0601)
        POST
      • 开票类型列表(SFT0602)
        POST
      • 可开票批次查询(SFT0603)
        POST
      • 开票申请(SFT0605)
        POST
      • 开票申请列表(SFT0606)
        POST
      • 开票申请详情(SFT0607)
        POST
      • 开票申请关联订单列表(SFT0608)
        POST
      • 开票额度账户列表(SFT0609)
        POST
      • 开票额度账户详情(SFT0610)
        POST
      • 开票申请撤销(SFT0611)
        POST
    • 项目
      • 项目列表(SFT0701)
      • 项目详情(SFT0702)
      • 项目新增(SFT0703)
      • 项目删除(SFT0704)
      • 项目确认单(SFT0705)
    • 完税凭证
      • 完税凭证记录(SFT1001)
    • 通知
      • 充值通知(1001)
      • 提现通知(2001)
      • 佣金结算通知(3001)
      • 佣金结算退票通知(5001)
      • 电子合同签约完成通知(8001)
      • 开票结果通知(9001)
    • 企业信息
      • 企业信息查询(SFT0901)
  • 营销金结算
    • 营销活动
      • 营销活动创建(SFT1101)
    • 结算
      • 营销金结算付款(SFT0502)
      • 营销金结算批次查询(SFT0503)
      • 营销金结算批次订单查询(SFT0504)
      • 营销金结算订单同步(SFT0510)
  1. 开票

可开票批次查询(SFT0603)

POST
/open/api/gateway.do
开票订单查询
查询商户佣金代发交易成功后可申请的开票的付款批次
注:在商户设置“按付款批次订单开票“时使用该接口查询可开票批次,申请接口需要传递开票关联批次号

请求参数

Body 参数application/json
apiCode
string 
接口编码:SFT0603
必需
merchantNo
string 
商户号
必需
requestNo
string 
请求流水
必需
timestamp
string 
时间戳
必需
version
string 
版本号,固定2.0
必需
sign
string 
签名
必需
bizModel
object (InvoiceBatchListModel) 
必需
batchNo
string 
平台批次号
可选
outBatchNo
string 
商户批次号
可选
taxBaseCode
string 
服务商编码
可选
projectCode
string 
项目编码
可选
invoiceType
string 
开票类型
可选
1:增值税专票(3%) 2:增值税专票(6%) 3:增值税普票(3%) 4:增值税普票(6%) 5:增值税普通(1%) 6:增值税专票(9%) 7:增值税普票(9%) 8:增值税专票(13%) 9:增值税普票(13%)
payApplyBeginTime
string <date-time>
交易时间从
可选
yyyy-MM-dd HH:mm:ss
payApplyEndTime
string <date-time>
交易时间至
可选
yyyy-MM-dd HH:mm:ss
page
number 
当前页,默认1
可选
size
number 
页带大小,默认10
可选
示例
{
    "apiCode": "SFT0603",
    "bizModel": "{\"page\":1,\"size\":10,\"taxBaseCode\":\"2000064001\"}",
    "sign": "kathnh8NfMm/hFUPXT6tv+9JmqT2bc9/59dI/C2/MtO2/XAfyEWJQIjfQ3fZshBGzp+yTwA1EnyLEY+zeFtz2kdX9LkJhUlyQ/pHzF541VZoVsPs4obYxsuYKraTMT4q8gOFRB6EHTYtoay/hx+97CUu3RKhnA5NWyv/VuArwvQ=",
    "requestNo": "deb82333-7b30-4009-bd18-503ef371c7f8",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240220194727"
}

示例代码

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": "SFT0603",
    "bizModel": "{\"page\":1,\"size\":10,\"taxBaseCode\":\"2000064001\"}",
    "sign": "kathnh8NfMm/hFUPXT6tv+9JmqT2bc9/59dI/C2/MtO2/XAfyEWJQIjfQ3fZshBGzp+yTwA1EnyLEY+zeFtz2kdX9LkJhUlyQ/pHzF541VZoVsPs4obYxsuYKraTMT4q8gOFRB6EHTYtoay/hx+97CUu3RKhnA5NWyv/VuArwvQ=",
    "requestNo": "deb82333-7b30-4009-bd18-503ef371c7f8",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240220194727"
}'

返回响应

🟢200OK
application/json
Body
code
integer 
响应码,200:成功
必需
msg
string 
响应消息
必需
page
string 
当前页
必需
size
string 
页大小
必需
totalCount
string 
总条数
必需
totalPage
string 
总页数
必需
batchList
array[object (InvoiceBatchModel) {16}] 
必需
batchNo
string 
平台批次号
必需
outBatchNo
string 
商户批次号
必需
taxBaseCode
string 
服务商编码
必需
taxBaseName
string 
服务商名称
必需
projectCode
string 
项目编码
必需
projectName
string 
项目名称
必需
totalCount
integer 
付款总笔数
必需
totalAmount
number 
付款总金额
必需
元,保留两位小数
successCount
integer 
成功总笔数
必需
successAmount
number 
成功总金额
必需
元,保留两位小数
successServiceAmount
number 
成功收取服务费
必需
元,保留两位小数
invoiceType
string 
开票类型
必需
1:增值税专票(3%) 2:增值税专票(6%) 3:增值税普票(3%) 4:增值税普票(6%) 5:增值税普通(1%) 6:增值税专票(9%) 7:增值税普票(9%) 8:增值税专票(13%) 9:增值税普票(13%)
invoiceAmount
number 
可开票金额
必需
元,保留两位小数
payApplyTime
string 
交易时间
必需
status
string 
交易状态
必需
1 成功
remark
string 
交易备注
可选
示例
{
    "code": 200,
    "msg": "成功",
    "page": "1",
    "size": "10",
    "totalCount": "6",
    "totalPage": "1",
    "batchList": [
        {
            "batchNo": "2024020400000009",
            "outBatchNo": "PO20240204000000122",
            "taxBaseCode": "2000064001",
            "taxBaseName": "九江万柳科技有限公司",
            "projectCode": "20240201430002",
            "projectName": "测试价格",
            "totalAmount": 1,
            "totalCount": 1,
            "successAmount": 1,
            "successCount": 1,
            "successServiceAmount": 1,
            "invoiceType": "3",
            "invoiceAmount": 2,
            "payApplyTime": "2024-02-04 15:38:53",
            "status": 1,
            "remark": null
        },
        {
            "batchNo": "2024051400000022",
            "outBatchNo": "P20240204000001811",
            "taxBaseCode": "2000064001",
            "taxBaseName": "九江万柳科技有限公司",
            "projectCode": "20240201430002",
            "projectName": "测试价格",
            "totalAmount": 3,
            "totalCount": 1,
            "successAmount": 3,
            "successCount": 1,
            "successServiceAmount": 1,
            "invoiceType": "3",
            "invoiceAmount": 4,
            "payApplyTime": "2024-02-04 15:12:00",
            "status": 1,
            "remark": null
        },
        {
            "batchNo": "2024051400000020",
            "outBatchNo": "P202402040000018",
            "taxBaseCode": "2000064001",
            "taxBaseName": "九江万柳科技有限公司",
            "projectCode": "20240201430002",
            "projectName": "测试价格",
            "totalAmount": 3,
            "totalCount": 1,
            "successAmount": 3,
            "successCount": 1,
            "successServiceAmount": 1,
            "invoiceType": "3",
            "invoiceAmount": 4,
            "payApplyTime": "2024-02-04 15:09:38",
            "status": 1,
            "remark": null
        },
        {
            "batchNo": "2024051400000019",
            "outBatchNo": "P202402040000017",
            "taxBaseCode": "2000064001",
            "taxBaseName": "九江万柳科技有限公司",
            "projectCode": "20240201430002",
            "projectName": "测试价格",
            "totalAmount": 3,
            "totalCount": 1,
            "successAmount": 3,
            "successCount": 1,
            "successServiceAmount": 1,
            "invoiceType": "3",
            "invoiceAmount": 4,
            "payApplyTime": "2024-02-04 15:08:49",
            "status": 1,
            "remark": null
        },
        {
            "batchNo": "2024051400000018",
            "outBatchNo": "P202402040000016",
            "taxBaseCode": "2000064001",
            "taxBaseName": "九江万柳科技有限公司",
            "projectCode": "20240201430002",
            "projectName": "测试价格",
            "totalAmount": 3,
            "totalCount": 1,
            "successAmount": 3,
            "successCount": 1,
            "successServiceAmount": 1,
            "invoiceType": "3",
            "invoiceAmount": 4,
            "payApplyTime": "2024-02-04 15:05:37",
            "status": 1,
            "remark": null
        },
        {
            "batchNo": "2024051400000014",
            "outBatchNo": "P202402040000012",
            "taxBaseCode": "2000064001",
            "taxBaseName": "九江万柳科技有限公司",
            "projectCode": "20240201430002",
            "projectName": "测试价格",
            "totalAmount": 3,
            "totalCount": 1,
            "successAmount": 3,
            "successCount": 1,
            "successServiceAmount": 1,
            "invoiceType": "3",
            "invoiceAmount": 4,
            "payApplyTime": "2024-02-04 14:56:43",
            "status": 1,
            "remark": null
        }
    ]
}
🟢201Created
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
上一页
开票类型列表(SFT0602)
下一页
开票申请(SFT0605)
Built with