社区论坛
交流工具使用、配置与问题一、功能名称
货件输出预览 (DEBUG)（feature_id：menu.debug_preview）
开发调试菜单，预览 API/发票组装后的货件 JSON 输出，供排查字段映射问题。
二、实现逻辑
- 入口：DEBUG 菜单 → 货件输出内容预览器
- 读取当前数据库货件，展示将发往 API 或写入模板的数据结构
- 仅建议管理员/开发者使用
三、数据 / 字段 / 配置支撑
数据库.xlsx实时数据- 相关 API/invoice JSON 映射规则
- 权限：
menu.debug_preview（通常仅开发者组）
四、使用教程
- 确保账号拥有 debug 权限。
- 输入货件号，查看结构化输出。
- 与 API 文档或模板列定义对照，定位缺字段或类型错误。
五、常见异常
| 异常情况 | 解决方法 |
|---|---|
| 「初始化失败」 | 确认数据库已成功加载；重新加载数据库后重试。 |
| 提示「请输入货件号」 | 在输入框填写有效货件号。 |
| 预览摘要「预览失败: {code}: {message}」 | 错误码与发票 V2 相同（如 SHIPMENT_NOT_FOUND、VAT_MISSING 等）；按错误码补全数据库或配置。 |
| JSON 输出缺字段 | 对照 API 文档或发票 JSON 映射规则，检查数据库列及 configs/invoice/ 字段映射。 |
| 菜单项不可见 | 当前账号用户组未含 menu.debug_preview 权限；联系管理员开通。 |
全部回复 (0)
暂无回复，来抢沙发吧。
登录 后可回复