liufumingren 673bd0bef3 docs(wms): 补菜鸟打印数据三段核查记录(printinfo 落库/形态兼容/templateURL)
记录 WMS 侧 2026-11-07 17:40 ~ 18:15 的三轮核查与修复:

1. OMS 淘宝(菜鸟)printinfo 落库不一致
   - 生产对照菠萝派菜鸟:signature / encryptprintinfo / ver 一致,仅 printinfo 为空
   - 影响:WMS 菜鸟主面单只从 printinfo 取,为空会退化为模板兜底,打印结果不一致
   - WMS 侧新增 buildOmsCainiaoPrintinfo 回拼;自测 18 例通过;需随 WMS 发布生效
2. 打印数据格式不对
   - printinfo 形态兼容(字符串/对象、encryptedData/encryptprintinfo 两种命名)
3. 菜鸟 templateURL 模板要求
   - 模板 ID 与接口配置逐一对账一致(申通 288948 / 韵达 288658 / 中通 300336 / 京东 776130)
   - printer_data_builder.js 模板地址改三级来源并告警兜底;回归 122 例通过
   - 建议(不阻塞)OMS 在 deliveryorder.getwaybill 补 template_url

顺手去掉文末多余的 wms/ 占位行。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 18:18:14 +08:00
Description
No description provided
1.9 MiB
Languages
JavaScript 70.5%
Vue 22.8%
TypeScript 6.5%