EDI 管理：EDI 连接与合作伙伴接入

用一个向导把零售商经 EDI 平台接进来，零代码配好报文映射，每条传输都用人话看得懂。

EDI 管理在 Integration → EDI 下，四个页面配合工作：连接（一行 = 一个零售商的一个平台账号）、Mapping（每种报文怎么翻译）、代码表（Mapping 引用的查表）和传输日志（每一条发出/收到的报文）。所有平台共用同一个向导、同一个详情页、同一个 Mapping 工具、同一种人话报错格式——不给任何平台做特例。可启用的报文集包括 850 采购单、855 采购单确认、856 发货通知、940 / 945 仓库出库类报文、846 库存通知、947 库存调整、943 / 944 库存转移类报文、810 发票、210 运费发票、204 运单招标和 214 运输状态。

第一步：打开连接向导，选平台#

1. 打开 Integration → EDI → 连接（/integration/edi/connections），点「+ 新建连接」。所有平台打开的都是同一个五步向导：1 选连接器 → 2 填凭证 → 3 测连接 → 4 配 mapping / 选模板 → 5 样例预览。
2. 选 EDI 平台（连接器），再填连接名称和零售商代码——如 WALMART。代码直接输入即可；Docklify 全站共用同一套零售商代码。
3. 勾选这个连接要用的报文集。入站 = 零售商 → Docklify，出站 = Docklify → 零售商。每个启用的报文集都应在第 4 步绑定一个 mapping。
4. 设置阶段先把测试模式和样例模式开着：这样真实报文进来之前，连接就能先建好、用样例报文测好、预览好。

第二步：填凭证，设失败告警#

• 凭证表单按该平台自己的字段清单生成——您只会看到这个平台真正需要的字段。密钥类字段是密码框，输入后永不回显。
• 失败告警在同一步设：连续失败 N 次后告警（默认 3）、连续失败 N 次后自动暂停（默认 10）——坏掉的连接会自己停下来，不会一直失败着去刷对方平台。
• 通知方式：站内通知默认开，邮件通知默认关。负责这个零售商的团队不常驻 Docklify 时，建议把邮件通知打开。

第三步：测连接#

1. 点「创建并测试连接」。Docklify 建好连接后立即跑测试：通过会显示「连接测试通过」和延迟；失败则用人话写清——发生了什么、下一步做什么，绝不显示堆栈。
2. 测试拉回到样例单据时，向导里会显示出来，并对它跑一次 Mapping 校验。校验列出问题时，先在第 4 步 / Mapping 工具里修复，再重新测试，然后才激活连接。

第四步：绑 mapping 或克隆模板#

• 给每个启用的报文集，要么绑定一个已有的 mapping，要么从模板库克隆一个模板。点完成时，克隆的模板会变成真正属于这个连接的 mapping。
• 也可以选「暂不绑定」先完成——但在 Integration → EDI → Mapping 里绑定之前，该报文集的传输都会失败，所以真实报文进来之前要绑好。

第五步：跑样例预览，然后完成#

1. 选要预览的报文集，把一份样例报文（JSON）粘贴到样例框里。
2. 点「试跑」。每个映射字段都会返回目标字段、源值、所用的函数链、输出值；失败时还有人话写的原因。
3. 全部字段通过后点完成。有字段失败，就去 Mapping 工具修好 mapping 再重跑预览——不要带着失败的预览点完成碰运气。

日常管理：在列表和详情里管连接#

• 列表里每个连接显示：平台、零售商、启用的报文集、模式（测试/样例开着时有标记）和状态。行操作有测试、详情和删除——删除连接会一并删除它的凭证。
• 连接上的开关可以在不删任何东西的情况下暂停或恢复它——零售商让您先停发一阵时就用它。
• 点详情打开连接抽屉：健康（近 24 小时）显示成功率和连续失败次数——正常、异常（已到告警阈值）或已暂停——还有告警/自动暂停配置、上次连接测试，以及最近传输（带重试和重放按钮）。

Mapping：零代码翻译报文#

1. 打开 Integration → EDI → Mapping（/integration/edi/mappings）。从「+ 新建 Mapping」开始，或打开模板库 tab，克隆一个已经符合您的平台和报文集的模板。
2. 在编辑器里给 mapping 起名，选报文集和方向，然后逐行搭：点选或拖拽源字段到一行上，设目标（Canonical）字段，串联函数——也可用常量、代码表查表和可选条件——直到这一行产出正确的值。
3. 在编辑器里用样例测试，然后激活。必填字段还没映射完时激活会被拦住——编辑器会明确列出缺哪几个。
4. 每次保存都生成新版本。点版本历史可以看历史版本：选两个版本对比（新增/删除/修改了哪些行），或回滚——回滚会把那个版本打开在编辑器里，和任何修改一样，激活前先测试。

代码表：Mapping 引用的查表#

• 打开 Integration → EDI → 代码表（/integration/edi/code-tables），点「+ 新建代码表」。表名用小写下划线命名——如 upc_to_sku、uom_map、carrier_map——再给它一个看得懂的说明。
• 条目就是简单的成对值：From（零售商发来的值）→ To（Docklify 用的值），外加可选备注。常见表翻译零售商 ship-to 代码、计量单位和承运商代码——运营在这里自己维护，不用写代码。
• 重复的 From 值会标红——保存前先修复，因为一个 From 只能对应一个 To。长列表用导入 CSV（粘贴 from,to,note 格式、每行一条；重复的会被跳过），导出 CSV 可把表下载下来。
• 保存代码表会生成它的新版本。Mapping 引用的是「表 + 版本」，所以在这里改表不会悄悄改变已经激活的 mapping。

传输日志：跟踪每条报文，修好失败的#

• 打开 Integration → EDI → 传输日志（/integration/edi/transmissions）。按状态、报文集或方向筛选，或按业务号 / 平台单号搜索。状态都是大白话：已收到、已映射、已完成、失败、重复报文、死信、待回执。
• 点一条传输的详情，能看到收到的原始报文和 mapping 后的 Canonical 形态，连同状态和回执——合作伙伴说报文「不对劲」时，先查这一对。
• 错误是写给人看的：一个标题、发生了什么、下一步做什么。可重试的错误行上有「可重试」标记和重试按钮。重试也修不好的错误——认证失败、Mapping 错误——不显示重试按钮：先修好凭证或 mapping，再用重放拿原始报文重跑（失败和死信的传输可用）。

本文用到的 Docklify 功能#

• EDI 连接五步向导：选连接器、填凭证、测连接、配 mapping / 选模板、样例预览 —— Integration → EDI → 连接 → + 新建连接（/integration/edi/connections）
• 连接详情：近 24 小时健康、连续失败次数、告警/自动暂停配置与最近传输 —— Integration → EDI → 连接 → 详情
• 零代码 Mapping 编辑器：模板库、样例测试、版本历史、版本对比与回滚 —— Integration → EDI → Mapping（/integration/edi/mappings）
• 带版本管理的代码表：查重、CSV 导入/导出 —— Integration → EDI → 代码表（/integration/edi/code-tables）
• 传输日志：人话报错、重试与重放 —— Integration → EDI → 传输日志（/integration/edi/transmissions）