簡介
QBoss 電子發票整合管理系統是一套包含上線測試、開立、管理、上傳等功能的電子發票系統，不需要租用其他外部系統或加 值服務中心，即可自行開立、上傳電子發票。 為了讓企業可以將QBoss 電子發票整合管理系統與現有 ERP 系統整合，弈飛資 訊研發團隊特別開發了一套以分散式物件為基礎的 API 開發套件，讓企業可以快速的完成開發、整合、與部署工作。
套件內容與開發平台
『QBoss 電子發票整合管理系統 API 開發套件』(以下簡稱本套件)內容包括：
- 開發環境專用 API 套件安裝檔
- 使用者環境 API 安控系統安裝檔
- 開發手冊(PDF檔)
- 範例程式原始碼
QBoss 電子發票整合管理系統 API 開發套件 .NET 版，是以 .Net Framework 4.6 為開發平台。 任何支援 .Net Framework 4.6 的開發工具與語言皆可使用，本文件將提供 C#範例程式。
API 架構說明
QBoss 電子發票整合管理系統 API 開發套件 .NET 版是依據 Factory Design Pattern 所設計與實作的一套分散式物件 API 系統。
架構設計
QBoss 電子發票整合管理系統 API 套件系統成員包含：
- API 代理程式： InvoiceFactory
- API 安控系統：APIController
其中 APIController 負責提供後勤服務，並與資料庫與印表機溝通。InvoiceFactory 則是負責服務前端的 ERP 系統，並透過 分散式物件傳遞方式與後端的 APIController 溝通。
應用情境
為了方便您規劃您的開發工作，以下提供幾種常見的使用情境與架構供您參考。
ERP 系統直接與 API 串接
這種方式是直接修改 ERP 系統的發票開立流程，讓使用者在不改變原有使用習慣的情形下，直接透過 ERP 系統開立發票。
當ERP 系統透過代理元件將發票需求傳遞給電子發票 API 之後，若發票開立成功，將會回傳發票號碼，ERP 系統即可將取得的發票號碼寫入訂單資料。
有關發票號碼配號部分，QBoss 電子發票API 可以選擇由整合管理系統配號，或是由外部 ERP 系統配號。對於原已導入電子計算機發票的企業，即可選擇由 ERP 系統配號，以簡化開發成本。
獨立開立工具搭配 ERP 系統使用
這種方式是在不改變原有 ERP 系統的原則下進行。最大的好處是開發、測試期間，原有 ERP 系統完全不受影響，是最安全、保守的方式。如果企業導入套裝 ERP 系統或是修改 ERP 系統的成本太高，可以選用這種方式。
使用者 Key 完訂單之後，ERP 系統將資料寫入資料庫，再利用自行開發的電子發票開立系統讀取訂單資料，並執行發票開立工作。
自動偵測新訂單並開立發票
這種方式可以視為是前一種方式的變形，利用一支自動化的服務或是應用程式偵測訂單狀態，若發現尚未開立發票的新訂單，或是其他發票作業，及自動取得相關資料，並通知 API 進行相關的發票作業。
如是不希望讓使用者在 ERP 系統與發票開立系統的操作介面中反覆的切換，或是希望將發票開立自動化導入原有ERP 系統者，則可以採用這種架構。
自行開發產業別快速開立工具
QBoss 電子發票整合管理系統是一套包含上線測試、開立、管理、上傳等多功能的電子發票系統，但是，對於多樣化的商業環境，QBoss 電子發票整合管理系統並無法滿足所有產業別的開立習慣。例如一些專業服務，他們的品項可能一支手就可以算出來，因此不需要什麼品名資料。或是像停車場這種計時收費的行業，他們的品項只有一個，例如停車費，因此只需要輸入金額，即可開立發票。又會類似報關行這類的行業，他們的客戶幾乎都是 B2B，而且需要能快速大量開立，因此在操作上希望以鍵盤操作為主。
對於這些的需求，就可以選擇針對行業別的不同需求與使用習慣，開發專屬的開立系統。
常見問答
如果是 API 的問題，您可以參考文件的範例程式，每一個範例程式都有詳細的註解說明。只要稍具程式開發能力者，應可輕鬆應付。
您也可以選擇購買 Email 技術支援服務，由本公司專業的工程師協助您解答問題。
如果是一般程式撰寫的學習與問題，這一部分請尋求專業的教育訓練機構提供程式開發的教育訓練。
沒有。程式開發的問題很難透過電話說明，針對 API 串接部分，本公司僅提供付費 Email 技術支援服務。
若貴公司需要專人解說 API 函數的使用方式，請與客服人員聯繫，會有業務人員與您聯繫。
若貴公司需要專人解說 API 函數的使用方式，請與客服人員聯繫，會有業務人員與您聯繫。
如果是一般程式撰寫的學習與問題，這一部分請尋求專業的教育訓練機構提供程式開發的教育訓練。
目前 .NET 版只能使用 .NET 開發工具開發。您可以參考建議 4-2 或 4-3 的架構的說明。
未來我們也會推出以 http 為通訊基礎的 WebAPI 版，即可使用不同的開發工具進行串接。
軟體授權
授權說明
本套件授智慧財產權保護，凡購買『QBoss 電子發票整合管理系統』之個人、企業或其協力廠商，基於開發與QBoss 電子發票整合管理系統介接功能之需求，在善意使用範圍內，皆可免費合法使用本套件，並可依需要部署於使用者環境。
開發套件乃依據現狀所研發，弈飛資訊不保證其必然適合貴公司之使用，亦不針對使用之必然或非必然結果提供任何的保證與承諾。
個人、企業或其協力廠商可參考開發手冊與範例說明自行使用本套件，弈飛資訊不提供任何形式的技術支援服務。
針對 API 串接使用部分，個人、企業或協力廠商可依需要另行購買付費之 Email 技術支援服務。
