本文主要講解如何從零開始，通過接入阿里云LinkedMall分銷API，將貓淘商品供應鏈接入到企業客戶（分銷商）自有商城體系的過程，包括業務流程和技術接口實現。
1、概述
1.1 背景
基于阿里電商體系的供應鏈能力，提供全套供應鏈接入API，服務企業電商場景，包括：企業福利、積分兌換、銷售帶貨、渠道流量轉化等，為企業提供質美價優的商品、合規的資金流、統一開票能力和標準物流履約體系。
1.2 適用客戶
此模式適合有一定研發能力的企業客戶選用。企業客戶（分銷商）在不改變原企業商城風格的前提下，靈活的接入更豐富的商品供給用于開展多種業務。
對于LinkedMall平臺提供的API/SDK，若您以商業目的使用，則您需事先從阿里云獲取商用授權，完成入駐審核流程，才能使用該服務。
關于具體使用規則，請參閱阿里云LinkedMall分銷商服務協議獲得詳細信息。
1.3 名詞定義
名詞 | 定義 |
分銷商 | 通過接入API，使用阿里商品供應鏈實現業務場景的企業客戶。 |
分銷商商城 | 分銷商入駐后，開通的分銷商城API對接中，此商城將作為采購方（買方）進行下單，在API語境下為分銷商采購商城。 |
用戶 | 分銷商（企業客戶）提供的業務服務的最終用戶或消費者。 |
分銷渠道供應商 | 提供貓淘商品聚合能力的渠道供應商。請在接入前，和對應的貓淘供應商完成溝通后再接入。 |
采購訂單 | 分銷商向分銷渠道供應商采購商品時，下的訂單，采購訂單（分銷交易單）在業務上為主子單模式。 |
店鋪賬單 | 所有采購訂單會在下月初固定時間，統一生成采購訂單關聯的賬單。 |
商品選品池 | 分銷商從渠道商店鋪中選取的可采購商品子集，目前每個采購店鋪默認創建一個商品選品池，并自動導入商品；分銷商創建采購訂單、商品的變更通知的商品需要在選品池中存在。 |
訂單 | 分銷商采購訂單下單后，按照一定的訂單拆單邏輯，在渠道店鋪中生成一個或多個訂單。訂單用于定義雙方交易合約，維護訂單支付、履約狀態的生命周期。 |
子訂單 | 按照SKU進行訂單拆單產出的實體，子訂單將包含子訂單費用、履約狀態等信息。? |
物流單 | 訂單進行物流履約時，用于關聯物流公司物流單以及物流狀態與詳情的實體。物流單與快遞號一一對應。 |
退款單 | 分銷商發起退款的處理實體，基于子訂單進行退款，包含退款基本信息、退款執行狀態等。 |
地址碼 | 采購訂單下單時，傳入下單地址需要轉換成標準的地址代碼。 |
2、接入流程
整個接入過程，大致分為4個階段：
入駐審核：注冊阿里云賬號，完成分銷商入駐。（企業信息、資金賬號、合同簽約等）
對接開發：基于分銷商接口SDK，完成開發和調試。（商品、訂單、帳單等API對接；商品、訂單消息對接）
選品聯調：選擇測試商品，由運營小二支持，完成正逆向的下單測試。
上線發布：選擇正式發布商品，發布上線。售后問題聯系天貓企業購小二統一處理，統一由天貓企業購完成開票對賬服務。
2.1 第一階段：入駐審核
分銷商入駐請參考分銷商入駐與工作臺操作指南。
2.2 第二階段：接入開發
2.2.1 正向交易
2.2.1.1 業務流程
相關API請參考訂單。
分銷商在完成API對接后，建議獨立搭建分銷商城，將商品同步至自建商品庫，下圖流程中的商品瀏覽僅做示意，不建議分銷商直接使用商品列表接口和商品詳情接口直接C端接入。
2.2.1.2 采購訂單狀態機
該狀態機展示的是采購訂單維度的生命周期。
2.2.1.3 拆單邏輯
采購訂單的拆單邏輯，遵循淘寶訂單的主子單拆單關系：
采購訂單：分銷商向LinkedMall發起的一筆采購交易訂單，可以包括多件商品和SKU。
采購訂單主單：一個分銷采購訂單包含1到N個分銷采購訂單主單，每個淘寶訂單主單和分銷采購單主單一一對應。
采購訂單子單：一個分銷采購訂單主單包含1到N個分銷采購訂單子單，每個淘寶訂單子單和分銷采購單子單一一對應。
拆分主單：根據淘寶主站商品的發貨店鋪和發貨倉等，拆分為多個分銷采購訂單主單（或淘寶訂單主單）。
拆分子單：每個分銷采購訂單主單根據子單最小顆粒度SKU進行子單拆分。
訂單狀態：分銷商必須存儲淘寶主單和子單的狀態，用于展示和判斷您自己商城側訂單狀態。
2.2.2 逆向交易
2.2.2.1 業務流程
相關API請參考售后單。
僅退款
退貨退款
2.2.2.2 售后單狀態機
LinkedMall側逆向狀態機示意：
2.2.2.3 限制條件
逆向流程中，更多的用戶發起和商家審核限制條件以淘寶天貓主站業務邏輯為準。
僅退款：
確認收貨前，申請退
商家未發貨，申請退款只需要選擇退款原因，只能全額退款。
商家已發貨，申請退款，用戶需要選擇是否收到貨，如果選擇未收到貨，可以申請全額退款（商家待確認是否退），如果選擇已經收到貨，可全額退或部分退款。
確認收貨后，申請退
確認收貨后，同上。
部分退款：
確認收貨前，申請退
商家未發貨，申請退款只需要選擇退款原因，不支持部分退款。
商家已發貨，申請退款，用戶需要選擇是否收到貨，如果選擇未收到貨，無法申請部分退款，如果選擇已經收到貨，可以支持部分退款。
確認收貨后，申請退
確認收貨后，同上。
退貨退款：
確認收貨前，申請退
商家未發貨，不可退貨退款。
商家已發貨，申請退貨退款，支持部分退款和全額退款，商家根據情況審核，其中7天無理由商家無法拒絕。
確認收貨后，申請退
確認收貨后，支持部分退款和全額退款，商家根據情況審核。
2.2.3 客戶側2C交易狀態關聯調用示例
備注：逆向流程中，更多的用戶發起和商家審核限制條件以淘寶天貓主站業務邏輯為準。
2.2.4 商品運營
2.2.5 API接口列表
API接口詳細描述請參考API參考。
本文所有提供的接口都是通過阿里云的 POP 網關對外透出，客戶需要用阿里云的用戶身份通過 LinkedMall 的SDK調用接口，LinkedMall已經提供了相應的 demo 程序，可以向對接人員索取。調用本文中所有接口的阿里云賬戶需要和自身的客戶Id綁定，否則將拒絕執行。
客戶通過SDK客戶端（Client）調用LinkedMall服務時，LinkedMall只能保證服務端穩定性，不能保證客戶端穩定性，因此客戶側有秒殺等大流量活動時，請提前通知LinkedMall并自行壓測驗證接口性能。
2.3 第三階段：測試聯調
聯系天貓運營小二，在專屬技術溝通群中溝通，配合企業客戶完成正逆向交易狀態變更及測試。
售后退款退貨邏輯
聯系天貓運營小二，在專屬技術溝通群中溝通，測試操作退款退貨
除特殊類目及場景，未發貨申請天貓立即自動退款。
2.4 第四階段：上線發布
上線前，聯系天貓運營小二，同步更新最新的商品庫，并根據業務需要上架商品。
請確認代扣支付寶賬號中余額充足，否則會影響正常下單。
發貨時效：
普通商品：一般是買家付款后24小時內上傳物流單號,買家付款后48小時內發貨 。
定制、預售及其他特殊情形等另行約定發貨時間的商品：約定時間內發貨。
固定賬期，根據接口的賬單信息核對貨款賬單，同時聯系天貓運營小二完成開票。
上線后，如遇系統技術等突發問題，在專屬技術溝通群中提交工單，會有技術人員根據故障等級及時響應。