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