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=0C16C67A6224B5C6093CBA7F45179EE8
    
    按首字母升序排列:
      app_key=test_appkey
      customerId=test
      method=order.getSensitiveData
      payload=0C16C67A6224B5C6093CBA7F45179EE8
    
    连接字符串: 连接参数名与参数值,并在首尾加上secret,此处假设secret=test,其中:payload=0C16C67A6224B5C6093CBA7F45179EE8,直接使用url参数中的值拼接,如下:
  • secret查询方法:
  • WMS登陆京东物流开放平台查看 https://open.jdwl.com/console/main
      testapp_keytest_appkeycustomerIdtestmethodorder.getSensitiveDatapayload0C16C67A6224B5C6093CBA7F45179EE8test
    
    生成签名 sign: 32位大写MD5值-> 2EDC0694537717B83D3410D2884774E7

results matching ""

    No results matching ""