夜豺软件

Appearance

开具发票 ​

请求地址: /api/v3/invoice

请求方式: POST

说明: 全面数字化电子发票的开具（专用发票、普通发票）。

请求参数 ​

参数名称类型必填说明
orderNostring是订单编号，同一个单号仅能开具一次发票，已开的单号再次提交将会返回上次开具成功的发票。
invoiceTypeCodestring是发票类型代码，02：全电普通发票，01：全电专用发票
fileFormatstring否需要返回版式文件格式（PDF,OFD,XML），多个以逗号分隔（影响速度）
taxNostring是销售方税号（统一社会信用代码）
sellerNamestring是销售方名称
sellerAddressstring是销售方地址
sellerTelephonestring是销售方电话
sellerBankNamestring是销售方开户行
sellerBankNumberstring是销售方银行账号
displaySellerstring否是否在备注里展示销售方银行账户，0：不展示（默认），1：展示
displaySellerAddstring否是否在备注里展示销售方地址电话，0：不展示（默认），1：展示
digitAccountstring否设置了多个账号时，传此参数可以指定开票账号
naturalMarkstring否购方类型，0：企业（默认）；1：个人
buyerNamestring是购方名称
buyerTaxNostring否购方税号，专票必填
buyerAddressstring否购买方地址
buyerTelephonestring否购买方电话
buyerBankNamestring否购买方开户行
buyerBankNumberstring否购买方银行账号
displayBuyerstring否是否在备注里展示购买方银行账号，0：不展示（默认），1：展示
displayBuyerAddstring否是否在备注里展示购买方地址电话，0：不展示（默认），1：展示
invoiceTotalPricestring否合计金额，不传时会自动通过明细计算；开具不含税发票时，建议传入合计金额
invoiceTotalTaxstring否合计税额，不传时会自动通过明细计算
invoiceTotalPriceTaxstring否价税合计，不传时会自动计算；开具含税发票时，建议传入价税合计
remarksstring否发票备注
payeestring否收款人
checkerstring否复核人
priceTaxMarkstring否含税标识：1 表示不含税价，2 表示含税价（默认）。注：仅用于价税分离；若请求报文已包含项目金额、税额，则本参数无意义。
discountReasonstring否小规模放弃享受优惠政策的原因。“04”：因前期开具 3%征收率发票发生折让/中止/退回需开具红字，或开票有误需重开 3%征收率发票
buyerConfirmstring否购方信息确认：0 忽略购方信息错误直接开具；空或不传则提示购方信息错误（默认）
amountConfirmstring否大金额信息确认：0 忽略提示直接开具；空或不传则提示开具金额较大（默认）
placeConfirmstring否建筑服务发生地与销售方注册地址不在同一县市提示：0 弹出提示（默认）；1 忽略提示开票
taxationMethodstring否差额开票代码：01 全额；02 差额（非差额留空）
invoiceSpecialMarkstring否特定要素类型代码：15二手车、03建筑服务、06不动产经营租赁、05不动产销售、13拖拉机和联合收割机、09旅客运输、14机动车、04货物运输、07代收车船税、01成品油、12自产农产品销售、16农产品收购
pushPhonestring否发票短信推送手机号（需开通短信推送服务）
pushEmailstring否发票推送邮箱
invoiceDetailListlist是项目明细列表，见下方“发票明细项字段”
paymentlist否支付信息列表，见下方“支付信息项字段”
extralist否附加要素列表，见下方“附加要素项字段”
leaseInfolist否不动产经营租赁信息列表（特定业务类型为06时必填）；元素数量应与项目明细一致，见下方“租赁信息项字段”
carriageInfoListlist否旅客运输服务发票信息列表（特定业务类型为09时必填），见下方“旅客运输项字段”

发票明细项字段（invoiceDetailList.item） ​

参数名称类型必填说明
invoiceLineNaturestring否发票行性质：0 正常行（默认），1 折扣行，2 被折扣行
goodsCodestring是商品和服务税收分类编码
categorystring是商品和服务税收分类简称
goodsNamestring是项目名称
goodsSpecificationstring否规格型号；不动产经营租赁发票无效
goodsUnitstring否单位；不动产经营租赁不能为空（填写面积单位）
goodsQuantitystring否数量；不动产经营租赁发票不能为空
goodsPricestring否单价
goodsTaxRatestring是税率
goodsTotalPricestring是金额
goodsTotalTaxstring否税额，不传时自动计算
freeTaxMarkstring否空：非零税率；1 免税；2 不征税；3 普通零税率
vatSpecialManagementstring否特定征税方式代码：01不征税、02零税率、03差额征税、04免税、05简易征税、06减按征税
preferentialMarkstring否税收优惠政策类型：01简易征收、02稀土产品、03免税、04不征税、05先征后退、06100%先征后退、0750%先征后退、08按 3%简易征收、09按 5%简易征收、10按 5%简易征收减按 1.5%计征、11即征即退 30%、12即征即退 50%、13即征即退 70%、14即征即退 100%、15超税负 3%即征即退、16超税负 8%即征即退、17超税负 12%即征即退、18超税负 6%即征即退

支付信息项字段（payment.item） ​

参数名称类型必填说明
payChannelstring否支付渠道：001现金，002银行转账，003票据，004借记卡，005信用卡，006购物卡/券，007优惠券，008商场积分，009支付宝，010微信支付，011云闪付，012Apple Pay，013Samsung Pay，099其他
payOrderNostring否交易单号

附加要素项字段（extra.item） ​

参数名称类型必填说明
extraNamestring是附加要素名称
extraContentstring是附加要素内容

租赁信息项字段（leaseInfo.item） ​

参数名称类型必填说明
leaseAddressstring是不动产地址
leaseDetailAddressstring否不动产详细地址
leaseCrossSignstring是跨地市标志（Y/N）
leaseHoldDateStartstring是租赁期起（yyyy-MM-dd；停车服务加时分为 yyyy-MM-dd HH:mm）
leaseHoldDateEndstring是租赁期止（yyyy-MM-dd；停车服务加时分为 yyyy-MM-dd HH:mm）
leasePropertyNostring是房屋产权证书/不动产权证号码，没有填“无”
leaseAreaUnitstring是面积单位：平方米、亩、m²、平方千米、公顷、hm²、km²

旅客运输项字段（carriageInfoList.item） ​

参数名称类型必填说明
carriageLeavestring是出发地，按行政区划名称填写，包括县（市、区）名称，可在县（市、区）后自主增添具体地址
carriageArrivestring是到达地，按行政区划名称填写，包括县（市、区）名称，可在县（市、区）后自主增添具体地址
carriageDatestring是出行日期（yyyy-MM-dd）
carriageNamestring是出行人姓名
carriageIdstring是参考附录 2
carriageIdNostring是出行人证件号码
carriageVehicleTypestring是交通工具类型：1飞机、2火车、3长途汽车、4公共交通、5出租车、6汽车、7船舶、9其他
carriageVehicleGradestring否交通工具等级。若交通工具为火车、飞机、船舶，则该要素为必填。等级示例：1）飞机：经济舱/头等舱/公务舱；2）船舶：一等舱/二等舱/三等舱；3）火车：一等座/二等座/软席(软座、软卧)/硬席(硬座、硬卧)

请求josn示例 ​

json
{"orderNo":"64d58b72-9743-8088-8cd8-******f95339","invoiceTypeCode":"02","fileFormat":"PDF","taxNo":"91520198MA******9P","sellerName":"贵州XXXX限公司","sellerAddress":"贵阳市","sellerTelephone":"0851-858985858","sellerBankName":"贵州银行","sellerBankNumber":"454343*****5464564","displaySeller":"","naturalMark":"","buyerName":"个人","buyerTaxNo":"","buyerAddress":"","buyerTelephone":"","buyerBankName":"","buyerBankNumber":"","displayBuyer":"","invoiceTotalPrice":"","invoiceTotalTax":"","invoiceTotalPriceTax":"","remarks":"","payee":"","checker":"","priceTaxMark":"","discountReason":"","buyerConfirm":"","amountConfirm":"","placeConfirm":"","taxationMethod":"","invoiceSpecialMark":"","invoiceDetailList":[{"invoiceLineNature":"", "goodsCode":"3040203000000000000","category":"信息技术服务","goodsName":"技术服务费","goodsSpecification":"","goodsUnit":"","goodsQuantity":"","goodsPrice":"","goodsTaxRate":"0.06","goodsTotalPrice":"1","goodsTotalTax":"","freeTaxMark":"","vatSpecialManagement":"","preferentialMark":""}]}

返回参数 ​

参数名称类型必填说明
serialNostring是开票流水号
invoiceTypeCodestring是发票类型代码，02：全电普通发票，01：全电专用发票
digitInvoiceNostring是数电发票号码
invoiceTimestring是开票日期及时间
invoiceTotalPriceTaxstring是发票价税合计
buyerNamestring否购买方名称
buyerTaxNostring否购买方纳税人识别号
sellerNamestring否销售方名称
sellerTaxNostring否销售方纳税人识别号
pdfUrlstring否发票PDF文件下载地址
ofdUrlstring否发票OFD文件下载地址
xmlUrlstring否发票XML文件下载地址

返回json示例 ​

json
{"code": 200,"msg": "开具成功","data": {"serialNo": "202408072105401******539","invoiceTypeCode": "02","digitInvoiceNo": "245220000000******170","invoiceTime": "2024-08-01 21:05:46","invoiceTotalPriceTax": 1,"buyerName": "个人","buyerTaxNo": "","sellerName": "贵州xxxx有限公司","sellerTaxNo": "91520198MA*******","pdfUrl": "","ofdUrl": "","xmlUrl": ""}