已開立發票資料上傳
Last updated
Last updated
若使用的是 /Append/Order 則 不須傳入 InvoiceID、InvoiceDateTime 但 必須傳入 RelateNumber 且必須不重複 若使用的是 /Append/PrintInvoices 則依照原開立發票格式上傳即可
閱讀說明:
B2B:指的是B2B交易所開立之發票(或三聯式發票),開立對象為公司行號或機關組織,其中發票內容有計算稅額以供買受人作為進項扣抵。 B2C:指的是B2C交易所開立之發票(或二聯式發票),開立對象為自然人或機關組織,其中發票內容不計算稅額,僅供買受人做為購買憑證。
B2B與B2C欄位標註說明: M: 必需提供資料 CM: 條件符合時,必需提供資料 O: 可選擇是否提供資料 CO: 條件符合時,可選擇是否提供資料 X: 不須提供資料
欄位名稱 | 欄位說明 | 欄位型態 | 欄位長度 | B2B | B2C | 條件說明 |
---|---|---|---|---|---|---|
欄位名稱 | 欄位說明 | 欄位型態 | 欄位長度 | B2B | B2C | 條件說明 |
---|---|---|---|---|---|---|
CompanyID
Seller BAN
String
10
M
M
賣方統編(必須為e首發票客戶)
InvoiceID
Invoice Number
String
10
M
M
發票字軌含流水號例如 QQ12345678
InvoiceDateTime
Invoice Create DateTime
DateTime
M
M
發票開立時間(訂單版得不需傳入),請採用ISO 8601格式傳遞UTC Time 例如: 2011-07-14T19:43:37
InvoiceFor
Invoice For Buyer
String
1
M
M
發票開立對象,使用B2B存證填寫B,使用B2C存證填寫C
BuyerID
Buyer BAN
String
10
M
M
買方統編,若為自然人須為 000000000 (10個0)
BuyerInvoiceTitle
Buyer Company Name
String
60
M
O
買方公司名稱
BuyerName
BuyerName
String
30
O
O
購買人姓名
BuyerTelNo
Buyer Telephone Number
string
26
O
O
買方電話號碼,若要傳送簡訊則此欄位填寫行動電話號碼
BuyerEmail
Buyer Email
String
80
O
O
買方電子郵件帳號,如果PrintMark=N此欄位與[買方電話號碼]兩者必填其一,否則電子發票通知無法寄送
BuyerAddress
Buyer Address
String
100
O
O
如要寄送實體發票,此欄位必填
CarrierType
載具類型
String
6
O
O
僅能為手機載具(3J0002)或自然人憑證(CQ0001)
CarrierId
載具編號
String
64
O
O
CheckNumber
Invoice Check Number
String
4
M
X
檢查碼,B2B 發票上必須列印四碼檢查碼(隨機四碼),且檢查碼必須與上傳至整合服務平台相同,若未列印(PrintMark=N)且未傳送此欄位,將由e首發票系統產生
RandomNumber
Invoice Random Number
String
4
X
M
隨機碼,B2C 發票上必須列印四碼隨機碼(隨機四碼),且隨機碼必須與上傳至整合服務平台相同,若未列印(PrintMark=N)且未傳送此欄位,將由e首發票系統產生
RelateNumber
Relate Number
String
20
O
O
關聯號碼,e首發票中可用來帶入關聯的訂單號碼
PrintMark
Print Mark
String
1
M
M
是否已列印紙本發票給買受人,是填Y,否填N
DonateMark
Donate Mark
String
1
X
M
是否捐贈發票,捐贈為Y,不捐贈為N,若已經列印(PrintMark=Y)則只能為N
NPOBAN
NPO BAN
String
7
X
CO
捐贈單位愛心碼,若DonateMark=Y則必須填此欄位
TaxType
TaxType
String
1
M
M
課稅別 1:應稅 2:零稅率 3:免稅
SalesAmount
Sales Amount
Decimal
(12,0)
CO
CO
銷售未稅總額;(明細小計總額); 如果為應稅時填寫(TaxType=1)
TaxAmount
Tax Amount
Decimal
(12,0)
CM
CM
總稅額; 如果為應稅時填寫(TaxType=1)
ZeroTaxSalesAmount
Zero Tax Sales Amount
Decimal
(12,0)
CO
CO
零稅銷售總額,如特別關稅; 如果為零稅率時填寫(TaxType=2)
CustomsClearanceMark
Customs Clearance Mark
String
1
CM
CM
通關方式 1:非經海關出口 2:經海關出口; 如果為零稅率時填寫(TaxType=2)
BondedArea
Bonded Area
String
1
CM
X
零稅率註記 1:符合買受人為保稅區營業人 2:符合買受人為遠洋漁業營業人3:符合買受人為自由貿易港區營業人; 如果為零稅率時填寫(TaxType=2)
BuyerRemark
Buyer Remark
String
1
CO
CO
買受人註記 1:得抵扣之進貨及費 2:得抵扣之固定資 3:不得抵扣之進貨及費用 4:不得抵扣之固定資口; 如果為零稅率時填寫(TaxType=2)選填此欄位
FreeTaxSalesAmount
Free Tax Sales Amount
Decimal
(12,0)
CM
CM
免稅銷售總額,如農特產品銷售; 如果為免稅時填寫(TaxType=3)
TotalAmount
Total Amount
Decimal
(12,0)
M
M
總金額(銷售未稅總額+總稅額);
MainRemark
發票備註
String
200
O
O
發票備註
UseFor
選擇使用發票組別
String
2
O
O
對應api/Inquire/GetInvoiceIDList中Details內的 UseFor欄位
PrinterNo
印表機編號
String
2
O
O
指定列印的印表機號;例如: 00、01
PrintWithDetail
選擇是否列印明細
String
1
O
O
2:僅列印發票,3:同時列印發票與明細
CutDetail
選擇C類發票明細是否裁斷
Boolen
1
O
X
true(預設):明細裁斷,false:明細不裁
Details
發票明細內容
Json Format Object
M
M
單身明細
DetailID
Serial Nnmber
String
3
M
M
三碼數字編碼,依序 001 002 不足三碼左邊補 0
ProductID
Product ID
String
20
O
O
產品代碼
ProductName
Product DEscription
string
256
M
M
產品名稱
Quantity
Quantity
Decimal
(12,4)
M
M
數量;
UnitPrice
Unit Price
Decimal
(12,4)
M
M
單價; B2B單價未含稅額,B2C單價包含稅額
SubTotal
Sub Total
Decimal
(12,4)
M
M
小計; (數量X單價)
Remark
明細備註
String
40
O
O
每個明細的備註