Download the PHP package thoth-pharaoh/ecpay-invoice without Composer
On this page you can find all versions of the php package thoth-pharaoh/ecpay-invoice. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
Informations about the package ecpay-invoice
綠界B2C開發票工具
版本匹配
| Laravel | package |
|---|---|
| 8.X | 1.X |
| 9.X | 2.X |
安裝
使用 composer 做安裝
匯出 Config
添加 .env 支付工具必要環境參數
使用方法
先引入門面
- 開立一般發票
- 開立延遲發票
- 觸發開立發票
- 取消延遲開立發票
- 開立一般折讓發票
- 開立線上折讓發票(通知開立)
- 作廢發票
- 作廢折讓發票
- 註銷重開
- 查詢發票(根據特店自訂編號)
- 查詢發票(根據發票號及開立日期)
- 查詢折攘明細
- 查詢作廢發票明細
- 查詢作廢折讓明細
- 查詢字軌
- 發送發票通知
- 手機條碼驗證
- 捐贈碼驗證
開立一般發票
$data 內容說明(array格式)
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| RelateNumber | ✔ | 特店自訂編號 | String (30) | 需為唯一值不可重複使用(請勿使用特殊符號) |
| ✔ | 列印註記 | String (1) | 0:不列印 1:要列印 注意事項: 1. 當捐贈註記[Donation]=1(要捐贈)或載具類別[CarrierType]有值時，此參數請帶0 2. 當統一編號[CustomerIdentifier]有值時，此參數請帶 1 |
|
| Donation | ✔ | 特店自訂編號 | String (1) | 0:不捐贈 1:要捐贈 注意事項: 當統一編號[CustomerIdentifier]有值或載具類別[CarrierType]有值 時，此參數請帶 0 |
| TaxType | ✔ | 課稅類別 | String (1) | 當字軌類別[InvType]為 07 時，則此欄位請填入 1、2、3 或 9 當字軌類別[InvType]為 08 時，則此欄位請填入 3 或 4 1:應稅。 2:零稅率。 3:免稅。 4:應稅(特種稅率) 9:混合應稅與免稅或零稅率時(限收銀機發票無法分辨時使用，且 需通過申請核可) |
| SalesAmount | ✔ | 發票總金額(含 稅) | int | 請帶整數，不可有小數點 僅限新台幣 金額不可為 0 元 |
| InvType | ✔ | 字軌類別 | String (2) | 該張發票的發票字軌類型 07:一般稅額 08 : 特種稅額 |
| CustomerID | 客戶編號 | String (20) | 格式為『英文、數字、下底線』等字元 | |
| CustomerIdentifier | 統一編號 | String (8) | 格式為數字 | |
| CustomerAddr | 客戶地址 | String (100) | 當列印註記[Print]=1(列印)時，為必填 | |
| CustomerPhone | 客戶手機號碼 | String (20) | 當客戶電子信箱[CustomerEmail]為空字串時，為必填 格式為數字 |
|
| CustomerEmail | 客戶電子信箱 | String (80) | 當客戶手機號碼[CustomerPhone]為空字串時，為必填 需為有效的 Email 格式，且僅可填寫一組 Email 注意事項: 1.測試環境請勿帶入之真實電子信箱，避免個資外洩 2.測試環境僅作 API 串接測試使用，僅以 API 回覆成功或失敗;批 次匯入功能/API 不提供發信測試，僅驗規則 |
|
| ClearanceMark | 通關方式 | String (1) | 當課稅類別[TaxType]=2(零稅率)時，為必填 1:非經海關出口 2:經海關出口 |
|
| LoveCode | 捐贈碼 | String (7) | 當捐贈註記[Donation]=1(要捐贈)時，為必填 格式為阿拉伯數字為限，最少三碼，最多七碼，首位可以為零 |
|
| CarrierType | 載具類別 | String (1) | 空字串:無載具 1:綠界電子發票載具 2:自然人憑證號碼 3:手機條碼載具 注意事項: 1. 當列印註記[Print] =1(要列印)或統一編號[CustomerIdentifier]有值時，請帶空字串 2.只有存在綠界電子發票載具(此參數帶 1)的發票，中獎後才能在 ibon 列印領取 |
|
| CarrierNum | 載具編號 | String (64) | 當[CarrierType]="" 時，請帶空字串 當[CarrierType]=1 時，請帶空字串，系統會自動帶入值，為客戶電 子信箱或客戶手機號碼擇一(以客戶電子信箱優先) [CarrierType]=2:請帶固定長度為 16 且格式為 2 碼大寫英文字母加 上 14 碼數字 [CarrierType]=3:請帶固定長度為 8 碼字元，第 1 碼為【/】; 其餘 7 碼則由數字【0-9】、大寫英文【A-Z】與特殊符號【+】【-】【.】這 39 個字元組成的編號 |
|
| SpecialTaxType | 特種稅額類別 | int | 當課稅類別[TaxType]為 1/2/9 時，系統將會自動帶入數字【0】 當課稅類別[TaxType]為 3 時，則該參數必填，請填入數字【8】 當課稅類別[TaxType]為 4 時，則該參數必填，可填入數字【1-8】， 並分別代表以下類別與稅率 1:代表酒家及有陪侍服務之茶室、咖啡廳、酒吧之營業稅稅率， 稅率為 25% 2:代表夜總會、有娛樂節目之餐飲店之營業稅稅率，稅率為 15% 3:代表銀行業、保險業、信託投資業、證券業、期貨業、票券業 及典當業之專屬本業收入(不含銀行業、保險業經營銀行、保險本 業收入)之營業稅稅率，稅率為 2% 4:代表保險業之再保費收入之營業稅稅率，稅率為 1% 5:代表銀行業、保險業、信託投資業、證券業、期貨業、票券業及典當業之非專屬本業收入之營業稅稅率，稅率為 5% 6:代表銀行業、保險業經營銀行、保險本業收入之營業稅稅率(適 用於民國 103 年 07 月以後銷售額) ，稅率為 5% 7:代表銀行業、保險業經營銀行、保險本業收入之營業稅稅率(適 用於民國 103 年 06 月以前銷售額) ，稅率為 5% 8:代表空白為免稅或非銷項特種稅額之資料 |
|
| InvoiceRemark | 發票備註 | String (200) | ||
| vat | 商品單價是否 含稅 | String (1) | 預設為含稅價 1:含稅 0:未稅 |
|
| Items | 商品 | array | 可多筆，商品最多支援 200 項 請參閱下面 Items 詳細說明 |
Items 參數說明(array格式)
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| ItemName | ✔ | 商品名稱 | String (100) | |
| ItemCount | ✔ | 商品數量 | Number | 支援整數 8 位小數 2 位 |
| ItemWord | ✔ | 商品單位 | String (6) | |
| ItemPrice | ✔ | 商品單價 | Number | 支援整數 8 位小數 7 位 若 vat=0(未稅)，商品金額需為未稅金額 若 vat=1(含稅)，商品金額需為含稅金額 |
| ItemAmount | ✔ | 商品合計 | Number | 支援整數 8 位小數 7 位 此為含稅小計金額 ItemAmount 各項總合並四捨五入=salesAmount(含稅) 注意事項: ※ItemAmount 需統一為含稅金額，且商品金額需符合以下規則: 1. 當 vat = 1, 且 TaxType = 1 或 4: ItemPrice(含稅)ItemCount = ItemAmount(含稅)ex: 5005 = 2500 2. 當 vat = 0,且 TaxType = 1(稅率 5%): ItemPrice(不含稅)ItemCount1.05 = ItemAmount(含稅) ex: 50051.05 = 2625 3. 當 vat = 0, TaxType = 4 且 ex: 50051.00 = 2500 |
| ItemSeq | 商品序號 | Int | ||
| ItemTaxType | 商品課稅別 | String (1) | 當課稅類別[TaxType] = 9 時，此欄位不可為 1:應稅 2:零稅率 3:免稅 注意事項: 當課稅類別[TaxType] = 9 時，商品課稅類別只能 1.應稅+免稅 2.應 稅+零稅率，免稅和零稅率發票不能同時開立 |
|
| ItemRemark | 商品備註 | String (40) |
開立延遲發票
$data 內容說明(array格式)
大部分與上列 開立一般發票 相同 額外增加欄位如下:
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| DelayFlag | ✔ | 延遲註記 | String (1) | 可註記此張發票要延遲開立或觸發開立發票 1:延遲開立 2:觸發開立 |
| DelayDay | ✔ | 延遲天數 | int | 若為延遲開立時，延遲天數須介於 1 至 15 天內 觸發開立時也可設定延遲天數，但須介於 0 至 15 天內 EX1: DelayFlag=1(延遲) DelayDay=7(天數) 此為 7 天後自動開立 EX2: DelayFlag = 2(觸發) DelayDay=2(天數) 此為被觸發後過 2 天才會開立，若此張發票都沒有被觸發，將不會被開立 |
| Tsr | ✔ | 交易單號 | String (30) | 用來呼叫付款完成觸發或延遲開立發票 API 的依據 均為唯一值不可重覆使用 |
| NotifyURL | 開立完成時通知特店系統的網址 | String (200) | 注意事項: 使用測試環境時，不提供 NotifyURL 開立通知 |
觸發開立發票
$transactionNumber 內容說明
| 參數 | 名稱 | 類型 | 說明 |
|---|---|---|---|
| $transactionNumber | 交易單號 | string | 觸發開立發票回傳的交易單號 |
取消延遲開立發票
$transactionNumber 內容說明
| 參數 | 名稱 | 類型 | 說明 |
|---|---|---|---|
| $transactionNumber | 交易單號 | string | 觸發開立發票回傳的交易單號 |
開立一般折讓發票
$data 內容說明(array格式)
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| InvoiceNo | ✔ | 發票號碼 | String (10) | 長度固定為 10 碼 |
| InvoiceDate | ✔ | 發票開立日期 | String (10) | 格式為「yyyy-MM-dd」 |
| AllowanceNotify | ✔ | 通知類別 | String (1) | 開立折讓後，寄送將相關發票折讓資訊通知消費者 S:簡訊 E:電子郵件 A:皆通知時 N:皆不通知 |
| AllowanceAmount | ✔ | 折讓單總金額(含稅) | int | |
| CustomerName | 客戶名稱 | String (60) | 格式為中、英文及數字等 | |
| NotifyMail | 通知電子信箱 | String (100) | 1. 若通知類別[AllowanceNotify]為電子郵件(E)，此欄位須有值 2. 需為有效的 Email 格式 3. 將參數值做 UrlEncode 4. 可帶入多組 Email，並以分號區隔 ex: [email protected];[email protected] |
|
| NotifyPhone | 通知手機號 碼 | String (20) | 1. 若通知類別[AllowanceNotify]為簡訊方式(S)，此欄位須有值 2. 格式為數字組成 |
|
| Items | 商品 | array | 可多筆，商品最多支援 200 項 請參閱下面 Items 詳細說明 |
Items 參數說明(array格式)
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| ItemName | ✔ | 商品名稱 | String (100) | |
| ItemCount | ✔ | 商品數量 | Number | 支援整數 8 位小數 2 位 |
| ItemWord | ✔ | 商品單位 | String (6) | |
| ItemPrice | ✔ | 商品單價 | Number | 支援整數 8 位小數 7 位 若 vat=0(未稅)，商品金額需為未稅金額 若 vat=1(含稅)，商品金額需為含稅金額 |
| ItemAmount | ✔ | 商品合計 | Number | 支援整數 8 位小數 7 位 此為含稅小計金額 ItemAmount 各項總合並四捨五入=salesAmount(含稅) 注意事項: ※ItemAmount 需統一為含稅金額，且商品金額需符合以下規則: 1. 當 vat = 1, 且 TaxType = 1 或 4: ItemPrice(含稅)ItemCount = ItemAmount(含稅)ex: 5005 = 2500 2. 當 vat = 0,且 TaxType = 1(稅率 5%): ItemPrice(不含稅)ItemCount1.05 = ItemAmount(含稅) ex: 50051.05 = 2625 3. 當 vat = 0, TaxType = 4 且 ex: 50051.00 = 2500 |
| ItemSeq | 商品序號 | Int | ||
| ItemTaxType | 商品課稅別 | String (1) | 當課稅類別[TaxType] = 9 時，此欄位不可為 1:應稅 2:零稅率 3:免稅 注意事項: 當課稅類別[TaxType] = 9 時，商品課稅類別只能 1.應稅+免稅 2.應 稅+零稅率，免稅和零稅率發票不能同時開立 |
|
| ItemRemark | 商品備註 | String (40) |
開立線上折讓發票(通知開立)
$data 內容說明(array格式)
各式與 開立一般折讓發票 皆相同
作廢發票
$data 內容說明(array格式)
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| InvoiceNo | ✔ | 發票號碼 | String (10) | 長度固定為 10 碼 |
| InvoiceDate | ✔ | 發票開立日期 | String (10) | 格式為「yyyy-MM-dd」 |
| Reason | ✔ | 作廢原因 | String (120) |
作廢折讓發票
$data 內容說明(array格式)
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| InvoiceNo | ✔ | 發票號碼 | String (10) | 長度固定為 10 碼 |
| AllowanceNo | ✔ | 折讓編號 | String (16) | |
| Reason | ✔ | 作廢原因 | String (120) |
註銷重開
$data 內容說明(array格式)
大部分與上列 開立一般發票 相同 額外增加欄位如下:
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| InvoiceNo | ✔ | 發票號碼 | String (10) | 長度固定為 10 碼 |
| VoidReason | ✔ | 註銷原因 | String (20) | |
| InvoiceDate | ✔ | 發票開立時間 | String (20) | 格式為 yyyy-MM-dd HH:mm:ss 發票開立時間需為先前開立發票的時間 |
查詢發票(根據特店自訂編號)
$relateNumber 內容說明
| 參數 | 名稱 | 類型 | 說明 |
|---|---|---|---|
| $relateNumber | 特店自訂編號 | string(30) | 需為唯一值不可重複使用 注意事項: 請勿使用特殊符號 |
查詢發票(根據發票號及開立日期)
$invoiceNo 及 $invoiceDate 內容說明
| 參數 | 名稱 | 類型 | 說明 |
|---|---|---|---|
| InvoiceNo | 發票號碼 | String (10) | |
| InvoiceDate | 發票開立日期 | String (10) | 格式為「yyyy-MM-dd」 |
查詢折攘明細
$invoiceNo 及 $allowanceNo 內容說明
| 參數 | 名稱 | 類型 | 說明 |
|---|---|---|---|
| InvoiceNo | 發票號碼 | String (10) | |
| AllowanceNo | 折讓編號 | String (16) |
查詢作廢發票明細
$relateNumber, $invoiceNo 及 $invoiceDate 內容說明
| 參數 | 名稱 | 類型 | 說明 |
|---|---|---|---|
| $relateNumber | 特店自訂編號 | String (10) | 需為唯一值不可重複使用 注意事項: 請勿使用特殊符號 |
| InvoiceNo | 發票號碼 | String (10) | |
| InvoiceDate | 發票開立日期 | String (10) | 格式為「yyyy-MM-dd」 |
查詢作廢折讓明細
$invoiceNo 及 $allowanceNo 內容說明
| 參數 | 名稱 | 類型 | 說明 |
|---|---|---|---|
| InvoiceNo | 發票號碼 | String (10) | 長度固定為 10 碼 |
| AllowanceNo | 折讓編號 | String (16) |
查詢字軌
$data 內容說明(array格式)
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| InvoiceYear | ✔ | 發票年度 | String (3) | 僅可查詢去年、當年與明年的發票年度，格式為民國年 ex:109 |
| InvoiceTerm | ✔ | 發票期別 | int | 0:全部，1: 1-2 月，2: 3-4 月，3: 5-6 月，4: 7-8 月，5: 9-10 月，6: 11-12月 |
| UseStatus | ✔ | 字軌使用狀態 | int | 0:全部，1:未啟用，2:使用中，3:已停用，4:暫停中，5:待審核，6: 審核不通過 |
| InvType | 字軌類別 | String (2) | 07:一般稅額發票，08:特種稅額發票 | |
| InvoiceHeader | 字軌名稱 | String (2) |
發送發票通知
$data 內容說明(array格式)
| 參數 | 必填 | 名稱 | 類型 | 說明 |
|---|---|---|---|---|
| InvoiceNo | ✔ | 發票號碼 | String (10) | |
| Notify | ✔ | 發送方式 | String (1) | S:簡訊 E:電子郵件 A:皆通知時 |
| InvoiceTag | ✔ | 發送內容類 型 | String (2) | I: 發票開立 II: 發票作廢 A: 折讓開立 AI: 折讓作廢 AW:發票中獎 |
| Notified | ✔ | 發送對象 | String (1) | C: 發送通知給客戶 M: 發送通知給特店 A: 皆發送通知 注意事項: 若發送對象類型(Notified)為 A 時，請注意廠商後台設定是否接受通知 |
| AllowanceNo | 折讓編號 | String (16) | 注意事項: 若發送內容類型(InvoiceTag)為 A 或 AI 時為必填 |
|
| Phone | 發送簡訊號 碼 | String (20) | 此欄位可與客戶電子信箱擇一選填，若客戶電子信箱未填，則此欄 位就必須有值 格式為數字 |
|
| NotifyMail | 發送電子郵 件 | String (80) | 此欄位可與客戶手機號碼擇一選填，若客戶客戶手機號碼未填，則 此欄位必須有值，且需為有效的 Email 格式 可帶入多組 Email，並以分號區隔 ex: [email protected];[email protected] |
手機條碼驗證
$barcode 內容說明
| 參數 | 名稱 | 類型 | 說明 |
|---|---|---|---|
| $barcode | 手機條碼 | String (8) | 格式應為 8 碼字元，第 1 碼為『/』; 其餘 7 碼則由數字【0-9】、大 寫英文【A-Z】與特殊符號【+】【-】【.】這 39 個字元組成 注意事項: 若手機條碼中有加號，可能在介接驗證時發生錯誤，請將加號改為 空白字元，產生驗證碼 英文、數字、符號僅接受半形字元 |
捐贈碼驗證
$loveCode 內容說明
| 參數 | 名稱 | 類型 | 說明 |
|---|---|---|---|
| $loveCode | 受贈單位之 捐贈碼 | String (7) | 捐贈碼以阿拉伯數字為限，最少三碼，最多七碼。內容定位採「文 字格式」，首位可以為零 |
All versions of ecpay-invoice with dependencies
PHP Build Version
Package Version
The package thoth-pharaoh/ecpay-invoice contains the following files
Loading the files please wait ....