よくある質問の記事一覧

APIで実行対象のデータベースを変更する際は、IDの書き換えだけでなく「インポート設定の列構成」の再確認が必要です。

API連携（CSVデータインポートAPIやCSVファイルインポートAPIなど）において、接続先のデータベースを切り替える場合、プログラム上の「データベースID（dbSchemaId）」や「インポート設定ID（importId）」を書き換えるだけでは不十分なケースがあります。

システムの正確性を保つためのセキュリティ制限や、データベースごとのインポートルールの違いにより、処理が失敗したり、API上は正常終了しているのにデータが登録されなかったりする事象が発生します。

主な事象

過去の問い合わせデータやFAQでは、データベースの切り替え時に以下のようなトラブルが報告されています。

• APIを実行すると「403：アクセスが拒否されました」というエラーが返ってくる。
• APIのレスポンスは「complete（成功）」となっているのに、対象のデータベースを確認してもレコードが1件も登録されていない。
• 手動でのインポートは成功するのに、API経由で同じIDを指定するとエラー（400：パラメータが不正です）になる。

これらのトラブルは、主に「接続許可設定」や「パラメータの記述ルール」の見落としが原因です。以下の確認・対処手順に沿って設定を見直してください。

エラーを解消するための確認・対処手順

1. インポート設定の「列の並び順」と「項目数」がCSVファイルと一致しているか確認する

API上は正常終了しているのにデータが登録されない場合、指定した「インポート設定ID（importId）」の内容が、送信しているCSVファイルの構造と合致していない可能性があります。手動インポートと異なり、APIでは「設定とファイルの不一致」が原因で全行がスキップされることがあります。

【確認箇所】 DB設定 ＞ 機能設定 ＞ インポート一覧 ＞ 該当設定の「項目設定」

【確認・対処手順】
1. 切り替え先のデータベースに作成した「インポート設定」を開きます。
2. 「項目設定」画面で、設定されている項目の数と並び順が、APIで送信するCSVファイルの列構成と完全に一致しているか確認してください。
3. 不要な列がある場合は「スキップ項目」を配置し、不足している場合は項目を追加してください。項目数や並び順が1つでもズレていると、入力検証エラーにより登録がスキップされます。

2. JSONパラメータの「大文字・小文字」が正確か再チェックする

APIリクエスト時に送信するJSONパラメータ（dbSchemaId, importId, keyIdなど）は、大文字と小文字を厳密に区別します。プログラムをコピー＆ペーストして作成した際に、一部の文字が異なっていると「パラメータが不正です（400エラー）」となります。

【確認・対処手順】
1. リクエストボディのJSONを確認します。
2. 例えば「KeyId」と記述している場合、正しくは「keyId」です。マニュアルに記載された正確なパラメータ名（例：dbSchemaId, importId）と一字一句違わないか、スペルミスがないかを確認してください。

3. APIトークンを発行したユーザーの「全体権限」と「DBアクセス権」を確認する

API実行に使用している「APIトークン」に紐づく実行ユーザーが、新しく指定したデータベースに対して適切な権限を持っていない場合、インポート設定（importId）を正しくロードできず処理が失敗します。

【確認箇所】 管理者設定 ＞ ユーザー設定 ＞ ユーザー管理 ＞ [対象ユーザーの「設定」および「アクセス権」]

• 【必要な機能権限】：
  ユーザーの基本設定にて、全体権限の「DB設定」権限にチェックが入っているか確認してください。
• 【必要なデータベースアクセス権】：
  対象のユーザー（または所属するユーザーグループ）に対し、接続先のデータベースの「参照」アクセス権および「管理」アクセス権が100%付与されているか確認してください。
  特に「管理」アクセス権がないデータベースに対しては、APIによるインポート設定の呼び出し、および失敗時のエラーログ（エラーデータ.csv）のダウンロードがシステム仕様上制限され、アクセス拒否（403）となります。

関連マニュアル

詳細な仕様の違いや作成手順については、下記記事をご確認ください。

API連携の接続先URLやパラメータの詳細に関するマニュアル

CSVエクスポートやインポートAPIの正式なエンドポイントURL、リクエスト形式の具体例について解説しています。
API連携オプション：設定方法

インポート設定の項目紐付けに関するマニュアル

CSVファイルの列とデータベース項目を正しく対応させるための「項目設定」の手順や、スキップ項目の活用方法について記載しています。
インポート一覧：項目設定

API連携でエラーが発生した際のトラブルシューティング

403エラー（アクセス拒否）や400エラー（パラメータ不正）の具体的な原因とチェックリストをまとめています。
API連携オプション：エラー「アクセスが拒否されました。」と表示された

（記事ID：2924）

レコード登録APIにおいて、従属項目の自動取得設定を有効にしながら一部の項目に任意値を指定して登録することはできません

現在の「楽楽販売」のAPI連携の仕様では、レコード登録APIのリクエストパラメータにおいて、関連マスタから従属項目を自動取得する設定（"getSubordinate": "1"）を有効にしている場合、リクエスト内容（values内）に含まれる従属項目への値指定は受け付けられない仕組みとなっています。

この自動取得が有効な状態で、valuesパラメータ内に従属項目の値を指定して送信すると、システムの整合性を保つための制限バリデーションにより、以下のエラーが発生してレコードの登録処理全体が強制ロールバック（失敗）されます。

• レスポンスHTTPステータス： 400 Bad Request（パラメータ不正）
• エラーコード（code）： 100
• エラーメッセージ（msg）：
  「従属項目を取得する場合は、従属項目に値を指定することができません。」

そのため、特定の従属項目にのみ外部システムから独自の文言を上書きして登録したい場合は、お手数をおかけしますが、以下の代替案による連携プログラムの設計・構築をご検討ください。

従属項目の一部に任意値を登録するための「2つの解決代替案」

自動取得機能の稼働と任意値の直接指定を1回のリクエストで共存させることはできませんが、APIのパラメータ指定方法や実行手順を工夫することで、安全に目的のデータ登録を実現することが可能です。

代替案1： getSubordinate を 0 に設定し、送信元の外部システム側で全従属項目の値を組み立てて送信する

「楽楽販売」側での自動取得に頼らず、連携元の外部システム（kintone、基幹システム、連携ツールなど）側で、マスタから引用する値と独自に上書きしたい値をあらかじめすべてマージ・構築してから送信する方法です。

【設定・実行手順】：
1. レコード登録APIのリクエストパラメータにて、"getSubordinate": "0" を明示的に指定します（またはパラメータ自体を記述しない）。
2. 外部システム側のプログラムにて、対象レコードの「DBリンク項目」に紐づくすべての従属項目の値を事前に準備します。
3. 上書きしたい従属項目には独自の文言を、それ以外の従属項目にはマスタから取得した値をセットし、一つのJSON valuesパラメータとして「楽楽販売」へ送信します。
※この方法は、すべての従属項目の値を外部から明示的に引き渡す必要があるため、外部システム側でマスター情報を一時的、または永続的に保持・参照できる開発環境に適しています。

代替案2： APIを2回に分けて実行し、1回目の登録で自動取得させた後、2回目の更新で特定項目のみを上書きする

「楽楽販売」のマスタ自動取得機能を活かしつつ、登録後に特定の項目だけを任意の外部データで修正する方法です。

【設定・実行手順】：
◆1回目：レコード登録APIの実行（新規追加）
・パラメータを  "getSubordinate": "1" に設定し、マスタに紐づくDBリンク項目（キー値）を指定してリクエストを投げます。
・これにより、すべての従属項目が「楽楽販売」内のマスタデータに基づいて自動的に入力された状態でレコードが新規作成されます。
◆2回目：レコード更新APIの実行（値の書き換え）
・1回目の登録成功レスポンスから作成されたレコードのIDを取得し、そのIDを更新キー（"id" または "keyId"）に指定します。
・パラメータは "getSubordinate": "0" を指定し、上書きしたい特定の従属項目に対してのみ、外部システムから任意の値を  values に格納してリクエストを送信します。従属項目は一度データベースに登録されれば、通常のテキスト項目や数値項目と同様に自由に上書き更新が可能です。

※この方法は、APIを複数回連続して実行（シーケンシャル処理）できるプログラム構成である場合に有効な回避策となります。

注意事項

getSubordinateが「1」でも、2階層目以上の「従属項目の従属項目」は空欄のまま登録されます

業務データベース ➔ マスタデータベース ➔ 親マスタデータベース のように、従属項目を数珠繋ぎ（ネスト）にして2段階以上遡ってデータをコピーする設定をデータベース（データベース）側に施している場合、レコード登録APIにおける自動従属取得は「直近の1階層目（子の従属項目）」しか自動実行されません。
2階層目以降（孫の従属項目）はAPI実行時には完全に無視され、空欄（値なし）のままレコードが登録されます。 ネスト構造の従属項目がある場合は、アプローチAで外部からすべて値を指定して送信するか、手動で一括再取得を行う設計にしてください。

データベース設定に「初期値」があってもAPI登録時は空欄になり、必須項目エラーが発生します

楽楽販売のデータベース項目設定で、対象項目に「初期値（デフォルト値）」を定義していても、APIでのレコード登録時にはその設定は適用されず、送信データに含めない限り空欄（null）として処理されます。
そのため、必須項目だからと「初期値が設定してあるから大丈夫だろう」とAPIの values パラメータから除外して送信すると、「'○○'を入力してください。（エラーコード100）」というパラメータ不正エラーが発生し、登録全体が失敗します。
API実行時は、必須項目にはすべて明示的に値を直接指定してリクエストを送信してください。

お問い合わせフォームよりご要望をお寄せください。

「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。

現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。

関連マニュアル

APIを利用したデータの登録・更新に関する詳細仕様、およびエラー発生時の詳細な解決手順については、サクセスナビの下記記事をご確認ください。

API連携オプション：設定方法に関するマニュアル

外部システムから「楽楽販売」へAPI（POSTメソッド）を投げる際のURL形式、認証ヘッダ（X-HD-apitoken）の記述方法、JSONパラメータの構成規則、および送信可能なデータ型の詳細を解説しています。
API連携オプション：設定方法

（記事ID：2940）

レコード更新APIで送信データに含まれない明細行を自動的に削除することはできません

現在の「楽楽販売」の仕様では、レコード更新APIを用いて明細行（テーブル形式の項目）を更新する際、リクエストデータに含まれていない既存の明細行を自動で判別して削除する機能はありません。

「楽楽販売」のAPIは、指定された更新キー（明細キーなど）に基づいて特定の行を書き換える、あるいは新しい行を追加する仕組みとなっています。
そのため、例えば元々4行あった明細に対して3行分の更新データのみを送信した場合、システム側では「残りの1行を削除する」という判断は行わず、指定されなかった4行目のデータはそのままデータベースに残る挙動となります。

また、レコード削除APIについても「レコード単位（親データごと）」の削除を目的とした機能であり、特定の明細1行のみを指定してピンポイントで削除するリクエストには対応していません。

お問い合わせフォームよりご要望をお寄せください。

「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。

現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。

API連携および明細更新に関する仕様とマニュアル

APIの正式なリクエスト形式や、自動処理における明細更新のロジックについては、下記記事をご確認ください。

API連携オプションの基本仕様と設定マニュアル

外部システムから「楽楽販売」へリクエストを投げる際の接続先URLや、JSON形式のパラメータ指定例について詳しく解説しています。
API連携オプション：設定方法

自動処理における明細更新の4つのパターン

APIではなく「楽楽販売」内部の自動処理で明細を更新する際の挙動（末尾に追加、すべて削除してから追加など）について記載されています。APIでのデータ構成を検討する際の参考になります。
自動処理設定：「レコード更新」パーツ

（記事ID：2923）

外部システムから「楽楽販売」のデータを取得するには、CSVエクスポートAPIに対してAPIトークン認証を用いたPOSTリクエストを実行することで設定可能です

「楽楽販売」のAPI連携オプションを利用することで、手動でのCSVエクスポート操作を介さずに、外部システム（基幹システムなど）から直接データを抽出・連携できるようになります。

これにより、バックアップ取得の自動化やシステム間のデータ同期の工数を大幅に削減し、データの正確性を保つことが可能です。

接続に必要なエンドポイントURL・HTTPメソッド・認証方式の仕様

CSVエクスポートAPIを実行するための基本情報は以下の通りです。接続先のURLは、ご利用中の環境ごとに固有のドメイン（サーバー名）とアカウント名（スキーマ名）を含める必要があります。

• エンドポイントURL：
  https://【ドメイン】/【アカウント】/api/csvexport/version/v1
• HTTPメソッド： POST
• 認証方式： APIトークン認証（HTTPヘッダに指定）
• HTTPヘッダ設定：
  Content-Type: application/json; charset=utf-8
  X-HD-apitoken: [発行したAPIトークン]

外部システムから送信するリクエストパラメータの設定例（JSON形式）と各項目の意味

リクエストのボディには、取得対象のデータベースや抽出条件を特定するためのパラメータをJSON形式で記述します。一度に取得する件数（limit）や開始位置（offset）を指定することで、大量のデータを分割して安全に取得することも可能です。

{
"dbSchemaId": "101406",
"searchId": "100809",
"listId": "100001",
"limit": 200,
"offset": 0
}

【各パラメータの解説】

• dbSchemaId： 対象データベースのIDです。
• searchId： 抽出に使用する「絞込み設定」のIDです。
• listId： 出力形式（列の並び順）を規定する「レコード一覧画面設定」のIDです。※指定しない場合は「ID」の降順かつ、一覧表示が「すべて」の初期項目でエクスポートされます。
• limit： 一度にエクスポートするレコード件数です（※上限値はプランによって厳格に異なります）。
• offset： データの取得開始位置（スキップ行数）です。

【APIトークン発行】と【APIアクセス制限（IP登録）】の手順

APIを実行するためには、操作を行うユーザーに紐づく「APIトークン」を事前に発行することに加え、送信元の接続グローバルIPアドレスをシステムに登録しておくことが必要です。

手順1：ユーザー管理画面から「APIトークン」を発行する

【設定箇所】 管理者設定＞ユーザー設定＞ユーザー管理

1. ユーザー一覧より、APIトークンを発行する対象ユーザー（セキュリティのため、API連携専用ユーザーの作成を強く推奨します）の「設定」ボタンをクリックします。
2. 「APIトークン」欄にある「生成」リンクをクリックします。
3. ランダムな文字列（トークン）が生成されるので、内容をコピーして控えておきます。
4. 画面下部の「確定」ボタンをクリックします。※「確定」を押さないと、生成されたトークンが有効になりませんのでご注意ください。

手順2：APIのアクセス制限（接続元IPアドレス登録）を登録する

【設定箇所】 管理者設定＞セキュリティ設定＞IPアクセス制限に関する設定

1. セキュリティの共通仕様として、「IPアドレス制限サービス」オプションの契約有無にかかわらず、APIを利用する際はアクセス元のグローバルIPアドレス登録が100%必須です。
2. 「APIのアクセス制限」欄に、リクエストを送信してくる外部システムサーバー等のグローバルIPアドレスを入力し、「確定」をクリックします。未登録のIPからのリクエストは、トークンが正しくてもすべて「403 Forbidden（アクセスが拒否されました）」として強制遮断されます。

URLの構成要素である「ドメイン」と「アカウント」を確認する方法

エンドポイントURLを作成する際に必要となる「ドメイン」と「アカウント」は、普段ログインに使用しているブラウザのURLから確認できます。

【確認例】
ログインURLが https://sv01.rakurakuhanbai.jp/sample_ac/top/main の場合

• ドメイン： sv01.rakurakuhanbai.jp （サーバー名を含むドメイン）
• アカウント：  sample_ac （ドメインの直後のスラッシュに続く文字列※ログインIDではありません）

お問い合わせフォームよりご要望をお寄せください。

「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。

現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。

関連マニュアル

詳細な仕様の違いや作成手順については、サクセスナビの下記記事をご確認ください。

API連携の全体的な設定方法と仕様書

外部システムとの連携設定手順書（PDF）をダウンロードできます。
API連携オプション：設定方法

APIトークンの具体的な発行手順

ユーザーごとにAPIトークンを生成・確定して安全に管理・利用する方法について解説しています。
API連携オプション：APIトークンの発行方法

サーバー名やURLアカウント（スキーマ）の確認方法

ご利用中の環境のドメインURLや、アカウント情報（スキーマ名）の確認方法、ログインIDとの違いについて解説しています。
「楽楽販売」の現在のバージョン／サーバー名の確認方法

API連携において1回あたりの上限（200件／10,000件）を超えるデータを連携したい場合

プランごとのエクスポート容量上限（2MB／10MB）やリクエスト数制限（20回／50回）、offsetとlimitパラメータを用いた具体的な分割取得・連結ループプログラムの設計パターンについて詳しく解説しています。
API連携オプション：リクエスト上限の回避方法

（記事ID：2922）

「楽楽販売」から「楽楽明細」へ、1回の連携実行で複数のPDFファイルを同時に送付することはできません

「楽楽明細」連携オプションの設定において「連携対象PDF」として指定できる項目は、1つの連携設定につき1つの「自動生成ファイル」項目のみです。

そのため、「請求書」のPDFが格納された項目と「納品書」のPDFが格納された項目の2つを、1回の連携操作（ボタンクリックやタイマーによる自動起動）で同時に「楽楽明細」へ送付・連携する機能はありません。

「請求書」と「納品書」の両方をユーザーの手元に届けるためには、運用に合わせて以下の代替案による設定をご検討ください。

複数のPDFファイルを効率的に「楽楽明細」へ連携するための代替案

システム上の制限により、別々の項目にある2つのファイルを一度に送ることはできませんが、帳票の作成方法や連携設定を工夫することで、実質的に複数の帳票情報を「楽楽明細」へ届けることが可能です。

1つのExcel雛形の「1シート目」に請求書と納品書の両方のレイアウトを配置し、1つのPDFファイルとして生成・連携する

「楽楽販売」のPDF出力オプションの仕様では、Excel雛形に複数のシートが存在する場合でも、PDFとして生成されるのは「1シート目」のみです。

この仕様を活かし、Excel雛形の1シート目の中に、上部に「請求書」、下部に「納品書」といった形で両方のレイアウトを並べて作成します。 この雛形を使用して自動処理の「ファイル生成」パーツを実行すれば、1つのPDFファイルの中に請求書と納品書の両方のページが含まれた状態で生成されます。
この「1つのPDF」を「楽楽明細」連携の対象項目に指定することで、1回の連携実行で両方の書類を取引先へ届けることが可能になります。

帳票種別ごとに「楽楽明細」連携設定を個別に作成し、それぞれのメニューから順番に連携を実行する

「請求書連携用」と「納品書連携用」の2つの連携設定を「楽楽明細連携設定」画面にて個別に作成します。 作成したそれぞれの設定を、レコード一覧メニューの「処理設定」にて「ボタン」や「プルダウン」として割り当てます。
ユーザーは一覧画面において、まず「請求書を連携」ボタンを押し、次に「納品書を連携」ボタンを押すという2ステップの操作を行うことで、それぞれのPDFファイルを「楽楽明細」へ送付できます。 1回での完了はできませんが、ファイル自体を分けたい場合にはこの運用が適しています。

お問い合わせフォームよりご要望をお寄せください。

「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。

現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。

関連マニュアル

詳細な仕様の違いや作成手順については、下記記事をご確認ください。

「楽楽明細」連携の設定方法に関するマニュアル

連携に必要なURLやAPIトークンの設定、連携対象とするPDF項目の指定方法について詳しく解説しています。
「楽楽明細」連携オプション：設定方法

PDF出力時の制限事項に関するマニュアル

PDF生成時に「1シート目のみが対象となる」仕様や、利用可能なフォント、改ページに関する注意点が記載されています。
PDF出力オプション

（記事ID：2921）

「インポート状況確認」画面、または「受信メール一覧」画面より実行結果の確認が可能です。

メールボックスオプションを利用して、受信したメールの添付CSVファイルを自動でインポート（一括登録・更新）した場合、その処理が正常に完了したか、あるいはエラーが発生したかは、システム内の状況確認画面やメールボックスの管理画面から詳細を把握できます。

特に、手動でのインポートとは異なり、メール経由のインポートは「設定の作成者」が実行者として扱われるため、確認するユーザーの権限設定によっては「結果が表示されない」事象が発生することがあります。
以下の手順に沿って、適切な確認方法と設定をご確認ください。

他のユーザーが設定したインポート結果が「インポート状況確認」画面に表示されない原因と対処法

メールボックスオプションによるインポート結果を確認しようとした際、「インポート状況確認」画面に履歴が表示されない場合があります。
これは、メール経由のインポートが「インポート設定の作成者（または最終更新者）」の権限で実行されるという仕様に起因します。

「インポート状況確認」権限をユーザーに付与する

自分以外のユーザーが作成したインポート設定によって実行された処理結果を閲覧するには、専用の権限が必要です。
この権限がない場合、画面には自分が直接実行した操作や、自分が作成した設定の履歴しか表示されません。

【設定箇所】 管理者設定＞権限設定＞全体権限一覧

【設定手順】
1. 管理者権限を持つユーザーでログインし、「全体権限一覧」を開きます。
2. 結果を確認したいユーザーの氏名をクリックします。
3. 「インポート状況確認」の項目にチェックを入れ、「確定」ボタンをクリックします。
※この権限を付与することで、他のユーザーが作成したメールインポート設定の実行結果（成功・失敗件数やエラーデータ）もすべて参照できるようになります。

受信メール一覧から「処理名」と実行状況を確認する手順

権限設定を変更せずに、特定のメールに対してどのような処理が行われたかをクイックに確認したい場合は、メールボックスの管理画面から確認する方法が有効です。

メールボックスの「処理名」欄を確認する

【確認箇所】 管理者設定＞データ設定＞メールボックス設定＞[対象メールボックスの「設定」]＞受信メール一覧

【確認手順】
1. 対象のメールボックスの「受信メール一覧」を開きます。
2. 各メールの行にある「処理名」の欄を確認します。
3. インポート予約が正常に受け付けられている場合は、ここに「インポート設定名」と「対象データベース名」が表示されます。
4. 処理結果が「エラー」となっている場合は、メールの「参照」ボタンをクリックして詳細画面を開くことで、エラーの発生有無を確認できます。

インポート設定の「レポートメール」を活用して自動通知を受け取る方法

画面を見に行かなくても、インポートが完了したタイミングで結果をメールで受け取ることが可能です。
エラー発生時のみ通知させる設定もできるため、異常に素早く気付くことができます。

レポートメールの送信先を設定する

【設定箇所】 データベース設定＞機能設定＞インポート一覧＞[対象設定の「設定」]

【設定手順】
1. インポート設定の「全体設定」タブを開きます。
2. 「レポートメールなどの詳細設定を表示」をクリックして設定欄を展開します。
3. 「インポート完了時のレポートメール」または「インポートエラー時のレポートメール」にて、通知を受け取りたい宛先（実行者、管理者、または直接入力）を選択します。
※メール経由のインポートの場合、「実行者」は「設定の最終更新者」を指します。
4. 「確定」ボタンをクリックして保存します。

お問い合わせフォームよりご要望をお寄せください。

「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。

現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。

関連マニュアル

詳細な仕様の違いや作成手順については、下記記事をご確認ください。

インポートの実行状況やエラーデータの確認方法に関するマニュアル

インポート状況確認画面の見方や、エラーが発生した際の「エラーデータ.csv」のダウンロード手順について詳しく解説しています。
インポート一覧：インポートの実行

メールボックスの振分け設定と自動処理に関するマニュアル

受信したメールをどのようにインポート処理へ振り分けるか、その設定手順と仕様について解説しています。
メールボックスオプション：はじめに

記事ID：2920）

SSLクライアント証明書のインポート時に「信用されたルート証明機関ストアに証明書を追加中にエラーが発生しました」と表示される場合の対処方法

SSLクライアント認証を利用するために、OSへクライアント証明書をインポート（インストール）しようとした際、ウィザードの最終段階で「信用されたルート証明機関ストアに証明書を追加中にエラーが発生しました」というメッセージが表示され、完了できない場合があります。

このエラーは「楽楽販売」側のシステム不具合ではなく、OS側の強固なセキュリティ仕様によるものです。
インポート時の手順で、証明書を格納する場所（証明書ストア）を誤って手動で「信頼されたルート証明機関」に指定してしまっていることが原因です。

会社支給のパソコンなどでOSのセキュリティポリシーが厳格に管理されている場合であっても、以下の「正しい手順」に沿って証明書ストアを自動選択または個人ストアに指定し直すだけで、自社のセキュリティ制限を緩和させることなく、一般ユーザー権限のままその場で安全にインポートを完了させることができます。

エラーを解消するための「正しいインストール手順」と確認項目

OSのインポートウィザードを進める際は、以下の選択項目を確実に指定してやり直してください。

1. インポートの開始時に「現在のユーザー」を必ず選択する

証明書ファイル（例：○○.p12）をダブルクリックして「証明書のインポート ウィザード」が起動した際、最初の画面で「保存場所」の選択が求められます。

• ここでは、必ず「現在のユーザー」にチェックを入れて［次へ］をクリックしてください。
• 誤って「ローカル コンピューター」を選択してしまうと、パソコン全体のシステムストアへの書き込みとなり、OSの管理者権限（Administrator）が強制的に必要になってエラーになるか、インポート処理がブロックされてしまいます。

2. 証明書ストアの設定で「自動的に選択」または「個人」を指定する

パスワード入力後の「証明書ストア」の選択画面が、今回のエラーが発生した直接の原因です。

【解決策】：

•  画面上の選択肢で、「証明書の種類に基づいて、自動的に証明書ストアを選択する」（デフォルト推奨）にチェックを入れてそのまま［次へ］進めてください。
• もし手動でストアを指定したい場合は、必ず「証明書をすべて次のストアに配置する」にチェックを入れ、［参照］ボタンから「個人」ストアを選択してください。
• 手動設定時に、誤って「信頼されたルート証明機関」や「エンタープライズの信頼」などのストアを選択して保存しようとすると、一般ユーザーからのシステム中枢ストアへの証明書追加がOSのプログラムによって強制遮断され、エラーメッセージが表示されます。「個人」ストアに配置すれば、楽楽販売は問題なく証明書を読み込むことが可能です。

3. インストール中の「セキュリティ警告」画面では「はい」をクリックする

ウィザードの完了直前に、「セキュリティ警告：次の証明機関から証明書をインストールすることをお勧めしません。…この証明書をインストールしますか？」という警告ポップアップが表示されます。

• 【仕様上の理由】： 楽楽販売が提供するSSLクライアント証明書は、外部のパブリックな有料認証局から購入しているものではなく、「ラクスのサーバーで独自に作成した自己署名証明書（プライベート独自証明書）」を使用しているため、OS側が警告を出すのが正常な仕様（動作）です。
• システム上の不具合ではありませんので、警告画面が出た場合はそのまま「はい（信頼する）」をクリックして完了させてください。「正しくインポートされました」と表示されれば、正常に動作します。

SSLクライアント認証運用時の注意事項

証明書のインポート完了後、日常の運用時やスマートフォンでのテスト時に、ユーザーからお問い合わせが殺到するブラウザ特有の制限仕様があります。

1. 【セッションロック】証明書選択を「キャンセル」すると、ブラウザを再起動するまで毎回アクセスエラーになります

SSL認証URLにアクセスすると、初回やブラウザ起動時に「証明書の選択ダイアログ」が表示されます。
このダイアログが表示された際、ユーザーが誤って何も選ばずに「キャンセル」をクリックしてしまったり、対象外の別の古い証明書をクリックして進もうとした場合、ブラウザ側に致命的なキャッシュが働きます。

• ブラウザは、そのブラウザセッションの間「このユーザーは証明書を提示しなかった（あるいは間違った証明書を提示した）」という結果を通信キャッシュとして強固に記憶します。
• そのため、一度キャンセルしてしまうと、以降はページを再読み込みしたり、タブを閉じて開き直したりしても、証明書選択画面が二度と表示されなくなり、「このサイトにアクセスできません（ERR_SSL_PROTOCOL_ERROR / ERR_CONNECTION_CLOSED）」などのエラー画面が表示され続け、ログインが永久に拒否されます。
• 【解決手順】： この事象に陥った場合は、起動しているブラウザ（ChromeやEdgeなど、開いているすべてのウィンドウとタブ）を一旦完全にすべて閉じてから、ブラウザを再度起動し直してください。これによりセッションキャッシュがクリアされ、再び「証明書の選択ダイアログ」が表示されるようになります。
  または「InPrivateウィンドウ（シークレットモード）」でURLを開き直すことでも、その場で選択ダイアログを再表示させることができます。

2. 【スマートフォンでの制限】iOS（iPhone/iPad）では、Safari以外のブラウザではログインできません

スマートフォンやタブレットは、楽楽販売のシステム仕様上「動作保証対象外（サポート範囲外）」の環境となりますが、もしiPhoneやiPad（iOS / iPad OS）端末にクライアント証明書（.p12ファイル）をプロファイルとしてインストールして運用をテストされる場合、Apple社（iOS）の厳格なセキュリティ仕様制限を考慮する必要があります。

• iOSのインフラ仕様上、システムにインストールしたクライアント証明書を読み取って通信に付加できるブラウザアプリは、標準ブラウザである「Safari」のみに制限されています。
• もし、iOS端末上のGoogle ChromeやEdge、Gmailアプリ経由のリンクブラウザなどで楽楽販売のSSL認証URLにアクセスしようとした場合、OSによる制限で証明書を読み込むことができず、「このサイトにアクセスできません」というエラー（ERR_CONNECTION_CLOSED）が発生してログインすることはできません。
• 【解決手順】： iPhone/iPadからSSLクライアント認証経由で楽楽販売を利用する場合は、必ず「Safari」ブラウザアプリから直接SSL認証URLを開く運用を徹底してください。

関連マニュアル

詳細な仕様の違いやインストール手順については、サクセスナビの下記記事をご確認ください。

SSLクライアント証明書の標準的なインストール手順

Windows環境（Google ChromeおよびMicrosoft Edge）において、管理者画面からの証明書のダウンロード、パスワード設定、インポートウィザードでの「現在のユーザー」や「自動選択」を用いた詳細な設定ステップを画面付きで網羅しています。
SSLクライアント認証サービスオプション：設定方法

【FAQ】スマートフォン／タブレットにおけるSSLクライアント認証でのログイン方法と注意点

iOS（iPhone/iPad）やAndroid端末における、証明書インストールの考え方、サポート対象外（動作保証外）であることの定義、およびiOSにおける「Safariブラウザ必須（Chrome等利用不可）」の制限仕様について詳しく解説しています。
スマートフォンでのログイン方法

（記事ID：2939）

「楽楽販売」のメール解析機能で、注文内容に応じて項目が動的に増減する本文を1つの設定で網羅することはできません

メールボックスオプションの「メール解析設定」において、受信メールの本文構造（項目の並び順や改行位置、スペースの数など）が1文字でも設定した「本文パターン」と異なると、システムは正しく値を抽出できず「解析不可」となります。

そのため、「注文があった商品カテゴリのみが本文に表示される」といった、注文内容によって項目数や行数が無数に変動するメールの場合、理論上は想定されるすべての本文パターンを「振分け設定」として個別に作成し、優先順位をつけて登録する必要があります。

しかし、組み合わせパターンが膨大になる場合、すべての設定を個別に作成・メンテナンスすることは現実的ではありません。
この課題を解決するためには、メールを受け取る側の設定を増やすのではなく、送信されるメールの「形式」そのものを固定化する代替案が有効です。

変動する注文メールを効率的に取り込むための代替案

既存の「変動する本文」に合わせて設定を量産するのではなく、運用を工夫することで設定を1つに集約し、取り込みの安定性を高める方法をご案内します。

送信元のメールシステム側で、注文の有無に関わらず全項目が含まれる「固定フォーマット」に統一する

最も効率的な回避策は、注文が入った項目だけを表示させるのではなく、送信元のシステム（ECサイトの注文フォームなど）の設定を変更し、常にすべての項目名が本文に記載される「固定フォーマット」のメールを送信するように調整することです。

例えば、カテゴリA〜Dまである場合、カテゴリBの注文しかなかったとしても、本文には「カテゴリA：(空欄)」「カテゴリB：10個」「カテゴリC：(空欄)」といった形で、すべての項目を必ず出力させます。
このように本文の構造を固定化することで、「楽楽販売」側の「本文パターン」を1種類に絞ることができ、設定の工数とメンテナンスの負担を大幅に削減できます。

この際、繰り返し発生する明細情報（商品名や数量など）については、###LOOP:BEGIN### と  ###LOOP:END### のパラメータを活用してパターン化することで、行数の増減にも柔軟に対応できます。

実際のシステム連携を開始する前に、個人のメールソフトからテスト送信を行い解析精度を確認する

送信元システム（注文フォーム等）の改修には工数がかかるため、まずは管理者が普段利用しているメールソフト（GmailやOutlookなど）を使用して、想定している「固定フォーマット」のメールを「楽楽販売」の受信用アドレスへ手動で送信し、期待通りの解析結果が得られるか検証してください。

「楽楽販売」のメール解析は、全角・半角の違いやスペースの数、改行コードの差異に非常に敏感です。手動送信によるテストで「解析不可」が発生しないことを確認してから、大元の注文メール送信システムの設定変更（固定化）を進めることで、構築後の「やっぱり取り込めなかった」という手戻りリスクを事前に排除できます。

お問い合わせフォームよりご要望をお寄せください。

「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。

現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。

メール解析設定時の注意点とマニュアル

メール解析を設定する際は、使用するパラメータの種類や、解析に失敗する具体的な原因を把握しておくことが重要です。詳細については、下記記事をご確認ください。

メール解析で使用できるパラメータ一覧と設定手順

1行の抽出（WORD）や複数行の抽出（LINE）、繰り返しの抽出（LOOP）など、本文構造に合わせたパラメータの使い分けについて詳しく解説しています。
メールボックスオプション：設定方法

メール解析が「解析不可」で失敗する場合の原因と対策

スペースの有無や改行数のズレなど、現場で発生しやすい解析エラーの具体例と、それらを解消するためのチェックポイントをまとめています。
メールボックスオプション：解析がうまくいかない・失敗する場合の原因と対策

（記事ID：2919）

管理者設定の「通常URLへのアクセス制限」を有効にすることで、ログアウト後も自動的にSSL認証URLのログイン画面が表示されるようになります。

「楽楽販売」のSSLクライアント認証オプションをご利用の際、初期状態では通常URL（証明書を必要としないURL）へのアクセスが許可されています。
この状態では、画面右上の「ログアウト」をクリックした際の遷移先が標準の通常URLログイン画面となる仕組みになっています。

システム全体のセキュリティレベルを統一し、ログアウト後の再ログイン時にも常にSSLクライアント証明書による認証を求める（SSL認証URLを表示させる）ためには、管理者設定にて通常URLへのアクセスを遮断する設定を行う必要があります。

【設定箇所】 管理者設定＞セキュリティ設定＞SSLクライアント認証に関する設定

設定手順

以下の手順で設定を有効にしてください。
なお、この設定は「SSL認証URL」からログインしている状態でなければ変更できません。
通常URLからログインしている場合は、設定画面内のチェックボックスがグレーアウトし、「確定」ボタンも表示されない制限がかかるため、必ず証明書による認証を通した状態で操作を行ってください。

1. SSL認証URLから「楽楽販売」にログインします。
2. 画面右上の「管理者設定」をクリックし、「セキュリティ設定」タブ内の「SSLクライアント認証に関する設定」を開きます。
3. 「通常URLへのアクセス制限」という項目にある「SSL認証URLからのアクセスのみ可能にする」のチェックボックスにチェックを入れます。
4. 「確定」ボタンをクリックします。
5. 「通常URLからのアクセスができなくなりますがよろしいですか？」というアラートが表示されるので、「OK」をクリックします。

※この設定を確定した瞬間から、ログアウト時の遷移先がSSL認証URLのログイン画面に切り替わります。 また、ブラウザのブックマーク等から通常URLへアクセスしようとしても、自動的に接続が拒否されます。

設定前の重要な注意点：全ユーザーのパソコンへの証明書インストールを完了させてください

「通常URLへのアクセス制限」を有効にすると、証明書がインストールされていないパソコンからは一切ログインができなくなります。
管理者がこの設定を有効にする前に、必ず「楽楽販売」を利用するすべてのユーザーのパソコンに対して、クライアント証明書のインストール作業が完了していることを確認してください。
万が一、未インストールの状態で制限をかけると、そのユーザーはシステムにアクセスできなくなるため、現場の運用に支障をきたす恐れがあります。

自動送信メール内のURLに関する仕様と注意点

通常URLへのアクセス制限を行った後の、自動送信メール内のURLの挙動は以下の通りです。運用に合わせて記述方法をご確認ください。

• 自動的にSSL認証URLへ切り替わるケース：
  自動処理の「メール送信」パーツなどで、ターゲット機能の「URLを記載」を使用して挿入されたURLは、制限設定後に自動でSSL認証URLへと切り替わります。
• 自動で切り替わらないケース：
  メール本文内に直接テキストとして通常URLを「直打ち（コピー＆ペースト）」して記載している場合は、システム側で自動的に書き換えることはできません。制限設定後はリンク切れの状態となるため、手動でSSL認証URLへ修正していただく必要があります。

お問い合わせフォームよりご要望をお寄せください。

「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。

現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。

関連マニュアル

詳細な仕様の違いや作成手順については、下記記事をご確認ください。

SSLクライアント認証の導入から設定までの全体マニュアル

証明書のダウンロード方法や、各ブラウザへの具体的なインストール手順について詳しく解説しています。
SSLクライアント認証サービスオプション：設定方法

（記事ID：2918）

「楽楽明細」連携を含むシステム連携は、自動処理のタイマー実行よりも先に処理が開始される仕様です。

「楽楽販売」のシステム全体のタイマー実行フローにおいて、システム連携（「楽楽明細」連携を含む）と自動処理は、実行される「グループ」が明確に分かれています。
実行順序は、まず「システム連携」グループに属するすべての処理が完了した後に、「自動処理」グループの実行が開始されるという固定のルールがあります。

そのため、「楽楽明細」連携の設定画面で「タイマー優先度」の数値を高く設定しても、それはあくまでシステム連携グループ内での実行順序を早めるためのものであり、自動処理グループに属するタイマー実行の順序を追い越したり、その優先度に影響を与えたりすることはありません。

【設定箇所】 データベース設定＞システム連携＞楽楽明細連携設定＞タイマー設定

システム連携と自動処理のタイマー実行における優先順位と実行フローの全容

タイマー起動（一括実行）は、指定した日の午前1時から順次開始されますが、複数の処理が予約されている場合は以下のフローで1つずつ実行されます。
同時に複数の処理が並列で動くことはありません。

1. システム連携グループの実行（「楽楽明細」連携を含む）
まず、すべての「システム連携」および「楽楽明細」連携のタイマー設定が確認されます。
これらは設定されている「タイマー優先度」の数字が大きい順に1つずつ実行されます。

2. 自動処理グループの実行
上記「1」のシステム連携グループに属するすべての処理が完全に終了した後に、初めて「自動処理」グループのタイマー実行が開始されます。
自動処理同士の順序は、自動処理設定内の「タイマー優先度」に基づいて決定されます。

「楽楽明細」連携のタイマー優先度が自動処理側の実行順序に影響を与えない理由

「楽楽明細」連携はシステム上の分類として「システム連携」の一部として扱われます。
システム連携と自動処理は実行される「順番待ちの列（キュー）」が分かれているため、楽楽明細連携の優先度を「10」にし、自動処理の優先度を「1」にしたとしても、楽楽明細連携が自動処理の列に割り込んで先に実行されるといった相互の影響は発生しません。
これらは独立したフローとして、決められた順序（システム連携 → 自動処理）で処理されます。

タイマー実行が重なった場合の優先度判定ルール（優先度の数値と処理件数）

同じグループ内（システム連携同士、または自動処理同士）で実行タイミングが重なった場合、以下のルールに従って実行順序が決定されます。

• ルール1：「タイマー優先度」の数字が大きい処理を先に実行します。
• ルール2：同じ「タイマー優先度」が複数設定されている場合は、抽出される「処理件数（レコード数または明細行数）」が少ない順に実行されます。

※タイマー優先度および処理件数の比較対象は、その設定があるデータベース内だけでなく、ご利用の環境（「楽楽販売」の1ドメイン内）に設定されているすべてのタイマー設定が対象です。

お問い合わせフォームよりご要望をお寄せください。

「楽楽販売」はお客様から頂戴したご意見・ご要望をもとに、
よりよく、寄り添う 販売管理クラウドを目指してまいります。

現在の仕様ではご希望の機能に対応しておりませんが、
お客様からの貴重なご意見として真摯に受け止め、今後の改善に役立ててまいります。

関連マニュアル

詳細な仕様の違いや作成手順については、下記記事をご確認ください。

「楽楽明細」連携におけるタイマー設定の具体的な手順

「楽楽明細」連携を特定の時間に自動実行させるためのタイマースイッチの切り替えや、優先度の設定方法について解説しています。
「楽楽明細」連携オプション：設定方法

自動処理をタイマーで一括実行させるための設定と仕様

自動処理を深夜に自動起動させるためのスケジュール設定や、実行順序の決まり方、強制終了時の挙動について詳しく記載されています。
自動処理設定：一括実行（タイマー起動）

（記事ID：2917）