GMOサインと連携する

GMOサイン連携アイテムを利用すると、申請書内に添付されたPDFファイルや申請書データから出力したPDF帳票を、GMOサインへ自動で送信し、電子署名を依頼することができます。
機能の概要は、「コラボフロー for GMOサインについて」をご確認ください。

※コラボフロー for GMOサインは、クラウド版のみご利用いただけます。
※コラボフロー for GMOサインはオプション製品です。利用するには、別途購入が必要です。

本記事の設定をおこなう前に

GMOサインと連携設定をおこなう必要があります。
以下の記事の内容を、ご確認ならびにご設定ください。

連携サービス設定（GMOサイン）

GMOサインへのWebhookの追加

GMOサイン側にWebhookを追加する必要があります。
GMOサインへのWebhook追加は、GMOグローバルサイン・ホールディングス社への申請が必要です。
手順については以下の記事をご確認ください。

GMOサインへのWebhook追加について（※リンク先記事は、お問い合わせ担当者様限定の公開です。）

GMOサイン連携アイテムの設定

経路アイテムの選択画面にて、「連携アイテム関連」のリスト内にある [GMOサイン連携] をクリックします。

経路アイテム「GMOサイン連携アイテム」の設定画面が表示されます。

接続先環境	GMOサインへの送信先環境を選択します。本番環境とテスト環境の両方が設定されている場合は、どちらか片方を選択できます。片方のみ設定されている場合は、設定済みの環境が自動で選択されます。 ※接続先環境は、連携サービス設定（GMOサイン）で顧客ID・シークレットキーが登録されている環境のみ表示されます。
封筒名	GMOサインに登録する書類の封筒名として使用するパーツを選択します。以下のフォームパーツが選択できます。テキスト（一行）パーツ（タイプ：ノーマル）テキストエリアパーツリストメニューパーツラジオボタンパーツマスター連携パーツ
契約締結証明書	署名完了後に取得する契約締結証明書の保存先パーツを選択します。添付ファイルパーツが選択できます。「(なし)」を選択した場合、証明書は保存されません。添付ファイルパーツを選択：選択したパーツに証明書が保存されます。「(なし)」を選択：証明書は保存されません。
添付ファイル	GMOサインに送信する添付ファイルパーツと、署名済みファイルの保存先パーツをマッピングします。設定方法については、本記事内の「添付ファイルのマッピング設定について」をご確認ください。
帳票	GMOサインに送信する帳票と、署名済みファイルの保存先パーツをマッピングします。 PDF帳票のみ選択できます。設定方法については、本記事内の「帳票のマッピング設定について」をご確認ください。
宛先設定（署名順）	署名を依頼する相手先（宛先会社名・宛先名・メールアドレス）と、署名者変更許可をマッピングします。設定方法については、本記事内の「宛先設定（署名順）のマッピング設定について」をご確認ください。
登録・更新	クリックすると、設定した内容で経路アイテムを登録・更新します。
削除	クリックすると、設定済みの経路アイテムを削除します。

添付ファイルのマッピング設定について

添付ファイルと署名済みファイルのマッピング設定をします。

No	行番号（自動採番）
添付ファイル	GMOサインに送信する添付ファイルパーツを選択します。
署名済みファイル保存先	署名済みPDFファイルの保存先となる添付ファイルパーツを選択します。「(なし)」を選択した場合、署名済みファイルは保存されません。
行を削除	クリックすると、クリックした行を削除できます。0行まで削除できます。
行を追加	クリックすると、行を追加できます。

帳票のマッピング設定について

PDF帳票と署名済みファイルのマッピング設定をします。
※本設定を利用するためには、帳票出力オプションが必要です。
※帳票設定にて、出力ファイル形式の「PDF」がONの場合、帳票の連携が可能です。

No	行番号（自動採番）
帳票	GMOサインに送信するPDF帳票を選択します。 PDF帳票のみが表示されます。
署名済みファイル保存先	署名済みPDFファイルの保存先となる添付ファイルパーツを選択します。「(なし)」を選択した場合、署名済みファイルは保存されません。
行を削除	クリックすると、クリックした行を削除できます。0行まで削除できます。
行を追加	クリックすると、行を追加できます。

宛先設定（署名順）のマッピング設定について

署名依頼メールを送信する相手先情報と署名者変更許可のマッピング設定をします。

No	行番号（自動採番）
宛先会社名	署名者の会社名として使用するパーツを選択します。
宛先名	署名者の氏名として使用するパーツを選択します。
メールアドレス	署名者のメールアドレスとして使用するパーツを選択します。
署名者変更許可	署名者による署名者変更を許可するか否かを制御するためのパーツを選択します。チェックボックスパーツもしくはラジオボタンパーツが選択できます。「(なし)」を選択した場合、署名者変更は許可されません。 ※設定するパーツの値に、「true」と「false」を設定ください。　そのほかの値では、正常に連携できません。
行を削除	クリックすると、クリックした行を削除できます。宛先は最低1件必要です。1行のみの場合に [×] をクリックすると、アラートが表示されます。
行を追加	クリックすると、行を追加できます。複数の署名者を設定する場合は、行を追加してください。行の順序が署名順となります。宛先の設定は最大50件までとなります。50件以上は行の追加ができません。

マッピング設定の補足

宛先会社名・宛先名・メールアドレスには、以下のフォームパーツが選択できます。
- テキスト（一行）パーツ（タイプ：ノーマル）
- テキストエリアパーツ
- リストメニューパーツ
- ラジオボタンパーツ
- マスター連携パーツ

制限事項

送信ファイルについて

GMOサインに送信できるファイルは、PDFファイルのみです。PDF以外のファイル（画像ファイルなど）は自動で除外されます。
パスワードで保護されたPDFファイルは、送信できません。
送信ファイル（添付ファイル＋帳票）の1ファイルあたりのサイズは、20MB以内にしてください。
送信ファイル（添付ファイル＋帳票）の合計サイズは、200MB以内にしてください。
送信ファイル（添付ファイル＋帳票）の合計ファイル数は、20個以内にしてください。

経路のエクスポート・インポートについて

GMOサイン連携アイテムは、エクスポート・インポートの対象外です。
GMOサイン連携アイテムを配置している経路をエクスポート・インポートした場合、アイテムの配置位置は引き継がれますが、設定内容は引き継がれず未設定の状態になるため、再度設定をおこなってください。

明細、テーブルパーツ内のフォームパーツについて

各設定では、明細、テーブルパーツ内のフォームパーツは選択できません。

補足

フォームパーツ選択肢の表示について

フォームパーツの選択肢は、「{パーツ名}({パーツID})」の形式で表示されるため、パーツ名が重複している場合でも見分けることができます。
フォームパーツの選択肢は、申請書上でのパーツの並び順で表示されます。

経路コピーについて

GMOサイン連携アイテムを配置している経路をコピーした場合、GMOサイン連携アイテムの設定値も保持されます。

署名待ち中の動作について

GMOサインへの書類送信が成功した場合、コラボフローの申請書はGMOサイン連携アイテムの段階で一時停止（署名待ち）状態になります。GMOサインで署名が完了すると、自動で次の段階へ進みます。
GMOサインからは却下/取消の Webhook 通知が送信されないため、GMOサイン上で書類が却下または取消された場合でも、コラボフロー側の申請書は自動的に進行しません。
申請者により該当申請書を取り消し・取り戻しをおこなう、もしくは、判定者により却下・取り戻しをおこなうなど、必要に応じて対応してください。

GMOサイン連携アイテムの通過に失敗した場合の動作について

GMOサイン連携アイテムの通過に失敗した場合は、該当アイテムの直前の申請者もしくは判定者にて再度申請もしくは判定をおこない、再度アイテムを通過させることで、GMOサインへの送信を再実行できます。
送信ファイルの合計サイズが上限を超えた場合は、合計サイズを調整したうえで、再度申請もしくは判定が必要です。

連携設定の解除について

連携設定を解除すると、GMOサイン連携アイテムを通過する際に認証エラーが発生します。
そのため、連携設定を解除する場合は、GMOサイン連携アイテムを利用している申請中の申請書が無いか、事前にご確認ください。

コラボフロー for GMOサインについて
GMOサインへのWebhook追加について（※リンク先記事は、お問い合わせ担当者様限定の公開です。）
GMOサイン連携で記録される監査ログ
コラボフロー for GMOサイントラブルシューティング