开放接口
标准 OpenAPI 开放接入
面向第三方业务系统提供标准开放接口，支持通过 X-App-Id、X-Timestamp、X-Sign 请求头进行验签，适合与 ERP、订单、交易、结算、财务系统集成。
接入流程
- 1
创建接入应用，获取 appId 和密钥
- 2
按 OpenAPI 规范生成签名，携带 X-App-Id、X-Timestamp、X-Sign 请求头
- 3
调用基础资料查询接口，获取法人主体、产品线、客户、税收分类编码、开票项目等配置
- 4
调用申请单预校验接口，提前发现字段或业务规则问题
- 5
调用申请单推送接口正式提交开票申请
- 6
通过申请单查询、发票查询、文件下载接口获取后续结果
接口分类
申请单接口
推送、预校验、查询申请单基础信息
- 数电普票/专票/二手车/机动车申请单推送与预校验
- 查询开票状态、审批状态、审批人、审批时间、审批备注
发票接口
发票列表查询、发票文件下载
- 发票列表与发票详情查询
- 下载 PDF/XML/OFD 等版式文件
基础资料接口
法人主体、产品线、客户、税收分类编码、开票项目查询
- 获取开票所需的基础配置数据
校验接口
特殊字符和字段长度规则预校验
- 在正式推送前提前发现字段或业务规则问题
签名认证与调用示例
请求头示例
X-App-Id: your-app-id X-Timestamp: 1797110400000 X-Sign: generated-signature Content-Type: application/json
curl 示例
curl -X POST https://api.example.com/openapi/apply/pre-check \
-H 'X-App-Id: your-app-id' \
-H 'X-Timestamp: 1797110400000' \
-H 'X-Sign: generated-signature' \
-H 'Content-Type: application/json' \
-d '{"legalEntityCode":"LE001","invoiceType":"E_NORMAL","items":[]}'常用枚举
发票类型
| 枚举值 | 发票类型 |
|---|---|
| E_NORMAL | 电子发票（普通发票） |
| E_SPECIAL | 电子发票（增值税专用发票） |
| E_SECOND_HAND | 电子发票（二手车销售统一发票） |
| E_MOTOR_VEHICLE | 电子发票（机动车发票） |
特定业务类型
| 枚举值 | 特定业务类型 |
|---|---|
| PRODUCT_OIL | 成品油 |
| GOODS_TRANSPORT | 货物运输服务 |
| REAL_ESTATE_RENTAL | 不动产经营租赁服务 |
| CONSTRUCTION | 建筑服务 |
面向 AI Agent 的接入建议
- 先读取 /llms.txt 建立站点地图
- 再读取本页面理解接入流程
- 根据业务场景选择申请单接口、发票接口或基础资料接口
- 生成代码时必须包含签名请求头、错误处理和重试策略