PCAクラウド連携プラグイン（商魂商管dx）
設定ガイド

V3.0

必要な環境についてPCAクラウド連携プラグインの利用には下記環境が必要です。


PCAクラウド商魂商管dxおよびWeb-API（※体験利用も可）
キントーン スタンダードプラン（※無料お試しも可）PCAクラウド商魂商管dx連携プラグイン

ご利用の前に■設定にあたって下記をご確認ください。

 本番環境での利用の前にテスト環境を作成した上で試用を充分におこなってください。理由の如何に関わらず、本プラグインの利用によるデータ消失やデータ破壊などのいかなる事象に対し、当社は一切の責任は負いません。
 本プラグインおよびアプリテンプレートについては当社サポートセンターによるサポート提供はおこないません。設定に関するサポートや設定代行やアプリ作成などの役務提供については、提供可能パートナーをご紹介いたします。
 不明点などについてはsip@pca.co.jpまでご連絡ください。
 プラグインの利用方法などについては別途、個別相談会もご用意しております。本資料の末尾をご確認ください。
 PCAクラウド商魂商管dxの操作問い合わせについてはサポートセンターまでご連絡ください。

なお、サポートセンターではキントーンやプラグイン、アプリに関するご質問にはお答えできません。

0．ダウンロードしたファイルの前準備• メールにてお知らせしたダウンロードURLをクリックしてプラグイン・アプリテンプレートをダウンロードしてください。

1．プラグイン：plugin-cloudcoop.zipは複数のプラグインや設定ファイルをZip形式にまとめてありますのでまず解凍してください。
解凍せずにキントーンに読み込むとエラーとなります。

2．アプリテンプレート：apptemplate-cloudcoop.zipは解凍せずにそのままキントーンに読み込んでください。

0．ダウンロードしたファイルの前準備• plugin-cloudcoop.zipに含まれるプラグイン一覧

プラグイン名プラグインファイル名

プラグイン名プラグインファイル名

プラグイン名プラグインファイル名

発注伝票登録プラグイン

PCA_import_send_order.zip

仕入伝票登録プラグイン

PCA_import_purchase.zip

部門マスタ登録プラグイン

PCA_import_department.zip

商品マスタ登録プラグイン

PCA_import_item.zip

得意先マスタ登録プラグインPCA_import_customer.zip

直送先マスタ登録プラグイン

PCA_import_direct_delivery.zip

仕入先マスタ登録プラグイン

PCA_import_supplier.zip

見積伝票抽出プラグイン

PCA_select_estimate.zip

受注伝票抽出プラグイン

PCA_select_receive_order.zip

売上伝票抽出プラグイン

PCA_select_sales.zip

発注伝票抽出プラグイン

PCA_select_send_order.zip

仕入伝票抽出プラグイン

PCA_select_purchase.zip

商品マスタ抽出プラグイン
仕入先マスタ抽出プラグイン

PCA_select_item.zip
PCA_select_supplier.zip

得意先マスタ抽出プラグイン
部門マスタ抽出プラグイン

PCA_select_customer.zip
PCA_select_department.zip

直送先マスタ抽出プラグイン

PCA_select_direct_delivery.zip

見積伝票登録プラグイン

PCA_import_estimate.zip

受注伝票登録プラグイン

PCA_import_receive_order.zip

売上伝票登録プラグイン

PCA_import_sales.zip• apptemplate-cloudcoop.zipに含まれるアプリテンプレート一覧
見積伝票登録アプリ

受注伝票登録アプリ

売上伝票登録アプリ

発注伝票登録アプリ

仕入伝票登録アプリ

商品マスタ登録アプリ

得意先マスタ登録アプリ

直送先マスタ登録アプリ

仕入先マスタ登録アプリ

部門マスタ登録アプリ

見積伝票抽出アプリ

受注伝票抽出アプリ

売上伝票抽出アプリ

発注伝票抽出アプリ

仕入伝票抽出アプリ

商品マスタ抽出アプリ

得意先マスタ抽出アプリ

直送先マスタ抽出アプリ

仕入先マスタ抽出アプリ

部門マスタ抽出アプリ

1．アプリの設定

 すでにキントーンを利用中で、PCAクラウド連携プラグインを利用したいアプリがある場合はこの項は飛ばしてください。
 PCAクラウド連携プラグインはキントーンアプリに適用して利用します。まずはアプリを用意してください。

キントーン「ポータル」

PCAクラウド連携プラグインに同梱のテンプレートアプリ
を利用する場合はこちら

2．プラグインの読み込み
キントーン環境にプラグインを読み込みます。

ダウンロードしたプラグインを選択

プラグインが表示されれば完了です。

3．プラグインのアプリへの適用
PCAクラウド連携プラグインを使いたいアプリにプラグインを適用します。

アプリの一覧画面右上にある歯車マークをクリックし、設定画面を表示します。

設定タブのプラグインをクリックします。

※キントーンへのログインユーザの権限によっては上記操作ができない場合があります。
その場合は社内のキントーン管理者へご確認ください。

3．プラグインのアプリへの適用
PCAクラウド連携プラグインを使いたいアプリにプラグインを適用します。

「プラグインの追加」をクリックします。

適用したいプラグインにチェックをつけて、追加ボタンを押します。

アプリの設定からアプリの更新をすると適用完了です。

4.プラグインの設定

4.プラグインのアプリへの適用と同様に設定画面を開き、プラグインの画面に移動してください。
設定の歯車マークをクリックしてプラグインの設定画面を開きます。

設定にあたり、手元にPCAクラウド利用通知書をご用意ください。

4.プラグインの設定

まずはPCAクラウドへの接続設定をおこないます。

PCAクラウド利用通知書に記載の内容を設定

PCAクラウド商魂商管dxのシステムユーザを設定
連携用に専用ユーザを作成するのがお勧め
ID・パスワード入力後に押すとデータ領域が選択可能に。
連携したいデータ領域を選択

4.プラグインの設定（伝票登録系プラグイン、マスタ登録系プラグイン）
キントーンとPCAクラウド商魂商管dxの項目割り当てをします。
この設定に従い、キントーンとPCAクラウド商魂商管dxが連携します。
キントーンからPCAクラウド商魂商管dxに登録したデータを更新するかしないかを設定。
伝票番号、伝票番号、得意先コードが同一の場合は登録済みデータとして判定。

キントーンのフィールドコード、項目名

PCAクラウド商魂商管dxの項目名（●は必須項目）値の編集可否項目の表示・非表示

キントーンからプラグインを使ってPCAクラウド商魂商管dxへ伝票データを登録した際に「伝票番号」に割り当てられた項目が空白の場合、PCAクラウド商魂商管dxで発番された伝票番号がキントーンアプリの項目にセットされます。
そのため、伝票番号発番をPCAクラウド商魂商管dxに任せる場合は伝票番号の項目を「項目値の編集を許可する」のチェックを外すことをお勧めします。

4.プラグインの設定（伝票登録系プラグイン）

消費税に関する計算と粗利（金額-原価）をPCAクラウド商魂商管dxのマスタ設定に準じる場合はこちらをチェックします。
キントーンのレコード詳細画面で保存を押すと同時にPCAクラウド商魂商管dxに連携する場合はこちらをチェックします。

伝票に含まれる得意先・仕入先や商品マスタのおおよその件数を選択。（1000件未満or1000件以上）※内部動作が一部変わります。
PCAクラウド商魂商管dxへ伝票登録が成功すると、ここで設定した項目に連携日時がセットされます。
プラグインの連携ボタンを表示する一覧を選択することができます。

キントーンのプロセス管理を利用している場合、PCAクラウド商魂商管dxへ連携するステータスを選択することができます。

4.プラグインの設定（伝票・マスタ抽出系プラグイン）

チェックOnにするとkintoneアプリに登録されていないデータと、登録済データの差分データのみを取得します。
チェックOffにすると取得のたびに一度既存のデータを全削除→取得データ登録をします。
PCAクラウド商魂商管dxと連携せずにキントーンアプリ上のみで管理している項目がある場合はご注意ください。

キントーンのフィールドコード、項目名

PCAクラウド商魂商管dxの項目名（●は必須項目）値の編集可否4.プラグインの設定（伝票・マスタ抽出系プラグイン）

データ抽出時の条件指示画面に表示する抽出条件を設定します。
また、初期表示する条件やその条件の変更可否の設定も可能です。

実際にデータ抽出する前に対象データ件数をチェックし、この設定を超える件数が対象となった場合はアラートを出します。
対象件数が多いと完了まで時間がかかるケースがありますので、テストした結果に応じて件数設定を調整ください。

4.プラグインの設定

プラグインを利用不可とする組織・ユーザやグループを指定することができます。
組織・ユーザ・グループは「cybozu.com共通管理」で設定されたものとなります。

プラグインの設定内容をテキストファイルに出力する、また出力されたプラグインの設定内容テキストファイルを取り込むことが可能です。

設定完了したら、「保存する」を押した後にアプリの設定から「アプリを更新」ボタンを押して反映させてください。

5.PCAクラウド商魂商管dxとの連携（伝票・マスタ登録系プラグイン）
設定が正しく行われアプリを更新すると、レコード一覧に連携用のボタンが表示されます。
プラグインの設定により、連携ボタンを表示する一覧を設定している場合は、設定している一覧を選んでください。
連携ボタンを押すとこの一覧に含まれるデータが連携されます。
ただし、プラグインの設定によっては連携対象とならない場合もあります。（下記参照）■連携対象とならないケース
1．プラグインの設定において、連携対象となるプロセス管理のステータスを選択している場合は選択しているス
テータスのレコードのみ連携対象となります。
2．プラグインの設定において、登録済みのデータの更新を許可していない場合、一度転送しているレコードは登録されません。（得意先コード、伝票日付、伝票Noが同一のレコードがPCAクラウド商魂商管dxに存在していると登録済みと判定します。）

5.PCAクラウド商魂商管dxとの連携（伝票・マスタ抽出系プラグイン））
設定が正しく行われアプリを更新すると、レコード一覧に連携用のボタンが表示されます。

条件を指定したうえで検索ボタンを押すと、条件にあったデータを抽出します。
■プラグインの設定により動作が変わる場合があります。
1．差分のみ反映する設定にしている場合は、kintoneアプリに登録されていないデータと、登録済データの差分データのみを取得します。
2．差分のみ反映する設定にしていない場合は、検索するたびに登録されているデータを全削除したうえで抽出・登録しなおします。
もし、PCAクラウド商魂のマスタから連携した項目データ以外のキントーンアプリ項目がある場合、その項目データも削除されるのでご注意ください。
3．条件指定画面に表示される条件は、プラグインの設定により変わります。条件内容の初期表示や変更の可否もプラグインの設定によります。
4．検索条件で抽出対象となったデータ件数がプラグインで設定した「確認メッセージを表示する件数」を超えるデータ件数となった場合、動作を継続するかの確認メッセージが表示されます。

5.PCAクラウド商魂商管dxとの連携■制約事項
・伝票系プラグイン（登録・抽出）においては、テーブル項目にて明細テーブルを作成する必要があります。
・伝票登録系プラグインにおいて明細テーブル内の複数の明細行データを連携する場合、同一の商品コードを含む明細行が存在すると更新登録ができません。（新規登録は可能）一度、登録した伝票データを更新可能な運用とする場合は明細行に同一商品コードが複数存在しないような運用にしてください。
運用上、同一商品コードを複数利用することが避けられない場合はsip@pca.co.jpまでご連絡ください。
・売上伝票登録、仕入伝票登録においては、受注・見積・発注伝票の参照登録は対応しておりません。
・受注伝票登録においては見積伝票の参照登録は対応しておりません。
・キントーン項目の「レコード番号」「作成者」「作成日時」「更新者」「更新日時」についてはフィールドコードを変更しないでください。

個別相談をご利用ください
プラグインの設定方法だけでなく、活用方法や運用相談などPCAクラウド×キントーンに関するどんなことでもご相談いただけます。
ご相談にあたっての費用は一切かかりませんので、ご安心してお申し込みください。

https://bit.ly/3HlxTq2

2024/05 第6版
クラウドインテグレーショングループ