交換發票

API路徑：

POST /invoices/exchange

簽章值需求欄位及排序：

BuyerID SalesAmount TaxIDNumber TimeStamp TotalAmount Type

欄位說明：

B2B欄位標註說明： 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	產生方法可參閱簽章值計算說明
TrackType	字軌類別	String		O	O	07:一般稅額計算之電子發票 08:特種稅額計算之電子發票 [default: 07]
BuyerID	買方統一編號	String	8	M	X	B2B:8碼統編 B2C:無
BuyerName	買方名稱	String		M	M	B2B:買方公司名稱, 如不能, 請填入買方統一編號 B2C:購買人姓名, 填入4位英數
BuyerPhoneNumber	買方電話號碼	String	26	O	O
BuyerAddress	買方地址	String	100	O	O
BuyerEmail	買方電子郵件帳號	String	80	O	O
BuyerNote	買方備註	String		O	O
CarrierType	載具類型	Integer		O	O	0:不使用載具 2:自然人憑證 3:手機條碼 [default: 0]
CarrierNumber	載具編號	String		CM	CM
Printer	印表機號	String		O	O
CustomNumber	自訂編號	String		O	O
Note	發票備註	String		O	O
BusinessNote	發票備註(不上傳)	String		O	O
Type	發票類別	String		M	M	1: B2C 2: B2B
TotalAmount	總金額	Decimal		M	M
SalesAmount	銷售未稅總額	Decimal		O	O
TaxAmount	總稅額	Decimal		M	M
ZeroTaxSalesAmount	零稅銷售總額	Decimal		CO	CO	如特別關稅; 如果為零稅率時(TaxType=2)填寫
FreeTaxSalesAmount	免稅銷售總額	Decimal		CO	CO	如農特產品銷售; 如果為免稅時(TaxType=3)填寫
TaxType	課稅別	Integer		M	M	1:應稅 2:零稅率 3:免稅
CustomsClearanceType	通關方式	Integer		CM	CM	1:非經海關出口 2:經海關出口; 如果為零稅率時(TaxType=2)填寫
BondedAreaType	零稅率註記	Integer		CM	X	1:符合買受人為保稅區營業人 2:符合買受人為遠洋漁業營業人 3:符合買受人為自由貿易港區營業人 如果為零稅率時(TaxType=2)填寫
IsPrinted	列印註記	Boolean		O	O	是否已列印紙本發票給買受人
IsDonated	是否捐贈	Boolean		X	O	若已經列印(IsPrinted=True)則只能為False
DonateCode	捐贈碼	String		X	CM	3-7碼數字
IsVATIncluded	品項價格是否含稅	Boolean		X	M	[default: false]

Items 發票明細內容格式說明

欄位名稱	欄位說明	欄位型態	欄位長度	B2B	B2C	條件說明
ProductName	商品名稱	string	255	M	M
Quantity	數量	Decimal	(12,4)	M	M	上限1000000
UnitPrice	單價	Decimal	(12,4)	M	M	B2B:單價未含稅額 B2C:根據IsItemsTaxIncluded決定
SubTotal	小計	Decimal	(12,4)	M	M	上限1000000
Note	明細備註	String	40	O	O	單一明細備註

傳輸範例：

{
		"TaxIDNumber": "54317589",
    "Timestamp": 1607073498,
		"Signature": "[簽章值]",
		"Data":
		{
      "BuyerID": "0000000000",
      "BuyerName": "買方名稱",
      "BuyerPhoneNumber": "0912345678",
      "BuyerEmail": "[email protected]",
      "BuyerAddress": "頭城",
      "Note": "備註",
      "BusinessNote": "BusinessNote",
      "Type": "B2C",
      "TotalAmount": 100,
      "SalesAmount": 100,
      "TaxAmount": 0,
      "TaxType": 1,
      "IsPrinted": true,
      "TrackType": "07",
      "IsVATIncluded": true,
      "Items": [
            {
                "ProductName": "手續費",
                "Quantity": 1,
                "UnitPrice": 50,
                "SubTotal": 50
            },
						{
                "ProductName": "手續費",
                "Quantity": 1,
                "UnitPrice": 50,
                "SubTotal": 50
            }
        ]
		}
}

回傳結果：

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