开票额度账户详情(SFT0610)

POST

/open/api/gateway.do

开票管理

查询开票额度账户详情

特别注意：1.如果商户只有一个服务商，并且服务商下只有一个开票类型时，两个参数可不传
2.如果商户有多个服务商一个服务商下只有一种开票类型时，需传taxBaseCode

请求参数

Body 参数application/json

apiCode

string

接口编码：SFT0610

必需

merchantNo

string

商户号

必需

requestNo

string

请求流水

必需

timestamp

string

时间戳

必需

version

string

版本号，固定2.0

必需

sign

string

签名

必需

bizModel

object (InvoiceAccountDetailModel)

必需

invoiceAcctNo

string

开票额度账号编号

可选

taxBaseCode

string

服务商编码

可选

invoiceAcctNo不为空时无作用

示例

{
    "apiCode": "SFT0610",
    "bizModel": "{\"invoiceAcctNo\":\"2024012909000002\"}",
    "sign": "nMrdV7Fsq7qHRHMHjnqSYS4cW466kDhQuq5+CJrsq6xTDULalq+wjaz1JUJTxhEi7v+kjuaAtGAcH8fWF0xJk6iTRTTNZAjh7g3Hun1+meU9F8XuofPFfjcXd9//EAGvlNlJnZi7owlNRU6dwhAOjHu+L/5iJlMe97LN3XUaYjE=",
    "requestNo": "e09f5eea-e148-4d6b-b702-3faa0e2eb229",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240221115202"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open/api/gateway.do' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiCode": "SFT0610",
    "bizModel": "{\"invoiceAcctNo\":\"2024012909000002\"}",
    "sign": "nMrdV7Fsq7qHRHMHjnqSYS4cW466kDhQuq5+CJrsq6xTDULalq+wjaz1JUJTxhEi7v+kjuaAtGAcH8fWF0xJk6iTRTTNZAjh7g3Hun1+meU9F8XuofPFfjcXd9//EAGvlNlJnZi7owlNRU6dwhAOjHu+L/5iJlMe97LN3XUaYjE=",
    "requestNo": "e09f5eea-e148-4d6b-b702-3faa0e2eb229",
    "version": "2.0",
    "merchantNo": "1088202103120003",
    "timestamp": "20240221115202"
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应码，200:成功

必需

msg

string

响应消息

必需

invoiceAcctNo

string

账户编号

必需

invoiceAcctName

string

账户名

必需

taxBaseCode

string

服务商编码

必需

taxBaseName

string

服务商名称

必需

invoiceType

string

开票类型

必需

1:增值税专票(3%) 2:增值税专票(6%) 3:增值税普票(3%) 4:增值税普票(6%) 5:增值税普通(1%) 6:增值税专票(9%) 7:增值税普票(9%) 8:增值税专票(13%) 9:增值税普票(13%)

openTime

string <date-time>

开通时间

必需

yyyy-MM-dd HH:mm:ss

canOpenAmount

number

可开票金额

必需

单位元，2位小数

openAmount

number

已开票金额

必需

单位元，2位小数

waitOpenAmount

number

待开票金额

必需

单位元，2位小数

status

string

状态

必需

0:无效 1:有效

示例

成功示例异常示例

{
    "code": 200,
    "msg": "成功",
    "invoiceAcctNo": "2024012909000002",
    "invoiceAcctName": "广州岭薪商务服务有限公司",
    "taxBaseCode": "2000064001",
    "taxBaseName": "九江万柳科技有限公司",
    "invoiceType": "2",
    "openTime": "2024-01-29 12:22:03",
    "canOpenAmount": 4046.06,
    "openAmount": 0,
    "waitOpenAmount": 0,
    "status": 1
}

开票额度账户列表(SFT0609)

开票申请撤销(SFT0611)