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