よくある質問 (15)

電子帳簿保存庫において、紐づくデータベース内の「任意の項目値（テキストやキー項目）」を直接指定して検索することはできません

電子帳簿保存庫の検索機能（詳細検索）において、紐づいているデータベース側の「任意のオリジナル項目（例：独自のテキスト項目、管理番号、キー項目など）」をそのまま検索条件として直接マッピング追加して指定する機能はありません。

電子帳簿保存庫の検索機能は、電子帳簿保存法の法的要件（日付・金額・取引先の3項目による範囲・組み合わせ検索）に対応するため、システム仕様上、検索条件の入力（絞り込み）に利用できる項目が以下の内容に制限・限定されているためです。

電子帳簿保存庫で「検索条件（検索窓）」に指定できる項目	画面上に「表示」のみ可能な項目（検索窓での指定は不可）
取引年月日（範囲指定／直接指定／値なし）取引先（直接指定／値なし）取引金額（範囲指定／直接指定／値なし）タイムスタンプ付与状況（付与待ち／付与済み／エラー）ファイル名（直接入力による部分一致）備考（直接入力による部分一致）	保存No.（自動採番8桁）保存日（アップロードされた日）保存ユーザー名（処理を実行したアカウント）対象データベース名／対象データベース項目名レコードID（※元レコードへのアクセスリンク）

そのため、データベース側で管理している「独自の管理番号（請求No.、案件IDなど）」をキーにして電子帳簿保存庫内のファイルを直接特定したい場合は、以下のいずれかの代替設定案・構築テクニックをご検討ください。

電子帳簿保存庫で「独自の管理番号」を一瞬で特定できるようにする2つの代替・自動化設計案

【推奨：完全自動化】「取引先」マッピング欄に、文字連結した「取引先名＋管理番号」を割り当てる方法

楽楽販売の仕様上、電子帳簿保存設定における「備考」項目に対して、データベースの項目を自動で紐付ける（転記させる）連動機能はありません。
手動で備考を編集する手間をなくすため、「取引先」項目のテキスト（1行）特性を活かして、管理番号を100%自動で連動・格納させるテクニックを推奨します。

◆構築手順：
1. データベース側に「文字連結タイプ」の表示用項目を作成する
【設定箇所】：管理者設定＞データベース設定＞基本設定＞項目設定
・新項目（例：「電帳法用_取引先名」項目タイプ：文字連結）を追加します。
・連結数式に、「【選択レコード：取引先名】_【選択レコード：管理番号（請求No）】」を指定して保存します。これにより、レコード登録時に「株式会社ラクス_REQ10023」のようなテキストが自動生成されます。

2. 電子帳簿保存設定のマッピングを変更する
【設定箇所】：管理者設定＞データベース項目詳細設定＞電子帳簿保存設定
・「取引先」のプルダウン指定において、手順1で作成した「電帳法用_取引先名」項目を選択し、確定保存します。

3. 保存庫で検索を実行する
・ファイルが保存されると、保存庫の取引先欄には「株式会社ラクス_REQ10023」が完全自動で格納されます。
・保存庫画面の上部にある「取引先」検索窓に、管理番号である「REQ10023」と入力して検索するだけで、目的のファイルを特定できます。

代替案②：自動処理の「ファイル生成」パーツ設定で、ファイル名に管理番号（検索キー）の値を含める

電子帳簿保存庫の「ファイル名」は、部分一致による直接入力検索に対応しています。
帳票を自動生成する際のファイル名に、あらかじめ「管理番号」や「伝票番号」などの一意の値を組み込んでおくことで、ファイル名をキーワードにして検索できるようになります。

◆構築手順：
1. 「管理者設定＞データベース設定」＞「機能設定」＞「自動処理設定」から、対象のファイル生成処理の「詳細設定」を開きます。
2. 「ファイル名」の設定欄にて、プルダウンから「【選択レコード】」の項目（例：顧客Noや伝票No）を選択し、固定の文字列などと組み合わせて設定します。
（設定例：【選択レコード：顧客No】_請求書.pdf）
3. 設定を確定し、自動処理を実行してファイルを生成・保存します。
4. 電子帳簿保存庫の一覧画面上部にある「ファイル名」検索欄に、顧客Noなどの番号を入力して検索を行います。

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

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

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

ログ保存期間設定を「標準3ヶ月」と「延長1年」の合算（計15ヶ月）にすることはできません

ログの保存期間設定は「現在の期間に新しく期間を追加する」という仕組みではなく、「設定した期間そのもの」が全保存期間として適用される仕様です。

そのため、設定画面で「1年」を選択した場合は、標準の3ヶ月分に1年が追加されて15ヶ月になるわけではなく、標準分を含めて「合計12ヶ月（1年）」の保管となります。

ご希望の「15ヶ月間」のログをシステム内に保持するためには、お手数をおかけしますが、設定値を「1年」の次の選択肢である「3年」に変更していただく必要があります。

※ログ保存期間を延ばしても、過去の削除されたログは復元されません
ログの保存期間設定を「3ヶ月」から「3年」に長く変更した場合、すでに過去の自動クリーンアップ処理によってシステムから消去されてしまった過去の操作ログ（4ヶ月前〜3年前のログ）が復活・復元されることはありません。

変更を行った当日以降に発生する操作ログが、最長3年間消えずに残るようになる仕様（未来に対する設定変更）です。「今から設定を延ばせば過去のデータ変更履歴をさかのぼって調査できる」という遡及復元は不可能な仕様となっていますので、あらかじめご留意ください。

15ヶ月以上のログを効率的に保管しつつ容量不足を回避する代替案

ログの保存期間を延ばすと、システム全体の「使用容量」を圧迫する可能性があります。現場での作業負担を軽減しつつ、安全にログを管理するための代替案をご案内します。

代替案1：ログ保存期間を「3年」に変更し、超過分のデータ量に合わせて「容量追加オプション」を申し込む

「楽楽販売」の仕様上、直近3ヶ月分までの操作ログは使用容量にカウントされませんが、3ヶ月を超えて保管するログはすべて「使用容量」としてカウント対象になります。

代替案2：システム容量を消費しないよう、3ヶ月ごとに操作ログをCSV出力して外部へバックアップする

「ログの保管期間を延ばしたいが、システム容量は増やしたくない」という場合には、標準の3ヶ月設定のまま、定期的に手動でログを書き出す運用が有効です。
管理者設定の「ログ一覧」画面から、対象期間のログをCSV形式でエクスポートし、貴社のファイルサーバーやパソコンローカル環境へ保存してください。

【注意事項】
ログの保存期間が長く設定されていても、画面上で「操作日時」に指定して一度に検索・出力できる期間は最大3ヶ月までです。
ただし、自動処理やインポートが毎日頻繁に回っている環境では、3ヶ月分のログ件数が数百万件に及び、一気にエクスポートを試みると「メモリ枯渇によるシステムエラー」で処理が中断するか、ファイル生成がいつまでも終わらずにフリーズする場合があります。
その際は、一括で出力しようとせず、必ず「1週間単位」や「1日単位」など、自社の操作ログの件数に応じて、細かく期間を区切って分割エクスポートを行ってください。

ログ保存期間の設定変更とバックアップに関するマニュアル

設定を変更する際の手順や、CSV出力によるバックアップ方法については、下記記事をご確認ください。

全体詳細設定（ログに関する設定）に関するマニュアル

操作ログ・メール送信ログの保存期間（3ヶ月、6ヶ月、1年、3年、5年、削除しない）の切り替え手順や、詳細情報を保存するためのチェックボックス設定について解説しています。
全体詳細設定

操作ログの検索・CSV出力手順に関するマニュアル

過去の操作履歴を条件指定で検索する方法や、バックアップとしてCSVファイルを出力する際の画面操作手順が記載されています。
ログ一覧

現在の使用容量とライセンス上限を確認する方法

ログの保管によって増加した現在のデータ使用量や、ご契約の上限容量を反映させるための「使用容量を更新」ボタンの実行手順について解説しています。
ライセンス管理

ログの自動削除タイミングや容量削減に関するFAQ

期間を過ぎたログが毎日深夜帯に自動削除される際のシステム制限（1日最大300万件の上限バッチ仕様）や、手動の容量反映タイミングについての解説記事です。
ログの保存期間を確認する方法

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

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

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

（記事ID：2915）

操作ログを15ヶ月間保管する方法・設定手順

オプション
ログ

管理者が証明書を代理取得し、ファイルとパスワードを取引先へ安全に共有して各自でインストールを依頼する運用が推奨されます

SSLクライアント認証において、証明書ファイルをダウンロードする操作には「管理者設定」にアクセスできるシステム管理権限が必要ですが、ダウンロードした後の「パソコンへのインストール（インポート）作業」自体は、管理者権限のないパソコン上（一般ユーザー環境）であっても実施可能です。

そのため、社外の取引先様に「楽楽販売」の管理者権限を一時的に付与したり、管理者が1台ずつ取引先のパソコンを回って作業したりする必要はありません。
管理者が代表して取得した証明書ファイルを配布し、各自でインポートを完了してもらうことで、セキュリティを最高水準に維持したまま極めてスムーズに導入を進めることができます。

【取引先様へ：証明書の「安全性」に関する重要説明】
「楽楽販売」のSSLクライアント証明書は、セキュリティの仕様上「1つのご契約環境（1顧客）につき1つの共通ファイル（拡張子：.p12）」が発行されるため、社外のすべての取引先様へ同一のファイルを配布することになります。

「同じ証明書ファイルを使っているなら、他の取引先のデータが混ざって見えてしまうのでは？」と不安を抱かれがちですが、その心配はありません。
クライアント証明書はあくまで「楽楽販売のサーバー（玄関のオートロック扉）への接続を許可するもの」に過ぎません。ログイン後に「どのデータ（画面やレコード）の閲覧・編集を許可するか」は、個々の「ログインID・パスワード」および「データベース（ユーザーグループ）ごとのアクセス権限設定」で厳格に制御されています。
そのため、共通の証明書を配布しても、お互いのデータが流出・混在することは完全に防がれています。

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

設定・運用の具体的な手順

以下の5つのステップで運用を行うことで、管理者の作業負担を最小限に抑えつつ、取引先様のパソコンへ安全に設定を適用できます。

管理者による証明書とパスワードの取得
管理者権限を持つユーザーが「SSLクライアント認証に関する設定」画面へアクセスし、「SSLクライアント証明書をダウンロードする」ボタンをクリックしてファイル（.p12）を取得します。
あわせて「パスワードをコピーする」ボタンをクリックし、インポート用パスワードを控えておきます。

取引先様へのファイル・パスワードの共有（取扱厳重注意）
ダウンロードした証明書ファイルを、メールやファイル転送サービス、チャットツールなどを利用して取引先様へ送付します。

※【流出時の重大リスク】：取引先様のメール転送ミス等で証明書が外部に流出してしまった場合、鍵の無効化と再発行は可能ですが、共通の1ファイルを使用しているため、「鍵を更新した場合は、自社の社員および他のすべての取引先の全パソコンで、一から新しい証明書を再インストールし直す」という膨大な復旧作業が発生します。
これを防ぐため、証明書ファイルとインポート用パスワードは、絶対に同じメールやチャットに記載して送らないでください。
「ファイルは共有リンク」「パスワードは電話や別チャット」など、必ず別経路で厳重に共有する運用を徹底してください。

インストール手順（マニュアル）の案内
取引先様が迷わず作業できるよう、証明書ファイルと併せて下記の「設定マニュアル（サクセスナビ）」のURLを共有してください。数回のクリックで完了する手順のため、取引先様ご自身で対応が可能です。
SSLクライアント認証サービスオプション：設定方法

取引先様によるインストールと接続確認
取引先様にて、共有されたファイルとパスワードを使用し、各自のパソコンでインストール作業を実施していただきます。完了後、SSL認証専用のURLからログインできるかをご確認いただきます。

※【パソコン共有時の注意】：取引先様が1台のパソコンをシフト制等で「複数のWindowsログインアカウント」に分けて共用している場合、証明書は「OSのログインユーザー（ブラウザ）」単位で保持されるため、ログインするすべてのWindowsアカウントごとに個別にインポート作業を行う必要があります。

通常URLへのアクセス制限の有効化（管理者自身のログインURLに注意）
すべての取引先様のインストールが完了したことを確認した後、管理者が「SSL認証URLからのアクセスのみ可能にする」にチェックを入れて確定します。
これにより、証明書のない端末（通常URL）からのアクセスを完全に遮断できます。

※【管理者自身の前提手順】：この「通常URLへのアクセス制限」の有効化（チェックON）および確定は、通常URLからアクセスしている状態では、設定変更を誤って締め出されるのを防ぐためチェックボックスがグレーアウトして操作できません。
設定を有効にする際は、必ず管理者ご自身が自身のパソコンに証明書をインストールし、一旦「SSL認証URL」からログインし直した上で設定を確定させてください。

「楽楽販売」のシステムから各パソコンへ証明書を一括で自動インストールすることはできません

現在の「楽楽販売」の仕様では、サーバー側からネットワークを通じて遠隔で各ユーザーのパソコンへ証明書を直接送り込んだり、一括でインストールを強制適用させたりする機能（グループポリシーによる配布検証等）は備わっておりません。

これは、個々のクライアント端末のOSやブラウザが持つ厳格なローカルセキュリティ領域に干渉しないための仕様上の制限です。そのため、上記のように「セキュリティ経路を分けたファイル配布による、各自でのローカルインポート操作」を依頼する運用を行ってください。

電子帳簿保存庫のファイルを開く際、ブラウザ設定やセキュリティ環境によってアクセス権エラー画面に遷移する場合があります

主な事象

ユーザーに対して電子帳簿保存庫のフォルダやファイルへの「参照」アクセス権が正しく設定・付与されているにもかかわらず、保存庫に保管されているファイルリンク（PDFなど）をクリックした際、画面に
「アクセス権がありませんアクセスしたデータへのアクセス権が変更された可能性があります。詳細は設定の管理者にお問い合わせください。」
というエラーメッセージが別タブで表示され、プレビューやダウンロードが正常に行えない事象が特定のユーザーや端末にて報告されています。

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

エラーが発生した際は、問題の発生源が「ブラウザ側（拡張機能やキャッシュ）」にあるのか、あるいは「会社の社内ネットワーク全体」にあるのかを以下の手順に沿って順に切り分けて特定し、対処してください。

STEP1：ブラウザの「シークレットモード」で開けるかテストする（原因の切り分け）

【確認・テスト手順】
1. ブラウザ（Google ChromeまたはMicrosoft Edge）のメニューから「新しいシークレットウィンドウ」または「InPrivateウィンドウ」を開きます。
2. シークレットウィンドウから再度「楽楽販売」へログインし、電子帳簿保存庫の対象ファイルが開けるかお試しください。

シークレットモードで正常にPDF等が開けた場合：
原因は「ブラウザのキャッシュ情報」または「インストールされているブラウザ拡張機能（アドオン）」による干渉の可能性があります。後述の【対処方法①・②】を実施してください。

シークレットモードでも同様のエラーが表示される場合：
原因はブラウザではなく、パソコンのウイルス対策ソフトや社内ネットワーク全体のセキュリティポリシーです。後述の【対処方法③】を実施してください。

【対処方法1】PDFや広告ブロック関連の拡張機能を一時的に無効化する

【設定箇所】ブラウザの設定＞拡張機能

【対処手順】
1. ブラウザの拡張機能管理画面（chrome://extensions/ など）を開きます。
2. インストールされている拡張機能の中から、特に以下のタイプの拡張機能を「オフ（一時的に無効化）」にしてください。
・「Adobe Acrobat」などのPDF関連拡張機能
・「AdBlock」や「広告ブロッカー」などの広告カット・トラッキング防止用拡張機能（これらはリファラー情報を削除する代表例です）
3. 拡張機能をオフにした状態で、再度ファイルをクリックして開けるかご確認ください。無効化して開けた場合、該当の拡張機能に「楽楽販売」のURLを『ホワイトリスト（除外対象）』として登録することでも解消が可能です。

【対処方法2】ブラウザのキャッシュをクリアする

【設定箇所】ブラウザの設定＞プライバシーとセキュリティ＞閲覧履歴データの削除

【対処手順】
1. ブラウザの設定から「キャッシュされた画像とファイル」の削除（クリーンアップ）を実行します。
2. 削除を終えたら一度ブラウザのすべてのウィンドウを完全に閉じ、再度ログインし直してください。古い権限保持キャッシュが残っていた場合にこの手順で解消します。

【対処方法3】社内のネットワーク管理者（システム部門）へ設定変更を相談する

シークレットモードでも解消しない場合、社内ネットワーク（社内ファイアウォール、プロキシサーバー、ゲートウェイ設定）を管理するシステム担当部門において、「外部通信送信時にリクエストヘッダの『Referer（リファラー）情報』を自動で削除・カットして遮断するセキュリティポリシー」が適用されている可能性が極めて高いです。

システム管理担当者へ、「楽楽販売（*.rakurakuhanbai.jp のドメイン）との通信においては、仕様上正常なページ動作にReferer情報の送信が必須となるため、Refererを送信（有効化）するようにプロキシやFW等の除外設定を施してほしい」旨を直接ご相談いただけますようお願いいたします。

どうしても解決しない場合の「緊急回避手順」

社内のセキュリティポリシー変更が認められない等、どうしてもブラウザ上でファイルをクリックしてプレビュー閲覧できない場合は、以下の操作で安全にファイルをローカルへ取り出し、閲覧することが可能です。

【一括ダウンロードでの迂回】：
電子帳簿保存庫画面の下部に表示されている「一括ダウンロード」機能（プルダウンまたはチェックボックス一括選択でのダウンロード）をご利用ください。

この方法を用いて一度Zip形式でまとめてローカルパソコンへエクスポート（ダウンロード）を施した場合は、リファラー制限チェックの動作干渉を完全にバイパスすることができるため、エラーを発生させずに安全にファイルを展開・確認することが可能です。
日常業務が滞る場合の緊急対応策としてお使いください。

「楽楽販売」の各種API・インポート機能を利用して、URL項目の「ラベル」を登録・保持することはできません

レコード更新API、レコード登録API、および各種CSVインポート機能を用いてURL形式の項目を更新する際、APIパラメータに表示用の「ラベル」を個別に指定して登録する機能はございません。

また、APIを通じてURL項目の値を書き換えた場合、画面上で設定されていた既存のラベル情報はシステム側で自動的にクリア（削除）され、URLの文字列（生のURL）そのものが表示される仕組みとなっております。
※あらかじめURL項目の項目詳細設定にて「初期値のラベル」を設定していた場合であっても、APIによるレコード新規登録時はその初期値ラベルは適用されず、クリアされた状態（生URL表示）で登録されます。

そのため、APIで更新したURLに対して特定の名称（例：「詳細はこちら」「関連資料」など、または別項目の「商談ID」など）をラベルとして画面に表示させたい場合は、URL項目自体のラベル機能ではなく、一覧画面側の表示設定を工夫する代替案にてご対応いただく必要がございます。

URL項目のラベルが消える問題を画面表示上の工夫で解決する代替案

APIによるラベルの直接更新はできませんが、レコード一覧画面の「（URLリンク）」特殊表示項目を利用することで、APIで更新されたURLに対して、固定または動的な表示ラベル（ハイパーリンク）を自由に設置することができます。

この方法は、APIで更新している「URL項目そのもの」を画面に出すのではなく、そのURLを参照する「仮想的なリンクボタン」を一覧画面に配置する手順です。
これにより、APIでURLが何度更新されても、画面上では常に指定した綺麗なラベル名でリンクを表示し続けることができます。

【設定箇所】 DB設定＞表示設定＞レコード一覧画面設定

設定手順

1. 対象のレコード一覧画面の編集画面を開く
左パネルのデータベース一覧から、対象のデータベースのスパナアイコン（DB設定）をクリックします。「表示設定」タブ内の「レコード一覧画面設定」を開き、利用している画面設定の「設定」ボタンをクリックします。

2. 「（URLリンク）」項目を追加する
画面中ほどにある「追加する項目」のプルダウンメニューから「（URLリンク）」を選択し、「追加」ボタンをクリックします。

3. 表示したいラベルの種類に応じて設定を行う
追加された「（URLリンク）」行の右端にある「設定」ボタンをクリックし、詳細を設定します。

パターンA：すべてのレコードで「詳細はこちら」などの共通文字を表示したい場合（固定ラベル）
・表示項目名：任意の名称（例：外部システム連携など）を入力します。
・URL：プルダウンから、APIで更新を行っている「元のURL項目」を選択します。
・ラベル：「直接指定」を選択し、「詳細はこちら」や「資料PDF」などの固定表示したい文字列を入力します。
パターンB：レコードごとに「商談ID」や「顧客名」などの値を表示したい場合（動的ラベル）
・表示項目名：任意の名称を入力します。
・URL：プルダウンから、APIで更新を行っている「元のURL項目」を選択します。
・ラベル：「選択レコード」にチェックを入れ、プルダウンからラベル名として表示させたい「テキスト（1行）項目」や「商談ID（キー項目）」等を選択します。
※このパターンでは、APIで「URL」と「商談IDなどの他項目」を同時に送信する設計にしておきます。

設定後、ポップアップ内の「確定」ボタンをクリックします。

4. 画面表示の調整と保存
一覧画面の項目並び順エリアにて、元々の「URL項目（生URLが表示されてしまう項目）」を「非表示（ゴミ箱アイコン）」にし、新しく作成した「（URLリンク）」項目を適切な位置に配置します。最後に画面下部の「確定」ボタンをクリックして保存します。

※この設定はレコード一覧画面ごとの設定となります。複数のメニューで同様の表示を行いたい場合は、それぞれのレコード一覧画面設定にて上記手順を実施してください。

HTTP送信パーツは「外部へデータを送信する（PUSH）」専用の機能であり、レスポンス内容を楽楽販売内のデータに格納することはできません

「楽楽販売」の自動処理における「HTTP送信」パーツは、メソッドが「GET」であるか「POST」であるかにかかわらず、送信先の外部システムから返ってきたレスポンス内容（データ）を解析して、楽楽販売の項目に自動で登録したり、後続の自動処理パーツの入力値として利用したりすることは一切できない仕組み（送信専用の仕様）となっています。

接続先の外部システムが必要とする通信規格（API仕様）に合わせて、適切なHTTPメソッド（GET/POSTなど）を選択し、リクエストヘッダやパラメータを構成して送信を行ってください。

【GETメソッドをHTTP送信パーツで利用するシーン】
接続先APIが「GETリクエストの受信をトリガーにして、連携先（外部側）で処理を完結させる」仕様になっている場合や、セキュリティの観点からGET接続を必須としている場合に、その通信規格に合わせてキック（トリガー）を送信するために選択・使用します。

外部システムから「楽楽販売」へデータを送信（PUSH）して連携する代替案

「楽楽販売」側からデータを取得しに行くことはできませんが、外部システム側を起点として「楽楽販売」が提供しているAPIを呼び出すことで、データの自動登録・一括更新が可能です。

外部システム側でプログラムを組み、「楽楽販売」の「レコード登録API」や「CSVデータインポートAPI」を実行してデータを送信する

外部システム側から「楽楽販売」のAPIエンドポイントに対してデータを送信（PUSH）する仕組みを構築してください。具体的な事前準備と制御方法は以下の通りです。

1. API連携オプションの準備

APIを利用するためには「API連携オプション」のご契約が必要です。本オプションを導入いただくことで、外部システムからのAPIリクエストを受け付けることが可能になります。

2. APIトークンの発行と有効化

【設定箇所】管理者設定＞ユーザー設定＞ユーザー管理
API連携に利用する「システム設定権限」を持ったユーザーの「設定」画面を開き、APIトークンを生成してください。
※生成後、画面最下部の「確定」ボタンをクリックしないとトークンがシステム上で有効になりませんので必ず確定を実行してください。このトークンをリクエストヘッダ（X-HD-apitoken）に指定して認証を行います。

3. 【最重要】IPアクセス制限の登録（※必須手順）

【設定箇所】管理者設定＞セキュリティ設定＞ IPアクセス制限に関する設定
楽楽販売のAPIセキュリティ仕様上、「IPアドレス制限サービス」オプションの契約有無にかかわらず、APIを実行する際はアクセス元（外部システム）のグローバルIPアドレスの登録が100%必須です。
設定画面内の「APIのアクセス制限」欄に、リクエストを送信してくる外部システムの送信元グローバルIPアドレスを必ず登録してください。未登録のIPアドレスからAPIを呼び出そうとすると、すべて「403 Forbidden（アクセスが拒否されました）」のエラーで強制遮断されます。

4. データ量に応じた適切なAPIの選択と実装

レコード登録／更新／削除API：1件ずつリアルタイムにデータを処理したい場合に使用します。
CSVデータインポートAPI：大量のデータ（マスタ等）をまとめて一括で登録・更新したい場合に使用します。オンプレミス環境や外部連携ツール（DataSpider等）からデータを流し込む場合、こちらを外部からキックすることで、APIリクエスト回数を大幅に削減できます。

HTTP送信パーツは「外部へデータを送信する（PUSH）」専用の機能であり、レスポンス内容を「楽楽販売」内のデータに格納することはできません

「楽楽販売」の自動処理における「HTTP送信」パーツは、メソッドが「GET」であるか「POST」であるかにかかわらず、送信先の外部システムから返ってきたレスポンス内容（データ）を解析して、楽楽販売の項目に自動で登録したり、後続の自動処理パーツの入力値として利用したりすることは一切できない仕組み（送信専用の仕様）となっています。

接続先の外部システムが必要とする通信規格（API仕様）に合わせて、「GET」または「POST（HTTPボディ形式としてform-data、JSONの指定が可能）」のいずれかを選択し、適切なリクエストヘッダおよびパラメータを構成して送信を行ってください。

【GETメソッドをHTTP送信パーツで利用するシーン】
接続先APIが「GETリクエストの受信をトリガーにして、連携先（外部側）で処理を完結させる」仕様になっている場合や、セキュリティの観点からGET接続を必須としている場合に、その通信規格に合わせてキック（トリガー）を送信するために選択・使用します。

外部システムのデータを「楽楽販売」に自動登録するための代替案

「楽楽販売」側が主体となって外部データを取得（PULL）し、自動でレコード登録を行うことはできませんが、外部システム側を起点とした構成にすることで、データの自動連携を実現できます。

外部システム側から「楽楽販売」のAPIを実行してデータを流し込む（PUSH型連携）

外部システム側から「楽楽販売」が提供している「レコード登録API」や「CSVデータインポートAPI」を呼び出す仕組みを構築してください。外部システム側で「楽楽販売」のAPIエンドポイントに対してデータを送信（POST）するプログラムを実装することで、外部の最新データを「楽楽販売」へ自動的に反映させることが可能になります。

詳細なAPIの仕様や接続方法については、下記記事をご確認ください。
API連携オプション：設定方法

CSVエクスポートAPIは「複数レコードをまとめたCSV形式のデータ」を一括で取得する仕様です

「楽楽販売」のAPI連携機能において、CSVエクスポートAPIは、指定したデータベースのレコード情報を1件ずつ送信するのではなく、複数のレコードをまとめた「CSVデータ」として一括で取得できる仕組みとなっています。

これにより、レコード参照API（1件ずつ取得するAPI）を利用する場合と比較して、通信回数を大幅に削減し、大量のデータを効率的に外部システムへ連携（PULL）することが可能です。

各プランにおけるリクエスト上限とエクスポート制限（1環境あたり）

CSVエクスポートAPIを含む「CSVインポート／エクスポート関連」のAPIグループには、システムの安定稼働を担保するため、ご契約プランごとに以下のリクエスト制限（1環境あたり）が設定されています。
外部システムを開発される際は、以下の閾値を超えないようにリミッター等の流量制御を実装してください。

制限項目	スタンダードプラン	プロプラン
1分間あたりのリクエスト数	最大 20回／分	最大 50回／分
1リクエストあたりの最大出力件数	最大 200件／回	最大 10,000件／回
1リクエストあたりの最大出力容量	5MB まで	10MB まで

【容量超過時のエラー制限と分割取得設計】
画面上からの手動CSV出力とは異なり、APIエクスポートでは出力データが上記の上限容量（5MBまたは10MB）を1バイトでも超過した場合、ファイルは自動分割されずに「400エラー（パラメータ不正）」となり処理が失敗します。

上限を超える大量データをエクスポートしたい場合は、一括で取得しようとせず、必ずパラメータの「limit（取得件数）」と「offset（取得開始位置：前回までの取得件数を加算した値）」を使用し、外部システム側で複数回に分割して繰り返しリクエスト（ページネーション）を行って連結するロジックを実装してください。

大量データをAPIで一括取得するための設定手順

外部システムから「楽楽販売」のデータを取得するための、楽楽販売側の事前準備手順です。

手順1：API連携を実行するユーザーの「APIトークン」を発行する

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

「ユーザー管理」の一覧より、API連携に使用するユーザーの「設定」ボタンをクリックします。
APIトークン欄の「生成」リンクをクリックし、トークンを発行します。
画面最下部の「確定」ボタンをクリックします。
※「確定」を押さないと、生成したトークンがシステム上で有効になりませんので必ずクリックしてください。

※APIトークンに紐づくユーザーが処理の実行者（操作ログ上の実施者）となります。
パスワードの有効期限切れやアカウント削除が発生すると、そのトークンも使用できなくなりますのでご注意ください。

手順2：リクエスト送信元システムのIPアドレスを「APIのアクセス制限」に登録する（重要）

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

楽楽販売のAPIセキュリティ仕様上、「IPアドレス制限サービス」オプションの契約有無にかかわらず、APIを実行する際はアクセス元（外部システム）のグローバルIPアドレスの登録が100%必須です。
未登録のIPからリクエストを送ると「403 アクセスが拒否されました」となります。

「IPアクセス制限に関する設定」画面を開きます。
「APIのアクセス制限」項目において、連携元システムが通信を送信してくるグローバルIPアドレスを正しく入力し、登録を保存します（可変IPの場合は候補となるアドレスをすべて登録してください）。

※なお、本番操作画面を制御する「ブラウザのアクセス制限」はAPIリクエストには影響しません。必ず「APIのアクセス制限」側に登録を行ってください。

手順3：外部システムからリクエストを送信する

外部システム側から、以下の仕様でリクエストヘッダを構成し、CSVエクスポートAPIのURLに対してリクエストを送信します。HTTPメソッドは「POST」のみ対応しています（GETはエラーとなります）。

リクエストURL：　
https://【サーバドメイン】/【アカウント名】/api/csvexport/version/v1
リクエストヘッダ（認証キー）： X-HD-apitoken: 【手順1で発行したAPIトークン】

※APIトークンを指定する際、Bearer や $、{} などの囲み文字は含めず、確認できるトークン文字列をそのままセットしてください。

「楽楽販売」のディスク容量を1環境あたり500GBを超えて拡張することはできません

プロプランにおけるディスク容量の上限は500GBと定められており、これ以上の容量を同一環境内で追加・拡張する機能はありません。

この上限値は、システムの安定稼働とパフォーマンスを維持するための仕組み上、一律の制限となっています。

そのため、蓄積されたデータや添付ファイルが500GBに達し、さらに多くのデータを管理する必要がある場合には、お手数をおかけしますが、別途新しい環境をご契約いただいた上で、データを分散・移行して運用していただく必要があります。

不要なデータを削除・整理して空き容量を確保する

現在の環境で運用を続ける場合は、定期的に不要なデータを削除する運用ルールを設ける必要があります。

【具体的な整理手順】
◆操作ログ・メール送信ログの保存期間短縮：管理者設定＞システム設定＞全体詳細設定より、ログの保存期間を短く設定します。 3ヶ月を過ぎたログは使用容量にカウントされるため、期間を短くすることで容量を削減できます。
※ログの保存期間を短縮しても、裏側ではシステム負荷を抑えるために「1日あたり最大300万件まで」という自動削除件数の制限ルールがあります。何千万件もの膨大なログが溜まっている環境では、変更後に不要なログがすべて消え去るまで数日〜数週間の時間がかかります。

◆過去レコードや添付ファイルの削除：数年前の不要なレコードや、データベース内の「ファイル」「イメージ」項目にアップロードされた重いデータを削除します。削除前に「CSV出力」を行っておけば、手元のパソコンにバックアップを残すことが可能です。

◆フォルダ内の生成ファイル削除：自動処理で作成された古いExcel/PDFファイルをフォルダから削除します。

容量上限を超過した際のシステムの挙動

契約容量（500GB）を超過した場合でも、システムの正確性を保つための仕組み上、即座にデータが自動削除されたり、ログインや操作がブロックされたりすることはありません。

超過時の通知と制限

使用容量が契約上限に達した場合、または残り100MB以下となった場合には、画面右上の「現在使用容量」部分に警告メッセージが表示されます。また、弊社より「不要データの削除」または「別環境の用意」に関するご案内を差し上げます。

プロプランにおいて、1環境（1サーバー）あたりのデータベース数を上限の500個以上に拡張することはできません

プロプランをご契約いただいている場合でも、1つの環境内に作成できるデータベース数の上限は500個までと定められています。
この上限値は、システムの安定稼働とパフォーマンスの正確性を保つための仕組み上の制限であり、オプションの追加などによって500個を超えて拡張・追加することはできない仕様です。

そのため、すでに500個のデータベースを作成済みで、さらに新しい業務管理のためにデータベースを追加する必要がある場合には、既存のデータベースを整理して枠を空けるか、後述する代替案をご検討いただく必要があります。

【注意】「楽楽販売」では、原因を問わず一度削除したデータベースやその中身をシステム的に復旧・元に戻すことは一切できません。
削除を確定する前に、必ず以下のバックアップを保存してください。

データのバックアップ： データベース内の全レコードをCSVファイルとして出力し保存します。
データベース設定（構造）のバックアップ： 管理者設定＞メンテナンス機能＞テンプレート出力 を実行し、データベースの設計データ（項目設定や画面レイアウトなどのテンプレートファイル）を書き出して保存します。万が一、後から同じ構成のデータベースを再構築したくなった場合に、このファイルを読み込むことで一瞬で設定を復元できます。

データベースの整理・移行時に参照すべきマニュアル

データベースの削除手順については、下記記事をご確認ください。

不要なデータベースを削除して枠を空ける手順

既存のデータベースを削除する際の操作方法と、削除前に確認すべき影響範囲について解説しています。
DBを削除する方法

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

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

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

（記事ID：2907）

プロプランでデータベース（DB）数を500個以上に拡張・追加することは可能か

オプション
ライセンス管理

よくある質問の記事一覧

電子帳簿保存庫でデータベース内の特定のテキスト項目やキー項目の値をキーにして検索する方法

操作ログを15ヶ月間保管する方法・設定手順

社外の取引先が利用するパソコンにSSLクライアント証明書をインストール・設定する推奨手順

電子帳簿保存庫のファイルを開く際に「アクセスしたデータへのアクセス権が変更された可能性があります」とエラーが表示される原因と対処方法

レコード更新APIでURL項目の表示用「ラベル」をセット・保持する方法はあるか

「楽楽販売」から外部システムのデータを自動取得（PULL）してレコード登録することは可能か

API連携におけるHTTPメソッド「GET」の用途と外部データの自動登録（PULL）について

CSVエクスポートAPIで複数レコードを「一括取得」する方法・仕様

プロプランでディスク容量（ストレージ容量）を上限の500GBを超えて拡張する方法・代替案

プロプランでデータベース（DB）数を500個以上に拡張・追加することは可能か

ラクス製品のご紹介