从2020年03月开始,台宽/深信软件公司应客户要求,开始和北京字节跳动科技有限公司就直播平台送检数据对接事宜进行沟通。明确双方数据传输协议、安全机制、硬件需求以及物理连接等诸多技术细节的具体需求。经过多方近半年多的版本不断升级,优化等操作,已经完全满足珠宝直播基地对送检数据的同步要求。
已经实现对接抖音珠宝直播基地含瑞丽、深圳、广州、四会、南阳。
现将此过程中可能涉及到的对接需求整理如下,供有需要的检测机构作参考及选择。
部分需求如下:
录入订单码
- 每一个订单上会粘贴订单码,如下图
- 质检方需要通过条码枪等外设,扫描此码录入到质检系统,并与该订单下所包含的所有商品的质检码做好映射,比如
录入质检结果
- 除了正常的质检通过后录入鉴定品类结果外,还有3种特殊的质检结果需要录入并回传
-福利商品:所有福利商品不用鉴定,直接录入结果为【通过】,商品名称回传“福利商品”
-拆单商品:部分商品价格太高,商家将一个商品拆为几个订单给用户分单支付,此时送检的商品只有一个,但拥有多个订单码,需要为每个订单码都录入一个相同的质检编码(证书编号)和质检结果并回传,只出一个证书
-驳回商品:如果鉴定结果为假货,录入结果为【未通过】并回传“驳回原因”
- 录入结果后支持修改,以免出现错误录入的情况
- 如果商品已经包含证书,则需要在质检后核对与证书信息是否一致;如果一致,直接复用该证书;如果不一致,需更改并回传鉴定结果,且证书没收作废
录入质检价格
- 按照每个质检码对应商品的质检价格录入,单位为分
回传数据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 业务id 由平台方分配
code 商品唯一编码(商品质检编号)
data 质检原因(封装为json格式)
create_time 请求创建时间 unix时间戳
sign 签名串由平台方分配
……
抖音/深信平台对接的需求调整20201010
追加的需求背景:
对于送检饰品只有一件,但对应多个订单(订单码)的情况。因为之前双方都没有考虑此情况,而抖音平台却需要了解每个订单的进度状况。所以需求调整之前一个送检饰品出一张检测证书,只能对应一个订单码的业务需求。
涉及需要调整的业务:
1)输入环节。深信证书业务管理平台允许检测站人员在一个证书编号中入多个订单码,多个订单码之前用“、”(顿号)分隔(如9787533288198、9780821377093、9780821375242)。考虑去除当前证书编号中重复出现的订单码。
2)存储环节。有可能订单码会在10个以上,建议将深信证书业务平台中订单码字段调整为nvarchar(200)
3)回传环节。因为抖音平台还是以每个独立的订单码作为判断条件,抖音平台不作调整的情况下,需要深信证书业务管理平台根据是否存在多个订单码的情况,拆分成多条记录回传,除了订单码不同外其它信息都是相同。
4)其它说明。涉及到检测站可能会对之前已经回传的订单码,再次回传,需要深信平台允许“追加”查询。