请求参数(主表)
| 参数名称 | 类型 | 必填 | 长度 | 描述 |
|---|
| trade_list | array | 是 | | 交易信息列表,当前仅支持单个交易,交易渠道仅支持支付宝 |
| trade_list.channel_type | string | 是 | 32 | 交易渠道,当前传 ALIPAY(支付宝) |
| trade_list.trade_no | string | 是 | 40 | 支付宝订单交易号(先有收款交易,才能开票) |
| outer_apply_id | string | 是 | 64 | 外部开票申请ID,税号维度下唯一,幂等键 |
| invoice_type | string | 是 | 16 | 发票类型:BLUE 蓝票;RED 红票 |
| invoice_kind | string | 是 | 32 | 票种:ALL_ELECTRONIC_SPECIAL 增值税专用发票;ALL_ELECTRONIC_GENERAL 普通发票 |
| invoice_red_reason | string | 条件 | 20 | 红冲原因(红票必传):FAULT 开票有误 |
| related_blue_invoice_no | string | 条件 | 20 | 关联蓝票发票号码(红票必传,暂仅支持全额红冲) |
| tax_no | string | 是 | 20 | 企业(商户)税号 |
| product_id | string | 是 | 16 | 发票产品ID(开通完成后由企业信息查询获得) |
| buyer_name | string | 是 | 128 | 购买方名称 |
| buyer_tax_no | string | 条件 | 20 | 购买方税号(证件类型传值时必传) |
| buyer_tax_no_type | string | 条件 | 32 | 购买方证件类型:BUSINESS_CERT 营业执照;IDENTITY_CARD 居民身份证 |
| buyer_address / buyer_tel | string | 否 | 128 | 购买方地址/电话 |
| buyer_bank_name / buyer_bank_account | string | 否 | 128 | 购买方开户行/银行账号 |
| show_buyer_bank_info | string | 否 | 32 | 发票是否展示购买方银行信息:Y/N,默认 N |
| show_seller_bank_info | string | 是 | 32 | 发票是否展示销售方银行信息:Y/N |
| seller_bank_account | string | 否 | 50 | 销售方银行卡账号 |
| remark | string | 否 | 200 | 发票备注 |
| nature_person_flag | string | 否 | 32 | 购买方是否自然人:Y/N;为 Y 时可配套传自然人证件三项 |
| nature_person_cert_type / cert_no / country | string | 否 | | 购买方自然人证件类型/证件号码/国籍(联动校验,详见备注) |
| clerk / clerk_cert_type / clerk_cert_no | string | 否 | | 开票员姓名/证件类型/证件号码(三项同传同空,传入会校验开票员授权) |
| invoice_item_list | array | 条件 | | 商品明细列表(交易账单无商品信息且未配置默认商品时必传),字段见下表 |
invoice_item_list 商品明细字段
| 参数名称 | 类型 | 必填 | 长度 | 描述 |
|---|
| serial_no | number | 是 | 32 | 明细行序号,从 1 开始 |
| item_code | string | 否 | 28 | 商品配置编码(填新增商品接口返回的 company_item_id) |
| tax_code | string | 条件 | 19 | 税收分类编码(无商品编码且未维护默认商品时必传) |
| item_name | string | 条件 | 120 | 商品名称(同上条件必传) |
| item_spec | string | 否 | 128 | 规格型号 |
| item_unit | string | 条件 | 32 | 商品单位(不动产租赁仅支持平方米;成品油仅支持升/吨) |
| item_num | string | 条件 | 27 | 商品数量(成品油场景必传;不传系统自行计算) |
| item_unit_amount | string | 否 | 27 | 不含税单价(不传系统自行计算) |
| item_amount | string | 条件 | 20 | 开票金额(与不含税金额二选一传入) |
| item_amount_without_tax | string | 条件 | 20 | 不含税金额(与开票金额二选一传入) |
| item_tax_amount | string | 否 | 20 | 商品税额(不传系统自行计算) |
| item_tax_rate | string | 条件 | 6 | 商品税率,(0,1) 小数最多四位 |
| invoice_line_property | string | 是 | 16 | 发票行性质:NORMAL_LINE 正常行;DISCOUNT_LINE 折扣行;DISCOUNTED_LINE 被折扣行 |
| favoured_policy_flag | string | 否 | 64 | 优惠政策标识:SIMPLE_COLLECTION 简易征收 / TAX_EXEMPT 免税 / NO_COLLECTION 不征税 等(完整枚举见联调字典) |
| related_blue_serial_no | number | 条件 | 32 | 关联蓝票明细行序号(红票必传) |
不动产租赁(real_property_business_list)、旅客运输(passenger_transport_list)、成品油等特殊场景为在此基础上追加对应信息列表,字段与官方规范完全一致,联调阶段提供完整字典。
响应参数
| 参数名称 | 类型 | 必返 | 描述 |
|---|
| invoice_apply_id | string | 是 | 开票申请ID,后续查询/重试凭据 |
| outer_apply_id | string | 是 | 外部开票申请ID(原样返回) |
请求示例
{
"trade_list": [{ "channel_type": "ALIPAY", "trade_no": "202420038056267143453111112" }],
"outer_apply_id": "KLFWD_20260718_0001",
"invoice_type": "BLUE",
"invoice_kind": "ALL_ELECTRONIC_GENERAL",
"tax_no": "9188203420009113TT",
"product_id": "2025040055152404",
"buyer_name": "某某信息技术有限公司",
"buyer_tax_no": "919901060000341630",
"buyer_tax_no_type": "BUSINESS_CERT",
"show_seller_bank_info": "N",
"invoice_item_list": [{
"serial_no": 1,
"tax_code": "3040201010000000000",
"item_name": "技术服务费",
"item_unit": "次",
"item_amount": "100.00",
"item_tax_rate": "0.01",
"invoice_line_property": "NORMAL_LINE"
}]
}响应示例
{
"code": "10000",
"msg": "Success",
"invoice_apply_id": "2025051000152001670002983470",
"outer_apply_id": "KLFWD_20260718_0001"
}