目錄一、先說結(jié)論二、現(xiàn)象出庫單拉下來了金額是空的三、為什么平臺規(guī)定不是聚水潭不給四、奇門是什么五、申請奇門要什么5.1 聚水潭文檔列的軟件著作權(quán)5.2 淘寶開放平臺那邊的要求5.3 我走到哪了六、奇門批下來之前財(cái)務(wù)對接怎么辦6.1 淘系訂單先掛起別按 0 推6.2 跟財(cái)務(wù)商量三種處理方式6.3 上線前一定要講清楚七、順便說一句聚水潭自帶的「財(cái)務(wù)小工具」已經(jīng)停用八、拼多多呢九、最后一、先說結(jié)論用聚水潭開放平臺做財(cái)務(wù)對接比如對接金蝶、用友淘寶天貓的訂單拿不到金額。這不是接口 bug是平臺規(guī)定淘系訂單數(shù)據(jù)不允許通過聚水潭直接透出要拿必須走阿里的網(wǎng)關(guān)——奇門聚水潭的「銷售出庫單查詢」對淘系訂單不返回線上單號、收件人、金額「訂單查詢」「售后單查詢」只能查到商家自有商城站點(diǎn)的單淘系的查不到所以「聚水潭奇門」說白了就是想把淘寶天貓訂單的金額拿進(jìn)財(cái)務(wù)系統(tǒng)得多開一條奇門通道。下面引用的都是聚水潭開放平臺官方文檔原文出處寫在每一段后面。二、現(xiàn)象出庫單拉下來了金額是空的我在做聚水潭對接金蝶云星空時用的是聚水潭開放平臺的「銷售出庫查詢」接口/open/orders/out/simple/query按start_ts增量拉已出庫的單。出庫單的每條明細(xì)里金額靠sale_price單價和sale_amount金額這兩個字段。寫映射的時候我去翻官方文檔才發(fā)現(xiàn)淘系訂單是例外。聚水潭官方文檔「財(cái)務(wù)系統(tǒng)對接聚水潭」里寫得很清楚拿淘系訂單涉及出入庫單據(jù)和商品金額的接口各自的限制是接口官方注意事項(xiàng)訂單查詢只能查詢到商家自有商城站點(diǎn)的訂單銷售出庫單查詢淘系訂單的出庫單不會返回淘系線上單號、收件人信息、金額等信息售后單查詢只能查詢到商家自有商城站點(diǎn)的售后單售后退倉單查詢—采購入庫查詢—采購?fù)素洸樵儭渌鋈霂觳樵儭鎏幘鬯堕_放平臺文檔 docId180「財(cái)務(wù)系統(tǒng)對接聚水潭」。財(cái)務(wù)對接最要緊的就是金額這一條等于把淘寶天貓店鋪的收入擋在了外面。一家公司如果主要在天貓賣貨光走聚水潭開放平臺財(cái)務(wù)對接基本做不下去。三、為什么平臺規(guī)定不是聚水潭不給聚水潭官方在「奇門對接場景」文檔里的原話為了達(dá)到用戶隱私及數(shù)據(jù)安全保護(hù)的規(guī)范要求淘系訂單數(shù)據(jù)將無法直接提供。聚水潭作為淘寶的服務(wù)商與淘寶平臺之間有協(xié)定平臺數(shù)據(jù)不允許通過聚水潭直接透出。如需透出需要經(jīng)過奇門網(wǎng)關(guān)透出注奇門是阿里的網(wǎng)關(guān)。出處聚水潭開放平臺文檔 docId27「奇門對接場景」。也就是說數(shù)據(jù)是淘寶的聚水潭只是淘寶的服務(wù)商淘寶不允許服務(wù)商把訂單數(shù)據(jù)直接轉(zhuǎn)給第三方要拿必須走淘寶自己的通道——奇門所以找聚水潭客服也沒用這條規(guī)則不在聚水潭手里。四、奇門是什么奇門是阿里開放平臺的一個網(wǎng)關(guān)。聚水潭里的淘系數(shù)據(jù)要給第三方系統(tǒng)就經(jīng)過奇門轉(zhuǎn)一道由淘寶那邊管住誰能拿、拿什么。聚水潭文檔里列了奇門的幾種場景場景干什么現(xiàn)狀奇門 WMS聚水潭和倉儲系統(tǒng)之間推出庫單、回傳發(fā)貨。聚水潭做 ERP 或做 WMS二選一不能雙向可申請奇門 POS獲取含淘系平臺的銷售出庫單帶加密的收件人信息奇門已經(jīng)不再頒發(fā)該場景資質(zhì)歷史申請到的可以繼續(xù)用奇門 CRM、線下 ERP文檔里作為可調(diào)自定義接口的場景列出—奇門自定義接口用上面任一場景的奇門 AppKey 調(diào)用只能查詢到淘系平臺的數(shù)據(jù)需要單獨(dú)授權(quán)出處聚水潭開放平臺文檔 docId27。通過奇門自定義接口聚水潭提供了三個查詢銷售出庫查詢、售后單查詢、訂單查詢文檔都注明「沒有收件人信息」。財(cái)務(wù)對接要的是金額不要收件人所以走「奇門自定義接口」這條路就夠了不需要 POS 場景也申請不到了。聚水潭文檔在「奇門適用場景」里也直接列了這一條聚水潭中有淘系訂單需要獲取該部分訂單的銷售出庫單到財(cái)務(wù)系統(tǒng)做財(cái)務(wù)賬統(tǒng)計(jì)的五、申請奇門要什么5.1 聚水潭文檔列的軟件著作權(quán)聚水潭文檔「奇門申請條件」里寫的是軟件著作權(quán)需要的材料系統(tǒng)界面說明書軟件著作權(quán)登記表軟件源碼不少于 6000 行5.2 淘寶開放平臺那邊的要求奇門資質(zhì)是在淘寶開放平臺申請的。按淘寶官方文檔申請路徑分兩種路徑誰能走自研系統(tǒng)僅限有開發(fā)能力的天貓商家自己用三方系統(tǒng)軟件廠商或其代理商做對接服務(wù)的第三方走的是「三方系統(tǒng)」。要準(zhǔn)備要求說明企業(yè)支付寶注冊淘寶開放平臺個人不行要企業(yè)主體軟件著作權(quán)就是 5.1 那個證書要下來MRD市場需求分析、產(chǎn)品功能、賣點(diǎn)、營銷策略PRD功能描述、業(yè)務(wù)流程、界面 demo、功能截圖、軟著截圖系統(tǒng)客戶端登錄憑證給奇門方核實(shí)系統(tǒng)真實(shí)存在審核周期官方說5–7 天。還有一條容易踩的WMS 類應(yīng)用的軟著名稱必須包含「WMS」或「倉儲管理」。只做財(cái)務(wù)對接的不受這條約束但如果打算申請奇門 WMS 場景軟著起名時就要注意。5.3 我走到哪了我自己正在走這個流程當(dāng)前進(jìn)度步驟狀態(tài)企業(yè)支付寶認(rèn)證已完成淘寶開放平臺入駐應(yīng)用軟件開發(fā)商已完成實(shí)人認(rèn)證已過MRD、PRD已寫好軟件著作權(quán)辦理中等下證提交奇門申請等軟著證書PRD 里要放軟著截圖軟著沒下來之前千萬別提交。PRD 里要求放軟著截圖缺了必被駁回駁回后還要等一段時間才能重新提交。走完之后我會把審核過程、駁回原因如果有、奇門接口的實(shí)際調(diào)用再寫一篇。六、奇門批下來之前財(cái)務(wù)對接怎么辦大多數(shù)商家不止淘寶天貓一個平臺。奇門沒通之前可以先把非淘系的單子對接起來淘系的單子單獨(dú)處理。6.1 淘系訂單先掛起別按 0 推最危險的做法是拿不到金額就按 0 推進(jìn)金蝶。財(cái)務(wù)月底一看一堆 0 元出庫單比沒推還麻煩。我的做法是沒有價格字段的單一律掛起記下原因等補(bǔ)上金額再推// 判斷一張聚水潭出庫單能不能推進(jìn)財(cái)務(wù)系統(tǒng)// 返回 null 表示可以推否則返回掛起原因functionholdReason(row){constitemsArray.isArray(row.items)?row.items:[];if(!items.length)return出庫單沒有明細(xì);constmissingPriceitems.some(itit.sale_priceundefined||it.sale_pricenull);if(missingPrice){return沒有價格字段淘系訂單聚水潭不返回金額需走奇門先掛起;}returnnull;}constready[];constheld[];for(constrowofrows){constreasonholdReason(row);if(reason)held.push({io_id:row.io_id,shop:row.shop_name,reason});elseready.push(row);}注意這里判斷的是「字段不存在」undefined或null不是「等于 0」。贈品、0 元單的價格本來就是 0那是正常數(shù)據(jù)要照常推。官方只說「不會返回金額」沒說是字段缺失還是給空值。更穩(wěn)的做法是再加一道按店鋪判斷讓客戶把淘寶、天貓店鋪的shop_id列出來這些店鋪的出庫單一律走掛起邏輯不依賴字段長什么樣。掛起的單要有地方能看到哪些店鋪、多少張、從哪天開始。不然時間一長沒人記得還有一批單沒進(jìn)賬。6.2 跟財(cái)務(wù)商量三種處理方式方式做法適合掛起等奇門淘系單先不推奇門通了一次性補(bǔ)推奇門很快能批下來只推數(shù)量出庫單推進(jìn)金蝶只管庫存數(shù)量金額由財(cái)務(wù)按其他來源補(bǔ)庫存要準(zhǔn)、收入另外算按平臺結(jié)算走賬出庫單只管庫存淘系收入按平臺結(jié)算賬單做財(cái)務(wù)本來就按平臺賬單確認(rèn)收入選哪種是財(cái)務(wù)的決定對接這邊要做的是把這三種都做成配置項(xiàng)不要寫死。6.3 上線前一定要講清楚我在方案里會把這句話寫在最前面淘寶天貓的訂單通過聚水潭開放平臺拿不到金額。要金額需要另外申請奇門周期取決于軟著和淘寶審核。客戶上線后才發(fā)現(xiàn)天貓的單全是 0信任就沒了。七、順便說一句聚水潭自帶的「財(cái)務(wù)小工具」已經(jīng)停用聚水潭官方文檔 docId180 開頭有一行提示財(cái)務(wù)小工具不再支持使用權(quán)限將不再頒發(fā)財(cái)務(wù)系統(tǒng)對接請走開放平臺應(yīng)用對接或者聯(lián)系 KA 定制以前有商家用聚水潭自帶的財(cái)務(wù)小工具把單據(jù)導(dǎo)進(jìn)金蝶、用友現(xiàn)在官方已經(jīng)停了要么走開放平臺應(yīng)用對接要么找聚水潭的 KA 定制。還在用老辦法的最好盡快確認(rèn)一下自己那條對接還能不能跑。八、拼多多呢聚水潭文檔里另外有一個「方舟對接場景」。拼多多訂單的金額走不走方舟、限制是什么我還沒核實(shí)到官方原文這篇先不寫核實(shí)后單獨(dú)補(bǔ)一篇。九、最后聚水潭奇門是什么淘系訂單數(shù)據(jù)的官方通道。淘寶不允許聚水潭把訂單數(shù)據(jù)直接給第三方要拿就得過奇門為什么要它聚水潭開放平臺的銷售出庫單對淘系訂單不返回金額財(cái)務(wù)對接走哪個場景奇門自定義接口只能查淘系不需要 POS也不再頒發(fā)申請要什么企業(yè)主體、軟著、MRD、PRD、可登錄的系統(tǒng)審核 5–7 天沒批下來之前淘系單掛起別按 0 推跟財(cái)務(wù)定好處理方式上一篇寫了聚水潭銷售出庫單對接金蝶云星空的整條線這一篇是其中「淘系訂單沒金額」這個坑的來龍去脈。在走奇門申請、或者被淘系訂單卡住的評論區(qū)聊看到都會回。