電子發票整合服務平台 --Turnkey 設定與操作說明 https://www.einvoice.nat.gov.tw 1
Turnkey 設定與操作說明 -Turnkey 操作介面 -Turnkey 環境與連線 -Turnkey 操作與設定 2
Turnkey 操作介面 - 啟動 點選 二代電子發票客戶端連線軟體 即可啟動程式 ( 注意 : 在 Window 7 或 Vista 上啟動時, 請點選滑鼠右鍵 以系統管理員身分執行 ) 3
Turnkey 操作介面 - 主要功能 營業人與平台中心端之資料傳送與接收 連線及發票處理記錄查詢 作業排程管理 ; 目錄設定 訊息加簽處理, 選擇加簽憑證 訊息版本轉換 4
Turnkey 操作介面 - 功能畫面 各項功能說明詳見 Turnkey 操作與設定 5
Turnkey 設定與操作說明 -Turnkey 操作介面 -Turnkey 環境與連線 -Turnkey 安裝設定 6
Turnkey 環境與連線 - 安裝環境需求 Windows 或 LINUX : -RAM: 2GB 以上 -H D: 可用空間 80GB 以上 ( 含運作空間 ) -CPU: 雙核以上 LINUX: ( 需使用圖形介面 ) Ubuntu 10.4 以上 Redhat ES 5.4 以上, 需安裝好 XWindow, 可支援 32 及 64 位元作業系統 WINDOWS: WINXP WIN2003Server 以上, 可支援 32 位元 及 64 位元作業系統 JAVA JDK -JDK1.6.X, 不支援 JDK1.7 資料庫 : -Turnkey 內部檔案系統 ( 不須外部資料庫 ) -PostgreSQL 8.0.x 或以上 ( 與 AP2AP Gateway 不同 Schema) -Oracle 10 以上 -MySQL5 MSSQL Server2003 以上 - 如沿用一代 PostGreSQL,Turnkey 需被建立在不同的資料庫中 7
Turnkey 環境與連線 - 安裝環境需求 二代電子發票整合服務平台之中心端連線主機名稱如下表, 使用 TurnKey 連線時請依照用途 ( 連線測試或是正式上傳 ) 之不同, 在 Turnkey 系統環境設定時選擇不同的執行環境, 避免測試資料或正式資料上傳到錯誤的整合服務平台上 8
Turnkey 環境與連線 - 安裝模式 前提 Turnkey 不能共用 DB Instance, 一個 Turnkey 須搭配一個 DB Instance 模式一 : 模式二 : 模式三 : PC1 Turnkey 1 ins1 Turnkey 1 ins1 Turnkey 1 PC2 Turnkey 2 PC3 Turnkey 3 ins2 ins3 Turnkey 2 Turnkey 3 ins3 PC ins2 Turnkey 2 Turnkey 3 PC ins 一台 PC 搭配一套 Tunrkye 與一個 DB 一台 PC 安裝多套 Tunrkye 個別相對應的 DB 一台 PC 搭配多套 Tunrkye 與單一 DB ( 無法運作 ) 9
Turnkey 環境與連線 - 上傳訊息傳輸流程 賣方營業人 開立發票 上傳目錄設定 > 目錄總覽 > 各別訊息類型中之來源目錄路徑資料夾 1. 轉檔 2. 封裝 3. 上傳 上傳發票資料 ERP 電子發票檔 Turnkey 下載傳送結果 目錄設定 > 來源目錄 > 指定路徑中之相對資料夾 B2B 交換目錄設定 (B2B 交換 ); B2B 存放目錄設定 (B2B 存證 ); B2C 存放目錄設定 發票配號訊息格式目錄設定 電子發票檔格式請參照 電子發票資料交換標準訊息建置指引 (MIG) 10
Turnkey 環境與連線 - 接收發票傳輸流程 買方營業人 接收發票 下載流程目錄設定 > 接收流程目的目錄 > 指定路徑中之相對資料夾 3. 轉檔 4. 封裝 5. 上傳 發票確認資料上傳 ERP 電子發票檔 ( 確認 ) Turnkey 1. 拆封 2. 轉檔 下載 電子發票檔 B2B 交換格式訊息對照如下 : A0102 發票開立確認 A0202 發票作廢確認 A0302 發票退回確認 B0102 折讓開立確認 B0202 折讓作廢確認 電子發票檔格式請參照 電子發票資料交換標準訊息建置指引 (MIG) 11
Turnkey 設定與操作說明 -Turnkey 操作介面 -Turnkey 環境與連線 -Turnkey 安裝設定 12
Turnkey 安裝設定 - 安裝設定流程 下載安裝 設定 使用及查詢 1 2 3 軟體下載 軟體安裝 2-1 資料庫設定 2-2 連線測試 A. 系統自動更新 B.SFTP Service C.WEB Service 13
Turnkey 安裝設定 - 自動更新檢查 Turnkey 啟動時會自動檢查是否有更新版本 ( 程式更新 I P 117.56.24.205 port 80) 點選 是 進行更新檔下載 點選 是 進行 Turnkey 程式更新 14
Turnkey 安裝設定 - 自動更新檢查 二代電子發票整合服務平台會依據營業人提供客戶端 IP 位置, 開通中心端之防火牆, 若營業人有異動就必須再填寫 電子發票整合服務申請單 ( 第四大項 ) 提出申請 15
Turnkey 安裝設定 - 安裝設定流程 下載安裝 設定 使用及查詢 1 系統管理 A. 憑證管理 B. 傳送帳號管理 C. 送方管理 D. 系統環境設定 2 3 檔案收送 A. 目錄設定 B. 下載流程目錄設定 C. 排程設定 ( 含清檔 ) 參考文件 1. Turnkey 使用說明書 ( 第三 四章節 V2.4 版 p22~p43 ) 2. 二代電子發票整合服務平台帳號核定通知 16
Turnkey 安裝設定 - 登入系統 操作步驟 : 1. 輸入使用者帳號與密碼 2. 點選 [ 確定 ] Turnkey 的使用帳號與密碼預設為帳號 : ADMIN 密碼 :ADMIN 使用者進入 Turnkey 之後, 可以使用 [ 系統管理 ]>[ 使用者管理 ] 功能, 建立管理者與使用者的帳號密碼 此帳號用於登入 Turnkey 畫面及 Turnkey 功能權限控管, 和 Turnkey 之中的傳送帳號其意義和功能都不同, 請注意不要混淆 17
Turnkey 安裝設定 - 操作主畫面 應用說明 : 1. 進入 Turnkey 畫面之後, 需要先確認是否為最新版本及現有連線環境為何 2. 二代電子發票客戶端連線軟體最新版本以平台公告為主 18
Turnkey 安裝設定 - 系統管理 -- 憑證管理操作步驟 : 1. 點選 [ 系統管理 ] 2. 點選 [ 憑證管理 ] 應用說明 : 此功能提供使用者管理憑證之設定, 此處設定的憑證會作為上傳資料的簽章之用, 若此 Turnkey 提供多組營業人 ( 統編 ) 資料上傳及交換, 則可設定多組憑證對不同來源的資料進行簽章 19
Turnkey 安裝設定 - 系統管理 -- 憑證管理操作步驟 : 1. 點選 [ 新增 ] 20
Turnkey 安裝設定 - 系統管理 -- 憑證管理操作步驟 : 1. 輸入自行設定的 [ 憑證代碼 ] 2. 輸入憑證密碼 3. 選擇憑證類型 憑證代碼請自行設定 ( 最長 4 碼 ) 4. 如為軟體憑證須設定憑證路徑 5. 點選 [ 確定 ] Card( 卡片 ) 及 PFX( 軟體憑證 ) 當憑證類型為 Card 時, 憑證路徑不允許編輯 1.Turnkey 可使用軟體憑證或卡片憑證, 且須完成整合服務平台上憑證登錄 ( 主憑證或附屬憑證 ) 才可以被使用, 否則上傳之資料會因為 驗章失敗 的錯誤被平台退回 2. 若為卡片憑證, 則只能設定一筆憑證資料, 且註冊憑證以及排程上傳資料時, 卡片必須保持在讀卡機之中, 否則執行簽章時會發生錯誤 21
Turnkey 安裝設定 - 系統管理 -- 傳送帳號管理操作步驟 : 1. 點選 [ 系統管理 ] 2. 點選 [ 傳送帳號管理 ] 應用說明 : 提供使用者管理傳送帳號相關設定 此傳送帳號及密碼是由電子發票整合服務平台提供, 作為連線平台時的身分識別之用, 若此 Turnkey 可為多個送方營業人傳送及接收資料, 可以設定多組帳號密碼 22
Turnkey 安裝設定 - 系統管理 -- 傳送帳號管理 操作步驟 : 1. 點選 [ 新增 ] 2. 輸入傳送帳號與密碼 3. 點選 [ 確定 ] 設定說明 : 傳送帳號與密碼須向整合服務平台提出申請, 申請後會核發傳送帳號與密碼 (Mail 通知 ) 二代電子發票整合服務平台帳號核定通知 23
Turnkey 安裝設定 - 系統管理 -- 送方管理操作步驟 : 1. 點選 [ 系統管理 ] 2. 點選 [ 送方管理 ] 1. 本功能提供使用者維護訊息送方清單 2. 送方是指使用此 Turnkey 上傳資料的營業人或加值中心 3. 上傳的發票都會透過 憑證管理 中設定的憑證加上簽章後, 以 傳送帳號 送出 4. 依據整合服務平台已設定的繞送代碼下載相對應的訊息 24
Turnkey 安裝設定 - 系統管理 -- 送方管理操作步驟 : 1. 點選 [ 新增 ] 25
Turnkey 安裝設定 - 系統管理 -- 送方管理 1. 請選擇 [ 憑證管理 ] 所設定的憑證代碼 平台所註冊或所允許之繞送代碼後, 點選 [ 確定 ] 2. 請選擇 [ 傳送帳號管理 ] 所設定之傳送帳號 非必要欄位 如為總公司或加值中心代傳, 則須勾選 [ 存證代理人 ] 3. 請點選 [ 查詢繞送代碼 ] 4 26
Turnkey 安裝設定 - 系統管理 -- 收方管理操作步驟 : 1. 點選 [ 系統管理 ] 2. 點選 [ 收方管理 ] 應用說明 : 此功能僅供回傳 B2B 交換買方自行設定用, 其餘則由系統自動擷取營業人最新平台 營業人接收方式設定 設定內容 27
Turnkey 安裝設定 - 系統管理 -- 收方管理操作步驟 : 1. 點選 [ 新增 ] 28
Turnkey 安裝設定 - 系統管理 -- 收方管理 1. 請輸入 [ 傳送帳號管理 ] 所設定之傳送帳號 2. 請點選 [ 查詢繞送代碼 ] 平台所註冊或所允許之繞送代碼後, 點選 [ 確定 ] 3 29
Turnkey 安裝設定 - 系統管理 -- 系統環境設定操作步驟 : 1. 點選 [ 系統管理 ] 2. 點選 [ 系統環境設定 ] 30
Turnkey 安裝設定 - 系統管理 -- 系統環境設定 / 系統設定 設定在 排程設定 中的執行記錄所存放的檔案名稱及位置 設定 Turnkey 連線至測試或正式環境 ( 必要設定 ) 提供排程設定中的清檔任務執行時, 要刪除幾天之前的資料的設定值 第一次進入 Turnkey 畫面中, 一定要先設定系統執行環境, 定義此 Turnkey 是連線至測試或是正式環境 31
Turnkey 安裝設定 - 系統管理 -- 系統環境設定 / 通知設定 設定發生事件紀錄時要寄送的 email 信箱地址, 寄件人 以及使用的郵件伺服器 若是郵件伺服器有設定帳號密碼則勾選, 若無則不需要 可設定郵件的內容中, 除了事件的通知外, 還要包含那些文字, 例如可寫入系統管理員的分機, 方便收到信件的人聯絡問題處理人員 當 Turnkey 自動檢測有連線錯誤或未完整接收平台回訊時, 將自動以 EMAIL 方式通知 32
Turnkey 安裝設定 - 檔案收送 操作步驟 : 1. 點選 [ 檔案收送 ] 2. 依照使用者需求點選設定 [B2B 存放目錄設定 ] [B2B 交換目錄設定 ] [B2C 存放目錄設定 ] [ 發票配號訊息目錄設定 ] 3. 設定相對應的 [ 下載流程目錄設定 ] 應用說明 : 1. 檔案收送的功能為設定上傳及下載的資料版本格式與存放目錄 2. 不論是透過 Turnkey 傳送或接收訊息, 上傳與下載目錄設定訊息版本 (MIG) 須一致, 才能正常解析 3. 訊息格式請參閱 電子發票資料交換標準訊息建置指引 ( MIG) 4. 各項目錄設定須由使用者點選 [ 確定 ], 系統才會建立相對應的路徑供上傳或下載使用 33
Turnkey 安裝設定 - 檔案收送 -- 上傳目錄設定 ( 範例 ) 若因系統架構須調整存放路徑, 則僅能調整 EINVTurnkey 前面指定的路徑 使用者需針對其上傳訊息, 將發票資訊擺放至對應訊息之目錄下的 SRC 資料夾中, 檔名無任何限制 例如, 若需使用 A0101 資料, 則需將資料放置於 : C:\Program Files\EINVTurnkey\UpCast\B2BEXCHANGE\A0101\SRC 34
Turnkey 安裝設定 - 檔案收送 -- 發票配號訊息目錄設定 ( 範例 ) 使用者需針對其上傳訊息, 將發票資訊擺放至對應訊息之目錄下的 SRC 資料夾中, 檔名無任何限制 例如, 若需使用 E0401 資料, 則需將資料放置於 : C:\Program Files\EINVTurnkey\UpCast\B2pMESSAGE\E0401\SRC 35
Turnkey 安裝設定 - 檔案收送 -- 下載流程目錄設定 ( 範例 ) 使用者可自發票相對應訊息之目的目錄下的 SRC 資料夾中, 取得賣方傳送出的發訊息資訊 例如, 若下載發票開立 A0101 資料, 則資料完成下載後, 將置放於 : C:\Program Files\EINVTurnkey\RecvTarger\A0101 中 36
Turnkey 安裝設定 - 檔案收送 操作步驟 : 1. 點選 [ 檔案收送 ] 2. 點選 [ 排程設定 ] 應用說明 : 1. 使用者可以手動或設定自動排程方式上傳與下載資訊 2. 可透過 [ 檢視訊息紀錄 ] 或 [ 檢視事件紀錄 ] 確認傳送結果 37
Turnkey 安裝設定 - 檔案收送 -- 排程設定 ( 自動排程 ) 本功能提供使用者設定收送發票資料的時間或間隔, 在使用本功能前, 須先設定好 憑證管理 帳號管理 送方管理 各存放及交換目錄 下載流程目錄 等基本資料 38
Turnkey 安裝設定 - 檔案收送 -- 排程設定 ( 自動排程 -- 選擇任務 ) 大型營業人適用例如 : 統一超商 加值中心名詞解釋 - 上傳轉檔 : 將訊息版本轉成統一格式上傳封裝 : 將轉檔後的訊息加註收送方代碼及憑證加簽傳送檔案 : 傳送到電子發票平台 中 小型營業人適用 啟動此任務時, 會根據 系統環境設定 中設定的 保留天數 清除此天數之前的上傳與下載歷史訊息紀錄 1. [ 各別任務 ] 及 [ 整合任務 ] 只能選擇一種任務模式 2. 如選擇 [ 各別任務 ] 則須完成設定 U: 上傳轉檔 U: 上傳封裝 U: 傳送檔案 D: 接收檔案 D: 下載拆封 D: 下載轉檔 3. 如選擇 [ 整合任務 ] 則須完成設定 A: 發票上傳 A: 發票下載 39
Turnkey 安裝設定 - 檔案收送 -- 排程設定 ( 自動排程 執行時間 ) 方式一 : 定時 + 星期 - 每天最多可設 8 組時間 方式二 : 間隔 + 星期 - 設定每隔多久執行接收 傳送起迄時間二擇一 40
Turnkey 安裝設定 - 檔案收送 -- 排程設定 ( 傳送與結果檢視 ) 排程開始到結束的傳送 接收記錄 查詢傳送 接收訊息的記錄 查詢錯誤事件記錄 手動上傳與下載訊息 自動排程之啟動與停止 41
Turnkey 安裝設定 - 安裝設定流程 下載安裝 設定 使用及查詢 1 2 交易日誌查詢 A. 檢視訊息記錄 B. 檢視事件記錄 C. 統計訊息紀錄 工具 清檔設定 42
Turnkey 安裝設定 - 交易日誌查詢 操作步驟 : 1. 點選 [ 交易日誌查詢 ] 2. 選擇欲查詢的方式 1. 須完成訊息之上傳與下載方得查詢到平台回覆最正確的結果 2. 檢視訊息紀錄 可查詢到傳送成功與失敗的訊息 3. 檢視事件紀錄 可查詢到傳送失敗的訊息 4. 統計訊息紀錄 可查詢並下載到傳送成功與失敗的訊息成為 CSV 檔案 43
Turnkey 安裝設定 - 交易日誌查詢 -- 檢視訊息紀錄 本功能提供使用者查詢 Turnkey 運作時期, 所處理的任何訊息記錄 提供簡易操作介面, 供使用者查詢訊息處理的過程及狀態 44
Turnkey 安裝設定 - 交易日誌查詢 -- 檢視訊息紀錄 針對狀態為 E(Error, 錯誤 ) 之訊息, 可利用滑鼠雙擊, 選擇開啟 事件紀錄 得知更詳細的錯誤說明 檢視訊息記錄前, 需先輸入查詢的條件, 如果都未輸入, 則顯示最近一小時的事件紀錄, 預設查詢筆數為 1000 筆, 最大可支援至 9999 筆 45
Turnkey 安裝設定 - 交易日誌查詢 -- 檢視訊息紀錄 狀態說明 : 表示發票資料上傳或處理的結果, 以下分別是各訊息代表的意義 -P: 資料處理中 -G: 資料上傳或下載完畢 -C: 資料上傳完畢, 且已收到整合服務平台回覆之存證或交換處理成功訊息上傳作業的資料要變為此狀態, 才代表此資料上傳成功 -I: 資料處理過程中被中斷, 當程式重新執行或錯誤問題排除後, 可自動繼續執行 -E: 資料上傳前發生格式或簽章錯誤, 或是資料已上傳後, 收到整合服務平台回覆之錯誤 46 46
Turnkey 安裝設定 - 交易日誌查詢 -- 檢視事件紀錄 本功能提供使用者查詢 Turnkey 運作時期, 所產生的任何錯誤記錄 提供簡易操作介面, 供使用者查詢訊息處理的錯誤原因 47
Turnkey 安裝設定 - 交易日誌查詢 -- 檢視事件紀錄 檢視事件記錄前, 需先輸入查詢的條件, 如果都未輸入, 則顯示最近一小時的事件紀錄, 預設查詢筆數為 1000 筆, 最大可支援至 9999 筆 48
Turnkey 安裝設定 - 交易日誌查詢 -- 檢視事件紀錄 更多錯誤訊息說明請參閱 Turnkey 使用說明書 P79~88 49
Turnkey 安裝設定 - 交易日誌查詢 -- 檢視事件紀錄 ( 錯誤訊息判讀與處理範例 ) 舉例 : 代碼狀態說明異常原因或處理方法 -004 PARSER: 解析發票時發生錯誤, 請確認解析發票時 1. 發票格式是否正確, 是否有符合 MIG 的規定 特別注意日期錯誤欄位與數字欄位是否符合規定 2. Turnkey 目錄設定是否正確, 目錄設定中選擇的 MIG 版本 編碼與型態是否與發票內容相符 3. 發票資料置放位置是否正確, 發票資料有按照其 MIG 名稱置放到對應的目錄下若以上設定都確認無誤, 並且找不到錯誤原因, 可將錯誤檔案及錯誤畫面寄給關貿客服人員協助釐清問題所在 此錯誤若在下載發票資料產生, 請洽關貿客服人員協助處理 50 50
Turnkey 安裝設定 - 交易日誌查詢 -- 統計訊息紀錄 此功能和檢視訊息紀錄相同, 不同之處是在查詢資料之前要先輸入查詢結果匯出的檔案位置, 系統會將查詢結果以 CSV 檔案格式匯出 此外, 此統計不受最大筆數 9999 的限制, 可提供營業人確認發票上傳結果狀態是否正常 51 51
Turnkey 安裝設定 - 交易日誌查詢 -- 統計訊息紀錄 報表明細資料, 提供訊息日期 狀態 發票識別碼等資料核對 狀態 :C 表示處理成功 E 表示錯誤發票識別碼 : 由訊息類型 + 發票號碼 + 發票日期組成 52 52
Turnkey 安裝設定 - 工具 -- 清檔設定 ( 手動清檔 ) 操作步驟 : 1. 設定刪除資料天數 2. 勾選清除項目 3. 點選 [ 執行 ] 本功能可提供使用者將指定路徑進行清檔動作, 以免因硬碟容量不足造成傳輸失敗 53
電子發票客服中心客服專線 :0800-521-988 客服傳真 :04-2378-4009 54