Skip to main content

蓝字发票开具

接口描述

开具蓝字发票。

请求地址

URL 参数

参数名称类型必选说明
ActionString操作的接口名称,本接口取值:ETax.Output.BlueInvoice

Header 参数

参数名称类型必选说明
TimestampString公共参数
SecretIdString公共参数
SignatureString公共参数
Content-TypeString取值:application/json

Body 请求参数

参数名称类型必选说明
areaCodeString地区编码,参见地区编码
taxpayerNumberString纳税人识别号
taxOfficerIDCardString办税人身份证号
invoiceRequestNoString请求流水号
长度32位。
调用端保证唯一。
提示重复开票可调用发票 查询接口获取发票数据。
remarksString备注
invoiceTypeCodeString发票类型编码
purchaserConfirmString购方信息确认
局端对购方信息会有校验,信息有误时会提示"当前未查询到购买方纳税人信息,请确认是否继续开具"可传0强制开具
purchaserNameString购买方名称
purchaserPhoneString购买方联系电话
purchaserAddressString购买方地址
purchaserTaxNumberString购买方税号
purchaserBankNameString购买方开户行
purchaserBankAccountString购买方银行账号
sellerNameString销方名称
sellerTaxpayerNumberString销方税号
sellerAddressString销方地址
sellerPhoneString销方联系电话
sellerBankNameString销方开户行
sellerBankAccountString销方银行账号
totalAmountString不含税金额合计
totalTaxString税额合计
taxKindString含税标志。1-不含税 2-含税
handlerNameString经办人姓名
handlerIdCardString经办⼈证件号码
handlerTypeString经办⼈证件种类代码
handlerTaxpayerNumberString经办⼈纳税⼈识别号
amountInFiguresString价税合计
items[]明细集合
+ unitPriceString单价
含税标志为含税时传含税单价,反之传不含税单价。
整数部分加⼩数部分⻓度最⻓14,⼩数部分最多13
+ unitString单位
+ itemKindString发票行性质,0:正常行 1:折扣行 2:被折扣行
+ specificationString规格型号
+ amountString金额
含税标志为含税时传含税⾦额,反之传不含税⾦额
+ taxString税额
+ taxRateString税率
+ quantityString数量
整数部分加⼩数部分⻓度最⻓ 14,⼩数部分最多13
+ commodityCodeString税收分类编码
+ specificTaxCodeString特定征税方式代码
+ itemNameString项目名称
+ favorableCodeString税收优惠政策类型代码(参考码表)
additionalInfoList[]附加信息列表
+ additionalInfoNameString附加信息名称
+ additionalInfoContentString附加信息内容
specificElementTypeCodeString特定要素类型代码
specificElementInfo{}特定要素信息
ext{}拓展字段
+ residualCreditString开具成功是否获取剩余额度
+ plateAddressString开具成功是否获取板式地址
blueBalanceDocumentDetailList[]详见差额凭证明细集合
reviewerString复核人
buyerIdentificationString购买方自然人标识
reducedTypeCodeString减按征税类型代码
handlerNationalityCodeString经办人国籍代码
deductionString扣除额
giveUpReasonString放弃享受减按1%征收率原因
buyerBankNumberFlagString是否展示购买方银行账号
sellerBankNumberFlagString是否展示销售方银行账号
receiverString收款人

specificElementInfo 特定要素信息

参数名称类型必选说明
constructService{}建筑服务 (建筑服务必填)
+ constructServiceSiteString建筑服务发生地 (建筑服务必填)
+ constructServiceAddressString发生地详细地址 (建筑服务必填)
+ constructServiceNameString建筑项目名称 (建筑服务必填)
+ constructCrossCitySignString跨地市标志 (建筑服务必填)
+ landVATItemNoString土地增值税项目编号

差额凭证明细集合

参数名称类型必选说明
amountDeductedString本次扣除金额
remarkString备注
paperInvoiceCodeString纸质发票代码
eInvoicenumberString数电票号码
salesIncludingTaxString含税销售额
issueDateString开具日期
certificateAmountTotalString凭证合计金额
certificateNumString凭证号码
certificateTypeString凭证类型 参见差额凭证类型代码
paperInvoiceNumString纸质发票号码

返回参数

公共返回参数

参数名称类型说明
codeInteger200 表示请求成功 详见状态码
messageString错误提示信息
startTimelong开始时间
endTimelong结束时间
callIdlong调用记录标识
data{}返回数据

data 内容说明

参数名称类型说明
invoiceNumString数电发票号码
blueInvoiceUsedDetail{}蓝字发票数据统计信息
+invoiceAmountTotalString发票合计金额
+invoiceTaxTotalString发票合计税额
+remainingCreditString剩余授信额度
+remainingPaperNumberString剩余纸质发票张数
+blueTicketsIssuedNumberString已开具蓝票张数
+creditUsedString已使用发票授信额度
+invoicePaperNumUsedString已使用发票张数
+creditTotalString总授信额度
issueDateString开票日期
格式: yyyy-MM-dd HH:mm:ss
paperInvoiceCodeString数电纸质发票代码
paperInvoiceNumString数电纸质发票号码
qrCodeUrlString二维码下载地址 (请求参数isReturnUrl为1时返回)
pdfUrlStringPDF格式下载地址 (请求参数isReturnUrl为1时返回)
ofdUrlStringOFD格式下载地址 (请求参数isReturnUrl为1时返回)
xmlUrlStringXML格式下载地址 (请求参数isReturnUrl为1时返回)
下载后是zip格式压缩包,需要⾃⾏解压