從2020年03月開(kāi)始，臺(tái)寬/深信軟件公司應(yīng)客戶要求，開(kāi)始和北京字節(jié)跳動(dòng)科技有限公司就直播平臺(tái)送檢數(shù)據(jù)對(duì)接事宜進(jìn)行溝通。明確雙方數(shù)據(jù)傳輸協(xié)議、安全機(jī)制、硬件需求以及物理連接等諸多技術(shù)細(xì)節(jié)的具體需求。經(jīng)過(guò)多方近半年多的版本不斷升級(jí)，優(yōu)化等操作，已經(jīng)完全滿足珠寶直播基地對(duì)送檢數(shù)據(jù)的同步要求。
已經(jīng)實(shí)現(xiàn)對(duì)接抖音珠寶直播基地含瑞麗、深圳、廣州、四會(huì)、南陽(yáng)。
現(xiàn)將此過(guò)程中可能涉及到的對(duì)接需求整理如下，供有需要的檢測(cè)機(jī)構(gòu)作參考及選擇。
部分需求如下：
錄入訂單碼
- 每一個(gè)訂單上會(huì)粘貼訂單碼，如下圖
- 質(zhì)檢方需要通過(guò)條碼槍等外設(shè)，掃描此碼錄入到質(zhì)檢系統(tǒng)，并與該訂單下所包含的所有商品的質(zhì)檢碼做好映射，比如
錄入質(zhì)檢結(jié)果
- 除了正常的質(zhì)檢通過(guò)后錄入鑒定品類結(jié)果外，還有3種特殊的質(zhì)檢結(jié)果需要錄入并回傳
-福利商品：所有福利商品不用鑒定，直接錄入結(jié)果為【通過(guò)】，商品名稱回傳“福利商品”
-拆單商品：部分商品價(jià)格太高，商家將一個(gè)商品拆為幾個(gè)訂單給用戶分單支付，此時(shí)送檢的商品只有一個(gè)，但擁有多個(gè)訂單碼，需要為每個(gè)訂單碼都錄入一個(gè)相同的質(zhì)檢編碼（證書(shū)編號(hào)）和質(zhì)檢結(jié)果并回傳，只出一個(gè)證書(shū)
-駁回商品：如果鑒定結(jié)果為假貨，錄入結(jié)果為【未通過(guò)】并回傳“駁回原因”
- 錄入結(jié)果后支持修改，以免出現(xiàn)錯(cuò)誤錄入的情況
- 如果商品已經(jīng)包含證書(shū)，則需要在質(zhì)檢后核對(duì)與證書(shū)信息是否一致；如果一致，直接復(fù)用該證書(shū)；如果不一致，需更改并回傳鑒定結(jié)果，且證書(shū)沒(méi)收作廢
錄入質(zhì)檢價(jià)格
- 按照每個(gè)質(zhì)檢碼對(duì)應(yīng)商品的質(zhì)檢價(jià)格錄入，單位為分
回傳數(shù)據(jù)Url:
bic.snssdk.com/inspect/sendcode
request struct {
1 string app_id
2 string code
3 string data
4 string create_time
5 string sign
6 string version
}
response struct {
1 int code
2 string msg
}
請(qǐng)求值：
app_id 業(yè)務(wù)id 由平臺(tái)方分配
code 商品唯一編碼（商品質(zhì)檢編號(hào)）
data 質(zhì)檢原因（封裝為json格式）
create_time 請(qǐng)求創(chuàng)建時(shí)間 unix時(shí)間戳
sign 簽名串由平臺(tái)方分配
……
抖音/深信平臺(tái)對(duì)接的需求調(diào)整20201010
追加的需求背景：
對(duì)于送檢飾品只有一件，但對(duì)應(yīng)多個(gè)訂單(訂單碼）的情況。因?yàn)橹半p方都沒(méi)有考慮此情況，而抖音平臺(tái)卻需要了解每個(gè)訂單的進(jìn)度狀況。所以需求調(diào)整之前一個(gè)送檢飾品出一張檢測(cè)證書(shū)，只能對(duì)應(yīng)一個(gè)訂單碼的業(yè)務(wù)需求。
涉及需要調(diào)整的業(yè)務(wù)：
1）輸入環(huán)節(jié)。深信證書(shū)業(yè)務(wù)管理平臺(tái)允許檢測(cè)站人員在一個(gè)證書(shū)編號(hào)中入多個(gè)訂單碼，多個(gè)訂單碼之前用“、”（頓號(hào)）分隔（如9787533288198、9780821377093、9780821375242）?？紤]去除當(dāng)前證書(shū)編號(hào)中重復(fù)出現(xiàn)的訂單碼。
2）存儲(chǔ)環(huán)節(jié)。有可能訂單碼會(huì)在10個(gè)以上，建議將深信證書(shū)業(yè)務(wù)平臺(tái)中訂單碼字段調(diào)整為nvarchar(200）
3）回傳環(huán)節(jié)。因?yàn)槎兑羝脚_(tái)還是以每個(gè)獨(dú)立的訂單碼作為判斷條件，抖音平臺(tái)不作調(diào)整的情況下，需要深信證書(shū)業(yè)務(wù)管理平臺(tái)根據(jù)是否存在多個(gè)訂單碼的情況，拆分成多條記錄回傳，除了訂單碼不同外其它信息都是相同。
4）其它說(shuō)明。涉及到檢測(cè)站可能會(huì)對(duì)之前已經(jīng)回傳的訂單碼，再次回傳，需要深信平臺(tái)允許“追加”查詢。
