3.1发票查验接口 - 百旺金穗云-SaaS标准化接口

功能描述：使用发票关键信息对增值税发票进行查验。

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

Date

string

必需

默认值:

host

string

必需

默认值:

x-htjs-nonce

string

必需

默认值:

x-htjs-ua

string

必需

默认值:

Authorization

string

必需

默认值:

Body 参数application/json

invoiceCode

string

发票代码(必传，全电票传空)

必需

invoiceNum

string

发票号码(必传)

必需

termCode

string

专票不含税金额, (普票可空，专票必传，全电票传价税合计)

必需

invoiceDate

string

发票日期(yyyy-mm-dd)(必传)

必需

jym

string

普票校验码（后六位）普票必传，专票可空

必需

nsrsbh

string

纳税人识别号（必传）

必需

fplxdm

string

发票类型代码

可选

区块链发票必填：10108，目前支持深圳、云南

kpfsbh

string

开票方税号

可选

区块链发票必填，目前支持深圳、云南

示例

{
    "invoiceCode": "发票代码(必传，全电票传空)", // 发票代码(必传，全电票传空)
    "invoiceNum": "发票号码(必传)", // 发票号码(必传)
    "termCode": "专票不含税金额, (普票可空，专票必传，全电票传价税合计)", // 专票不含税金额, (普票可空，专票必传，全电票传价税合计)
    "invoiceDate": "发票日期(yyyy-mm-dd)(必传)", // 发票日期(yyyy-mm-dd)(必传)
    "jym": "普票校验码（后六位）普票必传，专票可空", // 普票校验码（后六位）普票必传，专票可空
    "nsrsbh": "纳税人识别号（必传）", // 纳税人识别号（必传）
    "fplxdm": "发票类型代码（区块链发票必填：10108）",
    "kpfsbh": "开票方税号（区块链发票必填）" 

}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

string

返回代码 (1000 - 成功，其它值失败)

必需

msg

string

提示信息

必需

invoice

object

必需

salerAccount

string

销方银行账号

必需

isCancel

string

发票状态 N - 正常发票，Y - 作废发票，3 - 红冲，7 部分红冲，8 全额红冲

必需

machineCode

string

设备编号

必需

salerName

string

销方名称

必需

invoiceComment

string

备注

必需

invSource

string

必需

buyerName

string

购方名称

必需

invoiceDate

string

开票日期

必需

noTaxAmount

string

合计金额

必需

invoiceCode

string

发票代码

必需

invoiceNum

string

发票号码

必需

checkCode

string

校验码

必需

salerContact

string

销方地址电话

必需

province

string

省份

必需

buyerAccount

string

购方银行账号

必需

buyerTaxNum

string

购方税号

必需

salerTaxNum

string

销方税号

必需

invoiceType

string

发票类型

必需

taxAmount

string

税额

必需

totalTaxAmount

string

价税合计

必需

buyerContact

string

购方地址电话

必需

trainNo

string

车次(数电火车票)

可选

idNo

string

身份证号(数电火车票)

可选

idName

string

旅客姓名(数电火车票)

可选

seatNumber

string

座位号码(数电火车票)

可选

trainTime

string

发车时间(数电火车票)

可选

seatClass

string

座位等级(数电火车票)

可选

ticketType

string

客票类型(数电火车票)

可选

issuingNo

string

电子客票号(数电火车票)

可选

trainDate

string

发车日期(数电火车票)

可选

stationFrom

string

出发站(数电火车票)

可选

stationTo

string

到达站(数电火车票)

可选

agentCode

string

销售点代号（数电航空行程单）

可选

internationalFlag

string

国内国际标签（数电航空行程单）

可选

issuedBy

string

填开单位（数电航空行程单）

可选

remark

string

签注（数电航空行程单）

可选

from

string

到达站（数电航空行程单）

可选

string

目地地（数电航空行程单）

可选

eTicketNo

string

电子客票号码（数电航空行程单）

可选

amountTax

string

票价（税前⾦额）（数电航空行程单）

可选

fuelSurcharge

string

燃油附加费（数电航空行程单）

可选

caacDevelopmentFund

string

航发展基金（数电航空行程单）

可选

otherTaxes

string

其他税费（数电航空行程单）

可选

insurance

string

保险费（数电航空行程单）

可选

invoiceStateMsg

string

发票状态描述（数电航空行程单）

可选

dateOfIssue

string

/日期（数电航空行程单）

可选

seat

string

到达站（数电航空行程单）

可选

information

string

提示信息（数电航空行程单）

可选

details

array [object {9}]

必需

示例

{
    "code": "返回代码 (1000 - 成功，其它值失败)", // 返回代码 (1000 - 成功，其它值失败)
    "msg": "提示信息", // 提示信息
    "invoice": {
        "salerAccount": "销方银行账号", // 销方银行账号
        "isCancel": "发票状态 N - 正常发票，Y - 作废发票，3 - 红冲，7 部分红冲，8 全额红冲", // 发票状态 N - 正常发票，Y - 作废发票，3 - 红冲，7 部分红冲，8 全额红冲
        "machineCode": "设备编号", // 设备编号
        "salerName": "销方名称", // 销方名称
        "invoiceComment": "备注", // 备注
        "invSource": "", //
        "buyerName": "购方名称", // 购方名称
        "invoiceDate": "开票日期", // 开票日期
        "noTaxAmount": "合计金额", // 合计金额
        "invoiceCode": "发票代码", // 发票代码
        "invoiceNum": "发票号码", // 发票号码
        "checkCode": "校验码", // 校验码
        "salerContact": "销方地址电话", // 销方地址电话
        "province": "省份", // 省份
        "buyerAccount": "购方银行账号", // 购方银行账号
        "buyerTaxNum": "购方税号", // 购方税号
        "salerTaxNum": "销方税号", // 销方税号
        "invoiceType": "发票类型", // 发票类型
        "taxAmount": "税额", // 税额
        "totalTaxAmount": "价税合计", // 价税合计
        "buyerContact": "购方地址电话", // 购方地址电话
        "trainNo": "车次", ///数电火车票时有值
        "idNo": "身份证号", //数电火车票时有值
        "idName": "旅客姓名", //数电火车票时有值
        "seatNumber": "座位号码", //数电火车票时有值
        "trainTime": "发车时间", //数电火车票时有值
        "seatClass": "座位等级", //数电火车票时有值
        "ticketType": "客票类型", //数电火车票时有值
        "issuingNo": "电子客票号码", //数电火车票时有值
        "trainDate": "发⻋⽇期", //数电火车票时有值
        "stationFrom": "出发站", //数电火车票时有值
        "stationTo": "到达站", //数电火车票时有值
        "agentCode": "销售⽹点代号", //数电航空行程单时有值
        "internationalFlag": "国内国际标签", //数电航空行程单时有值
        "issuedBy": "填开单位", //数电航空行程单时有值
        "remark": "签注", //数电航空行程单时有值
        "from": "到达站", //数电航空行程单时有值
        "to": "目地地", //数电航空行程单时有值
        "amountTax": "票价（税前⾦额）", //数电航空行程单时有值
        "fuelSurcharge": "燃油附加费", //数电航空行程单时有值
        "caacDevelopmentFund": "⺠航发展基⾦", //数电航空行程单时有值
        "otherTaxes": "其他税费", //数电航空行程单时有值
        "insurance": "保险费", //数电航空行程单时有值
        "invoiceStateMsg": "发票状态描述", //数电航空行程单时有值
        "dateOfIssue": "//⽇期", //数电航空行程单时有值
        "seat": "到达站", //数电航空行程单时有值
        "information": "提示信息", //数电航空行程单时有值
        "eticketNo": "电⼦客票号码", //数电航空行程单时有值
        "details": [
            {
                "taxRate": "税率", // 税率
                "noTaxPrice": "不含税单价", // 不含税单价
                "serialNumber": "", //
                "goodsAmount": "明细合计金额", // 明细合计金额
                "numbers": "商品数量", // 商品数量
                "goodsTaxAmount": "明细税额", // 明细税额
                "measureUnits": "单位", // 单位
                "goodsName": "商品名称", // 商品名称
                "specifications": "规格型号" // 规格型号
            }
        ]
    }
}