エクスポートAPIとは、非対面契約の開始時にエクスポート_api_info Parameterの値を通じて設定した情報に基づいて、契約者が契約書を承認し、却下時に設定値を基に作成されたJSON形式のbodyを設定したURLにエクスポートして、該当会社側から受け取ることができるようにする機能です。
request_codeにユーザー定義の代わりに「embed」を入力すると、契約書進行のURLがエキスポートされ、カカオトークとメール通知は契約者に送信されません。 エクスポートを受信したURLに基づき、お客様側で別途に発送を行うことができます。
embed Code を使用する場合は、最初の非対面契約の呼び出し時にresponse に契約開始 URL を提供し、契約の進行時に署名者が契約書を承認、却下するたびにエクスポートで進行 URL と入力した契約者の番号、または電子メールを提供します。(電子メール、番号で呼び出した場合は番号) 契約完了時に文書のダウンロード、履歴認証書のダウンロード URL を提供します。
{
"header": {
"api_name": "export",
"session_id": "S1001",
"request_code": "{ exportAPI_info で指定したrequest_code value }",
"authorization":"{ 非対面契約API使用時に設定したauthorization value }"
},
"body": {
"clientid": "{ eSignonAPI使用のためのUnique ID }",
"processid": "1", //文書の進行段階の区分値
"requestid": "{ ヘッダーのrequest_code value }",
"actionid": "1", //文書の進行段階の区分値
"workdatetime": "2020-01-31 04:23:28.0", //作成完了時間
"worktype": "CF", //CF=承認、RT=返却(最初の契約者が返戻した場合、文書はキャンセルされます。)
"wfuid": "{}", //
"useremail": "{ 署名者 email }",
"opinion": "", //承認、差し戻し時に顧客が差し戻しメッセージ、転送メッセージを使用した場合に出力
"param_id": "param_value", // fields値を設定した場合、fields_valueをreturn
}
}
Export_api Response 例) code-embed 状態のとき (進行中)
{
"header": {
"api_name": "export",
"session_id": "S1001",
"request_code": "{embed}"
},
"body": {
"wfluid": "0",
"clientid": "{ eSignonAPI使用のためのUnique ID }",
"processid": "1", //文書の進行段階の区分値
"requestid": "{ embed }",
"actionid": "1", //文書の進行段階の区分値
"workdatetime": "2020-01-31 04:23:28.0", //作成完了時間
"worktype": "CF",//CF=承認、RT=返却(最初の契約者が返戻した場合、文書はキャンセルされます。)
"wfuid": "{}",
"useremail": "{ 署名者 email }",
"opinion": "", //承認、差し戻し時に顧客が差し戻しメッセージ、転送メッセージを使用した場合に出力
"param_id": "param_value",
"next_play_user":"{次の順番にサインするEメール}",
"play_url":"{次の順番にサインインするお客様にお渡しするURL}",
"status":"{Playing}", // 進行状態 - Playing(進行中) Complete(完了)
"next_user_name":"{次の署名者の名前}",
"user_name":"{現在の署名者名}"
}
}
Export_api Response 例)code-embed 状態のとき(完了)
{
"header": {
"api_name": "export",
"session_id": "S1001",
"request_code": "{embed}"
},
"body": {
"wfluid": "0",
"clientid": "{ eSignonAPI使用のためのUnique ID }",
"processid": "1", //文書の進行段階の区分値
"requestid": "{ embed }",
"actionid": "1", //文書の進行段階の区分値
"workdatetime": "2020-01-31 04:23:28.0", //作成完了時間
"worktype": "CF",//CF=承認、RT=返却(最初の契約者が返戻した場合、文書はキャンセルされます。)
"wfuid": "{}",
"useremail": "{ 署名者 email }",
"opinion": "", //承認、差し戻し時に顧客が差し戻しメッセージ、転送メッセージを使用した場合に出力
"param_id": "param_value",
"cert_url":"{履歴証明書ダウンロードURL}",
"download_url":"{文書ダウンロードURL}",
"status":"{Playing}", // 進行状態 - Playing(進行中) Complete(完了)
"user_name":"{現在の署名者名}"
}
}