蓝字发票开具

接口描述

开具蓝字发票。

请求地址

POSThttps://qst.imfbp.com/apihub/api?Action=Tax.Output.BlueInvoice

示例报文整理中

可先参考请求结构与公共参数。

Header 参数

参数名称	类型	必选	说明
Timestamp	String	必选	公共参数。
SecretId	String	必选	公共参数。
Signature	String	必选	公共参数。
Content-Type	String	必选	取值：application/json

Body 请求参数

参数名称	类型	必选	说明
areaCode	String	必选	地区编码，参见地区编码
taxpayerNumber	String	必选	纳税人识别号
taxOfficerIDCard	String	必选	办税人身份证号
invoiceRequestNo	String	必选	请求流水号 长度32位。 调用端保证唯一。 提示重复开票可调用发票 查询接口获取发票数据。
remarks	String	可选	备注
invoiceTypeCode	String	必选	发票类型编码
purchaserConfirm	String	可选	购方信息确认 局端对购方信息会有校验，信息有误时会提示"当前未查询到购买方纳税人信息，请确认是否继续开具"可传0强制开具
purchaserName	String	必选	购买方名称
purchaserPhone	String	可选	购买方联系电话
purchaserAddress	String	可选	购买方地址
purchaserTaxNumber	String	可选	购买方税号
purchaserBankName	String	可选	购买方开户行
purchaserBankAccount	String	可选	购买方银行账号
sellerName	String	必选	销方名称
sellerTaxpayerNumber	String	必选	销方税号
sellerAddress	String	可选	销方地址
sellerPhone	String	可选	销方联系电话
sellerBankName	String	可选	销方开户行
sellerBankAccount	String	可选	销方银行账号
totalAmount	String	必选	不含税金额合计
totalTax	String	必选	税额合计
taxKind	String	必选	含税标志。1-不含税 2-含税
handlerName	String	可选	经办人姓名
handlerIdCard	String	可选	经办⼈证件号码
handlerType	String	可选	经办⼈证件种类代码
handlerTaxpayerNumber	String	可选	经办⼈纳税⼈识别号
amountInFigures	String	必选	价税合计
items	[]	必选	明细集合
unitPrice	String	可选	单价 含税标志为含税时传含税单价，反之传不含税单价。 整数部分加⼩数部分⻓度最⻓14，⼩数部分最多13
unit	String	可选	单位
itemKind	String	必选	发票行性质，0：正常行 1：折扣行 2：被折扣行
specification	String	可选	规格型号
amount	String	必选	金额 含税标志为含税时传含税⾦额，反之传不含税⾦额
tax	String	必选	税额
taxRate	String	必选	税率
quantity	String	可选	数量 整数部分加⼩数部分⻓度最⻓ 14，⼩数部分最多13
commodityCode	String	必选	税收分类编码
specificTaxCode	String	可选	特定征税方式代码
itemName	String	必选	项目名称
favorableCode	String	可选	税收优惠政策类型代码(参考码表)
additionalInfoList	[]	可选	附加信息列表
additionalInfoName	String	可选	附加信息名称
additionalInfoContent	String	可选	附加信息内容
specificElementTypeCode	String	可选	特定要素类型代码
specificElementInfo			特定要素信息
ext		可选	拓展字段
invoiceRequestNo	String	可选	支付信息集合
transactionNumber	String	可选	交易单号
paymentChannelCode	String	可选	交易渠道代码
residualCredit	String	可选	开具成功是否获取剩余额度
plateAddress	String	可选	开具成功是否获取板式地址
blueBalanceDocumentDetailList	[]	可选	详见差额凭证明细集合
balanceTaxTypeCode	String	可选	差额征税类型代码，差额征税时必填：01-差额征税全额开票 02-差额征税差额开票
reviewer	String	可选	复核人
buyerIdentification	String	可选	购买方自然人标识
buyerCertificateType	String	可选	购买方证件类型，购买方证件类型、购买方证件号码同时为空或同时不为空
buyerCertificateNumber	String	可选	购买方证件号码
buyerNationalityCode	String	可选	购买方国籍类型代码，当购买方证件类型为外国护照等其他外国证件时必填
reducedTypeCode	String	可选	减按征税类型代码
handlerNationalityCode	String	可选	经办人国籍代码
deduction	String	可选	扣除额
giveUpReason	String	可选	放弃享受减按1%征收率原因
buyerBankNumberFlag	String	可选	是否展示购买方银行账号，Y-是 N-否
sellerBankNumberFlag	String	可选	是否展示销售方银行账号，Y-是 N-否
displayBuyerAddressPhone	String	可选	是否展示购买方地址电话，Y-是 N-否
displaySellerAddressPhone	String	可选	是否展示销售方地址电话，Y-是 N-否
receiver	String	可选	收款人

specificElementInfo 特定要素信息

参数名称	类型	必选	说明
constructService		可选	建筑服务 (建筑服务必填)
constructServiceSite	String	可选	建筑服务发生地 (建筑服务必填)
constructServiceAddress	String	可选	发生地详细地址 (建筑服务必填)
constructServiceName	String	可选	建筑项目名称 (建筑服务必填)
constructCrossCitySign	String	可选	跨地市标志 (建筑服务必填) Y/N
crossCityConfirm	String	可选	跨地市确认 (当跨地市标志为N且建筑服务发生地与销售方注册地址未在同一县市时需传Y) Y/N
crossRegionTaxRegistrationNum	String	可选	跨区域涉税事项报验管理编号(跨地市标志为Y时必填)
landVATItemNo	String	可选	土地增值税项目编号

差额凭证明细集合

参数名称	类型	必选	说明
amountDeducted	String	可选	本次扣除金额
remark	String	可选	备注
paperInvoiceCode	String	可选	纸质发票代码
eInvoicenumber	String	可选	数电票号码
salesIncludingTax	String	可选	含税销售额
issueDate	String	可选	开具日期
certificateAmountTotal	String	可选	凭证合计金额
certificateNum	String	可选	凭证号码
certificateType	String	可选	凭证类型 参见差额凭证类型代码
paperInvoiceNum	String	可选	纸质发票号码

返回参数

公共返回结构

参数名称	类型	说明
code	Integer	200 表示请求成功 详见状态码
message	String	错误提示信息
startTime	long	开始时间
endTime	long	结束时间
callId	long	调用记录标识
data		返回数据

data 内容说明

参数名称	类型	说明
invoiceNum	String	数电发票号码
blueInvoiceUsedDetail		蓝字发票数据统计信息
invoiceAmountTotal	String	发票合计金额
invoiceTaxTotal	String	发票合计税额
remainingCredit	String	剩余授信额度
remainingPaperNumber	String	剩余纸质发票张数
blueTicketsIssuedNumber	String	已开具蓝票张数
creditUsed	String	已使用发票授信额度
invoicePaperNumUsed	String	已使用发票张数
creditTotal	String	总授信额度
issuer	String	开票人
issueDate	String	开票日期 格式: yyyy-MM-dd HH:mm
paperInvoiceCode	String	数电纸质发票代码
paperInvoiceNum	String	数电纸质发票号码
qrCodeUrl	String	二维码下载地址 (请求参数isReturnUrl为1时返回)
pdfUrl	String	PDF格式下载地址 (请求参数isReturnUrl为1时返回)
ofdUrl	String	OFD格式下载地址 (请求参数isReturnUrl为1时返回)
xmlUrl	String	XML格式下载地址 (请求参数isReturnUrl为1时返回) 下载后是zip格式压缩包,需要⾃⾏解压