本文主要講解如何從零開(kāi)始，通過(guò)接入阿里云LinkedMall分銷(xiāo)API，將貓?zhí)陨唐饭?yīng)鏈接入到企業(yè)客戶（分銷(xiāo)商）自有商城體系的過(guò)程，包括業(yè)務(wù)流程和技術(shù)接口實(shí)現(xiàn)。

1、概述

1.1 背景

基于阿里電商體系的供應(yīng)鏈能力，提供全套供應(yīng)鏈接入API，服務(wù)企業(yè)電商場(chǎng)景，包括：企業(yè)福利、積分兌換、銷(xiāo)售帶貨、渠道流量轉(zhuǎn)化等，為企業(yè)提供質(zhì)美價(jià)優(yōu)的商品、合規(guī)的資金流、統(tǒng)一開(kāi)票能力和標(biāo)準(zhǔn)物流履約體系。

1.2 適用客戶

對(duì)于LinkedMall平臺(tái)提供的API/SDK，若您以商業(yè)目的使用，則您需事先從阿里云獲取商用授權(quán)，完成入駐審核流程，才能使用該服務(wù)。

關(guān)于具體使用規(guī)則，請(qǐng)參閱阿里云LinkedMall分銷(xiāo)商服務(wù)協(xié)議獲得詳細(xì)信息。

1.3 名詞定義

2、接入流程

整個(gè)接入過(guò)程，大致分為4個(gè)階段：

1. 入駐審核：注冊(cè)阿里云賬號(hào)，完成分銷(xiāo)商入駐。（企業(yè)信息、資金賬號(hào)、合同簽約等）

2. 對(duì)接開(kāi)發(fā)：基于分銷(xiāo)商接口SDK，完成開(kāi)發(fā)和調(diào)試。（商品、訂單、帳單等API對(duì)接；商品、訂單消息對(duì)接）

3. 選品聯(lián)調(diào)：選擇測(cè)試商品，由運(yùn)營(yíng)小二支持，完成正逆向的下單測(cè)試。

4. 上線發(fā)布：選擇正式發(fā)布商品，發(fā)布上線。售后問(wèn)題聯(lián)系天貓企業(yè)購(gòu)小二統(tǒng)一處理，統(tǒng)一由天貓企業(yè)購(gòu)?fù)瓿砷_(kāi)票對(duì)賬服務(wù)。

2.1 第一階段：入駐審核

分銷(xiāo)商入駐請(qǐng)參考分銷(xiāo)商入駐與工作臺(tái)操作指南。

2.2 第二階段：接入開(kāi)發(fā)

2.2.1 正向交易

2.2.1.1 業(yè)務(wù)流程

相關(guān)API請(qǐng)參考訂單。

2.2.1.2 采購(gòu)訂單狀態(tài)機(jī)

該狀態(tài)機(jī)展示的是采購(gòu)訂單維度的生命周期。

2.2.1.3 拆單邏輯

采購(gòu)訂單的拆單邏輯，遵循淘寶訂單的主子單拆單關(guān)系：

1. 采購(gòu)訂單：分銷(xiāo)商向LinkedMall發(fā)起的一筆采購(gòu)交易訂單，可以包括多件商品和SKU。

2. 采購(gòu)訂單主單：一個(gè)分銷(xiāo)采購(gòu)訂單包含1到N個(gè)分銷(xiāo)采購(gòu)訂單主單，每個(gè)淘寶訂單主單和分銷(xiāo)采購(gòu)單主單一一對(duì)應(yīng)。

3. 采購(gòu)訂單子單：一個(gè)分銷(xiāo)采購(gòu)訂單主單包含1到N個(gè)分銷(xiāo)采購(gòu)訂單子單，每個(gè)淘寶訂單子單和分銷(xiāo)采購(gòu)單子單一一對(duì)應(yīng)。

4. 拆分主單：根據(jù)淘寶主站商品的發(fā)貨店鋪和發(fā)貨倉(cāng)等，拆分為多個(gè)分銷(xiāo)采購(gòu)訂單主單（或淘寶訂單主單）。

5. 拆分子單：每個(gè)分銷(xiāo)采購(gòu)訂單主單根據(jù)子單最小顆粒度SKU進(jìn)行子單拆分。

6. 訂單狀態(tài)：分銷(xiāo)商必須存儲(chǔ)淘寶主單和子單的狀態(tài)，用于展示和判斷您自己商城側(cè)訂單狀態(tài)。

2.2.2 逆向交易

2.2.2.1 業(yè)務(wù)流程

相關(guān)API請(qǐng)參考售后單。

• 僅退款

• 退貨退款

2.2.2.2 售后單狀態(tài)機(jī)

LinkedMall側(cè)逆向狀態(tài)機(jī)示意：

2.2.2.3 限制條件

1. 僅退款：

   • 確認(rèn)收貨前，申請(qǐng)退

     • 商家未發(fā)貨，申請(qǐng)退款只需要選擇退款原因，只能全額退款。

     • 商家已發(fā)貨，申請(qǐng)退款，用戶需要選擇是否收到貨，如果選擇未收到貨，可以申請(qǐng)全額退款（商家待確認(rèn)是否退），如果選擇已經(jīng)收到貨，可全額退或部分退款。

   • 確認(rèn)收貨后，申請(qǐng)退

     確認(rèn)收貨后，同上。

2. 部分退款：

   • 確認(rèn)收貨前，申請(qǐng)退

     • 商家未發(fā)貨，申請(qǐng)退款只需要選擇退款原因，不支持部分退款。

     • 商家已發(fā)貨，申請(qǐng)退款，用戶需要選擇是否收到貨，如果選擇未收到貨，無(wú)法申請(qǐng)部分退款，如果選擇已經(jīng)收到貨，可以支持部分退款。

   • 確認(rèn)收貨后，申請(qǐng)退

     確認(rèn)收貨后，同上。

3. 退貨退款：

   • 確認(rèn)收貨前，申請(qǐng)退

     • 商家未發(fā)貨，不可退貨退款。

     • 商家已發(fā)貨，申請(qǐng)退貨退款，支持部分退款和全額退款，商家根據(jù)情況審核，其中7天無(wú)理由商家無(wú)法拒絕。

   • 確認(rèn)收貨后，申請(qǐng)退

     確認(rèn)收貨后，支持部分退款和全額退款，商家根據(jù)情況審核。

2.2.3 客戶側(cè)2C交易狀態(tài)關(guān)聯(lián)調(diào)用示例

2.2.4 商品運(yùn)營(yíng)

2.2.5 API接口列表

API接口詳細(xì)描述請(qǐng)參考API參考。

本文所有提供的接口都是通過(guò)阿里云的 POP 網(wǎng)關(guān)對(duì)外透出，客戶需要用阿里云的用戶身份通過(guò) LinkedMall 的SDK調(diào)用接口，LinkedMall已經(jīng)提供了相應(yīng)的 demo 程序，可以向?qū)尤藛T索取。調(diào)用本文中所有接口的阿里云賬戶需要和自身的客戶Id綁定，否則將拒絕執(zhí)行。

2.3 第三階段：測(cè)試聯(lián)調(diào)

1. 聯(lián)系運(yùn)營(yíng)小二配合測(cè)試

   聯(lián)系渠道運(yùn)營(yíng)小二，在專(zhuān)屬技術(shù)溝通群中溝通，配合企業(yè)客戶完成正逆向交易狀態(tài)變更及測(cè)試。

2. 售后退款退貨邏輯

   • 聯(lián)系渠道運(yùn)營(yíng)小二，在專(zhuān)屬技術(shù)溝通群中溝通，測(cè)試操作退款退貨等場(chǎng)景；

   • 除特殊類(lèi)目及場(chǎng)景，未發(fā)貨申請(qǐng)?zhí)熵埩⒓醋詣?dòng)退款。

3. 接口錯(cuò)誤碼和錯(cuò)誤獲取

   

   1. 開(kāi)啟debug模式，參考阿里云官方異常處理中通用異常 TeaException處理方式；

   2. 獲取error.data （如上圖示例）：

      errorCode -> CategoryInvalid 為錯(cuò)誤碼；

      errorMessage -> “該訂單商品類(lèi)目為生鮮類(lèi)目，僅允許僅退款操作” 為錯(cuò)誤原因；

   3. 其他語(yǔ)言也可以調(diào)試解析error結(jié)構(gòu)來(lái)獲取錯(cuò)誤碼與錯(cuò)誤原因結(jié)構(gòu)。

2.4 第四階段：上線發(fā)布

1. 上線前，聯(lián)系天貓運(yùn)營(yíng)小二，同步更新最新的商品庫(kù)，并根據(jù)業(yè)務(wù)需要上架商品。

2. 請(qǐng)確認(rèn)代扣支付寶賬號(hào)中余額充足，否則會(huì)影響正常下單。

3. 發(fā)貨時(shí)效：

   • 普通商品：一般是買(mǎi)家付款后24小時(shí)內(nèi)上傳物流單號(hào),買(mǎi)家付款后48小時(shí)內(nèi)發(fā)貨 。

   • 定制、預(yù)售及其他特殊情形等另行約定發(fā)貨時(shí)間的商品：約定時(shí)間內(nèi)發(fā)貨。

4. 固定賬期，根據(jù)接口的賬單信息核對(duì)貨款賬單，同時(shí)聯(lián)系天貓運(yùn)營(yíng)小二完成開(kāi)票。

5. 上線后，如遇系統(tǒng)技術(shù)等突發(fā)問(wèn)題，在專(zhuān)屬技術(shù)溝通群中提交工單，會(huì)有技術(shù)人員根據(jù)故障等級(jí)及時(shí)響應(yīng)。