灵工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. 开票

开票申请列表(SFT0606)

POST
/open/api/gateway.do
开票管理
查询商户开票申请列表
申请详情查询不存在返回code:519

请求参数

Body 参数application/json
apiCode
string 
接口编码:SFT0606
必需
merchantNo
string 
商户号
必需
requestNo
string 
请求流水
必需
timestamp
string 
时间戳
必需
version
string 
版本号,固定2.0
必需
sign
string 
签名
必需
bizModel
object (InvoiceApplyListModel) 
必需
applyNo
string 
平台申请单号
可选
outApplyNo
string 
商户申请单号
可选
taxBaseCode
string 
服务商编码
可选
invoiceType
string 
开票类型
可选
1:增值税专票(3%) 2:增值税专票(6%) 3:增值税普票(3%) 4:增值税普票(6%) 5:增值税普通(1%) 6:增值税专票(9%) 7:增值税普票(9%) 8:增值税专票(13%) 9:增值税普票(13%)
invoiceStyle
string 
开票形式
可选
电子:E_INVOICE 纸质:PAPER_INVOICE
applyBeginTime
string <date-time>
申请时间从
可选
yyyy-MM-dd HH:mm:ss
applyEndTime
string <date-time>
申请时间至
可选
yyyy-MM-dd HH:mm:ss
status
integer 
开票状态
可选
待审核 5 待开票 1 已开票2 申请驳回 9 已撤销 8
page
integer 
当前页,默认1
可选
size
integer 
页大小,默认10
可选
示例
{
    "apiCode": "SFT0606",
    "bizModel": "{\"page\":1,\"size\":10,\"taxBaseCode\":\"2000064001\"}",
    "sign": "cWKfp2ekw6tN6coi0qcc3WBMqnx3W6DSsJTfaIoUzALeoUL8CiVzv5nC9Bo72Q0QfMukCX3A+GnhvCf8WM0MWuEvKJxmU5+bNll5Js5GhdaGrsfvUL1tHAlbEYkukmmrOI524ucIS2ImZqcN5MXoL9LfGOjT+QjHjya5bRyyL/s=",
    "requestNo": "8862c49b-56c8-43b6-a078-0254f5c45225",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240221113209"
}

示例代码

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": "SFT0606",
    "bizModel": "{\"page\":1,\"size\":10,\"taxBaseCode\":\"2000064001\"}",
    "sign": "cWKfp2ekw6tN6coi0qcc3WBMqnx3W6DSsJTfaIoUzALeoUL8CiVzv5nC9Bo72Q0QfMukCX3A+GnhvCf8WM0MWuEvKJxmU5+bNll5Js5GhdaGrsfvUL1tHAlbEYkukmmrOI524ucIS2ImZqcN5MXoL9LfGOjT+QjHjya5bRyyL/s=",
    "requestNo": "8862c49b-56c8-43b6-a078-0254f5c45225",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240221113209"
}'

返回响应

🟢200OK
application/json
Body
code
integer 
响应码,200:成功
必需
msg
string 
响应消息
必需
page
string 
当前页
必需
size
string 
页大小
必需
totalCount
string 
总条数
必需
totalPage
string 
总页数
必需
dataList
object (InvoiceApplyInfoModel) 
必需
applyNo
string 
平台申请单号
必需
outApplyNo
string 
商户申请单号
必需
applyTime
string <date-time>
申请时间
必需
yyyy-MM-dd HH:mm:ss
openInvoiceType
string 
申请类型
必需
1 按批次 6: 按账户开票
taxBaseCode
string 
服务商编码
必需
taxBaseName
string 
服务商名称
必需
applyAmount
number 
申请金额
必需
单位元,保留两位小数
offsetAmount
number 
冲抵金额
必需
单位元,保留两位小数
openAmount
number 
实际开票金额
必需
单位元,保留两位小数
serviceAmount
number 
收取服务费
必需
单位元,保留两位小数
invoiceCategoryCode
string 
开票类目编码
必需
invoiceCategoryName
string 
开票类目名称
必需
invoiceType
string 
开票类型
必需
1:增值税专票(3%) 2:增值税专票(6%) 3:增值税普票(3%) 4:增值税普票(6%) 5:增值税普通(1%) 6:增值税专票(9%) 7:增值税普票(9%) 8:增值税专票(13%) 9:增值税普票(13%)
invoiceStyle
string 
开票形式
必需
电子:E_INVOICE 纸质:PAPER_INVOICE
unit
string 
单位
可选
number
number <float>
数量
可选
invoiceTime
string <date-time>
开票时间
可选
yyyy-MM-dd
drawerName
string 
开票人
可选
expressNo
string 
快递单号
可选
纸质票时
expressName
string 
快递公司
可选
纸质票时
receiveName
string 
收件人
可选
纸质票时
receiveMobileNo
string 
收件人联系号码
可选
纸质票时
receiveAddress
string 
收件地址
可选
纸质票时
remark
string 
开票备注
可选
status
integer 
开票状态
必需
待审核 5 待开票 1 已开票2 申请驳回 9 已撤销 8
示例
{
    "code": 200,
    "msg": "成功",
    "page": "1",
    "size": "10",
    "totalCount": "2",
    "totalPage": "1",
    "dataList": [
        {
            "applyNo": "2024020400330006",
            "outApplyNo": null,
            "applyTime": "2024-02-04",
            "openInvoiceType": 1,
            "invoiceAcctNo": null,
            "taxBaseCode": "2000064001",
            "taxBaseName": "九江万柳科技有限公司",
            "applyAmount": 2,
            "offsetAmount": 0,
            "openAmount": 2,
            "serviceAmount": 0,
            "invoiceCategoryCode": "35",
            "invoiceCategoryName": "鉴证咨询服务*咨询服务费",
            "invoiceType": "3",
            "invoiceStyle": "E_INVOICE",
            "unit": null,
            "number": 0,
            "invoiceTime": null,
            "drawerName": null,
            "expressNo": null,
            "expressName": null,
            "receiveName": null,
            "receiveMobileNo": null,
            "receiveAddress": null,
            "remark": "测试",
            "status": 8
        },
        {
            "applyNo": "2024020100120039",
            "outApplyNo": null,
            "applyTime": "2024-02-01",
            "openInvoiceType": 6,
            "invoiceAcctNo": "2024012909000002",
            "taxBaseCode": "2000064001",
            "taxBaseName": "九江万柳科技有限公司",
            "applyAmount": 111,
            "offsetAmount": 0,
            "openAmount": 111,
            "serviceAmount": 0,
            "invoiceCategoryCode": "35",
            "invoiceCategoryName": "鉴证咨询服务*咨询服务费",
            "invoiceType": "2",
            "invoiceStyle": "E_INVOICE",
            "unit": "",
            "number": 0,
            "invoiceTime": "2024-02-21",
            "drawerName": "李健",
            "expressNo": null,
            "expressName": null,
            "receiveName": null,
            "receiveMobileNo": null,
            "receiveAddress": null,
            "remark": "的事",
            "status": 2
        }
    ]
}
🟢201Created
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
上一页
开票申请(SFT0605)
下一页
开票申请详情(SFT0607)
Built with