thoth-pharaoh / ecpay-invoice
綠界B2C開發票工具
v2.0.0
2022-02-16 02:18 UTC
Requires
- php: ^8.0
- illuminate/support: ^9.0
Requires (Dev)
- orchestra/testbench: ^7.0
README
版本匹配
安裝
使用 composer 做安裝
composer require thoth-pharaoh/ecpay-invoice
匯出 Config
php artisan vendor:publish --tag=invoice-config --force
添加 .env 支付工具必要環境參數
INVOICE_URL="https://einvoice-stage.ecpay.com.tw/B2CInvoice/" INVOICE_MERCHANT_ID="2000132" INVOICE_HASH_KEY="ejCk326UnaZWKisg" INVOICE_HASH_IV="q9jcZX8Ib9LM8wYk" INVOICE_VISION="3.0.0"
使用方法
先引入門面
use Pharaoh\Invoice\Facades\Invoice;
- 開立一般發票
- 開立延遲發票
- 觸發開立發票
- 取消延遲開立發票
- 開立一般折讓發票
- 開立線上折讓發票(通知開立)
- 作廢發票
- 作廢折讓發票
- 註銷重開
- 查詢發票(根據特店自訂編號)
- 查詢發票(根據發票號及開立日期)
- 查詢折攘明細
- 查詢作廢發票明細
- 查詢作廢折讓明細
- 查詢字軌
- 發送發票通知
- 手機條碼驗證
- 捐贈碼驗證
開立一般發票
$invoice = Invoice::issue($data);
$data 內容說明(array格式)
Items 參數說明(array格式)
開立延遲發票
$invoice = Invoice::delayIssue($data);
$data 內容說明(array格式)
大部分與上列 開立一般發票
相同 額外增加欄位如下:
觸發開立發票
$invoice = Invoice::triggerIssue($transactionNumber);
$transactionNumber 內容說明
取消延遲開立發票
$invoice = Invoice::cancelDelayIssue($transactionNumber);
$transactionNumber 內容說明
開立一般折讓發票
$invoice = Invoice::allowance($data);
$data 內容說明(array格式)
Items 參數說明(array格式)
開立線上折讓發票(通知開立)
$invoice = Invoice::allowanceByCollegiate($data);
$data 內容說明(array格式)
各式與 開立一般折讓發票
皆相同
作廢發票
$invoice = Invoice::invalid($data);
$data 內容說明(array格式)
作廢折讓發票
$invoice = Invoice::allowanceInvalid($data);
$data 內容說明(array格式)
註銷重開
$invoice = Invoice::voidWithReIssue($data);
$data 內容說明(array格式)
大部分與上列 開立一般發票
相同 額外增加欄位如下:
查詢發票(根據特店自訂編號)
$invoice = Invoice::getIssueByRelateNumber($relateNumber);
$relateNumber 內容說明
查詢發票(根據發票號及開立日期)
$invoice = Invoice::getIssueByInvoiceNoAndData($invoiceNo, $invoiceDate);
$invoiceNo 及 $invoiceDate 內容說明
查詢折攘明細
$invoice = Invoice::getAllowance($invoiceNo, $allowanceNo);
$invoiceNo 及 $allowanceNo 內容說明
查詢作廢發票明細
$invoice = Invoice::getInvalid($relateNumber, $invoiceNo, $invoiceDate);
$relateNumber, $invoiceNo 及 $invoiceDate 內容說明
查詢作廢折讓明細
$invoice = Invoice::getAllowanceInvalid($invoiceNo, $allowanceNo);
$invoiceNo 及 $allowanceNo 內容說明
查詢字軌
$invoice = Invoice::getInvoiceWordSetting($data);
$data 內容說明(array格式)
發送發票通知
$invoice = Invoice::invoiceNotify($data);
$data 內容說明(array格式)
手機條碼驗證
$invoice = Invoice::checkBarcode($barcode);
$barcode 內容說明
捐贈碼驗證
$invoice = Invoice::checkLoveCode($loveCode);