導入財政部電子發票服務之文件集

備註

本文件集中所提及、引用、截取的文句、畫面多來自 財政部電子發票整合服務平台(https://www.einvoice.nat.gov.tw/)、財政部北區國稅局(https://www.ntbna.gov.tw/)。其著作權之合理使用，請詳見其平台之「著作權保護政策」及「政府網站資料開放宣告」網頁。

警告

本文件集乃基於忠實、客觀、利己且利他等原則寫作，難免還是有錯字、過版、語意模糊、誤用等情事發生。請利用人就自身風險擔負能力來利用本文件集，本文件集作者不擔保任何責任。

若對本文件集有任何意見、建議或改正，歡迎寄信到 hoamon@ho600.com 。

本文件集之著作權公開授權模式

Django-taiwan-einvoice.readthedocs.io 網站內容為 ho600 Ltd. 所創作， 除非另有說明，否則皆採用 創用 CC 姓名標示-相同方式分享 3.0 台灣 授權條款授權。


本文件集之目標

  • (完成)協助消費者在整合平台設定發票載具

  • (撰寫中)協助營業人在整合服務平台上，開立、作廢、開立折讓、作廢折讓、退回 B2B 電子發票

  • (撰寫中)協助營業人透過 Linux 版的 Turnkey-3+ 系統存證開立、作廢、註銷、開立折讓、作廢折讓 B2C 電子發票。所使用版本:

    • Turnkey 軟體版本: 3.0.2

    • 電子發票資料交換標準訊息建置指引(Message Implementation Guideline)版本: 3.2.1

  • (撰寫中)協助營業人利用 Django-taiwan-einvoice app 為 Turnkey 系統提供 Web API 服務

  • (待續)協助營業人透過加值服務中心完成電子發票相關服務

  • (待續)「查詢電子發票API」教學

備註

名詞釋疑

所謂 B2B 、 B2C ，並不完全套用以字面上的 Business 及 Customer 。因為 B2B 發票可以開給機關、組織，而 B2C 發票也可以開給一般營利公司。

我這邊提供比較適當的解釋， B 是法人、準法人(商業行號)， C 則是除自然人外，也包含法人、準法人。所以 B2B 一定是買賣雙方都有統編方可使用的服務，而 B2C 則是買方可以是自然人(無統編)也可以是法人、準法人。

名詞定義

  • EI: 財政部電子發票整合服務平台，也稱「大平台」

  • EPW: 使用 Django-based escpos_web App 建構的發票列印管理系統。 EPW 系統加上感熱式印表機可簡稱「發票機」

  • TKW: 使用 Django-based turnkey_web 程式來擴充 Turnkey 系統，使其提供 Web Api 功能的電子發票管理系統

  • CEC: 叫用 EPW 及 TKW 系統的自架電子商務銷售系統(Customize E-Commercial system)，也可稱「小平台」

  • TEA: 提供 CEC 系統叫用的 Django-based taiwan_einvoice App 。 如果說 CEC 是 CPython 撰寫的，那 CEC 就直接利用 TEA 函式庫去跟 EPW/TKW 互動，若 CEC 是 PHP/.Net/Java/… 撰寫的， 那就先叫用導入(import) TEA 的 Web Api Service (TEAWEB 或 taiwan_einvoice_web)，間接與 EPW/TKW 互動

使用 EI 大平台開立 B2B 電子發票的事前準備說明

  1. 測試用 財政部電子發票整合服務平台: 營業人身份(https://wwwtest.einvoice.nat.gov.tw/index!changeFocusType?newFocus=F1348636625449) 頁面

  2. 正式用 財政部電子發票整合服務平台: 營業人身份(https://www.einvoice.nat.gov.tw/index!changeFocusType?newFocus=F1348636625449) 頁面

  3. 效期內的實體憑證，依身份別來申辦:

    1. 「工商憑證」 - 一般營利事業單位用，申請網站請到 MOEACA

    2. 「XCA 憑證」 - 一般組織、團體單位用，申請網站請到 XCA

    3. 「GCA 憑證」 - 一般政府機關單位用，申請網站請到 GCA

    4. 「自然人憑證」 - 一般正常人用，請親自到 任一 戶政事務所辦理，說明在 此

  4. 使用實體憑證前，可至 經濟部工商憑證管理中心的瀏覽器檢測 頁面驗證相關元件

  5. 電子發票字軌號碼申請書(含電子發票開立系統自行檢測表) - 位於 EI 大平台/營業人文件下載頁面

  6. 使用電子發票承諾書 - 此文件與「電子發票字軌號碼申請書(含電子發票開立系統自行檢測表)」是放在同一個壓縮檔中

自建 Turnkey-3+ 來開立 B2C 電子發票的事前準備說明

  1. 實體憑證註冊 EI 大平台帳號

  2. 線上申請 Turnkey 正式區及驗證區: 申請網頁在 EI 大平台/Turnkey傳輸作業/Turnkey傳輸申請

  3. 申辦軟體憑證。雖然 Turnkey 也接受以實體憑證來傳輸發票檔，但實體憑證插讀卡機在上容易衍生資安疑慮

  4. 營業人應用 API 申請(捐贈碼、手機條 碼檢核及信用卡載具 等 API)

  5. 電子發票Turnkey上線前自行檢測作業 - 須於測試環境完成Turnkey上線前自行檢測作業，確保發票傳輸的正確性

參考資料

  • 財政部電子發票整合服務平台
    • 營業人
      • 財政部傳輸軟體(Turnkey)

        • 線上申請說明下載

        • 各項手冊與相關文件:

          • Turnkey-使用手冊_v3.2

        • Turnkey-3.0.2-linux

      • 文件下載
        • 營業人常用文件

          • 電子發票整合服務平台營業人導入與操作說明

          • 電子發票整合服務平台服務申請表

          • 電子發票營業人應用API(V1.7)

          • 軟體憑證製作手冊

          • 電子發票資料交換標準文件與範例(V3.2.1)

          • 電子發票Turnkey上線前自行檢測作業(V4.6)

          • 營業人比對上傳發票結果流程說明

          • 電子發票證明聯一維及二維條碼規格說明(V1.8)

          • 加解密API使用說明書(V1.12)

          • 電子發票QRCode加解密工具/營業人啟用第2層資訊防偽機制流程說明文件v20160817

          • 電子發票字軌號碼申請書(含電子發票開立系統自行檢測表)

  • 財政部北區國稅局>主題專區>稅務專區>營業稅>電子發票專區

目錄

版本修訂紀錄

文件撰寫中之待辦事項

Todo

待續

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/agent.rst ，第 4 行)

Todo

撰寫中

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/import_django_taiwan_einvoice.rst ，第 4 行)

Todo

待續

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/inquire_api.rst ，第 4 行)

Todo

  • 批次開立發票

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/merchant_create_b2b_invoice.rst ，第 209 行)

Todo

標題號稱「總覽」，然實際上，部份頁面還未撰寫到。

請耐心等候~

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/merchant_operations.rst ，第 4 行)

Todo

這裡所謂「Email接受」是由整合服務平台自動幫你確認接收的說法， 單純是從網頁文字說明判斷而來，實務上，尚未看到任何教學影片或投影片明確提及。 待確認這個說法。

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/merchant_operations/營業人功能選單/基本資料/營業人接收方式設定.rst ，第 20 行)

Todo

  • 列出各項作業名稱的實質定義

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/merchant_operations/營業人功能選單/待辦事項/待辦事項.rst ，第 14 行)

Todo

待續中。

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/merchant_operations/營業人功能選單/線上銷項發票作業/開立發票.rst ，第 8 行)

Todo

待續中。

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/merchant_operations/電子發票專用字軌號碼取號/電子發票上傳作業/上傳未使用空白發票號碼.rst ，第 8 行)

Todo

有撰寫書面文件，待整理。

(原始記錄 見 /home/docs/checkouts/readthedocs.org/user_builds/django-taiwan-einvoice/checkouts/latest/docs/self_checklist_before_turnkey_online.rst ，第 10 行)