跨境電商是現(xiàn)在發(fā)展比較火的行業(yè)之一。我們?cè)趶氖驴缇畴娚涛锪餍袠I(yè)的過(guò)程中也會(huì)遇到很多問(wèn)題，本文作者從五個(gè)步驟進(jìn)行了逐一分析，希望能幫助到你的工作。

一、物流商的接入

倉(cāng)庫(kù)能使用某個(gè)物流的前提是：提前和這個(gè)物流商進(jìn)行了商業(yè)合作，接入了相關(guān)的物流商。

這里的接入包含了兩層意思，一個(gè)是商業(yè)層面的合作，另一個(gè)就是技術(shù)層的接入。一般是先商業(yè)層面，然后才是技術(shù)層面。

例如倉(cāng)庫(kù)需要使用4px的物流，那么公司的物流經(jīng)理或者物流渠道專員就會(huì)聯(lián)系4px的銷售或者商務(wù)，然后溝通自己的訴求，談下一個(gè)合適的價(jià)格，然后逐步推進(jìn)，簽訂服務(wù)合同。4px則會(huì)為倉(cāng)庫(kù)開通單獨(dú)的物流賬號(hào)，然后就可以進(jìn)行下一步技術(shù)層面的接入了。

4px的商業(yè)層面接入

技術(shù)的接入，就是比較標(biāo)準(zhǔn)的“開發(fā)者接入模式”了，這里做一個(gè)簡(jiǎn)單的介紹。

一般包括以下步驟：

• 注冊(cè)開發(fā)者賬號(hào)：開發(fā)者需要在開放平臺(tái)上注冊(cè)一個(gè)賬號(hào)，填寫相關(guān)信息并通過(guò)驗(yàn)證。
• 創(chuàng)建應(yīng)用：創(chuàng)建一個(gè)應(yīng)用，為該應(yīng)用生成唯一的應(yīng)用標(biāo)識(shí)符和密鑰等憑證信息，以便后續(xù)調(diào)用開放平臺(tái)提供的API接口。
• 閱讀文檔：開放平臺(tái)一般會(huì)提供詳細(xì)的文檔和開發(fā)者指南，開發(fā)者需要仔細(xì)閱讀相關(guān)文檔，了解如何使用開放平臺(tái)提供的API接口。
• 開發(fā)調(diào)試：根據(jù)文檔和指南，開發(fā)者可以在自己的本地環(huán)境中進(jìn)行開發(fā)和調(diào)試，以確保API接口的正確性和穩(wěn)定性。
• 提交審核：開發(fā)者在完成開發(fā)和調(diào)試后，需要將應(yīng)用提交給開放平臺(tái)進(jìn)行審核，審核通過(guò)后才能正式上線并對(duì)外提供服務(wù)。
• 上線發(fā)布：審核通過(guò)后，開發(fā)者可以將應(yīng)用上線發(fā)布，供用戶使用。

4px的商戶開發(fā)者接入

二、物流商的API對(duì)接

在前面的文章中提到過(guò)，跨境物流的分類有很多種，其中產(chǎn)品經(jīng)理要重點(diǎn)關(guān)注“支持API對(duì)接的物流”，也就是“直郵物流”和“尾程物流”這兩大塊。

因?yàn)槲锪鳟a(chǎn)品經(jīng)理的大多數(shù)工作都和API對(duì)接有關(guān)系，需要頻繁地接入多個(gè)物流商，創(chuàng)建多個(gè)物流渠道，然后再和業(yè)務(wù)系統(tǒng)串聯(lián)起來(lái)，驗(yàn)證跑通了之后才算正式上線。

物流商的API對(duì)接這件事，說(shuō)難也難，說(shuō)容易也容易。

說(shuō)難是因?yàn)楹Ｍ鈧}(cāng)可能遍布多個(gè)國(guó)家或地區(qū)，需要接入多個(gè)國(guó)家或地區(qū)的物流商，工作量很大，而且每個(gè)物流商的API風(fēng)格、特性都不太一樣，需要持續(xù)地去攻克這些問(wèn)題；說(shuō)容易是因?yàn)榻尤胛锪魃藺PI這件事，本質(zhì)上都是一樣的API接入流程，都是看接口文檔，然后寫對(duì)接需求，最后再驗(yàn)證上線等。

1. 查看API文檔

完成了商業(yè)層面的對(duì)接之后，就會(huì)拿到相關(guān)的物流賬號(hào)和密碼，有一些物流商是需要在開放平臺(tái)去注冊(cè)成為開發(fā)者，開發(fā)者賬號(hào)密碼和業(yè)務(wù)系統(tǒng)的賬號(hào)密碼不太一樣，但是也有一些是通過(guò)業(yè)務(wù)賬號(hào)密碼去生成開發(fā)者賬號(hào)，這些具體要看物流商而定。

4px的接入流程

FedEx的接入流程

API文檔大多數(shù)都是對(duì)外Open的，即使你沒(méi)有成為開發(fā)者，沒(méi)有相關(guān)的賬號(hào)和密碼也是可以閱讀相關(guān)的內(nèi)容的。

而且API接入文檔中一般都會(huì)有Quick Start的部分，就是告訴開發(fā)者要接入這些物流服務(wù)大概需要多少步驟，這一些流程和操作一般來(lái)說(shuō)需要產(chǎn)品經(jīng)理自己先去閱讀，把一些關(guān)鍵信息和要做的動(dòng)作確認(rèn)清楚。

2. 確認(rèn)需要對(duì)接的接口

在了解了Quick Start的文檔內(nèi)容之后，知道了大概有多少步驟，要準(zhǔn)備什么東西，還有一個(gè)很關(guān)鍵的點(diǎn)就是要確認(rèn)一下自己的要對(duì)接多少個(gè)接口。

一個(gè)物流商服務(wù)商，由于自身的業(yè)務(wù)可能會(huì)比較復(fù)雜，可能會(huì)提供多種服務(wù)，例如4px除了物流服務(wù)，還有海外倉(cāng)服務(wù)，轉(zhuǎn)運(yùn)服務(wù)，退件服務(wù)等。

但是又因?yàn)檫@些服務(wù)都是放在一個(gè)開放平臺(tái)中的，所以為區(qū)分開發(fā)者到底需要接入哪個(gè)服務(wù)，就會(huì)需要開發(fā)者登錄開放平臺(tái)，然后申請(qǐng)相關(guān)的“應(yīng)用”或者“APP”，用來(lái)聲明你需要調(diào)用的服務(wù)是哪個(gè)。

4px的開放平臺(tái)創(chuàng)建應(yīng)用

Shopee支持的App類型

當(dāng)確定了要對(duì)接物流商的哪一類服務(wù)（APP）之后，接著就是查閱該服務(wù)類下的具體接口文檔，然后確定要對(duì)接哪幾個(gè)接口，因?yàn)榧词故峭活惙?wù)（例如“直發(fā)服務(wù)”），下面也會(huì)有很多具體的功能接口，類似于產(chǎn)品設(shè)計(jì)中的增刪改查導(dǎo)入導(dǎo)出等，不一定都要接入。

4PX直發(fā)服務(wù)的接口列表

FedEx的接口分類

燕文物流的API目錄

產(chǎn)品經(jīng)理需要結(jié)合實(shí)際的業(yè)務(wù)情況確定要對(duì)接哪些接口，這樣才能在下一步輸出需求文檔的時(shí)候有針對(duì)性，而不會(huì)讓開發(fā)感覺(jué)抓瞎。

例如燕文物流的API物流中有“美國(guó)地址校驗(yàn)”，“韓國(guó)個(gè)人通關(guān)碼校驗(yàn)”等，這些如果你的實(shí)際業(yè)務(wù)是沒(méi)有的，那么就可以不對(duì)接，選擇你需要的業(yè)務(wù)對(duì)接即可。

3. 輸出對(duì)接的需求文檔

完成了前面兩步之后，產(chǎn)品經(jīng)理就可以輸出相關(guān)的需求文檔了，接口對(duì)接類的需求和普通的業(yè)務(wù)需求文檔基本上是類似的，只不過(guò)需要額外多說(shuō)明幾個(gè)點(diǎn)：

• 接口文檔的資料，PDF或者是鏈接；
• 接口聯(lián)調(diào)的測(cè)試賬號(hào)、密碼、秘鑰等；
• 需要對(duì)接哪些接口，不同的接口的用處是什么；
• 一些核心的接口的字段映射關(guān)系，物流商需要什么字段，系統(tǒng)中應(yīng)該傳遞什么字段給它；

如果接口對(duì)接通了之后，怎么和業(yè)務(wù)系統(tǒng)打通，業(yè)務(wù)邏輯是怎么處理的？

這些內(nèi)容就和正常的需求描述一樣即可，所以對(duì)于API對(duì)接類的需求，重點(diǎn)就是產(chǎn)品需要提前把接口文檔琢磨透徹一些，然后從中提煉出一些核心的，高價(jià)值的內(nèi)容。

4. 聯(lián)調(diào)測(cè)試并解決一些阻塞的問(wèn)題

當(dāng)評(píng)審?fù)晷枨笾螅邪l(fā)就會(huì)進(jìn)入接口對(duì)接的開發(fā)工作中，此時(shí)產(chǎn)品經(jīng)理要做的就是及時(shí)解決一些阻塞性的問(wèn)題。例如研發(fā)反饋某個(gè)接口調(diào)不通，可能是對(duì)方的接口文檔沒(méi)有更新或者是有錯(cuò)誤，需要產(chǎn)品經(jīng)理從中協(xié)調(diào)去溝通解決。

例如研發(fā)發(fā)現(xiàn)某個(gè)接口需要的字段系統(tǒng)中沒(méi)有，那么可能產(chǎn)品要盡快確認(rèn)怎么去搞定這個(gè)字段，是不傳，還是在業(yè)務(wù)系統(tǒng)中新加一個(gè)字段傳過(guò)去。

例如研發(fā)聯(lián)調(diào)的時(shí)候發(fā)現(xiàn)有一些問(wèn)題和預(yù)期的不對(duì)，產(chǎn)品經(jīng)理要及時(shí)根據(jù)這些問(wèn)題去判斷可能的原因，然后調(diào)用資源去解決。

5. 發(fā)布上線

當(dāng)所有的接口都對(duì)接完成，并且也聯(lián)調(diào)通過(guò)之后，那么就可以上線了。

物流商對(duì)接完成后如果要正式投入生產(chǎn)，一般會(huì)需要做一些實(shí)單測(cè)試，因?yàn)橛幸恍┪锪魃痰臏y(cè)試環(huán)境不能做到仿真效果，所以必須要上線之后在正式的生產(chǎn)環(huán)境中測(cè)試驗(yàn)證一下。

實(shí)單測(cè)試一方面是看接口能不能跑通，數(shù)據(jù)是否正常，另一方面是看具體的業(yè)務(wù)是否能跑通，例如打印出來(lái)的面單是否能正常被物流商攬收，生成的物流賬單結(jié)算等是否正常等。

三、尾程物流商對(duì)接容易踩坑的點(diǎn)

1. 接口不清晰

在物流對(duì)接過(guò)程中，如果對(duì)方物流商的研發(fā)水平不行，接口文檔輸出的質(zhì)量也不會(huì)太高，就會(huì)導(dǎo)致有很多內(nèi)容你看不懂，也不知道是什么意思，所以就需要頻繁地和對(duì)方的研發(fā)人員溝通，所以接口對(duì)接的時(shí)候拉一個(gè)交流群是比較好的做法。

但是也有一些國(guó)外的物流商是沒(méi)有用微信、釘釘?shù)裙ぞ叩牧?xí)慣的，所以遇到了問(wèn)題就需要發(fā)郵件去溝通，這樣效率就稍微慢一些。

2. 對(duì)方不回復(fù)

在對(duì)接一些歐洲的本土物流商的時(shí)候最容易遇到的一個(gè)問(wèn)題就是“對(duì)方不回復(fù)”，因?yàn)闅W洲的文化習(xí)俗問(wèn)題，有些公司的年假很多，所以你發(fā)過(guò)去了郵件，可能對(duì)方去休假了，你就要十天半個(gè)月之后才會(huì)有人理你。

從我接觸過(guò)的項(xiàng)目來(lái)看，歐洲的物流商對(duì)接難度很大一部分來(lái)自于找不到人或者對(duì)方不回復(fù)。

所有產(chǎn)品經(jīng)理可以自己找一些交流群，多準(zhǔn)備好相關(guān)的資源，如果遇到了問(wèn)題之后直接求助交流群的其他產(chǎn)品或者研發(fā)也是一個(gè)好辦法。

傻傻地等對(duì)方回復(fù)是一個(gè)很低效率的操作，但是又沒(méi)得辦法，確實(shí)很煩。

3. 測(cè)試驗(yàn)證可能會(huì)收費(fèi)

跨境物流的包裹計(jì)費(fèi)節(jié)點(diǎn)一般來(lái)說(shuō)有兩種模式：

1. 一種是按預(yù)報(bào)收費(fèi)，意思就是你預(yù)報(bào)了面單之后，不管你用不用都會(huì)收費(fèi)，除非你及時(shí)取消這個(gè)單
2. 一種是按掃描收費(fèi)，意思就是預(yù)報(bào)了面單之后不會(huì)收費(fèi)，而是物流商攬收掃描了信息，錄入到了他們的系統(tǒng)之后才會(huì)收費(fèi)

所以，我們對(duì)接完成了物流接口之后，肯定是要上線的。上線之后在生產(chǎn)環(huán)境測(cè)試的時(shí)候，要問(wèn)清楚業(yè)務(wù)人員這個(gè)物流是怎么計(jì)費(fèi)的模式，如果是按預(yù)報(bào)收費(fèi)，那么就要及時(shí)取消，否則就會(huì)產(chǎn)生相關(guān)的物流費(fèi)用了。

4. 錯(cuò)誤提示看不懂

有一些本土的物流商對(duì)接完成之后，在調(diào)用對(duì)方接口的時(shí)候可能會(huì)提示報(bào)錯(cuò)，然后這些錯(cuò)誤提示很多可能是自己的當(dāng)?shù)卣Z(yǔ)言，例如德語(yǔ)、法語(yǔ)或者西班牙語(yǔ)等，這些錯(cuò)誤信息如果直接反饋給用戶的話，那么用戶看到了也會(huì)一臉懵。

而跨境物流下單的失敗率其實(shí)還挺高的，因?yàn)榈刂凡粚?duì)，字段不對(duì)，一些參數(shù)不合法等都會(huì)導(dǎo)致下單失敗，所以針對(duì)物流下單失敗的場(chǎng)景需要單獨(dú)去做“錯(cuò)誤信息的美化翻譯”，讓用戶可以通俗易懂地get到哪里出錯(cuò)了，要怎么修改，這個(gè)一塊的內(nèi)容我們會(huì)在后續(xù)的文章中介紹。

四、一些物流接口文檔分享

文中提到的一些接口文檔

https://www.yuque.com/jiaowovitamin/uizu4s/0983434#y1F1

五、小結(jié)

跨境物流的對(duì)接是一個(gè)比較繁瑣但又比較重要的事情，因?yàn)槲锪魇锹募s的一個(gè)基礎(chǔ)，物流的穩(wěn)定性對(duì)倉(cāng)庫(kù)來(lái)說(shuō)非常重要。因?yàn)樗⒉徽瓶卦谧约菏种?，如果物流商出了什么?wèn)題就會(huì)極大地影響到自己的業(yè)務(wù)。

所以關(guān)于物流對(duì)接這一塊，一定要謹(jǐn)慎加重視，同時(shí)還需要多總結(jié)一些提升效率的辦法，因?yàn)槲锪魃桃尤氲奶嗔耍绻麤](méi)有梳理出一套體系化的方案和流程，每次都是花費(fèi)高額的時(shí)間去接入的話就太低效率了。

跨境物流中會(huì)有很多物流商的接口文檔都是英文版，所以一些英語(yǔ)比較好的朋友去做這一塊的業(yè)務(wù)會(huì)有一定的優(yōu)勢(shì)，如果英文不好也沒(méi)關(guān)系，要學(xué)會(huì)借助工具去達(dá)到自己的目的，多用翻譯軟件也是可以的。