Cleo Integration Cloud 接続：取引先メールボックス経由で EDI ファイルを交換

最終更新 2026-11-01

Cleo インスタンスのアドレスと、Cleo 管理者が発行したメールボックスのユーザー名・パスワードを入力し、サインインをテスト、取引先ごとにマッピングして有効化します。

Cleo コネクタは、Cleo Integration Cloud インスタンス内の取引先メールボックス経由で取引先と EDI ファイルを交換します。新しいファイルがメールボックスのダウンロードフォルダに届いて注文になり、出荷通知や請求書などの送信ファイルがメールボックス経由で戻ります。この接続は API キーペアを使いません。Cleo の中に探すべき Client ID はありません。代わりに、インスタンスのアドレスとメールボックスアカウントでサインインします。以下で順に説明します。

Cleo 接続手順：まずインスタンスアドレスとメールボックスアカウント、次にテスト、取引先マッピング、有効化。

前提条件#

サインインできる Cleo Integration Cloud インスタンスと、そのアドレス——ブラウザで Cleo Integration Cloud または Harmony を開くときに使うアドレスと同じもの。
ファイル交換する取引先向けに、そのインスタンス内に取引先メールボックスが設定済みであること。メールボックスのユーザー名とパスワードは、取引先メールボックス作成時に自社の Cleo 管理者が発行します。
そのメールボックス経由でファイルをやり取りする EDI 取引先が少なくとも 1 社あること——たとえば発注書の受信、出荷通知と請求書の送信。
開始前に Cleo 管理者に確認しておくこと：インスタンスで API 呼び出しに対する API Key チェックが有効になっているかどうか。有効な場合にのみ API Key が必要です。大半のインスタンスでは無効で、ほとんどの人はこのフィールドを空にします。

認証情報の取得#

Cleo インスタンスのアドレスを控えてください。Cleo Integration Cloud または Harmony にサインインするアドレスで、例は https://mycompany.cleointegration.com です。これが次の手順の Base URL になります。必須であり、共有アドレスやサンプルではなく、ご自身のインスタンスでなければなりません。
Cleo 管理者に取引先メールボックスのユーザー名とパスワードを依頼してください。これらはメールボックス作成時にセットで発行されたもので、接続はこのアカウントでサインインしてファイルを交換します。インスタンス内のメールボックスアカウントであり、管理者が同じに設定していない限り、個人のサインインとは別です。
パスワードを失った場合は推測せず、Cleo 管理者に Cleo インスタンス内でメールボックスのパスワードをリセットしてもらい、新しいパスワードを使ってください。この接続専用のパスワード回復ページはインスタンス外にはありません。
管理者が、インスタンスで API 呼び出しに API Key が必要だと確認した場合にのみ、その API Key も依頼し、メールボックスの認証情報と一緒に保管してください。必要でない場合は他に何も要りません。この接続では使わないため、Client ID や Client Secret を探さないでください。

Integration への入力#

Integration → コネクタマーケットプレイス → Cleo → 新規接続を開きます。
Base URL：Cleo インスタンスのアドレス。例：https://mycompany.cleointegration.com。このフィールドは必須です。サインイン時に使うとおりに正確にコピーしてください。アドレスが違うと、次の手順のテストでサインイン先がなくなります。
Mailbox Username：取引先メールボックス作成時に Cleo 管理者が発行したメールボックスのユーザー名。個人のメールアドレスではなく、メールボックスアカウント自体を入力してください。
Mailbox Password：そのユーザー名とセットで発行されたパスワード。暗号化して保存され、再表示されることはありません。後で Cleo インスタンス内でこのパスワードをリセットした場合は、ここも更新してください。更新しないと接続がサインインできなくなります。
API Key（任意）：インスタンスで API 呼び出しに対する API Key チェックが有効な場合を除き、このフィールドは空にしてください。その場合にのみ、管理者から受け取った API Key を貼り付けます。空にしておくのが大半のインスタンスでは通常であり、ここが空でも接続が未完成という意味ではありません。

接続テスト#

接続テストをクリックします。テストはメールボックスのユーザー名とパスワードで Base URL にサインインし、サイントークンに交換します。通過が意味するのは 1 つだけです。インスタンスのアドレスに到達でき、そのメールボックスアカウントでサインインできることです。テストはメールボックスのファイルをダウンロードもアップロードもせず、ダウンロードフォルダとアップロードフォルダも確認しません。そのため、テスト通過だけでは EDI ファイルがすでに流れる状態とは限りません。フォルダと取引先の設定は次のセクションで扱い、サインインできるのにファイルが動かない場合に何を確認するかは下の FAQ で説明します。

Mapping / テンプレート選択#

Cleo はファイル交換で動作するため、マッピングは取引先のメールボックスフォルダを中心に、取引先ごとに設定します。取引先ごとにその取引先のテンプレートを選び、2 つの方向を確認してください。メールボックスのダウンロードフォルダから取り込む受信ファイル——たとえば発注書ファイル（850）——は、注文番号、明細、数量、配送先情報が正しい位置に入った標準注文になること。そして送信結果——履行から生成される出荷通知（856）と請求書（810）——は、その取引先が期待するファイル形式で書かれ、メールボックス経由でアップロードできる場所に置かれること。また、その取引先の EDI 接続設定で、新規受信ファイル用のダウンロードフォルダと送信ファイル用のアップロードフォルダが設定済みか確認してください。これらのフォルダは 4 つの認証情報フィールドとは別物であり、フォルダやマッピングが欠けている取引先は、テストが通ってもファイルの受け皿がありません。有効化前に、取引先ごとの実際のファイル 1 件でマッピングプレビューを確認してください。

Cleo ファイルの往復：注文ファイルがメールボックス経由で入り、出荷通知と請求書ファイルが戻ります。

有効化#

有効化後、Integration は設定した頻度で取引先メールボックスのダウンロードフォルダから新しいファイルを取得し、注文ファイルを注文に変換し、送信ファイル——出荷通知と請求書——をメールボックス経由でアップロードして各取引先へ届けます。流れるのはフォルダとマッピングが設定済みの取引先だけです。スキップした取引先は設定が終わるまで沈黙したままです。無人で任せる前に、Runs / Logs で取引先ごとの最初の数ファイルを確認してください。

よくある質問#

テスト失敗：サインインが拒否される

接続のメールボックスのユーザー名またはパスワードが、Cleo インスタンス内のメールボックスアカウントと一致していないか、ここに入力した後にインスタンス側でパスワードがリセットされています。テストはサインインまでしか進まないため、この段階での拒否は常にアドレスかメールボックスアカウント自体の問題であり、テストが到達しないフォルダやマッピングの問題ではありません。

まず Base URL を確認し、ご自身のインスタンスのアドレスであり、サインイン時に使うものと完全に一致しているか確かめてください。次に Cleo 管理者にメールボックスのユーザー名の確認を依頼し、パスワードが変わっている可能性がある場合はインスタンス内でメールボックスのパスワードをリセットしてもらってください。現在のパスワードを接続に貼り付け、保存して再テストしてください。

Client ID が見つからず、API Key フィールドで迷う

Cleo の設定に問題はありません。この接続にはもともと Client ID がありません。Cleo はここで API キーペアではなくインスタンスへのサインインを使うため、Client ID や Client Secret が発行されることはありません。API Key フィールドは別個の条件付きの追加項目で、インスタンスで API Key チェックが有効な場合にのみ関係します。大半のインスタンスでは有効になっていません。

Client ID を探すのはやめて、インスタンスのアドレスとメールボックスのユーザー名・パスワードだけを入力してください。API Key フィールドは空のままにします。ただし、Cleo 管理者がインスタンスで API Key が必要だと確認した場合は、管理者にキーを依頼して貼り付けてください。その後、接続をテストしてください。

テストは通るのに、取引先から EDI ファイルが届かない

サインインはできているため、アドレスとメールボックスアカウントに問題はありません。不足はサインインの後にあります。テストはメールボックスのファイルやフォルダに一切触れないため、取引先のダウンロードフォルダ設定、アップロードフォルダ設定、またはマッピングが欠けている可能性があり、それらがないとファイルの取得先がなく、注文になることはありません。

Cleo 管理者に、その取引先のファイルを取引先メールボックスが受信しているか確認を依頼してください。次に、その取引先の EDI 接続設定を開き、新規ファイル用ダウンロードフォルダと送信用アップロードフォルダの両方が設定されているか確認してください。上の Mapping セクションでその取引先のマッピングを仕上げ、実際のファイル 1 件で確認し、Runs / Logs でその取引先の次のファイルを監視してください。

注文は入るのに、出荷通知と請求書ファイルが取引先に届かない

受信は動作しているため、メールボックスとそのダウンロード側に問題はありません。不足しているのはその取引先設定の送信側です。アップロードフォルダ、または出荷通知（856）と請求書（810）の送信マッピングが未完成のため、履行結果を乗せて戻るファイルがありません。

その取引先の EDI 接続設定とマッピングを開き、送信側を仕上げてください。アップロードフォルダに加え、その取引先が期待するファイル形式での 856 と 810 のマッピングです。履行済みの注文でマッピングプレビューを確認し、Runs / Logs でその取引先への次の送信ファイルを監視してください。