EzSign關貿網路數位簽章服務平台

『關貿網路數位簽章服務平臺』線上製作與流程說明

使用 Google Chrome 或 Microsoft Edge 瀏覽器登入關貿網路數位簽章服務平臺。

連結網站： 使用 Google Chrome 或 Microsoft Edge 瀏覽器，進入關貿網路數位簽章服務平臺。
無帳號請先洽產品經理： 如果您尚未註冊帳號，請先聯繫產品經理進行帳號申請。
進入登入頁面： 在首頁右上角，滑鼠點擊 【登入】 按鈕。系統將自動跳轉至 「登入」畫面。
您可以選擇以下方式登入：
1.帳號與密碼： 在登入畫面中，輸入您的帳號和密碼。點擊登入按鈕，即可成功登入並開始試用。
2.行動自然人憑證： 在登入畫面中，點擊 行動自然人憑證登入 超連結，系統將自動跳轉至「行動自然人登入」畫面。
輸入您的 身分證號。點擊 行動自然人憑證登入 按鈕，即可前往行動自然人憑證APP進行驗證。
完成APP驗證後，再點擊「行動裝置驗證提醒」視窗確認按鈕，即可成功登入並開始試用。

[圖1-1-1]首頁

[圖1-1-2]登入頁面

[圖1-1-3]行動自然人憑證登入頁面

[圖1-1-4]行動自然人憑證APP驗證頁面

[圖1-1-5]確認完成APP驗證頁面

介接系統欲使用本平臺API時，介接來源與API之呼叫流程如下:

步驟 1：申請 API Token
在進行任何系統介接之前，首先需要至平臺完成 API Token 的申請。

API Token 是系統與數位簽章平臺進行通信的憑證，能確保 API 呼叫的安全性。
步驟 2：使用 API Token 呼叫對應的 API
根據您所需的服務功能，使用先前申請的 API Token 呼叫對應的 API。

在呼叫 API 時，請在請求標頭中包括您的 API Token，以便平臺識別並授權您的請求。
步驟 3：平臺回傳相應的服務結果
平臺將根據 API 請求回傳結果，若請求成功，將提供請求結果；若失敗，則會回傳錯誤信息。

注意事項：

請妥善保管您的 API Token，避免洩漏。
請遵循 API 呼叫限制，避免超過流量控制範圍。
發生錯誤時，請根據錯誤代碼進行排查並修正問題。

UploadPdfFile()

使用 UploadPdfFile 上傳 PDF 檔案，此 API 將會等候簽章完畢才回訊。

範例請求：

{
	"Method": "POST",
	"Url": "https://csp-tradevan.com.tw/APESP/v1/document/pdf",
	"Headers": {
		"Content-Type": "application/json;charset=utf-8",
		"apitoken": {{apitoken}}
	},
	"PathParameters": "N/A",
	"QueryParameters": "N/A",
	"Body": {
		"fileContent": ""JVBERi0xLj...SVFT0Y=",
		"fileName": "samplePdf",
		"account": "tv6678",
		"positionCode": ""
	}
}

範例回應：

{
	"errorCode": 1003,
	"errorMessage": "處理成功",
	"documentId": "D202501070002043",
	"viewUrl": "https://csp-tradevan.com.tw/APESP/pdfWeb/D202501070002043",
	"b64data": "JVBERi0xLj...U9GCg=="
}

CertData()

使用 CertData 取得憑證資訊。

範例請求：

{
	"Method": "POST",
	"Url": "https://csp-tradevan.com.tw/APESP/v1/certData",
	"Headers": {
		"Content-Type": "application/json;charset=utf-8",
		"apitoken": {{apitoken}}
	},
	"PathParameters": "N/A",
	"QueryParameters": "N/A",
	"Body": {
		"account":"tv6678",
		"certName":"6678測試憑證"
	}
}

範例回應：

{
	"errorCode": 1002,
	"errorMessage": "查詢成功",
	"cert": "0bf10352-e7c6-47ef-a6a4-5b45c83443dc",
	"subject": "CN=6678",
	"number": "1976ab8740a3b28f47b0222f5c367c58",
	"expiryDate": "2121/09/10",
	"issuer": "CN=6678",
	"status": [
        {
            "CN=6678": "NO_OCSP_URL"
        }
    ]
}

LineNotify()

使用 LineNotify 傳送通知訊息。

範例請求：

{
	"Method": "POST",
	"Url": "https://csp-tradevan.com.tw/APESP/v1/lineNotify",
	"Headers": {
		"Content-Type": "application/json;charset=utf-8",
		"apitoken": {{apitoken}}
	},
	"PathParameters": "N/A",
	"QueryParameters": "N/A",
	"Body": {
		"account": "tv6678",
		"content": "測試訊息",
		"notifiedPeople": ["tv6678"] ,
		"lineUuidList": ["5UfOnj1s3m8BHOk7AAhOphg1nnpU7JoZ9LiISS319nt"]
	}
}

範例回應：

{
	"errorCode": 1003,
	"errorMessage": "處理成功"
}

範例請求：

{
	"Method": "POST",
	"Url": "https://csp-tradevan.com.tw/APESP/v1/exportCertificate",
	"Headers": {
		"Content-Type": "application/json;charset=utf-8",
		"apitoken": {{apitoken}}
	},
	"PathParameters": "N/A",
	"QueryParameters": "N/A",
	"Body": {
		"type":"CT001",
		"patchNo":"2011",
		"account":"tv6678",
		"name":"林一_感謝狀local_2",
		"fieldMap":{
			"signature":"關小貿",
			"name":"林一",
			"project":"數位簽章平台"
		}
	}
}

範例回應：

{
	"errorCode": 1003,
	"errorMessage": "處理成功",
	"b64data": "JVBERi0xLj...UVPRgo="
}

新增電子契約

使用者可透過本平臺傳輸電子契約文件，文件經由本平臺進行簽章，具備不可否認性、完整性保護及身份驗證功能，確保資料真實可靠。系統亦會自動通知相關人員進行查看。

操作步驟:

1.使用者完成基本資料輸入後，點選「下一步」進入文件上傳階段。

2.點選「文件上傳」按鈕，選取欲處理的文件，文件成功上傳後，點選「下一步」進入簽署人設定階段。

3.設定簽署人相關資訊，完成後點選「發送簽署人」即可完成本次簽核流程。

[圖3-1-1-1]基本資料填寫畫面

[圖3-1-1-2]上傳文件畫面

[圖3-1-1-3]簽署人即通知內容設定畫面

注意事項:

1.檔案上傳限制

-單次簽核流程最多可上傳 5 個檔案。

-測試帳號：總檔案大小不得超過 1MB。

-正式帳號：總檔案大小不得超過 10MB。

2.簽署人設定

-可點選「增加簽署步驟」，客製化設定簽署流程的簽署關卡。

3.通知設定

-「設定通知交付 Email」：電子契約流程建立完成時，系統會發送通知至相關人員的 Email。

-「設定完成簽署通知 Email」：當電子契約流程全數簽署完成時，系統會發送通知至相關人員的 Email。

-「設定簽署人員通知頻率」：可設定尚未完成簽核時，系統通知該關卡相關人員的時間。

4.LINENotify 通知

-若會員註冊時有新增 LINENotify 權杖，則簽電子契約流程建立完成時，系統會透過 LINENotify 通知簽署人員及相關人員。

電子契約查詢

使用者可透過此功能查看電子契約資料。

[圖3-1-2-1]查詢結果畫面

[圖3-1-2-2]電子契約管理畫面

查詢結果詳細功能說明如下:

1.點選「契約編號超連結」，跳轉至電子契約管理頁面。

2.點選「新增簽署文件」，跳轉至建立電子契約頁面。

3.點選「匯出電子契約清單」，可下載電子契約清單。

電子契約管理頁面說明如下:

1.在基本資料進行調整後，點選「更新」按鈕，以保存變更。

2.簽署文件清單:「文件超連結」，可下載該文件;點選「查看簽章歷程」，可查看該文件的簽章歷程和簽章憑證資訊。

3.簽署進度:可查看文件的當前簽署進度。

產證作業

使用者可透過本平臺製作證書文件，文件經由本平臺進行簽章，具備不可否認性、完整性保護及身份驗證功能，確保資料真實可靠。

操作步驟:

1.使用者點選「新增證書」或「新增證書(CSV匯入)」進入證書製作階段。

2.完成基本資料輸入後，點選「下一步」進入文件瀏覽確認階段，點選「確認製作」，即可完成本次證書製作流程。

[圖3-2-1-1]新增證書畫面

[圖3-2-1-2]文件瀏覽確認畫面

[圖3-2-1-3]新增證書(CSV匯入)畫面

[圖3-2-1-4]查詢結果畫面

[圖3-2-1-5]寄信內容設定畫面

查詢結果詳細功能說明如下:

1.狀態為「製作中」，點選「交辦日期超連結」，跳轉至證書製作頁面。

2.狀態為「已完成」，點選「文件下載」，可下載該文件。

3.狀態為「已完成」，點選「信封」圖示，可將該文件寄送給欲通知人員。

4.點選「新增證書」按鈕，跳轉至證書製作頁面。

5.點選「新增證書(CSV匯入)」按鈕，跳轉至證書製作(CSV匯入)頁面。

新增欄位說明如下:

1.是否需驗證身分:若選擇「是」，需插入有效憑證卡，才可點選「確認製作」按鈕。

2.證書效期到期日:設定此欄位後，系統會在設定的到期通知時間，向相關人員發送通知。

3.編輯欄位內容:設定證書的資料。

4.CSV匯入:以CSV檔案匯入方式，設定證書的資料。

證書設計

使用者可透過本平臺製作證書文件，文件經由本平臺進行簽章，具備不可否認性、完整性保護及身份驗證功能，確保資料真實可靠。

操作步驟:

1.使用者完成基本資料輸入後，點選「下一步」進入文件上傳階段。

2.點選「文件上傳」按鈕，選擇欲處理的文件，文件成功上傳後，點選「下一步」進入畫面設計階段。

3.點選「選取QRCODE位置」按鈕，拖曳QRCODE顯示位置。點選「選取簽名位置」按鈕，設置簽名欄位位置，完成後可在文件上拖曳顯示欄位資料位置。若需刪除欄位，選取該欄位核取方塊並點選「清除勾選欄位」按鈕。

4.點選「完成」按鈕，則完成證書製作。

[圖3-2-1-1]基本資料填寫畫面

[圖3-2-1-2]上傳文件畫面

[圖3-2-1-3]畫面設計畫面

[圖3-2-1-4]查詢結果畫面

查詢結果詳細功能說明如下:

1.點選「新增證書版型」按鈕，跳轉至證書製作(版型設計)頁面。

2.狀態為「編輯中」，可點選「版型名稱超連結」，跳轉至證書製作編輯頁面。

3.狀態為「完成」且身分驗證為「否」，可點選「api文件下載」按鈕，下載該證書的API傳送JSON格式文件。

4.點選「垃圾桶」圖示，即可刪除該證書設計版型。

注意事項

1.檔案上傳限制

-單次簽核流程最多可上傳 5 個檔案。

-測試帳號：總檔案大小不得超過 1MB。

-正式帳號：總檔案大小不得超過 10MB。

建立簽核流程(憑證)

使用者可透過本平臺傳輸文件並設定簽署人關卡，文件經由本平臺進行簽章，具備不可否認性、完整性保護及身份驗證功能，確保資料真實可靠。系統亦會自動通知相關人員進行查看。

操作步驟:

1.使用者完成基本資料輸入後，點選「下一步」進入文件上傳階段。

2.點選「文件上傳」按鈕，選取欲處理的文件，文件成功上傳後，點選「下一步」進入簽署人設定階段。

3.設定簽署人相關資訊，完成後點選「發送簽署人」即可完成本次簽核流程。

[圖3-3-1-1]基本資料填寫畫面

[圖3-3-1-2]上傳文件畫面

[圖3-3-1-3]簽署人即通知內容設定畫面

注意事項:

1.檔案上傳限制

-單次簽核流程最多可上傳 5 個檔案。

-測試帳號：總檔案大小不得超過 1MB。

-正式帳號：總檔案大小不得超過 10MB。

2.簽署人設定

-可點選「增加簽署步驟」，客製化設定簽署流程的簽署關卡。

3.通知設定

-「設定通知交付 Email」：電子契約流程建立完成時，系統會發送通知至相關人員的 Email。

-「設定完成簽署通知 Email」：當電子契約流程全數簽署完成時，系統會發送通知至相關人員的 Email。

-「設定簽署人員通知頻率」：可設定尚未完成簽核時，系統通知該關卡相關人員的時間。

4.LINENotify 通知

-若會員註冊時有新增 LINENotify 權杖，則簽電子契約流程建立完成時，系統會透過 LINENotify 通知簽署人員及相關人員。

查詢簽核流程(憑證)

使用者可透過此功能查看簽核流程資料。

[圖3-3-2-1]查詢結果畫面

查詢結果詳細功能說明如下:

1.點選「交辦日期超連結」，跳轉至簽章流程管理頁面。

2.點選「新增簽署文件」，跳轉至建立簽章流程頁面。

簽章流程管理頁面說明如下:

1.在基本資料進行調整後，點選「更新」按鈕，以保存變更。

2.簽署文件清單:「文件超連結」，可下載該文件;點選「查看簽章歷程」，可查看該文件的簽章歷程和簽章憑證資訊。

3.簽署進度:可查看文件的當前簽署進度。

教學影片(發起端)：登入

教學影片(簽核端)：登入

報價單簽發

使用者可透過本平臺傳輸報價單文件，文件經由本平臺進行簽章，具備不可否認性、完整性保護及身份驗證功能，確保資料真實可靠。系統亦會自動通知相關人員進行查看。

操作步驟:

使用者完成基本資料輸入後，點選「發送通知人」即可完成本次報價單流程。

[圖3-4-1-1]報價單簽發畫面

注意事項:

1.檔案上傳限制

-單次簽核流程最多可上傳 5 個檔案。

-測試帳號：總檔案大小不得超過 1MB。

-正式帳號：總檔案大小不得超過 10MB。

2.通知設定

-「設定通知交付 Email」：電子契約流程建立完成時，系統會發送通知至相關人員的 Email。

-「設定完成簽署通知 Email」：當電子契約流程全數簽署完成時，系統會發送通知至相關人員的 Email。

-「設定簽署人員通知頻率」：可設定尚未完成簽核時，系統通知該關卡相關人員的時間。

3.LINENotify 通知

-若會員註冊時有新增 LINENotify 權杖，則簽電子契約流程建立完成時，系統會透過 LINENotify 通知簽署人員及相關人員。

回簽報價單

使用者可透過本平臺傳輸報價單文件並設定簽署人關卡，文件經由本平臺進行簽章，具備不可否認性、完整性保護及身份驗證功能，確保資料真實可靠。系統亦會自動通知相關人員進行查看。

操作步驟:

使用者完成基本資料輸入後，點選「發送通知人」即可完成本次報價單流程。

[圖3-4-2-1]回簽報價單建立畫面

注意事項:

1.檔案上傳限制

-單次簽核流程最多可上傳 5 個檔案。

-測試帳號：總檔案大小不得超過 1MB。

-正式帳號：總檔案大小不得超過 10MB。

2.通知設定

-「設定通知交付 Email」：電子契約流程建立完成時，系統會發送通知至相關人員的 Email。

-「設定完成簽署通知 Email」：當電子契約流程全數簽署完成時，系統會發送通知至相關人員的 Email。

-「設定簽署人員通知頻率」：可設定尚未完成簽核時，系統通知該關卡相關人員的時間。

3.LINENotify 通知

-若會員註冊時有新增 LINENotify 權杖，則簽電子契約流程建立完成時，系統會透過 LINENotify 通知簽署人員及相關人員。

查詢報價單

使用者可透過此功能查看報價單資料。

[圖3-4-3-1]查詢結果畫面

查詢結果詳細功能說明如下:

1.點選「建立日期時間超連結」，跳轉至報價單流程管理頁面。

2.點選「新增報價單文件」，跳轉至建立報價單流程頁面。

報價單流程管理頁面說明如下:

1.簽署文件清單:「文件超連結」，可下載該文件;點選「查看簽章歷程」，可查看該文件的簽章歷程和簽章憑證資訊。

教學影片(業務端)：登入

教學影片(客戶端)：登入

簽署紀錄查詢

使用者可透過此功能查看月份區間發起文件、文件總簽署及發證總數量。

[圖3-5-1-1]查詢結果畫面

[圖3-5-1-1]歷程查詢結果畫面

查詢結果詳細功能說明如下:

1.點選「發起次數超連結」，系統將顯示文件發起歷程的小視窗，點選「文件名稱超連結」，可下載該文件，點選「簽署次數超連結」，視窗下方顯示簽章歷程和簽章憑證資訊。

2.點選「發證次數超連結」，系統將顯示文件發證歷程的小視窗，點選「文件名稱超連結」，可下載該文件。

帳號資訊

使用者可透過此功能查看或調整帳號資訊。

[圖3-7-1-1]基本查詢畫面

[圖3-7-1-2]身分證維護畫面

[圖3-7-1-3]申請API權限畫面

帳號管理頁面說明如下:

1.在基本資料進行調整後，點選「修改帳號資訊」按鈕，以保存變更。

2.點選「修改身分證號碼」按鈕，進行變更身分證號碼。

3.點選「申請使用權限」按鈕，向本平台申請使用API權限，若核准，將會寄送API TOEN至註冊信箱。

『關貿網路數位簽章服務平臺』線上製作與流程說明

如何進入「關貿網路數位簽章服務平臺」畫面

API欄位格式說明

API錯誤代碼Error Code對應表

API呼叫流程

API清單

UploadPdfFile()

範例請求：

範例回應：

CertData()

範例請求：

範例回應：

LineNotify()

範例請求：

範例回應：

exportCertificate()

範例請求：

範例回應：

電子契約

新增電子契約

電子契約查詢

數位證書

產證作業

證書設計

簽核流程

建立簽核流程(憑證)

查詢簽核流程(憑證)

報價單作業

報價單簽發

回簽報價單

查詢報價單

簽署紀錄

簽署紀錄查詢

電子文件夾

已接收文件

已傳送文件

管理設定

帳號資訊

憑證管理