Skip to content

Commit

Permalink
[FEATURE] improve readme usage
Browse files Browse the repository at this point in the history
  • Loading branch information
depresto committed May 11, 2023
1 parent 06baf81 commit 98ca15c
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 18 deletions.
51 changes: 35 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,20 @@
# ECPay Invoice SDK [![CI](https://github.com/depresto/ecpay-invoice-sdk/workflows/CI/badge.svg)](https://github.com/depresto/ecpay-invoice-sdk/actions?query=workflow%3ACI) [![codecov](https://badgen.net/codecov/c/github/depresto/ecpay-invoice-sdk)](https://codecov.io/gh/depresto/ecpay-invoice-sdk)
# 綠界發票(ECPay) Node.js SDK [![CI](https://github.com/depresto/ecpay-invoice-sdk/workflows/CI/badge.svg)](https://github.com/depresto/ecpay-invoice-sdk/actions?query=workflow%3ACI) [![codecov](https://badgen.net/codecov/c/github/depresto/ecpay-invoice-sdk)](https://codecov.io/gh/depresto/ecpay-invoice-sdk)


綠界發票 SDK

## Installation
## 安裝 Installation

```bash
# yarn
yarn add ecpay-invoice-sdk

# npm
npm install --save ecpay-invoice-sdk

# pnpm
pnpm add ecpay-invoice-sdk
```

## Usage
## 使用方式 Usage

### Create SDK Instance (ES5)

Expand All @@ -35,17 +40,25 @@ const client = new EcpayInvoiceClient({
});
```

### Issue B2C invoice
### 開立發票 Issue B2C invoice

詳情請見官方文件:[文件網址](https://developers.ecpay.com.tw/?p=7809)
詳情請見官方文件:[文件網址](https://developers.ecpay.com.tw/?p=7896)

```javascript
await client.issueB2CInvoice({

RelateNumber: "ORDERID12345",
Print: "0", // 0:不列印 1:要列印
Donation: "0", // 0:不捐贈 1:要捐贈
CarrierType: "1", // 空字串:無載具 1:綠界電子發票載具 2:自然人憑證號碼 3:手機條碼載具
SpecialTaxType: 0, // 特種稅額類別
CustomerEmail: "test@example.com",
Items: [
{ ItemName: "測試商品", ItemCount: 1, ItemWord: "", ItemPrice: 1000 },
],
});
```

## Revoke B2C invoice
## 作廢發票 Revoke B2C invoice

詳情請見官方文件:[文件網址](https://developers.ecpay.com.tw/?p=7809)

Expand All @@ -57,24 +70,30 @@ await client.revokeB2CInvoice(
);
```

### Issue B2C Allowance
### 開立折讓 Issue B2C Allowance

詳情請見官方文件:[文件網址](https://developers.ecpay.com.tw/?p=7809)
詳情請見官方文件:[文件網址](https://developers.ecpay.com.tw/?p=7901)

```javascript
await client.issueB2CAllowance({

InvoiceNo: "AA123456", // 發票號碼
InvoiceDate: "2023-01-01", // 發票開立日期
AllowanceNotify: "E", // S:簡訊 E:電子郵件 A:皆通知時 N:皆不通知
CustomerEmail: "test@example.com",
Items: [
{ ItemName: "測試商品", ItemCount: 1, ItemWord: "", ItemPrice: 1000 },
],
});
```

## Revoke B2C Allowance
## 作廢折讓 Revoke B2C Allowance

詳情請見官方文件:[文件網址](https://developers.ecpay.com.tw/?p=7809)

```javascript
await client.revokeB2CAllowance(
"AA123456", // 發票號碼
"2016022615195209", // 折讓號
"invoke reason" // 作廢原因
"AA123456", // 發票號碼
"2016022615195209", // 折讓號碼
"invoke reason" // 作廢原因
);
```
4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "ecpay-invoice-sdk",
"version": "1.0.8",
"description": "綠界發票 SDK",
"version": "1.0.9",
"description": "綠界發票 Node.js SDK",
"main": "./build/index.js",
"types": "./build/index.d.ts",
"author": "Wen-Hong Huang <waynehonghuang@gmail.com>",
Expand Down

0 comments on commit 98ca15c

Please sign in to comment.