| 接口名称:/open/invoice/invoiceBlue |
|---|
请求参数：
| 字段 | 类型 | 必填项 | 描述 |
| merchantCode | text | 是 | 机构商户号（必填） |
| outTransNo | text | 是 | 商户外部流水号，全局唯一最长50位（必填） |
| tradeNo | text | 是 | 商户请求流水号，固定16位长度，后面将弃用 |
| buyerName | text | 是 | 购买方名称（必填） |
| buyerTaxpayerNum | text | 否 | 购买方纳税人识别号（单位必填） |
| buyerAddress | text | 否 | 购买方地址 |
| buyerTel | text | 否 | 购买方电话 |
| buyerBankName | text | 否 | 购买方开户行 |
| buyerBankAccount | text | 否 | 购买方银行账号 |
| takerName | text | 否 | 收票人名称 |
| takerTel | text | 否 | 收票人手机号 |
| takerEmail | text | 否 | 收票人邮箱 |
| remark | text | 否 | 备注 |
| casherName | text | 否 | 收款人，没有指定时，使用注册时的默认收款人 |
| drawerName | text | 否 | 开票人，没有指定时，使用注册时的默认开票人 |
| reviewerName | text | 否 | 复核人，没有指定时，使用注册时的默认复核人 |
| specialInvoiceKind | text | 否 | 成品油票需要传：08，收购发票需要传：02（注：收购发票只能开具税率为 0、免税、不征税的发票），不动产经营租赁服务发票需要传：06，旅客运输服务发票需要传：09，货物运输服务发票需要传：04，建筑服务发票需要传：03，其他票种可以为空 |
| invoiceIssueKindCode | text | 否 | 增值税电子专用发票填08，增值税纸质普通发票填04, 增值税纸质专用发票填01，其它发票可不填，没有指定时，使用注册时的发票开具种类； 10：增值税电子普通发票, 04：增值税普通发票, 01：增值税专用发票,9：区块链电子发票,08：增值税电子专用发票(成品油),81：电子发票（增值税专用发票）,82：电子发票（普通发票） |
| extensionNum | text | 否 | 开票的税盘分机号,不填写将随机获取在线分机的对应分机号，发票类型01，04必填 |
| notifyUrl | text | 否 | 开票结果后台通知地址 |
| variableLevyFlag | text | 否 | 全电发票差额征税标识，差额征税-全额开票填1 |
| invIssueChannel | text | 否 | 非乐企联用不传，4：乐企联用（腾讯）,5：乐企联用（支付宝） |
| paymentList | Json Array | 否 | 支付信息列表，非乐企联用不传 |
| subMchid | text | 否 | 微信支付商户号，使用腾讯乐企联用时可以传值，不传值默认取该税号下第一个开通乐企联用的商户号 |
| payType | number | 否 | 非乐企联用不传，支付信息列表有值时，该字段无效；支付方式，1003:微信，1004:支付宝， 1001:现金 |
| items | Json Array | 是 | 开票项目列表 |
| realEstateRentalService | Json Object | 按条件 | 不动产经营租赁服务，仅发票类型81，82时，支持。不动产经营租赁服务相关的税收分类编码，必填。 |
| passengerTransportList | Json Object | 按条件 | 旅客运输服务列表，仅发票类型81，82时，支持。 |
| goodsTransportList | Json Object | 按条件 | 货物运输服务列表，仅发票类型81，82时，支持。 |
| buildService | Json Object | 按条件 | 建筑服务，仅发票类型81，82时，支持。建筑服务相关的税收分类编码，必填。 |
开票项目列表：
| 字段 | 类型 | 必填项 | 描述 |
| taxClassificationCode | text | 是 | 税收分类编码（必填）（点击下载税收分类编码信息表） |
| goodsName | text | 是 | 开票项目名称（必填） |
| taxRateValue | text | 是 | 税率(精确到2位小数) |
| quantity | text | 否 | 数量(票面信息，精确到前8位小数。成品油发票数量不能为空，数量和单价必须同时为空或同时不为空) |
| includeTaxFlag | text | 否 | 含税标示(0：不含税，1：含税，默认为 0 不含税) |
| meteringUnit | text | 否 | 单位 |
| specificationModel | text | 否 | 对应规格型号 |
| unitPrice | text | 否 | 单价(精确到8位小数) 默认为不含税,可通过含税标示 includeTaxFlag，定义此字段为含税。成品油发票单价不能为空，数量和单价必须同时为空或同时不为空 |
| zeroTaxFlag | text | 否 | 非零税率传""，0:出口零税，1:免税，2:不征税，3:普通零税率 |
| discountAmount | text | 否 | 该商品行的折扣金额，传负数 |
| invoiceAmount | text | 是 | 金额(精确到2位小数) 默认为不含税,默认为不含税，可通过含税标示 includeTaxFlag，定义此字段为含税（必填） |
| preferentialPolicyFlag | text | 否 | 优惠政策标识，空：不使用，1:使用。零税率标识为0、1、2时该值必填1。 |
| zeroTaxFlag | text | 否 | 零税率标识，税率为0时该值必填。空：非零税率，1：免税，2：不征税，3：普通零税率 |
| vatSpecialManage | text | 否 | 增值税特殊管理，优惠政策标识为1时必填，填免税、不征税、简易征收等 |
| refinedOilInfo | Json Object | 按条件 | 成品油行业额外信息，成品油乐企联用开票时，须填 |
支付信息列表：
| 字段 | 类型 | 必填项 | 描述 |
| paymentChannel | text | 是 | 支付渠道代码，001:现金 002:银行转账, 003:票据, 004:借记卡,005:信用卡,006:购物卡/券,007:优惠券,008:商场积分,009:支付宝, 010:微信支付, 011:云闪付,099:其他 |
| paymentOrderNo | text | 是 | 微信、支付宝等支付系统的交易单号 |
| tradeNo | text | 是 | 微信、支付宝的商户单号 |
| transactionAmount | text | 是 | 交易金额 10 位(精确到 2位小数 不能小于开票金额） |
不动产经营租赁服务：
| 字段 | 类型 | 必填项 | 描述 |
| region | text | 是 | 不动产所在省市（县）区。 |
| detailedAddress | text | 是 | 不动产详细地址。 |
| areaUnit | text | 是 | 面积单位。平方千米 平方米 公顷 亩 h ㎡ k ㎡ ㎡ |
| crossCitySign | text | 是 | 跨地(市)标志。 0：否；1：是。 |
| leaseTerm | text | 是 | 租赁期起止。例如2022-12-01 2022-12-12 |
| titleNo | text | 否 | 产权证书/不动产权号。若没有证书填写“无”。 |
| carPlateNum | text | 否 | 车牌号。税收分类编码为3040502020200000000（车辆停放服务）时可以填值，其他情况不能填值。 |
旅客运输服务列表：
| 字段 | 类型 | 必填项 | 描述 |
| traveler | text | 是 | 出行人 |
| travelDate | text | 是 | 出行日期。格式 yyyy-MM-dd |
| travelerIdType | text | 是 | 出行人证件类型 |
| travelerIdNo | text | 是 | 出行人证件号码 |
| departurePlace | text | 是 | 出发地 |
| destinationPlace | text | 是 | 到达地 |
| vehicleType | text | 是 | 交通工具类型。1:飞机；2:火车；3:长途汽车；4:公共交通；5:出租车； 6:汽 车；7:船舶；9:其他 |
| seatClass | text | 是 | 等级。【飞机】：则值为公务舱、头 等舱、经济舱的其中一种。 【火车】：则值为一等座、二 等座、软席（软座、软卧）、 硬席（硬座、硬卧）的其中一 种。 【船舶】：则值为一等舱、二 等舱、三等舱的的其中一种。 |
货物运输服务列表：
| 字段 | 类型 | 必填项 | 描述 |
| transportToolType | text | 是 | 运输工具种类。铁路运输、公路运输、水路运输、航空运输、管道运输 |
| transportToolBrand | text | 是 | 运输工具牌号 |
| departurePlace | text | 是 | 起运地 |
| destinationPlace | text | 是 | 到达地 |
| transportGoodsName | text | 是 | 运输货物名称 |
建筑服务：
| 字段 | 类型 | 必填项 | 描述 |
| landTaxItemNo | text | 否 | 土地增值税项目编号 |
| buildServicePlace | text | 是 | 建筑服务发生地 |
| detailedAddress | text | 是 | 详细地址 |
| buildProjectName | text | 是 | 建筑项目名称 |
| crossCitySign | text | 是 | 跨地(市)标志。0：否；1：是 |
成品油行业额外信息：
| 字段 | 类型 | 必填项 | 描述 |
| station | text | 是 | 成品油交易的站点 |
| tradeTime | text | 是 | 完成此次交易时，使用油枪加油的操作时间。格式 yyyy-MM-dd HH:mm:ss |
| gunNumber | text | 是 | 成品油交易对应的加油枪号码 |
响应：
| invoiceReqSerialNo | text | 发票请求流水号 |
| qrCodePath | text | 电子发票链接（需反base64编码） |
后台通知：
通知类型 event: InvoiceNotify
| code | text | 发票状态码：0000：开票成功；6666：未开票（撤回开票中发票）；9999：开票失败。 |
| msg | text | 发票状态描述（成功/失败原因） |
| invoiceType | text | 开票类型1：蓝票；2：红票；3：蓝废；4：红废。 |
| reqSerialNo | text | 发票请求流水号，旧 |
| invoiceReqSerialNo | text | 发票请求流水号 |
| outTransNo | text | 商户外部流水号 |
| tradeNo | text | 订单号，开票成功时必传，失败时不传 |
| invoiceCode | text | 发票代码，开票成功时必传，失败时不传 |
| invoiceNo | text | 发票号码，开票成功时必传，失败时不传 |
| invoiceDate | text | 开票日期，开票成功时必传yyyy-MM-dd HH:mm:ss，失败时不传 |
| downloadUrl | text | 发票下载Url，电子发票开票成功时，即发票种类代码为 10 或 08 时必传，失败时不传，不定长，Base64字符串，其他发票种类不传 |
| securityCode | text | 效验码，开票成功时必传，失败时不传 |
| buyerName | text | 购买方名称 |
| buyerTaxpayerNum | text | 购买方纳税人识别号 |
| buyerAddress | text | 购买方地址 |
| buyerTel | text | 购买方电话 |
| buyerBankName | text | 购买方开户行 |
| buyerBankAccount | text | 购买方银行账号 |
接入商接收到异步通知后，响应“SUCCESS”这7个大写字母即表示通知成功，不成功的将会在下次尝试通知，通知频率为5s/10s/15s ······，最多通知20次