FAQ

1、如何在虎符控制台创建应用并完成与wms对接？

（1）创建ERP应用

登陆虎符控制台创建ERP类型的应用，虎符控制台地址是https://hufu-yd-console.jdcloud.com

注：创建虎符应用前需要创建京东云AccessKey，AccessKey管理页面地址：https://uc.jdcloud.com/account/accesskey虎符应用依赖于京东云accessKey，如果删除或禁用京东云accessKey，会导致虎符应用不可用！

（2）接入场景

进入场景列表

选择上一步创建的应用接入“虎符仓储服务新”场景

（3）发起接入申请

进入我的场景

点击接入管理，进入对接页面,点击上线申请

填写wms应用信息以及erp应用回调地址

至此，对接申请完毕，等待wms到物流服务市场审核通过即可完成对接流程。

(4) 下游 WMS 如何入驻物流街

WMS 请参考虎符-物流街入驻手册420.pdf

2、API文档

2.1、在线文档

3、SDK下载

3.1、erp调用虎符

4、后端签名算法

4.1、ERP端后端签名

我们用虎符网关透传到鼎内ERP服务的请求为例：

    http://test.com?method=order.getSensitiveData&app_key=testerp_appkey&customerId=stub-cust-code&timestamp=2015-04-26%2000:00:07&sign=BEBE2622F988DBD735D6C225C2F8FAC8&sign_method=md5&v=2.0&format=json

输入参数为(如果参数中有类似 timestamp=2015-04-26%2000:00:07 的要把参数 URL Decode之后再计算签名)

注：参数列表中的sign不参与计算签名，除此之外所有参数都要参与计算签名

  method=order.getSensitiveData
  app_key=testerp_appkey
  customerId=test
  timestamp=2015-04-26 00:00:07
  sign_method=md5
  v=2.0
  format=json

按首字母升序排列:

  method=order.getSensitiveData
  app_key=testerp_appkey
  customerId=test
  format=json
  sign_method=md5
  timestamp=2015-04-26 00:00:07
  v=2.0

连接字符串: 连接参数名与参数值,并在首尾加上secret，此处假设secret=test，其中：body用请求中的body数据代替，如下：

secret查询方法：

ERP登陆虎符控制台查看 https://hufu-yd-console.jdcloud.com/#/hufu/list

  testapp_keytesterp_appkeycustomerIdtestformatjsonmethodorder.getSensitiveDatasign_methodmd5timestamp2015-04-26 00:00:07v2.0{"name":"zhang san"}test

生成签名 sign: 32位大写MD5值-> 7F7179CB3811588FE27F9A714E9D9F60

4.2、WMS端后端签名

我们用物流网关透传到WMS服务的请求为例：

  http://test.com?method=order.getSensitiveData&app_key=test_appkey&customerId=stub-cust-code&payload=0C16C67A6224B5C6093CBA7F45179EE8&timestamp=2015-04-26%2000:00:07&sign=BEBE2622F988DBD735D6C225C2F8FAC8&sign_method=md5&v=2.0&format=json
  请求body为：{"name":"zhang san"}

输入参数为：

注：参数列表中只有这些参数参与签名：app_key customerId method payload，其中payload的value为请求体body的MD5摘要（此处与ERP端的后端签名算法有区别）
```
  method=order.getSensitiveData
  app_key=test_appkey
  customerId=test
  payload=c688228e16d9dd2206b3fec8f2bd453d
```
按首字母升序排列:
```
  app_key=test_appkey
  customerId=test
  method=order.getSensitiveData
  payload=c688228e16d9dd2206b3fec8f2bd453d
```
连接字符串: 连接参数名与参数值,并在首尾加上secret，此处假设secret=test，其中：payload=c688228e16d9dd2206b3fec8f2bd453d，直接使用url参数中的值拼接，如下：
secret查询方法：
WMS登陆京东物流开放平台查看 https://open.jdwl.com/console/main
```
  testapp_keytest_appkeycustomerIdtestmethodorder.getSensitiveDatapayloadc688228e16d9dd2206b3fec8f2bd453dtest
```
生成签名 sign: 32位大写MD5值-> F63B7E08406AF9033B6FDE449AA40612

ERP对接物流云仓相关

FAQ