訂單匯入
未有api的通路透過此方法做各種訂單狀態下的訂單手動匯入
尚未付款有支援第三方API的通路，其訂單可透過API拉訂單到OneEC內，ex：yahoo、蝦皮、momo、91app等；未支援第三方API的通路，其訂單則透過以下方式將訂單匯入到OneEC內，ex：pinkoi、line禮物、博客來等。
目前支援「通路後台excel匯入格式」之通路：pinkoi、line禮物，操作流程參考訂單明細–通路後台訂單格式匯入–說明。 除了上述通路，未有api的通路目前須透過OneEC訂單公版格式做訂單匯入，如博客來，操作流程參考訂單／退貨明細–手動匯入–說明。（若您的通路屬於未有api，請告知我們，我們將盡快開發。等這些通路的後台訂單格式匯入到OneEC的功能開發好，訂單格式就不須轉成OneEC訂單公版格式，即可直接做匯入。） <2022/11/24版>、
訂單／退貨明細–手動匯入–說明
〔訂單明細〕：請盡量將訂單從 <待出貨> 開始匯入，一有改變狀態就要做新的匯入，新的狀態就會蓋掉舊的狀態，直到 <訂單完成> 或者 <退貨完成> 的最終狀態，故請謹慎每一次的匯入。 〔退貨明細〕：目前則是輔助參考用，不一定要匯入，若要匯入，其格式請依訂單／退貨明細–手動匯入–說明做出正確格式的退貨明細，否則可能會匯入失敗。
匯入〔退貨明細〕前，必須要先匯入〔訂單明細〕，否則會匯入失敗！
三大按鈕說明
匯入範例檔下載：下載〔訂單明細〕公版、〔退貨明細〕公版
訂單匯入：匯入〔訂單明細〕、〔退貨明細〕
訂單匯入執行結果：查看〔訂單明細〕和〔退貨明細〕的匯入狀態及結果
依下載匯入的公版，做訂單細節的填入，注意說明如下
公版欄位為固定排序，勿刪除／新增，必填欄位一定要填寫，若其他欄位無內容，可留空白！
訂單編號 & 項次– 填入〔訂單／退貨明細〕的邏輯需一致！
訂單編號、項次：同通路的訂單盡量以相同的編號方式來填入，以下表格為兩種通路下針對同一張訂單不同商品的訂單編號配上項次的範例。
訂單編號：order123 項次：0
訂單編號：order123 項次：1
訂單編號：order123 項次：2
訂單編號：order001 項次：0
訂單編號：order002 項次：0
訂單編號：order003 項次：0
〔退貨明細〕中的訂單編號配上項次依〔訂單明細〕所設定的邏輯來製作正確格式的公版。例如：〔訂單明細〕為上方第一種的訂單編號模式，碰到<部分退貨-商品C-數量1>，在〔退貨明細〕中的訂單編號填入order123、項次填入2、退貨數量填入1。〔退貨明細〕的訂單編號&項次要與〔訂單明細〕所填入的一樣，否則可能會出現error。
這些欄位請填入相對應的ID：〔訂單明細〕的〔訂單狀態〕、〔溫層〕、〔配送方法〕、〔物流公司編號〕，以及〔退貨明細〕的〔退貨狀態〕、〔物流公司編號〕。
在〔訂單明細〕公版中的〔退貨號碼〕、〔退貨數量〕、〔取消數量〕為參考欄位，非必填，目前訂單手動匯入不支援部分取消。若〔退貨編碼/商品/數量/日期〕要顯示在OneEC的訂單中的退貨資訊裡，則需透過匯入〔退貨明細〕匯入。
配送方法 – 說明
對於未支援第三方API的通路（自訂通路），目前在OneEC的一站出貨只支援<自行配送>的配送方式，若您的匯入訂單會使用到OneEC的一站出貨功能，在訂單匯入EXCEL中的〔配送方法〕請填寫<自行配送>相對應的數字，這樣的訂單並且狀態為<待出貨>才會進到一站貨的作業系統裡。若您將不使用OneEC的一站出貨，則填寫物流相對應的配送方法，如上圖。<2022/11/01版>
日期/時間相關欄位- 可不必依公版時間格式！（以下內容必看，輸入錯誤時區，將不便於更改）
- 例如：〔訂單明細〕中的訂單成立日、通路出貨日、最晚出貨日、應出貨日、指定到貨日、發票開立日；〔退貨明細〕中退貨單成立日、退貨單結束日、退貨單終止日 - 若依造公版時間格式寫入，請將EXCEL儲存格內容轉換成公版時間的UTC+0格式（點進去儲存格就要是2022-05-05T16:16:11.111Z這樣子UTC+0的內容，如下圖所示） - 若不依造公版時間格式，我們就會以EXCEL檔中的時區當作訂單時間的依據時區（如下圖所示），存入到OneEC中，這裡須注意 "時間填寫到公版上在EXCEL呈現出的時間是否與後通路台所顯示訂單時間一致"，若在通路後台為UTC+0的時間，放入到公版顯示為UTC+8時間，我們就會以公版上的時間轉成廠商所在時區顯示在OneEC裡。
匯入 – 訂單 ∕ 退貨明細 – 操作流程
1、按下〔訂單匯入〕
2、選擇〔匯入訂單明細〕or〔匯入退貨明細〕
匯入〔訂單 / 退貨明細〕後，將出現以下畫面：
匯入錯誤的檔案 -> 不會出現任何資料畫面 匯入欄位缺少的檔案 -> 出現錯出誤通知，錯誤通知如下圖
到〔訂單匯入執行結果〕，查看匯入狀態＆結果
若填入的欄位未依照OneEC公版範例中的格式，而導致無法存進OneEC的後台，將會出現上述的「無總筆數、無成功筆數、無失敗筆數」的結果。OneEC將有retry 4次機制，沒結果的話每5分鐘會自動跑一次，若20分鐘過去，仍沒出現結果，請確認格式有無依照公版，若無依照公版，需重新調整成正確格式後再次匯入！
到〔小鈴鐺〕，查看匯入結果＆失敗訊息
批次排程中有出現失敗筆數的訂單，其失敗原因會依在EXCEL上的第X列，統一顯示顯在小鈴鐺中。上圖的失敗原因是因為「未匯入〔訂單明細〕，直接匯入〔退貨明細〕」而產生的匯入失敗結果。
訂單 / 退貨明細匯入成功後，到訂單畫面再次確認！
自訂通路的訂單由下次訂單匯入來更新狀態，新的狀態會蓋掉舊的狀態，僅有在一站出貨押下確認出貨後，訂單狀態會被動變成〔已出貨〕，請參閱訂單明細-手動匯入 & 一站出貨之間的 <訂單狀態關係> 的說明與範例。
訂單明細匯入 - 訂單狀態為〔訂單已取消〕=> 取消狀態呈現〔完全取消〕，進〔查看〕出現〔取消資訊〕
目前僅支援〔完全取消〕，若第2次匯入的商品數量比起前一次減少／增加，將以第2次匯入的商品數量為取消數量！（等同於覆蓋上一次匯入的商品數量）<2022/11/01>
退貨明細匯入 - 退貨狀態呈現〔已退貨／局部退貨〕=>進〔查看〕出現〔退貨貨訊〕
訂單明細–通路後台訂單格式匯入–說明
操作流程
1、在通路後台下載訂單明細（個資匯入到OneEC後就會隱碼，匯入檔案的個資不須隱碼） 2、在OneEC訂單UI中，按下〔訂單匯入〕 3、按下〔訂單明細〕＆ 選擇〔通路〕，按下〔匯入 #通路 格式〕
4、選擇〔 #通路 訂單明細Excel檔〕，即匯入完畢
匯入後的結果與通知，與OneEC通用格式相同，請參考訂單／退貨明細–手動匯入–說明
出貨相關，請參考訂單明細–手動匯入 & 一站出貨之間的 <訂單狀態關係>
常見問題，請參考常見Q&A
匯入時，遇到無效，相關說明
1、訂單狀態非以下指定文字
pinkoi
待出貨
已出貨
已完成
已取消
line禮物
已付款
配送中
寄送完成
已取消
露天拍賣
尚未付款 / 待確認
待出貨 / 待取消
已出貨
已取消
2、必填欄位未填寫內容
3、數字型態的欄位填寫成非數字
4、日期型態的欄位填寫成非日期格式
5、原表頭有所異動時，ex：原表頭的順序改變 （表頭數量一樣）、原表頭的欄位減少（表頭數量不一樣）、原表頭插入新的欄位
訂單明細–手動匯入 & 一站出貨之間的 <訂單狀態關係>
手動匯入的訂單，需透過下一次的訂單匯入，主動改變訂單的狀態。若您的自訂通路有開通OneEC的一站出貨功能（現階段自訂通路預設為開啟出貨功能，若需要關閉請告知我們），訂單在一站出貨中的〔確認出貨〕按下按鈕後，訂單狀態會自動改成〔已出貨〕且附上〔貨運公司〕&〔出貨物流單號〕&〔通路出貨日期〕&〔OneEC出貨日期〕，如下圖的操作所示。
匯入的訂單狀態為 <待出貨>，才會進入到一站出貨流程裡
對於〔自訂通路〕，OneEC的出貨物流僅開放〔自訂貨運〕，其操作流程請參閱一站出貨的說明
若您的自訂通路有支援OneEC的取消出貨，按下取消出貨後，在訂單查詢中的訂單狀態將不會有任何改變，請匯入新的訂單狀態來改變原有的訂單狀態！
常見Q&A
Q：先匯入〔訂單明細〕再匯入〔退貨明細〕，查看發現〝退貨狀態無改變〞，卻附上〝退貨資訊〞？（狀況如下圖所示）
這樣的狀況是因為〔退貨明細〕中的商品料號與〔訂單明細〕的商品料號不一致而導致。將〔退貨明細〕中的商品料號填寫正確，再次匯入，退貨狀態就會變成〔已退貨〕or〔局部退貨〕，且〔退貨資訊〕將更新成最新匯入的版本。
Q：匯入〔訂單明細〕or〔退貨明細〕後，到〔訂單匯入執行結果〕看，發現無結果，過5分鐘後（沒結果的話，OneEC retry最多跑4次，最多20分鐘），結果的訂單數為2倍，完成率為200%（狀況如下圖所示）
這是因為retry機制，導致結果的訂單數 & 完成比率大於原本的數量，為正常現象！
最后更新于