非対面契約開始 - ExportAPI 説明

エクスポートAPIとは、非対面契約の開始時にエクスポート_api_info Parameterの値を通じて設定した情報に基づいて、契約者が契約書を承認し、却下時に設定値を基に作成されたJSON形式のbodyを設定したURLにエクスポートして、該当会社側から受け取ることができるようにする機能です。

request_codeにユーザー定義の代わりに「embed」を入力すると、契約書進行のURLがエキスポートされ、カカオトークとメール通知は契約者に送信されません。 エクスポートを受信したURLに基づき、お客様側で別途に発送を行うことができます。

embed Code を使用する場合は、最初の非対面契約の呼び出し時にresponse に契約開始 URL を提供し、契約の進行時に署名者が契約書を承認、却下するたびにエクスポートで進行 URL と入力した契約者の番号、または電子メールを提供します。(電子メール、番号で呼び出した場合は番号) 契約完了時に文書のダウンロード、履歴認証書のダウンロード URL を提供します。

Parameter

export_api Response)

{
	"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":"{現在の署名者名}"
	}
}

Last updated