電子發票API
Process 1: 開立發票
測試環境(僅提供UTF-8編碼)

https://ssl.smse.com.tw/api_test/SPEinvoice_Storage.asp

欄位參數(請注意大小寫)

O:必要、▲:非必要、X:不用填

API主要為四大部分 使用者參數\發票資訊\商品明細\買受人資訊
參數 名稱 B2C B2B 格式 說明
使用者參數
Grvc電子發票帳號由速買配提供
Verify_key驗證碼由速買配提供
發票資訊
InvoiceDate開立發票日期YYYY/MM/DD
InvoiceTime開立發票時間HH:MM:SS
Intype發票稅率類型07/0807:一般稅額計算之電子發票
08:特種稅額計算之電子發票
TaxType課稅別 1/2/3/4/9 1:應稅
2:零稅率
3:免稅
4:應稅(特種稅率)
9:混合應稅與免稅或零稅率(限收銀機發票無法分辨時使用)
BuyerRemark買受人註記 1/2/3/4 可保留空白
1:得抵扣之進貨及費
2:得抵扣之固定資
3:不得抵扣之進貨及費用
4:不得抵扣之固定資口
CustomsClearanceMark通關方式註記 1/2 可保留空白
1:非經海關出口
2:經海關出口
(若為零稅率發票,此為必填欄位)
GroupMark彙開註記Y可保留空白
如為彙開發票再填入
BondedAreaConfirm買受人簽署適用
零稅率註記
1/2/3 可保留空白
1:買受人為保稅區營業人
2:買受人為遠洋漁業營業人
3:買受人為自由貿易港區營業人
DonateMark捐贈1/0 1:捐贈
0:不捐贈
有Buyer_id時,必須為0
捐贈時載具類型(CarrierType)不可填入
LoveKey愛心碼DonateMark為1,此處不可為空
Visa_Last4信用卡末四碼4字元如為刷卡交易,請填入卡號末四碼
data_id自訂發票編號50字元 如該號碼已開立過發票,將無法重複開立,除非發票作廢/退回
orderid自訂號碼30字元營業人自訂使用
商品明細
除總金額(AllAmount)參數外均以【 | 】(半形)符號區隔,並依照商品明細排列,各項總數必須相同
Description商品明細商品1|商品2 請勿填入符號
Quantity數量明細數量1|數量2 純數字,必須大於0
UnitPrice單價明細單價1|單價2 純數字,可以小於0
透過單價含稅(UnitTAX)指定金額含稅或未稅價
Unit單位明細單位1|單位2 請勿填入符號
Amount各明細總額金額1|金額2 由每項【數量*單價】計算
純數字,可以小於0
AllAmount總金額(含稅)不可小於0 由各明細總額(Amount)合計
金額必須含稅
純數字,不可小於0
UnitTAX單價含稅Y/N 商品單價是否含稅
Y:含稅金額(預設)
N:未稅金額
買受人資訊
Buyer_id買受人統編 有值:開立B2B發票
空值:開立B2C發票
CompanyName買受人公司名稱 請勿填入符號
Name買受人姓名 請勿填入符號
Phone電話0900123456 純數字,請勿填入符號
Facsimile傳真 純數字,請勿填入符號
Email信箱
Address地址
CarrierType載具類型 速買配載具:EJ0113
手機條碼:3J0002
自然人憑證:CQ0001
CarrierID載具ID明碼 當載具類型(CarrierType)有值時,此處不可為空
CarrierID2載具ID暗碼 當載具類型(CarrierType)有值時,此處不可為空

開立規則與各欄位規則整理
買受人個人公司
捐贈載具統編發票
捐贈填1填0
愛心碼
載具類型
載具ID
統一編號
Process 1-1: 回應值
<SmilePayEinvoice>
<Status>0</Status>
<Desc></Desc>
<Grvc>SEI1000002</Grvc>
<orderno>order20171231</orderno>
<data_id>inid00001</data_id>
<InvoiceNumber>YY00000000</InvoiceNumber>
<RandomNumber>1234</RandomNumber>
<InvoiceDate>2017/12/31</InvoiceDate>
<InvoiceTime>23:59:59</InvoiceTime>
<CarrierID></CarrierID>
</SmilePayEinvoice>

Xml Tag說明
參數 名稱 說明
Status狀態碼 回應值請參考下表
Desc詳細原因 回應值請參考下表
orderno自訂號碼
data_id自訂發票編號
InvoiceNumber發票號碼 實際發票開立號碼
RandomNumber隨機碼 僅B2C發票才會回應此碼
InvoiceDate開立日期
InvoiceTime開立時間
CarrierID載具ID 如申請速買配載具則會回應載具號碼

回應代號說明
代號 說明 代號 說明
-1001商家帳號缺少參數 -10011查無商家帳號
-10012尚未開放B2B功能 -10013尚未開放B2C功能
-10021統一編號(Buyer_id)格式錯誤 -10022統一編號不可捐贈(DonateMark)必須為0
-10023統一編號(Buyer_id)內容錯誤 -10024統一編號(Buyer_id)不可使用其他載具(CarrierType)
-10025缺少公司名稱(CompanyName) 尚未開放B2C功能
-10031缺少開立日期(InvoiceDate、InvoiceTime) -10032日期格式(InvoiceDate、InvoiceTime)錯誤
-10033B2C開立需再48hr內 -10034B2B開立需再168hr內
-10041發票類別(Intype)錯誤 -10042買受人註記欄(BuyerRemark)錯誤
-10043通關方式註記(CustomsClearanceMark錯誤) -10044捐贈註記(DonateMark)錯誤
-10045愛心碼(LoveKey)空白 -10046愛心碼伺服器異常
-10047查無此愛心碼(LoveKey) -10048課稅別(TaxType)錯誤
-10049買受人簽署適用零稅率註記
(BondedAreaConfirm)錯誤
-10051手機號碼(Phone)格式錯誤 -10052速買配載具號碼(CarrierID)錯誤
-10053查無載具號碼(CarrierID) -10054缺少Email參數
-10055建立載具失敗 -10056查無手機條碼(CarrierID)
-10057自然人憑證(CarrierID)格式錯誤
-10061商品各項目數量不符 -10062品名(Description)空白
-10063商品數量(Quantity)內容錯誤 -10064商品金額(UnitPrice、Amount)內容錯誤
-10065商品小計(UnitPrice、Amount)驗算錯誤 -10066商品總金額(AllAmount)驗算錯誤
-10067商品與總金額(ALLAmount)不符合規定
-10071無可用字軌
-10072自訂發票編號 (data_id)重複
Process 2: B2C發票其他作業(作廢發票/折讓/作廢折讓)
測試環境(僅提供UTF-8編碼)

https://ssl.smse.com.tw/api_test/SPEinvoiceB2C_Storage_Modify.asp

欄位參數(請注意大小寫)

O:必要、▲:非必要、X:不用填

API主要為四大部分 使用者參數\相關欄位
參數 名稱 B2C B2B 格式 說明
使用者參數
Grvc商家代號由速買配提供
Verify_key驗證碼由速買配提供
相關欄位
InvoiceNumber發票號碼填入需處理的發票號碼
AllowanceNumber折讓單號碼填入需處理的折讓單號碼
types服務類型 Cancel:作廢發票
Void:註銷發票
AancelAllowance:作廢折讓單
CancelReason作廢原因20字元作廢發票實際原因
ReturnTaxDocumentNumber專案作廢核准文號60字元可保留空白
如有【專案作廢核准文號】請填入
VoidReason註銷原因20字元註銷發票實際原因
Remark備註200字元

處理規則與各欄位規則整理
作廢發票註銷發票作廢折讓單
發票號碼
折讓單號碼
作廢原因
專案作廢核准文號
註銷原因
備註
Process 2-1: 回應值
<SmilePayEinvoice>
<Status>0</Status>
<Desc></Desc>
<Types></Types>
<Grvc>SEI1000002</Grvc>
<InvoiceNumber>YY00000000</InvoiceNumber>
<AllowanceNumber>YY00000000</AllowanceNumber>
<CancelDate>2017/12/31</CancelDate>
<CancelTime>23:59:59</CancelTime>
<VoidDate>2017/12/31</VoidDate>
<VoidTime>23:59:59</VoidTime>
</SmilePayEinvoice>

Xml Tag說明
參數 名稱 說明
Status狀態碼回應值請參考下表
Desc詳細原因回應值請參考下表
Types服務類型
Grvc商家代號
InvoiceNumber發票號碼
AllowanceNumber折讓單號碼
CancelDate發票作廢/折讓單作廢日期僅在types=Cancel/AancelAllowance才回應
CancelTime發票作廢/折讓單作廢時間僅在types=Cancel/AancelAllowance才回應
VoidDate發票註銷日期僅在types=Void才回應
VoidTime發票註銷時間僅在types=Void才回應

回應代號說明
代號 說明
-1000商家帳號缺少參數
-1001查無商家帳號
-1002服務類型錯誤
-2001缺少發票號碼(InvoiceNumber)或作廢原因(CancelReason)
-2002作廢原因(CancelReason)超過字數
-2003專案作廢核准文號(ReturnTaxDocumentNumber)超過字數
-2004備註(Remark)超過字數
-2005缺少發票號碼(InvoiceNumber)或註銷原因(VoidReason)
-2006註銷原因(VoidReason)超過字數
-2007缺少折讓單號碼(AllowanceNumber)或作廢原因(CancelReason)
-2010查無該筆發票/折讓單
Process 3: B2B發票其他作業(作廢發票/退回/作廢折讓)
測試環境(僅提供UTF-8編碼)

https://ssl.smse.com.tw/api_test/SPEinvoiceB2B_Storage_Modify.asp

欄位參數(請注意大小寫)

O:必要、▲:非必要、X:不用填

API主要為四大部分 使用者參數\相關欄位
參數 名稱 B2C B2B 格式 說明
使用者參數
Grvc商家代號由速買配提供
Verify_key驗證碼由速買配提供
相關欄位
InvoiceNumber發票號碼填入需處理的發票號碼
AllowanceNumber折讓單號碼填入需處理的折讓單號碼
types服務類型 Cancel:作廢發票
Reject:退回發票
AancelAllowance:作廢折讓單
CancelReason作廢原因20字元作廢發票實際原因
ReturnTaxDocumentNumber專案作廢核准文號60字元可保留空白
如有【專案作廢核准文號】請填入
VoidReason註銷原因20字元註銷發票實際原因
Remark備註200字元

處裡規則與各欄位規則整理
作廢發票退回發票作廢折讓單
發票號碼
折讓單號碼
作廢原因
專案作廢核准文號
退回原因
備註
Process 3-1: 回應值
<SmilePayEinvoice>
<Status>0</Status>
<Desc></Desc>
<Types></Types>
<Grvc>SEI1000002</Grvc>
<InvoiceNumber>YY00000000</InvoiceNumber>
<AllowanceNumber>YY00000000</AllowanceNumber>
<CancelDate>2017/12/31</CancelDate>
<CancelTime>23:59:59</CancelTime>
<RejectDate>2017/12/31</VoidDate>
<RejectTime>23:59:59</VoidTime>
</SmilePayEinvoice>

Xml Tag說明
參數 名稱 說明
Status狀態碼回應值請參考下表
Desc詳細原因回應值請參考下表
Types服務類型
Grvc商家代號
InvoiceNumber發票號碼
AllowanceNumber折讓單號碼
CancelDate發票作廢/折讓單作廢日期僅在types=Cancel/AancelAllowance才回應
CancelTime發票作廢/折讓單作廢時間僅在types=Cancel/AancelAllowance才回應
RejectDate發票退回日期僅在types=Reject才回應
RejectTime發票退回時間僅在types=Reject才回應

回應代號說明
代號 說明
-1000商家帳號缺少參數
-1001查無商家帳號
-1002服務類型錯誤
-2001缺少發票號碼(InvoiceNumber)或作廢原因(CancelReason)
-2002作廢原因(CancelReason)超過字數
-2003專案作廢核准文號(ReturnTaxDocumentNumber)超過字數
-2004備註(Remark)超過字數
-2005缺少發票號碼(InvoiceNumber)或退回原因(RejectReason)
-2006退回原因(RejectReason)超過字數
-2007缺少折讓單號碼(AllowanceNumber)或作廢原因(CancelReason)
-2010查無該筆發票/折讓單
Process 4: 開立折讓單
測試環境(僅提供UTF-8編碼)

https://ssl.smse.com.tw/api_test/SPEinvoice_Storage_Allowance.asp

欄位參數(請注意大小寫)

O:必要、▲:非必要、X:不用填
參數 名稱 格式 說明
使用者參數
Grvc電子發票帳號由速買配提供
Verify_key驗證碼由速買配提供
折讓單資訊
InvoiceNumber發票號碼填入需折讓的發票號碼
AllowanceNumber折讓單號碼15字元(英/數混合)
不可填入符號
可保留空白
速買配會自動產生
AllowanceType折讓類型1/21:買方開立折讓單
2:賣方開立折讓單(預設)
折讓明細
均以【 | 】(半形)符號區隔,並依照折讓明細排列,各項總數必須相同
Description商品明細商品1|商品2 請勿填入符號
Quantity數量明細數量1|數量2 純數字,必須大於0
UnitPrice單價明細單價1|單價2 純數字,可以小於0
透過單價含稅(UnitTAX)指定金額含稅或未稅價
Unit單位明細單位1|單位2 可保留空白
請勿填入符號
Amount各明細總額(未稅)金額1|金額2 由每項【數量 * 單價 - 稅金】計算
純數字,可以小於0
Process 4-1: 回應值
<SmilePayEinvoice>
<Status>0</Status>
<Desc></Desc>
<Grvc>SEI1000002</Grvc>
<InvoiceNumber>YY00000000</InvoiceNumber>
<AllowanceNumber>YY00000000</AllowanceNumber>
</SmilePayEinvoice>

Xml Tag說明
參數 名稱 說明
Status狀態碼回應值請參考下表
Desc詳細原因回應值請參考下表
Grvc商家代號
InvoiceNumber發票號碼
AllowanceNumber折讓單號碼

回應代號說明
代號 說明
-1001商家帳號缺少參數
-10011查無商家帳號
-1002發票號碼(InvoiceNumber)錯誤
-10021商品不可空白
-10022商品各項目數量不符
-10023商品明細(Description)不可空白
-10024數量明細(Quantity)不可空白
-10025單價明細(UnitPrice)金額異常
-1003查無此筆發票
-10031超過可折讓金額