接 TrueCommerce：订单报文进来，发货与发票报文出去
向 TrueCommerce 客户经理索取接口地址，填入 API Key 或 OAuth 客户端凭证，测试、配好交易伙伴映射、激活——订单报文流进来，发货与发票报文流回去。
TrueCommerce 连接器经 TrueCommerce 与您的交易伙伴交换 EDI 报文：伙伴的订单报文流进来变成订单，发货与发票报文再流回去给伙伴。它不是店铺连接——一切按交易伙伴、按报文组织。
前置条件#
- 一个 TrueCommerce 账号，且能联系客户经理索取 API 接口地址和凭证。
- 至少一个与您交换 EDI 报文的交易伙伴——订单报文进来、发货与发票报文出去。每个伙伴后面都要单独配映射。
- 先定好这个连接用哪种认证方式：单独用 API Key，或没有 API Key 时用 OAuth 客户端凭证（Client ID + Client Secret）。两种方式二选一——不要把两套字段混着填。
拿凭证#
- 向您的 TrueCommerce 客户经理索取您账号的 API 接口地址（Base URL）。没有它连接填不了——所有报文交换都走这个地址。
- 如果用 API Key 方式：向 TrueCommerce 索取您账号的 API Key，并完整复制。用 API Key 时不需要填 OAuth 字段。
- 如果没有 API Key：改向 TrueCommerce 索取 OAuth 客户端凭证——OAuth Client ID 和 OAuth Client Secret。两个必须成套。
- 拿到 Client Secret 后立刻妥善保存：它只显示一次。丢了就请 TrueCommerce 客户经理重新签发。
填进 Integration#
- 打开 Integration → 连接器市场 → TrueCommerce → 新建连接。
- Base URL（接口地址）：粘贴客户经理给您的 TrueCommerce API 接口地址，以 https:// 开头。这个字段必填，且必须是 TrueCommerce 的地址——填成别的系统的地址不会有回应。
- API key：如果用 API Key 方式，把 TrueCommerce 的 API Key 粘到这里。如果用 OAuth 方式，这个字段留空——API key 留空就是告诉连接改走 OAuth 客户端凭证。
- OAuth Client ID：仅当 API key 字段留空时必填。粘贴 TrueCommerce 为您账号签发的 OAuth Client ID。已经填了 API Key 时，这个字段可以留空。
- OAuth Client Secret：仅当 API key 字段留空时必填，且与 OAuth Client ID 成套——两个必须来自同一次签发。它加密存储，永不回显。
测试连接#
点测试连接。测试会访问您填的 Base URL，并出示您所选方式的凭证——API Key，或 API key 留空时的 OAuth Client ID 与 Client Secret。通过说明该地址能到达 TrueCommerce、且凭证被接受。失败时留好测试给出的报错：它会说明是地址被拒还是凭证被拒，下面的常见问题逐种讲了怎么处理。
配 Mapping / 选模板#
TrueCommerce 的 Mapping 按交易伙伴配，不是整个连接一套设置。每个伙伴选它自己的模板，核对它的订单报文怎么映射成标准订单——订单号、行明细、数量、收货信息——以及发货与发票数据怎么映射回该伙伴期望的报文格式。没配映射的伙伴，报文没有落点：它的订单报文变不成订单，发货与发票报文也组不出来给它。逐个伙伴配完，激活前逐个看映射预览。
激活#
激活后，已配映射的交易伙伴的订单报文会流进来变成订单，发货与发票报文经 TrueCommerce 发回给各伙伴。没配映射的伙伴不会有动静——映射配好前，它那边什么都不会流动。先在 运行监控 / 日志里盯每个伙伴的头几条报文，确认无误再放手跑。
常见问题#
测试失败：凭证被拒
连接上的凭证与 TrueCommerce 为您账号签发的不一致。常见原因是要么复制不完整，要么方式只填了一半：API key 字段留空了——这会让连接改走 OAuth——但 OAuth Client ID 和 Client Secret 只填了一个，成套的凭证缺一半，自然不会被接受。
定一种方法并填完整。API Key 方式：粘贴完整 API Key，OAuth 字段留空。OAuth 方式：API key 留空，把同一次签发的 OAuth Client ID 和 OAuth Client Secret 两个都粘上——Secret 只显示一次，保存的那份丢了就请客户经理重新签发。保存后重新测试。
测试失败：根本连不上 TrueCommerce
连接里的 Base URL 填错了，测试敲错了门。常见原因：地址打错或粘贴时截断了、填成了别的系统的地址，或者客户经理给了新地址但连接里还是旧的——那个地址上没有 TrueCommerce 回应，凭证根本轮不到被检查。
请 TrueCommerce 客户经理确认您账号确切的 API 接口地址，把连接里的 Base URL 原样换成那个地址——以 https:// 开头——保存后重新测试。
连接正常，但某个伙伴的订单报文一直变不成订单
连接本身是好的——测试能通过，其他伙伴可能也在正常流动。问题出在这个交易伙伴没有配映射，或者它的模板覆盖不了它的订单报文，于是它进来的报文没有落点，永远变不成订单。
打开该交易伙伴的映射，选它的模板，用它的一条真实订单报文看映射预览——订单号、行明细、数量、收货信息都应落进标准订单。保存映射后，去 运行监控 / 日志看该伙伴的下一条报文。
订单进得来，但发货与发票报文到不了伙伴那里
入站是通的，说明地址和凭证都没问题。缺口在该伙伴映射的出站一侧：伙伴配了订单报文进来，但发货与发票报文出去从没配上，履约结果没有报文可搭，自然回不去。
打开该交易伙伴的映射，把出站一侧也配上：发货报文和发票报文，按该伙伴期望的格式。用一个已履约的订单看映射预览，然后去 运行监控 / 日志盯该伙伴的下一条出站报文。