# 国补管理
国补（国家以旧换新补贴）是国家针对家电、手机等品类推出的补贴政策，消费者购买符合条件的商品可享受政府补贴，无需自行垫付全款。在微信小店下单时，消费者只需支付实付金额，补贴部分由财政垫付。
商家收到货款后，需向微信小店上传发票作为核销凭证，微信小店将发票信息同步给政府，审核通过后补贴款才会结算给商家。本模块提供的接口，即为商家完成这一发票上传流程的技术对接通道。
发票由商家以销售方身份开具，开票抬头为购买消费者，开票金额 = 消费者实付金额 + 国家补贴金额。
# 开发前准备
- 权限与凭证：本模块所有接口不支持第三方平台（ISV）调用，仅支持微信小店商家自研调用，使用小店 access_token。
- 消息推送配置：本模块无事件通知，无需配置。
# 接入流程
# 第一步：获取开票参考信息（可选）
此步骤为可选。如果商家开票系统已能获取消费者身份信息和交易金额，可直接跳过，进入商家开票环节。此接口的主要价值在于返回广东银联同步过来的商品型号、品牌名、能效等级等数据，可作为发票「规格型号」字段的填写参考。
调用 [API] 获取国补订单开票信息 / query_invoicing_info，传入国补订单的 order_id，返回以下参考数据：
name：发票抬头（订单归属人实名）tax_no：发票税号（订单归属人身份证号）payment_amount：用户实付金额subsidy_amount：国家补贴金额invoice_total_amount：开票总金额（实付 + 补贴）goods_name、goods_model、brand_name：商品信息（仅作为"规格型号"填写参考，从广东银联接口获得）efficiency：能效/水效等级bar_code、sn_code、imei1、imei2：商品编码信息
开票填写要求（深圳国补）：
- 购买人名称：填写申报补贴人的实名名称，不可使用虚拟名称
- 规格型号（
invoice_goods_model）：有能效/水效产品需与能效网保持一致，且与商品型号一致；无匹配型号或无能效/水效产品可填通用型号 - 开票金额（
invoice_total_amount）：= 实际支付金额 + 补贴金额 + 旧机金额（如有） - 备注（
remark）：- 纯购买新机：
销售订单编号、能效（如有）、水效（如有）、SN 码（如有）、IMEI 码（如有）、补贴金额、实付金额 - 通过以旧换新购买：
销售订单编号、能效（如有）、水效（如有）、SN 码（如有）、IMEI 码（如有）、补贴金额、实付金额、旧机金额及其他费用
- 纯购买新机：
- 附件赠品：附件赠品金额应为 0，如赠品涉及金额需单独开票
调用限制：
order_id必须是使用了国补的订单- 只能在订单确认收货之后调用
# 第二步：上传发票文件
调用 [API] 上传国补订单发票文件 / upload_invoice_file，传入发票图片的公网可访问链接（file_link），返回 media_id。
文件要求：
- 支持格式：
.jpg/.png - 文件大小：≤ 1MB
# 第三步：上传发票信息
调用 [API] 上传国补订单发票信息 / upload_invoice_info，传入第二步获得的 invoice_media_id 及完整发票信息。
必填字段说明：
order_id：国补订单 IDinvoice_no：发票号码invoice_date：开票时间（秒级时间戳，要求小于当前时间）invoice_media_id：第二步获取的media_idinvoice_type：发票类型，枚举值：01=增值税专用发票、04=纸质普通发票、09=数电专票、10=电子普通发票、90=数电普票invoice_total_amount：税价合计，单位（分）invoice_tax_amount：发票税额，单位（分）sales_enterprise_name：销售企业名称tax_payer：销售方纳税人识别号num：数量service_name：货物或应税劳务服务名remark：备注（填写规则见下方说明）invoice_goods_model：规格型号（填写规则见下方说明）
选填字段说明：
invoice_code：发票代码（发票类型为90时可选填）invoice_check_code：发票校验码（发票类型为10或04时必填；类型为01、09、90时选填）
调用限制：
order_id必须是使用了国补的订单- 只能在订单确认收货之后调用
- 同一笔订单最多可上传 5 次
# 接口全览
# API 接口
| 中文名 / 英文名 | 请求方式 | 功能说明 |
|---|---|---|
| 获取国补订单开票信息 / query_invoicing_info | POST /channels/ec/subsidy/query_invoicing_info | 查询国补订单的发票抬头、金额、商品型号等开票参考信息 |
| 上传国补订单发票文件 / upload_invoice_file | POST /channels/ec/subsidy/upload_invoice_file | 上传发票图片文件，获取 media_id 供后续接口使用 |
| 上传国补订单发票信息 / upload_invoice_info | POST /channels/ec/subsidy/upload_invoice_info | 上传国补订单完整发票信息，完成国补核销凭证提交 |
所有接口不支持云调用，不支持第三方平台调用。
# 常见问题 FAQ
Q：哪些订单需要上传国补发票？
A：使用了国家补贴的订单在确认收货后需要上传。可通过 order_id 调用接口确认，如果返回错误码 987100102（订单非国补订单），则该订单无需上传。
Q：发票上传失败报错 987100118 怎么处理？
A：该错误表示发票文件链接无效。请确保 file_link 参数传入的是公网可直接访问的链接，不支持内网地址或需鉴权的链接。
Q：发票信息中 remark 和 invoice_goods_model 字段如何填写？
A：详见第一步「开票填写要求」说明。其中 remark 需包含销售订单编号、能效、SN 码、补贴金额、实付金额等；以旧换新场景还需附加旧机金额；invoice_goods_model 需与商品型号一致，有能效产品需与能效网一致。
文档变更日志（1条）