2024-09 蝦皮API改版與新增功能介紹
為進一步提升電子發票的自動化作業，蝦皮API全面更新，新增退貨資訊授權取用功能，同時強化發票與折讓處理流程，優化稅務合規性。本次更新主要帶來以下幾個改進：
1. 避免跨期開立發票
根據國稅局對營業人的規定，發票應於收款或出貨時開立，避免出現跨期、短開或漏開發票的情況。為此，e首發票將蝦皮API的預設開立發票日期從「To_confirm_receive（貨物送達）」改為「Ready_TO_ship（準備出貨）」狀態，即訂單準備出貨時就會自動拋單開立發票。如果營業人希望保留原設定，則需自行承擔稅務風險。
2. 自動化發票開立與處理流程
營業人授權e首發票使用新版蝦皮API後，系統會根據訂單狀態通知e首發票，當訂單狀態為「Ready_TO_ship」時，自動拋單開立電子發票。若訂單在開立發票前取消，系統會自動取消該筆訂單；如發票已開立，則會對應作廢發票，若已跨期無法作廢，系統會自動生成折讓單。
3. 退貨資訊自動讀取與折讓處理
新版API每7天會自動讀取蝦皮已審核的退貨單，並根據退貨金額自動開立折讓單。如果訂單尚未開立發票，系統會先開立發票再開立折讓單；若已開立發票，則根據期別處理折讓。當訂單結案後，若客戶在鑑賞期內退貨，系統將依據蝦皮退貨資訊自動生成折讓單，即便發票狀態不會更新。
4. 多渠道資訊同步
所有折讓訊息會通過API同步回蝦皮訂單備註，確保數據透明且可追溯，讓營業人能夠即時掌握發票與折讓狀態，減少稅務錯誤。
這次更新的重點在於優化發票開立時間、強化自動化退貨處理，並提升營業人在蝦皮平台上的合規性與管理效率。
2024 蝦皮API改版說明 FAQ
一、蝦皮API接單出貨開立發票
Q1: 接單後，系統在什麼時間點會自動開立發票？
A1: 當訂單狀態變更為「Ready_TO_ship（準備出貨）」時，蝦皮API會自動將訂單信息拋入e首發票系統，並自動開立電子發票。
Q2: 如果營業人希望發票在「貨物送達」後開立，可以更改設定嗎？
A2: 可以選擇保留原設定在「To_confirm_receive（貨物送達）」狀態開立發票，但這可能會導致跨期開立，營業人需自行承擔相關稅務風險。
Q3: 發票自動開立後，營業人需要手動上傳到財政部平台嗎？
A3: 不需要，系統會自動上傳已開立的發票至財政部電子發票整合服務平台，並進行存證。
Q4: 如果發票開立後發現金額錯誤，該如何處理？
A4: 如果發現金額錯誤，且發票尚未跨期，系統可自動作廢發票並重新開立。如果已跨期，則需通過開立折讓單來進行處理。
Q5: 萬一出現訂單異常導致發票未能及時開立，該怎麼辦？
A5: 如果訂單異常導致發票未開立，系統會發送通知提醒營業人檢查訂單狀態，並根據情況手動介入處理發票開立問題。
Q6: 系統自動開票的發票是否會同步更新到其他平台？
A6: 是的，系統開立的發票會自動更新到蝦皮訂單備註中，並可同步至其他平台，讓營業人即時查看發票狀態。
二、蝦皮API訂單取消
Q1: 訂單取消後，系統會如何處理發票？
A1: 當訂單全單取消，系統會自動作廢已開立的發票。如果訂單取消時發票尚未開立，系統將直接取消開票操作。
Q2: 若訂單在客戶取貨後取消，會進入什麼流程？
A2: 只要客戶已取貨，訂單取消或部分退貨都會進入退貨作業流程，系統會自動依退貨單生成折讓單，而不會作廢發票。
Q3: 訂單取消時發票已跨期，系統如何處理？
A3: 如果發票已跨期無法作廢，系統會自動開立折讓單來處理已開立的發票，無需手動干預。
Q4: 訂單取消後，營業人是否需要手動作廢發票？
A4: 系統會自動處理發票作廢或折讓，營業人通常不需要手動干預，建議讓系統自動處理，以避免錯誤。
Q5: 如果系統未能正常處理訂單取消後的發票，該怎麼辦？
A5: 若系統發生異常，營業人可手動介入處理發票作廢或折讓，但建議僅在系統出現問題時介入，平時應依賴系統自動操作以減少錯誤。
Q6: 部分取消的情況如何處理？
A6: 部分取消的情況會進入退貨作業流程，而不是訂單取消，系統會根據退貨單自動開立折讓單。
三、蝦皮API訂單退貨
Q1: 客戶取貨後部分退貨，系統會如何處理？
A1: 當客戶取貨後進行部分退貨，系統會自動讀取退貨單，並根據退貨金額自動生成折讓單。
Q2: 如果營業人手動處理退貨折讓，會有什麼風險？
A2: 建議讓系統自動生成折讓單，若營業人手動介入可能導致重複開立折讓單或金額錯誤。除非系統發生異常，否則不建議手動干預。
Q3: 系統自動生成的折讓單與實際金額不符怎麼辦？
A3: 系統會依據蝦皮審核通過的退貨單自動生成折讓單，營業人應定期檢查折讓單與實際退貨金額，若不符可聯繫系統客服進行更正。
Q4: 退貨單讀取的頻率是如何設定的？
A4: 系統每7天會自動讀取蝦皮審核通過的退貨單，並自動處理折讓單的生成。
Q5: 若訂單退貨後，發票尚未開立，系統如何處理？
A5: 如果退貨時訂單尚未開立發票，系統會先自動開立發票，再依退貨單生成折讓單。
Q6: 系統會將退貨與折讓訊息同步到蝦皮訂單嗎？
A6: 是的，系統會將退貨與折讓資訊同步更新至蝦皮訂單備註，營業人可以在蝦皮平台上查看相關信息。