Rithum（Dsco）接続：注文取込、ASN・請求メッセージ送信
Rithum サプライヤーアカウントの Client ID と Client Secret を取得し、API ベース URL は本番用に空欄のままにするか、先に試す場合はサンドボックスのアドレスを入力、テスト、取引先マッピング設定、有効化を行います。
Rithum コネクタは Rithum ネットワーク（Dsco API v3）経由で小売業者と EDI ドキュメントを交換します。取引先からの注文ドキュメントが入り込んで注文になり、ASN と請求ドキュメントが取引先へ返送され、在庫も同じ接続で交換されます。ストアへのサインインではなく、すべて取引先ごと・ドキュメントごとに構成されます。
前提条件#
- Rithum（Dsco）サプライヤーアカウント。この接続の API 認証情報はそのサプライヤーアカウントに属するもので、ストアのログインではありません。
- Rithum の導入担当者に連絡できること。Client ID と Client Secret はサプライヤーアカウント向けにペアで発行され、まだ持っていない場合は導入担当者が提供します。
- Rithum 上でドキュメントを交換する取引先（小売業者）が少なくとも 1 社あること——注文の受信、ASN と請求書の送信。本ガイドの後半で取引先ごとにマッピングします。
- 最初の接続で使う環境を決めておくこと。API ベース URL を空欄にすれば本番、先に接続を試す場合はサンドボックスのアドレスを入力します。正確なアドレスは下の 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（任意）：このフィールドを空欄にすると本番になり、接続先は https://api.dsco.io/api/v3 になります。まずサンドボックスで接続を試す場合は、代わりに https://staging-api.dsco.io/api/v3 を入力してください。この 2 つのアドレスのいずれかを正確に入力するか、フィールドを空欄にしてください。他システムのアドレスは入力しないでください。
- Client ID：Rithum サプライヤーアカウント向けに発行された Client ID を貼り付けます。Client Secret と取り違えないでください。ID はこのフィールド、シークレットは次のフィールドです。
- Client Secret：Client ID と同じ発行ペアの Client Secret を貼り付けます。暗号化して保存され、再表示されることはありません。
接続テスト#
接続テストをクリックします。テストは 2 段階で実行され、両方通過して初めて接続が機能しているとみなされます。まず Client ID と Client Secret を Rithum と交換してアクセストークンを取得します。次にそのトークンを使って、選択した API アドレスの /hello チェックを呼び出します。ベース URL が空の場合は本番アドレス、入力した場合はサンドボックスのアドレスです。通過すれば両段階とも成功です。認証情報が受け付けられ、Rithum API が応答しました。失敗したらテストが表示するエラーを控えてください。トークンの段階で壊れたのか /hello の段階なのかが分かり、下の FAQ で各ケースを説明しています。
Mapping / テンプレート選択#
Rithum のマッピングは接続全体で 1 設定ではなく、取引先ごとに行います。小売の取引先ごとにその取引先のテンプレートを選び、注文ドキュメントが標準注文にどうマッピングされるか——注文番号、明細、数量、配送先情報——と、ASN・請求データがその取引先の期待するドキュメント形式にどう戻るかを確認してください。マッピング未設定の取引先はドキュメントの受け皿がなく、注文は入らず、ASN・請求ドキュメントも組み立てられません。接続テストの通過は認証情報と API アドレスが機能することの証明にすぎず、取引先のマッピングが済んだことにはなりません。取引先を 1 社ずつ進め、有効化前に各社のマッピングプレビューを確認してください。
有効化#
有効化後、マッピング済みの取引先からの注文ドキュメントが入り込んで注文になり、在庫が接続経由で交換され、ASN・請求ドキュメントが Rithum 経由で各取引先へ返送されます。マッピングのない取引先は沈黙したままで、マッピングを設定するまで何も流れません。サンドボックスのアドレスでテストした場合は、実際の取引で有効化する前に API ベース URL を空欄（本番）に戻して再テストしてください。無人で任せる前に、Runs / Logs で取引先ごとの最初のドキュメントを確認してください。
よくある質問#
テストがトークンの段階で失敗する
Rithum が認証情報を受け付けなかったため、トークンは発行されず、テストは /hello チェックに到達しませんでした。よくある原因は、値のコピーが不完全なこと、Client ID と Client Secret を互いのフィールドに入れてしまったこと、または 2 つの値が異なる発行ペアのものであることです。ID とシークレットは発行されたペアでのみ機能します。
サプライヤーアカウントの API / 開発者設定から両方の値をコピーし直し、Client ID が Client ID フィールドに、Client Secret が Client Secret フィールドに入り、両方が同じ発行ペアのものであることを確認してください。シークレットが手元にない場合、または値がどのペアのものか分からない場合は、Rithum の導入担当者に新しいペアの発行を依頼し、両方の値を入力して保存し、再テストしてください。
トークンは発行されるが /hello チェックが失敗する
認証情報は受け付けられました——トークンの段階は通過しました——が、接続が指す API アドレスが /hello チェックに応答しなかったため、接続はまだ接続済みとはみなされません。よくある原因は API ベース URL です。この接続が使う 2 つのアドレスと異なる入力になっている、手で編集されている、または本番をテストするつもりなのにサンドボックスを指したままになっている（その逆も）ことがあります。
API ベース URL を 2 つのアドレスのいずれか正確に設定してください。本番は空欄（https://api.dsco.io/api/v3）、サンドボックスでテストする場合はサンドボックスのアドレス https://staging-api.dsco.io/api/v3 を入力します。保存して再テストしてください。正確なアドレスでも /hello チェックが失敗する場合は、テストが表示するエラーを控え、再試行前に Runs / Logs を確認してください。
接続できているのに、ある取引先の注文が入ってこない
接続自体は正常で、テストも通り、他の取引先は流れているかもしれません。問題は、この取引先のマッピングが未設定であるか、取引先が本番で送信しているのに接続がサンドボックスのアドレスのままになっており、注文ドキュメントの受け皿がこの接続にないことです。
まず API ベース URL を確認してください。実際の取引では空欄（本番）であるべきです。次にその取引先のマッピングを開き、テンプレートを選び、実際の注文ドキュメント 1 件でマッピングプレビューを確認してください。注文番号、明細、数量、配送先情報がすべて標準注文に落ちるはずです。マッピングを保存したら、Runs / Logs でその取引先の次のドキュメントを確認してください。
注文は入るのに、ASN・請求ドキュメントが取引先に届かない
受信は動作しているため、認証情報と API アドレスに問題はありません。不足しているのはその取引先マッピングの送信側です。注文ドキュメントの受信は設定済みでも、ASN・請求ドキュメントの送信が未設定のため、履行結果を乗せて戻るドキュメントがありません。
その取引先のマッピングを開き、送信側も設定してください。ASN ドキュメントと請求ドキュメントを、その取引先が期待する形式で設定します。履行済みの注文でマッピングプレビューを確認し、Runs / Logs でその取引先への次の送信ドキュメントを確認してください。