航天金税接口文档(V3.0.0.2)详细介绍了企业端与金税设备交互的开票接口,旨在支持报税盘管理及发票操作功能。该接口设计采用XML格式字符串作为数据传输媒介,以确保高效且标准化的通信。
第1章接口概述部分强调了接口的核心作用,即通过XML字符串来执行开票机上的各种任务,如发票开具、查询、作废等,同时也涵盖了对金税设备状态的管理和控制。接口程序运行在本地,通过HTTP服务提供给应用调用,支持POST方法请求,参数需经过base64编码后再发送。
第2章接口说明具体列举了20多个操作接口,每个接口都对应着特定的功能。例如:
- 开启金税设备:用于初始化金税设备,需要输入数字证书密码,成功后返回设备相关信息,这是所有后续操作的基础。
- 发票开具:包括增值税专用发票、普通发票、电子发票和卷式发票的开具,分别针对不同的发票类型。
- 发票作废:允许对已开具的发票进行作废处理,适用于开具错误或不符合规定的场景。
- 发票打印:支持发票的物理打印,确保发票的可追溯性和合规性。
- 监控信息查询:提供对系统运行状态和交易记录的监控,有助于故障排查和审计。
- 发票查询:允许用户查询发票历史记录,便于财务管理和税务核查。
- 红字通知单:涉及红字发票的操作,包括上传通知单、下载校验结果和打印申请单。
- 发票批量查询:引入了批量查询功能,提高了数据检索的效率。
- 商品分类编码下载:为了支持更准确的商品分类管理,增加了自动下载最新的编码库。
- 发票上传:允许用户上传相关的发票数据,可能与外部系统集成。
- 购票信息查询:查询购票记录,方便追踪购买行为。
- 发票卷选择:选择合适的发票卷号,确保发票使用的正确性。
- 获取开票代码号码:实时获取当前可用的开票号码,确保发票编号的连续性和唯一性。
- 红字申请单打印:支持打印红字申请单,满足报税和审计需求。
- 空白发票作废:对于未使用的空白发票,可以进行作废处理。
- 发票分配:管理发票的分配和使用权限。
- 发票退回接口:对于错误或者无法使用的发票,提供退回机制。
整个文档详细而全面,覆盖了从设备管理到具体业务操作的各个环节,是企业进行金税设备操作和报税工作的重要参考。