接 Cleo Integration Cloud：经伙伴 mailbox 交换 EDI 文件
填入您的 Cleo 实例地址和 Cleo 管理员发放的 mailbox 用户名与密码，测试登录、逐个伙伴配映射、激活——EDI 文件经伙伴 mailbox 流进流出。
Cleo 连接器经您 Cleo Integration Cloud 实例里的伙伴 mailbox 与交易伙伴交换 EDI 文件：新文件到达 mailbox 的下载文件夹后变成订单，发货通知、发票等出站文件再经 mailbox 上传回去。这个连接不用 API 密钥对——Cleo 里没有要找的 Client ID。您用的是实例地址加一个 mailbox 账号登录，下面一步步讲清。
前置条件#
- 一个您能登录的 Cleo Integration Cloud 实例，以及它的地址——就是您在浏览器里打开 Cleo Integration Cloud 或 Harmony 用的那个地址。
- 实例里已为您要交换文件的伙伴建好一个伙伴 mailbox。mailbox 的用户名和密码由您自己的 Cleo 管理员在建伙伴 mailbox 时发放。
- 至少一个文件经该 mailbox 走的交易伙伴——例如采购订单进来，发货通知和发票回去。
- 开工前先向您的 Cleo 管理员确认一件事：您的实例有没有对 API 调用开启 API Key 校验。只有开启了才需要 API Key——多数实例没开，多数人这个字段留空。
拿凭证#
- 记下您的 Cleo 实例地址。它就是您登录 Cleo Integration Cloud 或 Harmony 用的地址，例如 https://mycompany.cleointegration.com。它就是下一步要填的 Base URL——必填，且必须是您自己的实例，不能填共享地址或示例地址。
- 向您的 Cleo 管理员索取伙伴 mailbox 的用户名和密码。它们是建 mailbox 时成套发放的，连接就是用这个账号登录并收发文件——它是您实例里的一个 mailbox 账号，除非管理员特意设成一样，否则它不是您的个人登录账号。
- 密码丢了不要猜：由您的 Cleo 管理员在您的 Cleo 实例里重置 mailbox 密码，您再用新密码。实例之外没有单独给这个连接用的密码找回页。
- 只有管理员确认您的实例对 API 调用要求 API Key 时：再向他们索取那个 API Key，和 mailbox 凭证放一起保管。如果实例不要求，您不需要别的了——不要去找 Client ID 或 Client Secret，这个连接不用它们。
填进 Integration#
- 打开 Integration → 连接器市场 → Cleo → 新建连接。
- Base URL：您的 Cleo 实例地址，例如 https://mycompany.cleointegration.com。这个字段必填。按您登录时用的样子原样粘贴——地址错了，下一步的测试就无处登录。
- Mailbox Username（邮箱用户名）：您的 Cleo 管理员在建伙伴 mailbox 时发放的 mailbox 用户名。填 mailbox 账号本身，不要填个人邮箱地址。
- Mailbox Password（邮箱密码）：与该用户名成套发放的密码。它加密存储，永不回显。日后您在 Cleo 实例里重置了这个密码，记得回到这里一并更新，否则连接将无法登录。
- API Key（可选）：除非您的实例对 API 调用开启了 API Key 校验，否则这个字段留空。只有开启了，才粘贴管理员给您的 API Key。留空是多数实例的正常情况——这里为空不代表连接没填完。
测试连接#
点测试连接。测试会用 mailbox 用户名和密码登录您填的 Base URL，并换取一个登录 token。通过只说明一件事：实例地址能到达、且该 mailbox 账号能登录。测试不会下载或上传任何 mailbox 文件，也不会检查您的下载与上传文件夹——所以测试通过本身不代表 EDI 文件已经能流动。文件夹与伙伴的配置在下一节讲；如果能登录但文件不动，下面的常见问题讲了要查什么。
配 Mapping / 选模板#
Cleo 按文件交换工作，所以 Mapping 围绕伙伴的 mailbox 文件夹、按交易伙伴逐个配。每个伙伴选它自己的模板，核对两个方向：从 mailbox 下载文件夹拉进来的入站文件——例如采购订单文件（850）——应落成标准订单，订单号、行明细、数量、收货信息都在对的位置；出站结果——由履约生成的发货通知（856）和发票（810）——应按该伙伴期望的文件格式写好，并放到经 mailbox 上传的位置。同时确认该伙伴在 EDI 连接设置里的新文件下载文件夹与出站文件上传文件夹已经配好：这些文件夹与前面四个凭证字段是两回事，文件夹或映射缺失的伙伴，即使测试通过，它的报文也没有落点。激活前，用每个伙伴的一份真实文件看一遍映射预览。
激活#
激活后，Integration 按您设的频率从伙伴 mailbox 的下载文件夹拉新文件，把订单文件变成订单，并把出站文件——发货通知和发票——经 mailbox 上传回去、送达各伙伴。只有文件夹与映射都配好的伙伴才会流动；被跳过的伙伴在配置完成前不会有动静。先在 运行监控 / 日志里盯每个伙伴的头几份文件，确认无误再放手跑。
常见问题#
测试失败：登录被拒
连接上的 mailbox 用户名或密码与您 Cleo 实例里的 mailbox 账号对不上，或者密码在您填进来之后又在实例里被重置过。测试只走到登录这一步，所以这一步被拒永远是地址或 mailbox 账号本身的问题——与文件夹、映射无关，测试根本走不到那里。
先检查 Base URL，确认是您自己的实例地址、与您登录时用的完全一致。然后请 Cleo 管理员确认 mailbox 用户名；如果密码可能变过，请他们在实例里重置 mailbox 密码。把当前密码粘进连接，保存后重新测试。
找不到 Client ID，API Key 字段也让人困惑
您的 Cleo 设置没有问题——这个连接本来就没有 Client ID。Cleo 在这里用的是实例登录，而不是 API 密钥对，所以从来不会为它签发 Client ID 或 Client Secret。API Key 字段是另一个有条件的附加项：只有实例开启了 API Key 校验时才用得上，多数实例并没有开启。
不要再找 Client ID，只填实例地址和 mailbox 用户名与密码即可。API Key 字段留空，除非您的 Cleo 管理员确认您的实例要求 API Key——那种情况下向他们索取并粘贴进去。然后测试连接。
测试通过，但伙伴的 EDI 文件一直不来
登录是通的，说明地址和 mailbox 账号没问题。缺口在登录之后：测试根本不碰 mailbox 的文件和文件夹，所以某个伙伴仍可能缺下载文件夹配置、上传文件夹配置或映射——缺了这些，它的文件就没有地方被取走，永远变不成订单。
请 Cleo 管理员确认伙伴 mailbox 确实在收该伙伴的文件，然后打开该伙伴的 EDI 连接设置，检查新文件下载文件夹与出站文件上传文件夹都已配好。再按上面 Mapping 一节把该伙伴的映射配完，用一份真实文件核对一遍，并去 运行监控 / 日志盯该伙伴的下一份文件。
订单进得来，但发货通知与发票文件到不了伙伴那里
入站是通的，说明 mailbox 及其下载一侧没问题。缺口在该伙伴配置的出站一侧：它的上传文件夹，或发货通知（856）与发票（810）的出站映射从没配完，履约结果没有文件可搭，自然回不去。
打开该伙伴的 EDI 连接设置与映射，把出站一侧配完：上传文件夹，加上按该伙伴期望的文件格式配的 856 与 810 映射。用一个已履约的订单看映射预览，然后去 运行监控 / 日志盯给该伙伴的下一份出站文件。