仪表盘
一眼看清当前的欠款规模与结构。全部数据读自本地快照，打开即显示，不实时访问金蝶。
欠款结构
期末余额 = 期初余额 + 本期应收 − 本期收款 − 本期冲销额 − 到款未入账；欠款占比 = 期末余额 ÷ 本期应收。
超90天合计 / 超360天合计按单个客户的账龄汇总（与「账期查询表」同一套算法，不是拿维度合计去算的）；
超期占比 = 超90天合计 ÷ 期末余额。
数据连接与设置
本系统全部数据都来自金蝶云星空的 WebAPI 接口。这里负责把取数通道打通：填写账套与账号、验证登录、试出报表接口并保存成模板。
登录成功后会拿到一个 kdservice-sessionid 会话，后续所有查询都靠它。全程只读，只调用查询接口，不会调用任何保存/提交/审核接口。
WebAPI 连接信息
地址末尾的 /k3cloud 可以省略，工具会自动补全。
连通检测
三个环节逐个推进，任何一步失败都会直接告诉你原因和下一步该找谁。
-
地址规范化
把你填的地址补全成 …/K3Cloud，并拼出登录/查询接口地址
-
WebAPI 登录验证
调用 ValidateUser，用账套ID + 用户名 + 密码换会话
-
会话可用性
确认 kdservice-sessionid 已拿到，后续查询可以复用它
—
下一步动作建议
查看原始返回（发给金蝶实施商时请附上）
单据试查 / 探测
先确认哪些单据查得到，再确认每张单据有哪些字段。这是「用 WebAPI 取数」能不能落地的前置条件。
金蝶用的是内部英文代号，不是中文名。比如应收单是 AR_receivable、收款单是 AR_RECEIVEBILL。
相当于 Excel 的列名，也是代号。例如 FBillNo=单据编号、FDate=日期、FCustId.FName=客户名称。
相当于 Excel 的筛选，可留空。日期要加单引号，例如 FDate>='2026-01-01'。
难点在于：金蝶这些代号不同版本可能不一样，而且它没有提供"列出全部单据"的接口。所以下面这三个按钮是配套用的 —— 先「批量探测常用单据」确认能查到哪些单据，再「探测可用字段」把无效字段自动剔掉，最后「试查」拉真数据。
查询结果
还没有查询结果。
探测结果
报表直读 · 应收款汇总表（YSKHZB）
这张表在「报表分析」菜单下，是报表不是单据，所以标准单据查询接口很可能读不到它。只能挨个方法试，找出真正能读到它的那一个。
如果所有方法都读不到，怎么办？（先看一眼，省得白试）
那说明这张报表很可能没有 WebAPI 出口——金蝶的报表通常是后台 SQL 算出来的，不对外暴露接口。这时有三条退路：
- 退路一（推荐）：改用已经打通的 WebAPI 去查
AR_receivable（应收单）+AR_RECEIVEBILL（收款单），自己按客户汇总出这 11 列。好处是能拿到明细，后面算账龄、逾期都用得上。 - 退路二：找金蝶实施商，给这张报表配一个 WebAPI 能调用的接口（需要二开）。
- 退路三：先在金蝶里把报表导出成 Excel，工具读 Excel。能应急，但没法每天自动拉。
YSKHZB客户关系管理 > 客户管理 > 报表分析第 1 步 · 选一个方法（候选只是参考，可直接改写）
只有 ExecuteBillQuery / QueryBusinessInfo / View 是常用标准方法；其余来自公开资料、未在本环境核实。 最终以金蝶【公共设置 → 动态服务定义 → WebAPI】在线测试页面为准。
[{...}]，如 ExecuteBillQuery
第 2 步 · 参数
可以直接把金蝶在线测试页面里的调用示例整段粘进来，不用自己拆结构。
格式检查：等待输入
第 3 步 · 模板占位参数（参数里写 {{BEGIN_DATE}} 这类占位符即可自动替换）
试调记录（点任意一条展开原始返回）
还没试过任何方法。建议先点上面的候选方法芯片，再点「发起调用」。
数据结果
还没有读到数据。
已保存的模板
还没有保存模板。某个方法试通后点「保存为模板」，以后就能一键按模板拉数。
报表取数设置
这里配好之后，业务页面的「应收款汇总表」与「账期查询表」就会以它作为默认结算组织。
金蝶报表内部的 FSettleOrgLst 实际要的是组织内码（填编码会被静默当成"查不到"，
返回 0 行且不报错）。服务端会自动做「编码 → 内码」翻译并缓存，
所以这里保持填编码即可；多个组织用英文逗号分隔。
点「校验」，可以看到你填的编码会被翻译成哪个内码再发给金蝶。
已采集的组织映射（编码 → 内码）
每日快照
正在读取…
查询故障排查
业务页面上查不到数据时，用这里定位原因。只拉 20 行，并把金蝶的原始返回原样贴出来。
单次约 30~110 秒（金蝶服务端在算，不是卡住）。结算组织取自上面的「报表取数设置」， 要改就改上面那张卡片。
点上面任一按钮，这里会显示结果；下面「金蝶原始返回」是可复制的原文。
账龄数据维护
「账期查询表」要的是每个客户、每个月的本期应收。历史月份在这里导入， 当月由每日快照自动提供、不用导；每个自然月只要导一次。
直接从金蝶把那张表整块选中复制粘贴即可 —— 按月横向展开的形状，例如 往来单位编码 / 往来单位名称 / 期末余额 / 2025.11 / 2025.12 / … / 2026.9。 四列的长表（往来单位编码、往来单位名称、月份、本期应收）也认。 月份支持 2026.9、2025.11、2026-09、2026年9月 等写法。
账龄口径说明
「账期查询表」上每个数字是怎么来的。业务页上不再重复这些文字。
分段：30天以内 / 30-60天 / 60-90天 / 90-120天 / 120-150天 / 150-180天 / 180-360天 / 360天以上，按欠款「拖了多久」分。天数是按**月份**落的 （当月 = 30天以内，上个月 = 30-60天，依此类推），不是逐笔按实际天数。
算法：以待填总额（该客户期末余额）为额度，从本月起往回逐月用「该月本期应收」填充， 填入 min(该月应收, 剩余额度)，填满即止；最后一个月只取剩余部分。 所有已知月份的应收都不够填的余额，全部归入兜底段「360天以上」。 各月应收与填入金额不一致是正常的（说明期间有回款）。
超90天合计 ＝ 90-120天 ＋ 120-150天 ＋ 150-180天 ＋ 180-360天 ＋ 360天以上。
数据来源：期末余额取自每日快照（与「应收款汇总表」「仪表盘」同一份）； 各月本期应收取自上面导入的历史数据（当月取自快照）。
往来单位范围：客户编码以 90 开头的往来单位不参与统计 —— 这类是内部/关联往来，在同步时就被剔除，不计入任何账龄段与欠款合计。
负数余额：期末余额为负（预收 / 余额在贷方）的客户，账龄按 0 处理， 不参与分段。这批客户会在结果页的「需要留意」里单独报出条数。
对账单申诉
业务员在「客户对账单」上点「申诉」提交的都在这里。每条都带着提交当时的单据摘要 （区间 / 行数 / 欠款 / 剥离段数 / 生成时间）—— 缓存每天被覆盖，没这份摘要就没法复现。
还没有申诉。
结算组织显示名
业务页面的组织下拉只显示这里的简称（业务员看不懂编码和内码）。留空则回退到金蝶全称。
| 组织编码 | 金蝶全称 | 内码 | 页面显示 | 操作 |
|---|
还没有采集到组织。到「数据连接与设置 → 报表取数设置」点一次「刷新组织映射」。
业务员账户
—
从 Excel 直接复制 姓名、企业微信账号、销售部门、销售区域、手机号 五列（顺序固定，后四列可空），粘贴到下面。 按姓名去重：已存在的只补空字段，不会覆盖你已经维护过的值。
| 姓名 | 企业微信账号 | 销售部门 | 销售区域 | 手机号 | 状态 | 操作 |
|---|
还没有账户。点上面的「新增账户」逐条加，或「粘贴导入」从 Excel 批量进来。
正在加载…
账龄结果
还没有结果。
你名下目前没有欠款的客户。
近两个月没有已开票的发票。
对账单预览
下面就是打印出来的样子（A4 横向）。底部的黄色提示区只给制单人看，打印时会自动去掉。
点开列表里的一张对账单即可查看；列表里没有的，去「临时其他客户查询」。
认为这张对账单做得不对（数字不对 / 逻辑要改）就在这里说明。 提交时会连带当时那张单子的摘要一起记下来，管理员按它复现，不用你再截图。
到款明细
| 渠道名称 | 类型 | 责任人 | 状态 | 操作 |
|---|
还没有到款记录。点右上角「＋ 添加一行」登记第一笔。
渠道总览
—| 渠道 | 期初余额 | 账面余额 | 实际余额 | 差额 | 待对账 | 操作 |
|---|
渠道字典是空的。先到「到款登记表 → 渠道设置」把收款渠道建起来。
点上面任意一个渠道的「提现」，这里会显示它的提现明细。
对账明细
这个渠道还没有对账记录。点「＋ 添加一次提现」开始。
销售数据分析
按应收单的审核日期、含税金额统计销售额；目标按业务员 / 区域录入，同时给同月对比与同期累计。
完成情况
正在读取本地销售数据…
目标设置
物料品类
还没有销售数据 —— 先点上面的「拉取销售数据」，物料清单才会出来。