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