电子税务局集成操作手册
模块：
mkl_tax_bureau_integration· 远鼎特有 · 菜单：会计 → 电子税务局
依赖：account· 与mkl_einvoice分工：本模块负责税局通道，电子发票负责开票执行
1. 模块定位（本土化 + 国际化）
| 能力 | 说明 |
|---|---|
| 本土化 | 对接中国电子税务局 API：发票上传、验真、申报记录 |
| 国际化 | Odoo 标准 account.move 模型扩展，不破坏多公司/多币种架构 |
| 与官方文档关系 | 对照 Odoo 会计与开票；中国税率/科目来自 l10n_cn |
实施分工：
mkl_tax_bureau_integration → 税局连接、验真、申报台账
mkl_einvoice → 销项开票、作废、红冲
mkl_vat_declaration → 申报底稿汇总（进项认证 + 税率汇总）
l10n_cn_reports → 法定资产负债表/利润表（企业版）
2. 菜单结构
会计
└── 电子税务局
├── 税务局配置 （财务经理）
├── 发票管理
│ ├── 发票上传
│ └── 发票验真
└── 税务申报
3. 首次配置
路径：会计 → 电子税务局 → 税务局配置
| 配置项 | 说明 |
|---|---|
| 纳税人识别号 | 统一社会信用代码 |
| API 端点 / 证书 | 税局或服务商提供的接入参数 |
| 环境 | 测试 / 生产 |
| 定时任务 | 发票上传、申报状态同步（见 ir.cron） |
保存后执行 连接测试。生产环境通常需固定出口 IP 白名单。
4. 发票验真
路径：会计 → 电子税务局 → 发票管理 → 发票验真
- 选择供应商账单或录入发票代码、号码、开票日期、金额。
- 运行验真向导，系统调用税局接口返回真伪与票面信息。
- 验真结果写入 验真记录，供进项认证与 增值税申报辅助 引用。
实务提示：采购三单匹配前建议先验真专票，避免虚假进项。
5. 发票上传
路径：会计 → 电子税务局 → 发票管理 → 发票上传
- 将 Odoo 已确认的客户发票/供应商发票元数据上传税局台账（具体字段以部署接口为准）。
- 查看 上传日志：成功 / 失败 / 重试。
- 与 电子发票对接 联用时：开票成功后自动或批量触发上传。
6. 税务申报记录
路径：会计 → 电子税务局 → 税务申报
- 记录各税种申报期间、申报状态、回执信息。
- 不替代金税客户端申报，但作为 Odoo 内申报台账 与关账留痕。
- 月末配合 会计期间与关账 清单第 45 项（增值税）。
7. 权限与安全
| 角色 | 建议权限 |
|---|---|
| 财务经理 | 税务局配置、申报确认 |
| 会计 | 验真、上传、查看日志 |
| 出纳 | 只读验真结果 |
API 密钥仅存 tax.bureau.config，勿写入用户可编辑字段。
8. 故障排查
| 现象 | 处理 |
|---|---|
| 连接超时 | 检查防火墙、税局服务状态、证书有效期 |
| 验真失败 | 核对代码/号码/日期/金额与票面一致 |
| 上传重复 | 查上传日志去重，避免同一 move_id 重复提交 |