金蝶云星空数据导出

SKILL.md

---
name: kingdee-data-exporter
description: 金蝶云星空经营数据（多表单据+报表）导出 Skill。用于指导用户安装后填写 `config.py` 的 `KINGDEE_CONFIG`（base_url/acctid/username/password），然后运行 `data_exporter.py` 批量导出 `bill_configs` + `report_configs` 中已配置的所有表单/报表。支持先 `--list-orgs` 导出全部组织列表，再用 `--org` 指定组织（或 `--org all` 全组织）导出，并可用 `--only` 只导出某个单据/报表；也提供对导出 Excel 做二次筛选（按组织/单据类型）的脚本用法示例。
---

## 你需要做什么（最少步骤）

1) 安装依赖（在本 Skill 目录执行）：

```bash
python -m pip install -r requirements.txt
```

2) 准备配置（避免把真实账号提交到 GitHub）：

- 复制 `config.example.py` 为 `config.py`
- 在 `config.py` 里填写 `KINGDEE_CONFIG`
- `WECHAT_CONFIG.webhook` 可留空（或运行时加 `--no-wechat`）

3) 运行导出：

```bash
python data_exporter.py
```

说明：默认会导出 `data_exporter.py` 里 `bill_configs` + `report_configs` 的全部配置项，生成一个多 Sheet 的 Excel。

当前报表中包含 `银行存款流水账`（`CN_BankDetailReport`），默认字段为：银行账号、银行账户名称、业务日期、单据编号、摘要、制单人、币别、收入金额、支出金额、金额、往来单位、收付款用途、单据类型。它按 `--org` 指定的组织范围查询；如需限定银行账号，可在本地 `config.py` 的 `KINGDEE_CONFIG["bank_account_numbers"]` 中填写账号列表。

当前单据中包含 `收票单`（`IV_ReceivedInvoice`），默认字段为：单据编号、发票代码、发票号码、购货方名称、销售方名称、不含税额、税额、价税合计、开票日期、发票状态、关联单据编号、关联单据类型、关联单据日期。它按开票日期和结算组织范围查询，可用 `--fields` 追加 `官方字段说明/收票单.txt` 中的其他字段。

## 常用命令

### 查看当前脚本支持导出的“单据/报表清单”

```bash
python data_exporter.py --show-config
```

你会看到两类条目：

- `[BILL] form_id | bill_name`
- `[RPT ] form_id | report_name`

后续 `--only` 参数就填这些 `form_id` 或者中文名称（支持逗号分隔）。

### 检查是否有新版本

脚本启动时会自动检查 GitHub 最新 Release；发现新版本时会在控制台输出更新地址，并在企业微信导出摘要里附带版本提醒。

```bash
python data_exporter.py --check-update --no-wechat
```

如运行环境不能访问 GitHub，可加 `--no-update-check` 关闭检查。

### 先导出全部组织列表（降低配置难度）

```bash
python data_exporter.py --list-orgs --no-wechat
```

会生成 `组织列表_YYYYmmdd_HHMMSS.xlsx`，里面至少包含：

- `number`: 组织编码（后续 `--org` 要用）
- `name`: 组织名称

### 某期间 + 某组织 + 全部单据/报表

例如导出 2026-02-01 到 2026-02-28，组织编码 ORG001 的所有配置项：

```bash
python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org ORG001 --no-wechat
```

组织也可以填多个（逗号分隔）：

```bash
python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org ORG001,ORG002,ORG003 --no-wechat
```

### 某期间 + 某组织 + 某单据类型明细（只导出 1 个表单/报表）

1) 先用 `--show-config` 找到你要的 `form_id`，比如“销售出库单”对应 `SAL_OUTSTOCK`

2) 再用 `--only` 只导出它：

```bash
python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org ORG001 --only SAL_OUTSTOCK --no-wechat
```

也可以用中文名：

```bash
python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org ORG001 --only 销售出库单 --no-wechat
```

例如只导出银行存款流水账：

```bash
python data_exporter.py --start 2026-06-01 --end 2026-06-12 --org ORG001,ORG002 --only 银行存款流水账 --no-wechat
```

例如只导出收票单：

```bash
python data_exporter.py --start 2026-06-01 --end 2026-06-30 --org ORG001 --only 收票单 --no-wechat
```

### 全组织导出（先“全量”再二次筛选）

如果你想先导出全组织，再在 Excel 中二次筛选：

```bash
python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org all --no-wechat
```

注意：全组织数据量可能很大，建议优先使用 `--only` 缩小范围。

## 二次筛选：从导出 Excel 里筛某组织/某单据类型

当你已经用 `--org all` 导出了一份总表（或导出多个组织），可以用下面脚本把各 Sheet 按组织/单据类型再筛一遍，输出一个“过滤后的新 Excel”。

脚本位置：`skills/kingdee-data-exporter/scripts/filter_export_excel.py`

示例（按组织编码 ORG001 过滤，并且只保留“单据类型=应收单”的明细行；会自动对每个 Sheet 尝试匹配常见组织列/单据类型列）：

```bash
python scripts/filter_export_excel.py --input "云星空经营数据_2026年02月_20260401_120000.xlsx" --org ORG001 --bill-type "应收单"
```

如果你只想处理某一个 Sheet：

```bash
python scripts/filter_export_excel.py --input "云星空经营数据_2026年02月_20260401_120000.xlsx" --sheet "应付单" --org ORG001
```

输出文件默认会生成在同目录，文件名会带 `_filtered` 后缀；也可指定 `--output`。

## 打包发布（可选）

如果你要把该 Skill 打包成 `.skill` 文件发布，有两种方式：

```bash
python ../skill-creator/scripts/package_skill.py .
```

如果你的仓库里没有 `skill-creator`，也可以直接把本目录打成 zip 并改后缀为 `.skill`（本质是 zip）。