接 B2BGateway：订单进来，发货与发票出去（EDI）
向您的 B2BGateway 客户团队索取 Base URL，从 B2BGateway 账号复制 API Key，两项都填进 Integration，测试、按交易伙伴配 Mapping、激活——订单报文流进来，发货与发票报文流出去。
B2BGateway 连接器经 B2BGateway 与您的交易伙伴交换 EDI 报文：伙伴的采购订单报文进来变成订单，发货与发票报文再发回给同一伙伴。它不是店铺连接——一切按交易伙伴、按报文类型组织，所以每个伙伴都要单独配、单独验。
前置条件#
- 一个 B2BGateway 账号。Base URL 不是自己去查的公开地址——由您的 B2BGateway 客户团队按您的账号提供。
- 能拿到该 B2BGateway 账号里的 API Key，或有能提供它的人。这个 Key 会在每次请求里以 X-API-Key 请求头发出。
- 至少有一个经 B2BGateway 交换报文的交易伙伴。这个连接不会替您新建伙伴——伙伴那一侧的交换关系要先存在，它的报文才能流动。
- 第一次连接先用一个伙伴的测试报文把配置验通——不要拿正式伙伴的报文试新 Mapping。
拿凭证#
- 向您的 B2BGateway 客户团队索取您账号的 API Base URL，并按他们给的样子原样复制。它以 https:// 开头——如果对方给的地址看着不完整，请让他们确认，不要自己猜后半截。
- 从您的 B2BGateway 账号拿到 API Key。如果在账号里找不到，问您的 B2BGateway 客户团队这个账号在哪里显示它——不要拿另一个账号的 Key 顶替。
- 把两个值放在一起保管：Base URL 决定连接跟哪里说话，API Key 证明这是您的账号。下一步两个都要填。
填进 Integration#
- 打开 Integration → 连接器市场 → B2BGateway → 新建连接。
- 接口地址 Base URL（必填）：粘贴客户团队给您的 B2BGateway API 接口地址，例如 https://…。整个地址原样复制——少一个字符、多一个空格、或填了另一个账号的地址，下一步测试都会失败，哪怕 API Key 是对的。
- API 密钥 API Key（必填）：粘贴您 B2BGateway 账号的 API Key。连接与 B2BGateway 通信时，它会以 X-API-Key 请求头发出。它按密钥存储、加密保存，保存后永不回显。
- 保存连接，但先不要激活。先测试，再配交易伙伴 Mapping——凭证填对了但没配伙伴映射，连接照样一份报文都动不了。
测试连接#
点测试连接。测试会访问您填的 Base URL，并把 API Key 以 X-API-Key 请求头带上，所以地址和 Key 是一起验的：通过，说明 B2BGateway 有回应且接受了您账号的 Key。然后拿一个交易伙伴的一条真实订单报文跑单据级预览，先看清"伙伴字段 → 标准订单"对照再上线。如果还没有伙伴发过测试报文，先请伙伴——或您的 B2BGateway 客户团队——发一条；预览需要一条真实报文。测试本身失败时对照下面的常见问题：先分清是 Base URL 还是 API Key 的问题，不要两个一起改。
配 Mapping / 选模板#
B2BGateway 的 Mapping 按交易伙伴配，不是整个连接一个设置。每个伙伴选该伙伴的模板，并核对与它交换的报文类型：订单报文入站，发货与发票报文出站。在预览里确认伙伴的标识、货号、数量和收货信息都落进标准订单的正确字段，您的发货与发票数据也映射回伙伴期望的字段。伙伴之间不共用一份 Mapping——一个伙伴配完可以先上线，另一个伙伴可以还在配置中；新伙伴的第一份正式报文之前，永远要单独做一次它自己的 Mapping 核对。
激活#
激活后，已配好映射的交易伙伴的订单报文会流进来变成订单；这些订单发出后，发货与发票报文会经 B2BGateway 发回给伙伴。先在 运行监控 / 日志里盯每个伙伴的首批报文——还没配映射的伙伴不会交换报文，所以每个伙伴的第一单、第一次发货、第一张发票都要单独确认，无误后再放手跑。
常见问题#
测试失败：API Key 被拒绝
填进连接的 API Key 与您 B2BGateway 账号上的 Key 对不上。这个 Key 以 X-API-Key 请求头发出，所以错一个或少一个字符、粘贴时带了尾随空格、或填的是另一个 B2BGateway 账号的 Key，在 B2BGateway 看来都一样：不是您的 Key。
从您的 B2BGateway 账号重新拿一次 API Key——找不到就问客户团队这个账号在哪里显示它——粘进 API 密钥字段，前后不要带任何多余字符，保存后重新测试。不要同时改 Base URL，这样才能分清是哪个改动起了作用。
测试失败：连接连不上 B2BGateway
填进连接的 Base URL 错了，请求根本到不了您账号对应的 B2BGateway 地址。地址是手敲的、被截短的、或从另一个账号抄来的，都会这样——API Key 完全正确，测试照样过不去。
请您的 B2BGateway 客户团队确认您账号准确的 API Base URL，把接口地址字段替换成那个地址的完整原文——以 https:// 开头，不增不减——保存后重新测试。
测试能通过，但某个交易伙伴的报文不流动
那个交易伙伴的 Mapping 还没配，或还没配完。连接测试只证明地址和 API Key 没问题——报文是按伙伴流动的，没配完映射的伙伴，没有东西能转换它的订单报文，也没有通道发它的发货与发票报文，哪怕同一连接上的其他伙伴都正常。
打开该伙伴的 Mapping 步骤，选该伙伴的模板，把与它交换的报文类型配好——订单入站、发货与发票出站——再用该伙伴的一条真实报文跑单据预览。预览里每个字段都落对位置后，再开通该伙伴的交换，并在 运行监控 / 日志里核对它的首批正式报文。