开票申请(SFT0605) - 灵工SAAS平台OpenAPI2.0文档

开票申请模式支持三种 1:按批次 3:按批次条件范围 6: 按账户开票
1）1:按批次时，需要使用可开票批次查询(SFT0603) 接口查询可开票批次订单
2）2:按批次范围时，注意设置范围条件参数
3) 6:按额度账户开票，使用开票额度账户列表(SFT0609) 和开票额度账户详情(SFT0610) 查询可开票额度

注：1.开票申提交后，在平台未申请情况下，可以使用开票申请撤销(SFT0611) 接口撤回申请
2.不同的模式，都是基于商户在平台设置的情况下，具体情况跟技术线上沟通了解

请求参数

Body 参数application/json

apiCode

string

接口编码：SFT0605

必需

merchantNo

string

商户号

必需

requestNo

string

请求流水

必需

timestamp

string

时间戳

必需

version

string

版本号，固定2.0

必需

sign

string

签名

必需

bizModel

object (InvoiceApplyModel)

必需

outApplyNo

string

商户申请单号

必需

不能重复

openInvoiceType

integer

开票申请类型

必需

1 按批次 3 按批次(条件范围) 6: 按账户开票

taxBaseCode

string

服务商编码

必需

invoiceAcctNo

string

开票额度账户

必需

开票申请类型为6时

applyAmount

number

申请金额

必需

开票申请类型6时，单位元，保留两位小数

invoiceType

string

开票类型

必需

可固定写死 2.通过SFT0602接口查询

invoiceStyle

string

开票形式

必需

电子票:E_INVOICE 纸质票:PAPER_INVOICE

categoryCode

string

开票类目编码

必需

二级类目编码

categoryName

string

开票类目名称

必需

一二类目名称拼接，如: A*B

unit

string

单位

可选

number

number <float>

数量

可选

receiveName

string

收件人

可选

纸质票时

receiveMobileNo

string

收件人联系号码

可选

纸质票时

receiveAddress

string

收件地址

可选

纸质票时

remark

string

开票备注

可选

orderNos

array[string]

批次单号列表

必需

开票申请类型为1时

condition

object (InvoiceApplyConditionModel)

可选

开票申请类型为3时可传参数

示例

{
    "apiCode": "SFT0605",
    "bizModel": "{\"applyAmount\":222,\"categoryCode\":\"44\",\"invoiceAcctNo\":\"2024012909000002\",\"invoiceStyle\":\"E_INVOICE\",\"invoiceType\":\"2\",\"number\":0,\"openInvoiceType\":6,\"outApplyNo\":\"202402210000012345\",\"taxBaseCode\":\"2000064001\"}",
    "sign": "lTT9LVp+RZjpwNSog+5zM4yTe6jIbLsxutnP8sHfK58BmjWInFh+P0JFxMCdClJjsOJIUwjdyxZe3zxZmN7eTMTj1xduSCl8id+t9L0pLn27Ud48Ktb8fKOBCt4n1XKBxpLkQFg6LA3tza1lCxYIY85zPzOnu6TVP2OqHQkg7zw=",
    "requestNo": "2379351f-939e-43de-a690-ba3d188b90f2",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240221141518"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Body

code

integer

响应码，200:成功

必需

msg

string

响应消息

必需

applyNo

string

平台申请单号

必需

outApplyNo

string

商户申请单号

必需

applyAmount

number

申请金额

必需

单位元，2位小数

offsetAmount

number

冲抵金额

必需

单位元，2位小数

serviceAmount

number

需收取服务费

必需

单位元，2位小数

openAmount

number

实际开票金额

必需

单位元，2位小数

示例

成功示例异常示例

{
    "code": 200,
    "msg": "成功",
    "applyNo": "2024022100760001",
    "outApplyNo": "202402210000012345",
    "applyAmount": 222,
    "openAmount": 222,
    "offsetAmount": 0,
    "serviceAmount": 0
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found