ISV 开票申请接口测试案例

关键字段说明

字段	含义	备注
`custId`	商户号	必填
`fapiaoApplyId`	外部发票申请单号	必填，若使支付宝微信场景，使用支付宝微信订单号作为申请单号
`totalAmount`	开票总金额	单位：分
`orderTime`	下单时间	`yyyyMMddHHmmss`
`transactionInfos[].payChannel`	支付渠道	`CASH`=现金、`WECHAT_PAY`=微信支付等
`items[].taxCode`	税收分类编码	成品油仅支持 `10701010` 开头
`items[].taxRate`	税率	万分之一，`1300`=13%、`300`=3%
`items[].quantity`	数量	单位为 10⁻⁸，`100000000`=1
`items[].totalAmount`	单行金额合计	单位：分
`items[].realEstateLeasingInformation`	不动产租赁行业扩展信息	不动产场景必填，如停车场

案例一：不动产（不动产租赁开票）

场景：不动产租赁行业开票，商品为「车辆停放服务」，税率 3%，具体税率以税局为准，税收分类编码 3040502020200000000（需填车牌号），支付渠道为微信支付（WECHAT_PAY），携带不动产租赁扩展信息 realEstateLeasingInformation。

{
  "agetId": "6100****7131",
  "totalAmount": "1",
  "orderTime": "20260707195406",
  "fapiaoApplyId": "420000****2363",
  "phone": "176****3003",
  "custId": "60000016****58",
  "sign": "****（已脱敏）",
  "transactionInfos": [
    {
      "amount": "1",
      "payChannel": "WECHAT_PAY",
      "transactionId": "420000****2363"
    }
  ],
  "remark": "不动产开票",
  "items": [
    {
      "totalAmount": 1,
      "taxRate": "300",
      "unit": "平方米",
      "quantity": "100000000",
      "taxCode": "3040502020200000000",
      "goodsName": "车辆停放服务",
      "realEstateLeasingInformation": {
        "crossCityFlag": false,
        "realPropertyArea": "1",
        "realPropertyCode": "",
        "address": "河南省周口市川汇区****",
        "province": "河南省",
        "plateNo": ["豫PU****"],
        "city": "周口市",
        "leasePeriodStart": "2025-12-04T22:01:18+08:00",
        "certificateNo": "",
        "leasePeriodEnd": "2026-05-21T18:53:49+08:00"
      }
    }
  ],
  "version": "1.0.0",
  "timestamp": "1783425246943"
}

校验要点：

税收编码 3040502020200000000 需填写 plateNo。

信息都要真实信息，以免税局校验不过导致开票失败

realEstateLeasingInformation 中 province 须以「省/市/自治区」等结尾，city 须以「市/区」等结尾，address 须含街/路/号等，leasePeriodStart/leasePeriodEnd 为 RFC3339 格式。

案例二：现金 / 储值 / 线下交易

场景：线下现金/储值交易开票，支付渠道为现金（CASH）。

{
  "timeStamp": 1783493272,
  "agetId": "6100***734",
  "totalAmount": 22034,
  "orderTime": "20260708144752",
  "fapiaoApplyId": "5481****3272",
  "phone": "133****9856",
  "custId": "60000003****82",
  "sign": "****（已脱敏）",
  "transactionInfos": [
    {
      "amount": 22034,
      "payChannel": "CASH",
      "transactionId": "P133****2118"
    }
  ],
  "remark": "杨浦区****；油枪号：2；交易时间：2026-07-08 14:47:51",
  "items": [
    {
      "totalAmount": 22034,
      "taxRate": 1300,
      "unit": "升",
      "quantity": 3221000000,
      "specification": "92号",
      "taxCode": "1070101010100000000",
      "goodsName": "92号车用汽油"
    }
  ],
  "version": "1.0.0"
}

校验要点：

transactionInfos[].payChannel 为 CASH，代表现金/线下交易场景。

用于验证线下现金渠道下的开票链路。

开票申请

ISV 开票申请接口测试案例

关键字段说明

案例一：不动产（不动产租赁开票）

案例二：现金 / 储值 / 线下交易

请求参数

返回响应

开票申请

ISV 开票申请接口测试案例#

关键字段说明#

案例一：不动产（不动产租赁开票）#

案例二：现金 / 储值 / 线下交易#

请求参数

返回响应

ISV 开票申请接口测试案例

关键字段说明

案例一：不动产（不动产租赁开票）

案例二：现金 / 储值 / 线下交易