開立折讓

API路徑:

POST /allowances/issue

簽章值需求欄位及排序:

TaxIDNumber TimeStamp InvoiceNumber

欄位說明:

B2B與B2C欄位標註說明: M:必需提供資料 CM:條件符合時,必需提供資料 O:可選擇是否提供資料 CO:條件符合時,可選擇是否提供資料 X:不須提供資料

欄位名稱

欄位說明

欄位型態

欄位長度

B2B

B2C

條件說明

TaxIDNumber

賣方統一編號

String

8

M

M

須為發票平台商家

Timestamp

時間戳記

Integer

M

M

使用 GMT + 0 之時間戳記 系統會視正負10分鐘內之戳記為合法

相關轉換請參考 [https://www.unixtimestamp.com/]

Signature

簽章驗證值

String

M

M

產生方法可參閱簽章值計算說明

InvoiceNumber

發票號碼

String

10

M

M

TaxAmount

稅額

Decimal

M

M

TotalAmount

未稅總計

Decimal

M

M

Note

備註

String

O

O

Items 發票明細內容格式說明

欄位名稱

欄位說明

欄位型態

欄位長度

B2B

B2C

條件說明

ProductName

商品名稱

string

255

M

M

Quantity

數量

Decimal

(12,4)

M

M

UnitPrice

單價

Decimal

(12,4)

M

M

B2B:單價未含稅額 B2C:根據IsItemsTaxIncluded決定

SubTotal

小計

Decimal

(12,4)

M

M

Note

明細備註

String

40

O

O

單一明細備註

傳輸範例:

{
		"TaxIDNumber": "54317589",
    "Timestamp": 1607073498,
    "Signature": "[簽章值]",
		"Data":
		{
			"InvoiceNumber": "AW29290816",
			"NotifyType": "Email",
			"NotifyEmail": "[email protected]",
			"NotifyPhone": "0955555555",
			"NotifyCustomerName": "tester",
			"TaxAmount": 2,
			"TotalAmount": 40,
			"Note": "12345678",
			"Items": [
            {
                "productID": "I0001",
                "productName": "手續費",
                "quantity": 1,
                "UnitPrice": 40,
                "subTotal": 40
            }
        ]
		}
}

回傳結果:

[
  {
    // 成功上傳
    "AllowanceNumber": "AW29290816001",
    "Status": "Success",
    "Error": ""
  },
  {
    // 上傳失敗
    "Status": "Success",
    "Error": "買方姓名 不可為空"
  }
]

Last updated

Was this helpful?