{"repo":"paid-tw/einvoice","free":true,"listed":false,"github":"https://github.com/paid-tw/einvoice","clone":"git clone https://github.com/paid-tw/einvoice.git","description":"台灣電子發票統一 SDK：一套與供應商無關的介面，支援 Amego、ECPay 綠界、ezPay 藍新與財政部平台。Unified e-invoice (電子發票) SDK for Taiwan — one interface, multiple providers.","language":"TypeScript","stars":152,"topics":["amego","e-invoice","ecpay","einvoice","electronic-invoice","ezpay","fapiao","invoice","monorepo","sdk"],"license":"MIT","category":"api-integrations-sdks","readme_excerpt":"einvoice-tw English ｜ 繁體中文 統一的 台灣電子發票 SDK 。一套與供應商無關的介面，搭配多個供應商轉接器 —— 在 Amego、ECPay、ezPay、ezReceipt、Simpany 等供應商之間切換，完全不需要動到你的商業邏輯。 台灣所有加值中心都包裝同一套財政部 MIG 4.0 規格，因此核心操作完全一致： 開立 / 作廢 / 折讓 / 折讓作廢 / 查詢 。本 SDK 將這些操作建模一次，讓每個供應商都只是一個 輕薄的轉接器。 套件 套件 npm 角色 --- --- --- @paid-tw/einvoice core 統一型別、 InvoiceProvider 介面、Zod 驗證、 MockProvider @paid-tw/einvoice-amego adapter Amego (amego.tw) — MD5 簽章 @paid-tw/einvoice-ezpay adapter ezPay 藍新 (ezpay.com.tw) — AES 加密 @paid-tw/einvoice-ecpay adapter ECPay 綠界 (ecpay.com.tw) — B2C 2.0，AES 加密 @paid-tw/einvoice-ezpay-crossborder adapter ezPay 境外電商 — 跨境 B2C、原生外幣 @paid-tw/einvoice-ezreceipt adapter ezReceipt 易發票 (COIMOTION) — 訂單導向 REST、token 認證 @paid-tw/einvoice-simpany adapter Simpany (simpany.co) — JWT 認證、雙主機 REST；⚠️ 寫入端點未經實測（見套件 README） 只需安裝你會用到的供應商 —— 轉接器是各自獨立的套件，因此一個只用 Amego 的應用程式 永遠不會拉進其他供應商的相依套件。 使用方式 只要更換建構子即可切換供應商 —— 你其餘的程式碼相依於 InvoiceProvider 介面，而非 特定轉接器。 不需憑證即可測試 MockProvider 跑與真實轉接器相同的驗證，但不發送網路請求。它也模擬狀態機（作廢後 不可再作廢 / 折讓）、依宣告的 capabilities 拒絕不支援的操作，並可用 failNext() 注入一次性錯誤來測試你的錯誤處理： 功能偵測 各供應商支援的選用功能不盡相同。每個供應商都會宣告一組 capabilities ，讓你能在 執行期就先分支處理，而不是等到呼叫失敗才發現缺少某項功能： 能力對照 每個轉接器都會宣告一組 capabilities ；可在執行期用 supports(provider, cap) / assertSupports(provider, cap) 偵測。 能力 Amego ECPay ezPay ezPay 跨境 ezReceipt Simpany --- :---: :---: :---: :---: :---: :---: ISSUE — 開立 ✅ ✅ ✅ ✅ ✅ ✅ VOID — 作廢 ✅ ✅ ✅ ✅ ✅ ✅ ALLOWANCE — 折讓 ✅ ✅ ✅ ✅ ✅ ✅ VOID ALLOWANCE — 折讓作廢 ✅ ✅ ✅ ✅ ✅ ✅ QUERY — 查詢 ✅ ✅ ✅ ✅ ✅ ✅ B2B — 統一編號買受人 ✅ ✅ ✅ — ✅ ✅ MIXED TAX — 混合稅率發票 ✅ ✅ ✅ — ✅ — QUERY BY ORDER ID","default_branch":null,"files":null,"tree":[],"storefront":"/r/paid-tw","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/paid-tw/einvoice/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}