申请开票接口

开发中

POST

/jiafulai/paymentgateway/api/invoice/app

读者发票抬头管理

请求参数

Body 参数application/json

appId

string

应用ID

必需

应用ID

sign

string

签名

必需

签名

reqTime

string

时间戳

必需

时间戳

tenantId

string

租客Id

必需

租客Id

mchOrderNoArray

array[string]

支付订单的商户订单号数组

必需

支付订单的商户订单号数组：已经支付成功的支付订单的商户订单号数组

invoiceType

string

发票类型

必需

发票类型 1：增值税电子普通发票；2：增值税电子专用发票；

taxNo

string

纳税人识别号

必需

纳税人识别号

invoiceTitle

string

发票抬头

必需

发票抬头

registerAddress

string

公司地址

可选

公司地址

phone

string

公司电话

可选

公司电话

bank

string

开户行

可选

开户行

bankAccount

string

银行账号

可选

银行账号

string

电子邮箱

必需

接收电子发票的邮箱

invoiceAmount

string

开票金额

可选

保留两位小数

readerCardNo

string

读者证号

可选

若有则传递

readerIdNumber

string

读者身份证号或护照号

可选

读者身份证号或护照号，或其他可以唯一识别读者的号码

示例

{
    "appId": "string",
    "sign": "string",
    "reqTime": "string",
    "tenantId": "string",
    "mchOrderNoArray": [
        "string"
    ],
    "invoiceType": "string",
    "taxNo": "string",
    "invoiceTitle": "string",
    "registerAddress": "string",
    "phone": "string",
    "bank": "string",
    "bankAccount": "string",
    "email": "string",
    "invoiceAmount": "string",
    "readerCardNo": "string",
    "readerIdNumber": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/jiafulai/paymentgateway/api/invoice/app' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "string",
    "sign": "string",
    "reqTime": "string",
    "tenantId": "string",
    "mchOrderNoArray": [
        "string"
    ],
    "invoiceType": "string",
    "taxNo": "string",
    "invoiceTitle": "string",
    "registerAddress": "string",
    "phone": "string",
    "bank": "string",
    "bankAccount": "string",
    "email": "string",
    "invoiceAmount": "string",
    "readerCardNo": "string",
    "readerIdNumber": "string"
}'

返回响应

🟢200成功

*/*

Body

code

string

返回状态

可选

COMMON_200-处理成功，其他-处理有误，详见msg

msg

string

返回信息

可选

具体错误原因，例如：签名失败、参数格式校验错误

data

object

返回数据

可选

返回开票结果数据，json格式数据

status

string

开票状态

必需

开票状态，INVOICING—开票中；INVOICED—已开票；CANCELING—作废中；CANCELED—已作废

applyInvoiceNo

string

发票申请编号

必需

发票申请编号

示例

{
    "code": "string",
    "msg": "string",
    "data": {
        "status": "string",
        "applyInvoiceNo": "string"
    }
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

修改于 2025-03-18 08:02:55

查询读者的发票抬头

查询开票状态