接 Rithum（Dsco）：订单进来，ASN 与发票报文出去
拿到 Rithum 供应商账号的 Client ID 与 Client Secret，API 基址留空走生产、想先试就填沙箱地址，测试、配好交易伙伴映射、激活——订单流进来，ASN 与发票报文流回去。
Rithum 连接器经 Rithum 网络（Dsco API v3）与零售商交换 EDI 报文：交易伙伴的订单报文流进来变成订单，ASN 与发票报文再流回去给伙伴，库存也走同一个连接交换。它不是店铺登录授权——一切按交易伙伴、按报文组织。
前置条件#
- 一个 Rithum（Dsco）供应商账号。这个连接用的 API 凭证属于该供应商账号——不是店铺登录账号。
- 能联系上您的 Rithum 开户对接人：Client ID 与 Client Secret 是为您的供应商账号成对发放的，还没有的话就找开户对接人拿。
- 至少一个在 Rithum 上与您交换报文的交易伙伴（零售商）——订单进来、ASN 与发票出去。每个伙伴后面都要单独配映射。
- 先定好第一次连接用哪个环境：API 基址留空走生产，或填沙箱地址先试连。确切地址见下面填进 Integration 一节。
拿凭证#
- 在您的 Rithum 供应商账号里，到 API / 开发者设置处找 API 凭证：Client ID 与 Client Secret。它们属于供应商账号、成对发放——两个都要。
- 那里没有 API 凭证的话，向您的 Rithum 开户对接人索取。就说需要供应商账号的 API Client ID 与 Client Secret。
- 把两个值完整复制并妥善保存。这一对必须配套使用：一对里的 Client ID 配另一对的 Client Secret 是用不了的。
- Client Secret 丢了就请 Rithum 重新发放——连接里保存后永不回显，丢了没法从连接里找回来。
填进 Integration#
- 打开 Integration → 连接器市场 → Rithum → 新建连接。
- API Base URL（API 基址，选填）：留空即走生产——连接会去 https://api.dsco.io/api/v3。想先对沙箱试连，就改填 https://staging-api.dsco.io/api/v3。只能原样填这两个地址之一、或留空——不要填别的系统的地址。
- Client ID：粘贴为您的 Rithum 供应商账号发放的 Client ID。注意不要和 Client Secret 填反——ID 填这个字段，Secret 填下一个。
- Client Secret：粘贴与 Client ID 同一对发放的 Client Secret。它加密存储，永不回显。
测试连接#
点测试连接。测试分两步，两步都过才算连通。第一步用您的 Client ID 与 Client Secret 向 Rithum 换取访问令牌（token）；第二步拿这个 token 去调用您所选 API 地址上的 /hello 探针——基址留空时是生产地址，填了沙箱地址时就是沙箱地址。通过说明两步都成了：凭证被接受、Rithum API 有回应。失败时留好测试给出的报错——它会说明断在换 token 一步还是 /hello 一步，下面的常见问题逐种讲了怎么处理。
配 Mapping / 选模板#
Rithum 的 Mapping 按交易伙伴配，不是整个连接一套设置。每个零售商伙伴选它自己的模板，核对它的订单报文怎么映射成标准订单——订单号、行明细、数量、收货信息——以及 ASN 与发票数据怎么映射回该伙伴期望的报文格式。没配映射的伙伴，报文没有落点：它的订单进不来，ASN 与发票报文也组不出来给它。测试连接通过只证明凭证和 API 地址可用——不代表任何伙伴已经配好映射。逐个伙伴配完，激活前逐个看映射预览。
激活#
激活后，已配映射的交易伙伴的订单报文会流进来变成订单，库存经这个连接交换，ASN 与发票报文经 Rithum 发回给各伙伴。没配映射的伙伴不会有动静——映射配好前，它那边什么都不会流动。如果您之前是对沙箱地址试连的，正式交易激活前先把 API 基址改回留空（生产）并重新测试。先在 运行监控 / 日志里盯每个伙伴的头几条报文，确认无误再放手跑。
常见问题#
测试在换 token 一步失败
Rithum 没接受这组凭证，token 没换到，测试根本没走到 /hello 那一步。常见原因：值复制不完整、Client ID 与 Client Secret 互相填反了位置，或者两个值来自不同的发放对——ID 与 Secret 只有按发放时的那一对配套才管用。
从供应商账号的 API / 开发者设置处重新复制两个值，确认 Client ID 进 Client ID 字段、Client Secret 进 Client Secret 字段，且来自同一次发放。手里没有 Secret 了、或拿不准两个值是不是同一对，就请 Rithum 开户对接人重新发放一对，两个值都填上，保存后重新测试。
token 换到了，但 /hello 探针没过
凭证被接受了——换 token 一步过了——但连接指向的 API 地址没有应答 /hello 探针，所以这个连接还不算连通。常见原因是 API 基址：填得和这个连接用的两个地址对不上、手改过，或者想测生产却还指着沙箱（反之亦然）。
把 API 基址设成两个地址之一，原样照填：走生产就留空（即 https://api.dsco.io/api/v3），对沙箱试连就填沙箱地址 https://staging-api.dsco.io/api/v3。保存后重新测试。地址原样填对了 /hello 还是不过，留好测试给出的报错，并去 运行监控 / 日志看一遍再试。
连接正常，但某个伙伴的订单一直进不来
连接本身是好的——测试能通过，其他伙伴可能也在正常流动。问题出在这个交易伙伴没有配映射，或者您连的还是沙箱地址、伙伴却在生产上发单，于是它的订单报文在这个连接上没有落点。
先看 API 基址：正式交易时应留空（生产）。再打开该交易伙伴的映射，选它的模板，用它的一条真实订单报文看映射预览——订单号、行明细、数量、收货信息都应落进标准订单。保存映射后，去 运行监控 / 日志看该伙伴的下一条报文。
订单进得来，但 ASN 与发票报文到不了伙伴那里
入站是通的，说明凭证和 API 地址都没问题。缺口在该伙伴映射的出站一侧：伙伴配了订单报文进来，但 ASN 与发票报文出去从没配上，履约结果没有报文可搭，自然回不去。
打开该交易伙伴的映射，把出站一侧也配上：ASN 报文和发票报文，按该伙伴期望的格式。用一个已履约的订单看映射预览，然后去 运行监控 / 日志盯该伙伴的下一条出站报文。