常見問題：API／串接

本頁摘要

API 開立、批次傳送、錯誤處理、各平台介接（蝦皮API串接等）常見問題。平台介接與一般作業區分。

開立 API 欄位與傳送（一般）

問題	解答	適用
如何避免同時傳入相同的發票資料？	API 為多執行緒寫入，未完全寫入前無法檢查重複。請分批傳入發票資料，並在成功回覆後再傳入下一筆，避免同時提交相同發票號碼 (InvoiceID)。	開立API／一般
InvoiceID 要自己給號嗎？	可交由系統取號（訂單版）；若自行配號（發票版），請確保為當期字軌且序號連續。	開立API／一般
可以一次送多張嗎？	依方案而定；建議逐張送，便於逐筆錯誤定位與重送。	開立API／一般

問題	解答	適用
萬一出現訂單異常導致發票未能及時開立，該怎麼辦？	系統會發送通知提醒營業人檢查訂單狀態，並可根據情況手動介入處理發票開立。	一般／電商整合
如何避免逾期？	排程上傳需時間，臨界案件請即刻手動上傳；必要時改當日重開，或依規定改以折讓／作廢處理。	一般

以下為蝦皮平台 API 串接時之開立時點與同步說明；與一般開立 API、後台作業區分。未來若有 MOMO API串接、其他電商 API串接，將另立對應區塊。

問題	解答	適用
[蝦皮API 串接] 接單後，系統在什麼時間點會自動開立發票？	當蝦皮訂單狀態變更為「準備出貨」時，蝦皮 API 會自動拋單並開立電子發票。	蝦皮API串接
[蝦皮API 串接] 如果希望發票在「貨物送達」後開立，可以更改設定嗎？	可保留「貨物送達」狀態開立，但可能導致跨期開立，營業人需自行承擔稅務風險。	蝦皮API串接
[蝦皮API 串接] 系統自動開票的發票是否會同步更新到蝦皮？	會，開立發票會自動更新至蝦皮訂單備註，營業人可於蝦皮平台即時查看發票狀態。	蝦皮API串接

問題	解答	適用
如何取得 API 串接的 KEY？	須先填寫「e首發票 API 測試申辦與開通使用同意書」完成開通，方可取得串接用 KEY。測試開通效期為 30 天（依申請書與公告為準）；正式環境 KEY 依合約或管理後台取得。申請書：e首發票加值中心 API 測試帳號申請書	開立API／一般
不確定開通流程怎麼辦？	客服會引導您完成開通。可透過 LINE@、客服 07-7190888、業務 0800-800-402 或 Email：service@ieinv.com 聯繫。開通申請書與表單以官網或客服提供為準；連結若失效請洽客服。	開立API／一般