斑马网络景区数电发票（全电发票）接口 API 应用场景规划方案

一、方案总览

定位：面向景区售票、闸机、二消、旅行社、OTA、年卡 / 会员全业务链，基于税务数电发票官方接口实现自动开票、自动红冲、自动归集、合规入账，零人工、实时、全流程可追溯。目标：100% 覆盖游客开票需求、财务零差错、税务零风险、游客体验最优。适用：景区自营票务、智慧景区平台、票务 SaaS、景区财务系统。

二、核心业务场景（10 大高频必选场景）

1）线上购票自动开票（游客小程序 / 公众号 / 官网）

流程：游客下单支付 → 系统实时调用数电发票开具接口 → 开票成功 → 自动推送PDF+XML到游客手机 / 邮箱 / 卡包。价值：游客即买即开、无需人工审核、无排队。关键字：实时开票、微信 / 支付宝卡包、手机号 / 邮箱交付。

2）线下窗口 / 自助机一键开票

流程：窗口出票 / 自助机取票 → 游客扫码 / 输入手机号 → 触发开票接口 → 秒开秒推。价值：窗口不接触发票、不打纸质票、降本增效。

3）闸机核销后开票（先入园后开票）

流程：游客刷码 / 刷证入园（核销成功）→ 订单状态变为 “已消费”→ 支持事后开票/ 自动开票。价值：符合 “消费完成开票” 合规口径，避免退票与发票冲突。

4）OTA / 旅行社渠道自动开票与对账

流程：OTA 订单同步 → 按游客抬头自动开票 → 发票回传 OTA / 旅行社 → 自动生成开票对账表。支持：美团、飞猪、携程、同程、旅行社分销。价值：渠道对账清晰、发票不扯皮、结算更快。

5）景区二消统一开票（餐饮 / 购物 / 停车 / 演艺 / 索道）

流程：游客一笔支付包含：门票 + 观光车 + 餐饮 + 停车 → 系统合并开票（按商品编码分行）→ 一张发票全包含。价值：游客体验好、财务统一入账、税务口径一致。

6）年卡 / 会员卡 / 储值卡开票（预收款合规）

模式 A（储值 / 预售）：不开票，消费时逐笔开票。模式 B（年卡服务费）：按服务期一次性开票。接口能力：支持不征税 / 预付卡发票、支持后续消费冲红 / 补差开票。价值：完全符合税务 “预收款≠必须立刻开征税票” 规则。

7）退票 / 改签自动红冲（废单自动处理）

流程：游客退票 / 作废订单 → 系统自动查询发票状态 → 已开票则自动红冲（全额冲红） → 冲红成功方可完成退款。价值：杜绝 “已退票未冲红” 虚开风险、财务自动闭环。

8）对公 / 企业客户批量开票（旅行社 / 企业团单）

流程：企业团单上传税号、抬头、项目 → 系统批量调用开票接口 → 批量下载 PDF/XML → 自动回传对账单。价值：团单最快、最稳、最合规。

9）发票归集与报销（企业差旅 / 公务出行）

流程：游客开票时选择 “报销归集”→ 发票 XML/PDF 自动同步至企业费控 / 报销系统。价值：公务出行免打印、免粘贴、秒报销。

10）财务中台：自动入账、税务申报、风控

能力：

• 开票日志全留存
  
• 发票状态：开具 / 红冲 / 作废 / 作废重开
  
• 自动生成发票台账、销售额台账、销项税额台账
  
• 与景区财务 / ERP 对接自动生成凭证价值：审计无忧、税务零风险。
  

三、API 接口清单（最简可用版）

四、数据字段设计（景区标准）

开票必传（最小集）

• 订单号 / 票务单号
  
• 购票人手机号 / 游客 UID
  
• 购买时间、支付金额、支付流水
  
• 商品名称：门票服务 / 观光车服务 / 停车服务 / 餐饮服务 / 演艺服务等
  
• 税率 / 税收编码（按税务核定）
  
• 购买方信息（个人：姓名 / 手机号；企业：名称 + 税号 + 地址电话 + 开户行）
  
• 开票类型：数电普通发票 / 数电专用发票（按需）
  

发票回填

• 发票号码、发票代码（数电发票号码）
  
• 开票时间、校验码、PDF/URL
  
• 开票状态、红冲状态、异常信息
  

五、业务规则与风控（景区关键）

1. 先支付后开票：未支付不允许开票
   
2. 已核销优先开票：避免退票与发票冲突
   
3. 一票一单 / 可合并：支持同一游客多商品合并开票
   
4. 红冲强规则：已开票必须先红冲再退款
   
5. 个人默认普票；企业可开专票（按景区资质）
   
6. 发票项目统一：固化商品名称与税收编码，防止开错
   

六、系统对接架构（推荐）

1. 景区票务系统（订单、支付、核销）
   
2. 数电发票中间服务（接口封装、重试、幂等、日志）
   
3. 税务数电发票平台（官方通道）
   
4. 游客端（小程序 / 公众号 / 短信 / 邮箱）
   
5. 财务中台（台账、对账、凭证）
   

部署方式：云服务 / 私有化均可，建议异步开票 + 重试机制保证稳定。

七、实施里程碑（4 周可上线）

• Week1：需求确认、税号资质、接口申请、商品编码核定
  
• Week2：接口对接、订单 - 开票链路打通
  
• Week3：红冲、查询、推送、异常处理测试
  
• Week4：UAT、上线、培训、运维
  

斑马网络，专注于企业电子发票接口应用研发应用交付，欢迎垂询合作：18665090200 汤先生