--- type: blog_post id: 188294 title: "2024-09 蝦皮API改版與新增功能介紹" category: "blog-integration" slug: "2024-09-蝦皮API改版與新增功能介紹" last_updated: 2026-06-19 status: "active" tags: ["e首發票專網 最新消息 蝦皮API改版"] ref_url: "https://www.youshop.com.tw/blog-integration/2024-09-%E8%9D%A6%E7%9A%AEAPI%E6%94%B9%E7%89%88%E8%88%87%E6%96%B0%E5%A2%9E%E5%8A%9F%E8%83%BD%E4%BB%8B%E7%B4%B9/188294" --- # 2024-09 蝦皮API改版與新增功能介紹   [](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEj9k6_RlXJS3eKadiT6xe1JQI_JHDyCFcF_9xC7lvtUM6jG-ECGVK50I-VYDQzNFuFEkwG6AOxl-cEN5Y5GTTse09S7UMYUMCBM1qNpbIu82F1_hbVwYVqbtEjm7wVfPYZQDobHrv28cDU3iievwhmnU_FNOKdyEsgWF60Arj5B6OnuwocIwzohjS3yD7hP/s600/%E5%9E%8B%E9%8C%84%E6%96%87%E7%AB%A0%E7%A4%BA%E6%84%8F%E5%9C%96.png) 2024-09 蝦皮API改版與新增功能介紹 為進一步提升電子發票的自動化作業，蝦皮API全面更新，新增退貨資訊授權取用功能，同時強化發票與折讓處理流程，優化稅務合規性。本次更新主要帶來以下幾個改進： 1. 避免跨期開立發票 根據國稅局對營業人的規定，發票應於收款或出貨時開立，避免出現跨期、短開或漏開發票的情況。為此，e首發票將蝦皮API的預設開立發票日期從「To_confirm_receive（貨物送達）」改為「Ready_TO_ship（準備出貨）」狀態，即訂單準備出貨時就會自動拋單預定**48HR**後開立發票。如果營業人希望保留原設定貨物送達，則需自行承擔稅務風險。 2. 自動化發票開立與處理流程 營業人授權e首發票使用新版蝦皮API後，系統會根據訂單狀態通知e首發票，當訂單狀態為「Ready_TO_ship」時，自動拋單開立電子發票。若訂單在**48HR**內開立發票前取消，系統會自動取消該筆訂單；如發票已開立，則會對應作廢發票，若已跨期無法作廢，系統會自動生成折讓單。 3. 退貨資訊自動讀取與折讓處理 新版API每7天會自動讀取蝦皮已審核通過的退貨單，並根據退貨金額自動開立折讓單。如果訂單尚未開立發票，系統會先開立發票再開立折讓單；若已開立發票，則根據期別處理折讓。當訂單結案後，若客戶在鑑賞期內退貨，系統將依據蝦皮退貨資訊自動生成折讓單，即便發票狀態不會更新。 4. 多渠道資訊同步 所有折讓訊息會通過API同步回蝦皮訂單備註，確保數據透明且可追溯，讓營業人能夠即時掌握發票與折讓狀態，減少稅務錯誤。 這次更新的重點在於優化發票開立時間、強化自動化退貨處理，並提升營業人在蝦皮平台上的合規性與管理效率。 2024 蝦皮API改版說明 FAQ 一、蝦皮API接單出貨開立發票 Q1: 接單後，系統在什麼時間點會自動開立發票？ A1: 當訂單狀態變更為「Ready_TO_ship（準備出貨）」時，蝦皮API會自動將訂單信息拋入e首發票系統，並自動**48HR**後開立電子發票。 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: 是的，系統會將退貨與折讓資訊同步更新至蝦皮訂單備註，營業人可以在蝦皮平台上查看相關信息。