zeyi / open-doc

Download as
Browse Code »

Commit 56b7e0fe46864b43b334d738f7f9824351a1db67

Authored by 王富国
1 parent e731bd63
Exists in master

feat: 添加通鲁仓储订单对接接口

Showing 1 changed file with 539 additions and 0 deletions   Show diff stats
order/warehouse/2022083101/仓储接口.md 0 → 100644
  Diff comments   View file @56b7e0f
... ... @@ -0,0 +1,539 @@
  1 +[toc]
  2 +
  3 +# 仓储订单对接API
  4 +
  5 +则一提供了不同规范的API，调用服务端API前，需了解开发前须知及调用流程。本文提供了调用则一服务端API示例，供开发者参考。
  6 +
  7 +## 白名单
  8 +
  9 +则一服务端API接口访问有IP白名单限制，需要接口调用方提供调用API的服务器IP地址。
  10 +
  11 +## 数据加签
  12 +
  13 +采用md5(32位小写)算法生成签名
  14 +appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒) + nonce(6位随机码大小写字母数子组合) + data(请求数据)
  15 +
  16 +## 数据加密
  17 +
  18 +数据加密采用AES算法
  19 +加密模式： CBC
  20 +填充方式：PKCS5Padding
  21 +偏移量：iv(则一提供)
  22 +加密内容：appKey(则一提供) + timestamp(当前时间戳毫秒) + nonce(6位随机码大小写字母数子组合) + data(加密数据)
  23 +密钥： appSecret(则一提供)
  24 +输出：base64
  25 +字符集：utf-8
  26 +注：无敏感数据则无需加密
  27 +
  28 +## 获取访问凭证
  29 +
  30 +### 概述
  31 +
  32 +调用则一服务API时，都需要先获取对应权限类型的访问凭证accessToken。访问凭证（accessToken）是由则一权限系统颁发的，用来校验调用者的身份信息，确保调用者具有要执行的操作的权限。
  33 +**说明**： 在使用accessToken时，请注意：
  34 +
  35 +* accessToken的有效期默认为30天，有效期内重复获取会返回相同结果，过期后获取会返回新的accessToken。
  36 +* 开发者需要缓存accessToken，用于后续接口的调用。不能频繁调用获取accessToken接口，否则会受到频率拦截。
  37 +* 当调用业务API时，如果返回状态码为401，则说明accessToken不正确或已过期，这时需要重新获取accessToken后再调用对应的API。
  38 +
  39 +### 接口信息
  40 +
  41 +#### 请求方式：
  42 +
  43 +post
  44 +
  45 +#### 请求地址：
  46 +
  47 +* 生产：https://gw.shjiuze.cn/auth-service-api/login/password
  48 +* 测试：https://test.shjiuze.cn/auth-service-api/login/password
  49 +
  50 +#### Body参数
  51 +
  52 +| 名称 | 类型 | 必填 | 示例值 | 描述 |
  53 +| -------- | ------ | ---- | ----------- | ---------------- |
  54 +| username | String | 是 | zhangsan | 用户名，则一提供 |
  55 +| password | String | 是 | password123 | 密码，则一提供 |
  56 +
  57 +#### 返回参数
  58 +
  59 +| 名称 | 类型 | 示例值 | 描述 |
  60 +| ------------------------------ | ---------- | -------------------------------- | -------------------------------------------------- |
  61 +| success | boolean | true | 成功标识: true 成功，false 失败 |
  62 +| businessException | boolean | false | 业务异常标识: true 业务异常，false 正常 |
  63 +| errorCode | String | 200 | 错误码: 200 业务异常，500 系统异常， 空表示无错误 |
  64 +| message | String | 订单号不能为空 | 错误信息，无错误则返回空 |
  65 +| result | ZYTokenDto | | accessToken结果数据 |
  66 +|     accessToken | String | 000626f15b4b41bba6fe56216a5d2f73 | accessToken |
  67 +|     expiresIn | Integer | 2060 | 有效期限单位秒，accessToken在2060秒后过期 |
  68 +|     tokenType | String | bearer | token类型 |
  69 +
  70 +#### 请求示例
  71 +
  72 +##### Http方式
  73 +
  74 +```http
  75 +POST /auth-service-api/login/password HTTP/1.1
  76 +Host:test.shjiuze.cn
  77 +Content-Type:application/json
  78 +
  79 +{
  80 + "username" : "zeyi",
  81 + "password" : "test1111"
  82 +}
  83 +```
  84 +
  85 +##### Java-sdk方式
  86 +
  87 +##### [下载SDK](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)
  88 +
  89 +```java
  90 +public class Sample {
  91 + public static void main(String[] args_) {
  92 + String appKey = "appkey";
  93 + String appSecret = "appSecret";
  94 + ZYClient zyClient = new ZYClient(appKey, appSecret);
  95 + ZYTokenRequestDto zyTokenRequest = new ZYTokenRequestDto();
  96 + zyTokenRequest.setUsername("zeyi");
  97 + zyTokenRequest.setPassword("test1111");
  98 + String body = gson.toJson(zyTokenRequest);
  99 + HttpResponseData httpResponseData = zyClient.doPost(Constants.TEST_HOST + Constants.TOKEN_PATH, body);
  100 + if(httpResponseData == null) {
  101 + throw new TokenException("则一Token请求失败,返回为空!");
  102 + }
  103 + ZYResponse<ZYTokenDto> zyResponse = gson.fromJson(httpResponseData.getBody(), new TypeToken<ZYResponse<ZYTokenDto>>(){}.getType());
  104 + if(!Boolean.TRUE.equals(zyResponse.isSuccess())) {
  105 + throw new TokenException("则一Token请求返回失败!" + zyResponse.getMessage());
  106 + }
  107 + if(zyResponse.getResult() == null) {
  108 + throw new TokenException("则一Token请求返回失败,返回结果为空!" + zyResponse.getMessage());
  109 + }
  110 + if(StringUtils.isBlank(zyResponse.getResult().getAccessToken())) {
  111 + throw new TokenException("则一Token请求返回数据异常,AccessToken为空!" + zyResponse.getMessage());
  112 + }
  113 + // 结果 zyResponse.getResult();
  114 + }
  115 +}
  116 +```
  117 +
  118 +#### 返回示例
  119 +
  120 +```json
  121 +{
  122 + "success": true,
  123 + "businessException": false,
  124 + "errorCode": null,
  125 + "message": null,
  126 + "result": {
  127 + "accessToken": "64d7f367-609b-4f7d-a84d-a3d2a0b5ad85",
  128 + "expiresIn": 602105,
  129 + "tokenType": "bearer"
  130 + }
  131 +}
  132 +```
  133 +
  134 +## 入库下单
  135 +
  136 +### 简要描述
  137 +
  138 +入库单创建接口
  139 +
  140 +### 请求URL
  141 +
  142 +· 测试环境：https://test.shjiuze.cn/oms-service-api/warehouseOrder/inStock
  143 +
  144 +· 生产环境：https://gw.shjiuze.cn/oms-service-api/warehouseOrder/inStock
  145 +
  146 +### 请求方式
  147 +
  148 +POST
  149 +
  150 +### Headers参数
  151 +
  152 +| 名称 | 类型 | 必填 | 示例值 | 描述 |
  153 +| ------------- | ------ | -------------------------- | -------------------------------- | ------------------------------------------------------------ |
  154 +| Authorization | String | 是&nbsp;&nbsp;&nbsp;&nbsp; | Bearer a2c5680001 | 调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。 |
  155 +| appKey | String | 是 | 0867ef5f23ef446483749e19e1692b40 | 则一提供 |
  156 +| timestamp | String | 是 | 1643251533306 | 当前时间戳毫秒值 |
  157 +| nonce | String | 是 | gdst9t | 6位小写字母数字组合随机串 |
  158 +| sign | String | 是 | fa3ed338d6dfe18e7273c8692234ee70 | 签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成 |
  159 +
  160 +### Body参数
  161 +
  162 +| 参数名 | 必传 | 类型 | 说明 |
  163 +| ------------------------------------------ | ---- | ------ | ----------------------------------------- |
  164 +| code | 是 | string | 客户单号 |
  165 +| supplier | 否 | string | 供应商名称 |
  166 +| planTime | 否 | string | 预计操作日期时间戳(毫秒)-->入库通知日期 |
  167 +| billTime | 否 | string | 单据日期时间戳(毫秒)(如无默认当前时间) |
  168 +| remark | 否 | String | 备注 |
  169 +| goodList | 是 | list | 商品集合 |
  170 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseCode | 是 | string | 仓库编号 |
  171 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseAreaCode | 否 | string | 库区编号 |
  172 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseLocCode | 否 | string | 库位编号 |
  173 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseStatus | 是 | string | 库存状态（KCZ00 【正常】、KCZ01【冻结】） |
  174 +| &nbsp;&nbsp;&nbsp;&nbsp;code | 是 | string | 商品编码 |
  175 +| &nbsp;&nbsp;&nbsp;&nbsp;name | 否 | string | 商品名称 |
  176 +| &nbsp;&nbsp;&nbsp;&nbsp;barCode | 否 | string | 商品条码 |
  177 +| &nbsp;&nbsp;&nbsp;&nbsp;packageType | 否 | string | 包装规格 |
  178 +| &nbsp;&nbsp;&nbsp;&nbsp;unit | 否 | string | 单位 |
  179 +| &nbsp;&nbsp;&nbsp;&nbsp;produceDate | 否 | string | 生产日期时间戳(毫秒) |
  180 +| &nbsp;&nbsp;&nbsp;&nbsp;expiryDate | 否 | string | 过期日期时间戳(毫秒) |
  181 +| &nbsp;&nbsp;&nbsp;&nbsp;stockCount | 是 | int | 入库数量 |
  182 +| &nbsp;&nbsp;&nbsp;&nbsp;weight | 否 | int | 重量 |
  183 +| &nbsp;&nbsp;&nbsp;&nbsp;volume | 否 | int | 体积 |
  184 +| &nbsp;&nbsp;&nbsp;&nbsp;transactionSubCode | 否 | string | 交易子单号(PO号) |
  185 +| &nbsp;&nbsp;&nbsp;&nbsp;lineNumber | 否 | string | 单据行号 |
  186 +| &nbsp;&nbsp;&nbsp;&nbsp;batchNumber | 否 | string | 批次号 |
  187 +| &nbsp;&nbsp;&nbsp;&nbsp;pciCode | 否 | string | pciCode |
  188 +| &nbsp;&nbsp;&nbsp;&nbsp;factoryLineNumber | 否 | string | 工厂行号 |
  189 +| &nbsp;&nbsp;&nbsp;&nbsp;remark | 否 | string | 备注 |
  190 +
  191 +### 返回结果正常示例
  192 +
  193 + { "success": true, "businessException": false}
  194 +
  195 +### 返回结果异常示例
  196 +
  197 + { "success": false, "businessException": true, "errorCode": "500", "message": "XXX异常!"}
  198 +
  199 +### 请求示例
  200 +
  201 +#### Java-sdk方式 [下载SDK](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)
  202 +
  203 +```java
  204 +public class Sample {
  205 + public static void main(String[] args_) {
  206 + String appKey = "appkey";
  207 + String appSecret = "appSecret";
  208 + String jsonData = "订单下单Body参数JSON数据";
  209 + ZYClient zyClient = new ZYClient(appKey, appSecret);
  210 + HttpResponseData httpResponseData =
  211 +zyClient.doPost(Constants.TEST_HOST + "/oms-service-api/warehouseOrder/inStock", "accessToken", jsonData);
  212 + if(httpResponseData == null) {
  213 + throw new BusinessException("则一请求失败,返回结果为空!");
  214 + }
  215 + if(httpResponseData.getStatus() == HttpURLConnection.HTTP_UNAUTHORIZED) {
  216 + //重新获取token再次请求
  217 + httpResponseData = zyClient.doPost(Constants.TEST_HOST +
  218 + "/oms-service-api/warehouseOrder/inStock", "accessToken", jsonData);
  219 + }
  220 + }
  221 +}
  222 +```
  223 +
  224 +
  225 +
  226 +## 出库下单
  227 +
  228 +### 简要描述
  229 +
  230 +出库单创建接口
  231 +
  232 +### 请求URL
  233 +
  234 +· 测试环境：https://test.shjiuze.cn/oms-service-api/warehouseOrder/outStock
  235 +
  236 +· 生产环境：https://gw.shjiuze.cn/oms-service-api/warehouseOrder/outStock
  237 +
  238 +### 请求方式
  239 +
  240 +POST
  241 +
  242 +### Headers参数
  243 +
  244 +| 名称 | 类型 | 必填 | 示例值 | 描述 |
  245 +| ------------- | ------ | -------------------------- | -------------------------------- | ------------------------------------------------------------ |
  246 +| Authorization | String | 是&nbsp;&nbsp;&nbsp;&nbsp; | Bearer a2c5680001 | 调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。 |
  247 +| appKey | String | 是 | 0867ef5f23ef446483749e19e1692b40 | 则一提供 |
  248 +| timestamp | String | 是 | 1643251533306 | 当前时间戳毫秒值 |
  249 +| nonce | String | 是 | gdst9t | 6位小写字母数字组合随机串 |
  250 +| sign | String | 是 | fa3ed338d6dfe18e7273c8692234ee70 | 签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成 |
  251 +
  252 +### Body参数
  253 +
  254 +| 参数名 | 必传 | 类型 | 说明 |
  255 +| ------------------------------------------ | ---- | ------ | ----------------------------------------- |
  256 +| code | 是 | string | 客户单号 |
  257 +| supplier | 否 | string | 供应商 |
  258 +| receiverCustomerCode | 是 | string | 收货客户编号 |
  259 +| receiver | 是 | string | 收货人 |
  260 +| receiverMobile | 否 | string | 收货人电话 |
  261 +| receiverAddress | 是 | string | 收货地址 |
  262 +| planTime | 否 | string | 预计操作时间-->入库通知日期 |
  263 +| billTime | 否 | string | 单据日期时间戳(毫秒)(如无默认当前时间) |
  264 +| cityCode | 否 | string | 城市编码 |
  265 +| bgm | 是 | string | 消息编号 |
  266 +| remark | 否 | string | 备注 |
  267 +| goodList | 是 | list | 商品集合 |
  268 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseCode | 是 | string | 仓库编号 |
  269 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseAreaCode | 否 | string | 库区编号 |
  270 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseLocCode | 否 | string | 库位编号 |
  271 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseStatus | 是 | string | 库存状态（KCZ00 【正常】、KCZ01【冻结】） |
  272 +| &nbsp;&nbsp;&nbsp;&nbsp;code | 是 | string | 商品编码 |
  273 +| &nbsp;&nbsp;&nbsp;&nbsp;name | 否 | string | 商品名称 |
  274 +| &nbsp;&nbsp;&nbsp;&nbsp;barCode | 否 | string | 商品条码 |
  275 +| &nbsp;&nbsp;&nbsp;&nbsp;packageType | 否 | string | 包装规格 |
  276 +| &nbsp;&nbsp;&nbsp;&nbsp;unit | 否 | string | 单位 |
  277 +| &nbsp;&nbsp;&nbsp;&nbsp;produceDate | 否 | string | 生产日期时间戳(毫秒) |
  278 +| &nbsp;&nbsp;&nbsp;&nbsp;expiryDate | 否 | string | 过期日期时间戳(毫秒) |
  279 +| &nbsp;&nbsp;&nbsp;&nbsp;stockCount | 是 | int | 应出库数量 |
  280 +| &nbsp;&nbsp;&nbsp;&nbsp;weight | 否 | int | 重量 |
  281 +| &nbsp;&nbsp;&nbsp;&nbsp;volume | 否 | int | 体积 |
  282 +| &nbsp;&nbsp;&nbsp;&nbsp;transactionSubCode | 否 | string | 交易子单号 |
  283 +| &nbsp;&nbsp;&nbsp;&nbsp;lineNumber | 否 | string | 单据行号 |
  284 +| &nbsp;&nbsp;&nbsp;&nbsp;batchNumber | 否 | string | 批次号 |
  285 +| &nbsp;&nbsp;&nbsp;&nbsp;ediSkuNo | 否 | string | D365内部编号 |
  286 +| &nbsp;&nbsp;&nbsp;&nbsp;pciCode | 否 | string | pciCode |
  287 +| &nbsp;&nbsp;&nbsp;&nbsp;factoryLineNumber | 否 | string | 工厂行号 |
  288 +| &nbsp;&nbsp;&nbsp;&nbsp;remark | 否 | string | 备注 |
  289 +
  290 +### 返回结果正常示例
  291 +
  292 + { "success": true, "businessException": false}
  293 +
  294 +### 返回结果异常示例
  295 +
  296 + { "success": false, "businessException": true, "errorCode": "500", "message": "XXX异常!"}
  297 +
  298 +### 请求示例
  299 +
  300 +#### Java-sdk方式 [下载SDK](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)
  301 +
  302 +```java
  303 +public class Sample {
  304 + public static void main(String[] args_) {
  305 + String appKey = "appkey";
  306 + String appSecret = "appSecret";
  307 + String jsonData = "订单下单Body参数JSON数据";
  308 + ZYClient zyClient = new ZYClient(appKey, appSecret);
  309 + HttpResponseData httpResponseData =
  310 +zyClient.doPost(Constants.TEST_HOST + "/oms-service-api/warehouseOrder/outStock", "accessToken", jsonData);
  311 + if(httpResponseData == null) {
  312 + throw new BusinessException("则一请求失败,返回结果为空!");
  313 + }
  314 + if(httpResponseData.getStatus() == HttpURLConnection.HTTP_UNAUTHORIZED) {
  315 + //重新获取token再次请求
  316 + httpResponseData = zyClient.doPost(Constants.TEST_HOST +
  317 + "/oms-service-api/warehouseOrder/outStock", "accessToken", jsonData);
  318 + }
  319 + }
  320 +}
  321 +```
  322 +
  323 +
  324 +
  325 +## 库存释放接口
  326 +
  327 +### 简要描述
  328 +
  329 +库存释放接口
  330 +
  331 +### 请求URL
  332 +
  333 +· 测试环境：https://test.shjiuze.cn/oms-service-api/warehouseOrder/release
  334 +
  335 +· 生产环境：https://gw.shjiuze.cn/oms-service-api/warehouseOrder/release
  336 +
  337 +### 请求方式
  338 +
  339 +POST
  340 +
  341 +### Headers参数
  342 +
  343 +| 名称 | 类型 | 必填 | 示例值 | 描述 |
  344 +| ------------- | ------ | -------------------------- | -------------------------------- | ------------------------------------------------------------ |
  345 +| Authorization | String | 是&nbsp;&nbsp;&nbsp;&nbsp; | Bearer a2c5680001 | 调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。 |
  346 +| appKey | String | 是 | 0867ef5f23ef446483749e19e1692b40 | 则一提供 |
  347 +| timestamp | String | 是 | 1643251533306 | 当前时间戳毫秒值 |
  348 +| nonce | String | 是 | gdst9t | 6位小写字母数字组合随机串 |
  349 +| sign | String | 是 | fa3ed338d6dfe18e7273c8692234ee70 | 签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成 |
  350 +
  351 +### Body参数
  352 +
  353 +| 参数名 | 必传 | 类型 | 说明 |
  354 +| --------------------------------------------- | ---- | ------ | ----------------------------------------------- |
  355 +| code | 是 | string | 客户单号 |
  356 +| planTime | 否 | string | 预计操作日期时间戳(毫秒) |
  357 +| billTime | 否 | string | 单据日期时间戳(毫秒)(如无默认当前时间) |
  358 +| remark | 否 | String | 备注 |
  359 +| goodList | 是 | list | 商品集合 |
  360 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseCode | 是 | string | 仓库编号 |
  361 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseAreaCode | 否 | string | 库区编号 |
  362 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseLocCode | 否 | string | 库位编号 |
  363 +| &nbsp;&nbsp;&nbsp;&nbsp;warehouseStatus | 是 | string | 释放后库存状态（KCZ00 【正常】、KCZ01【冻结】） |
  364 +| &nbsp;&nbsp;&nbsp;&nbsp;beforeWarehouseStatus | 是 | string | 释放前状态（KCZ00 【正常】、KCZ01【冻结】） |
  365 +| &nbsp;&nbsp;&nbsp;&nbsp;code | 否 | string | 商品编码 |
  366 +| &nbsp;&nbsp;&nbsp;&nbsp;name | 否 | string | 商品名称 |
  367 +| &nbsp;&nbsp;&nbsp;&nbsp;barCode | 否 | string | 商品条码 |
  368 +| &nbsp;&nbsp;&nbsp;&nbsp;packageType | 否 | string | 包装规格 |
  369 +| &nbsp;&nbsp;&nbsp;&nbsp;unit | 否 | string | 单位 |
  370 +| &nbsp;&nbsp;&nbsp;&nbsp;produceDate | 否 | string | 生产日期时间戳(毫秒) |
  371 +| &nbsp;&nbsp;&nbsp;&nbsp;expiryDate | 否 | string | 过期日期时间戳(毫秒) |
  372 +| &nbsp;&nbsp;&nbsp;&nbsp;number | 否 | int | 数量 |
  373 +| &nbsp;&nbsp;&nbsp;&nbsp;weight | 否 | int | 重量 |
  374 +| &nbsp;&nbsp;&nbsp;&nbsp;volume | 否 | int | 体积 |
  375 +| &nbsp;&nbsp;&nbsp;&nbsp;transactionSubCode | 否 | string | 交易子单号(PO号) |
  376 +| &nbsp;&nbsp;&nbsp;&nbsp;lineNumber | 否 | string | 单据行号 |
  377 +| &nbsp;&nbsp;&nbsp;&nbsp;batchNumber | 是 | string | 批次号 |
  378 +| &nbsp;&nbsp;&nbsp;&nbsp;pciCode | 否 | string | pciCode |
  379 +| &nbsp;&nbsp;&nbsp;&nbsp;factoryLineNumber | 否 | string | 工厂行号 |
  380 +| &nbsp;&nbsp;&nbsp;&nbsp;remark | 否 | string | 备注 |
  381 +
  382 +### 返回结果正常示例
  383 +
  384 + { "success": true, "businessException": false}
  385 +
  386 +### 返回结果异常示例
  387 +
  388 + { "success": false, "businessException": true, "errorCode": "500", "message": "XXX异常!"}
  389 +
  390 +### 请求示例
  391 +
  392 +#### Java-sdk方式 [下载SDK](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)
  393 +
  394 +```java
  395 +public class Sample {
  396 + public static void main(String[] args_) {
  397 + String appKey = "appkey";
  398 + String appSecret = "appSecret";
  399 + String jsonData = "库存释放Body参数JSON数据";
  400 + ZYClient zyClient = new ZYClient(appKey, appSecret);
  401 + HttpResponseData httpResponseData =
  402 +zyClient.doPost(Constants.TEST_HOST + "/oms-service-api/warehouseOrder/release", "accessToken", jsonData);
  403 + if(httpResponseData == null) {
  404 + throw new BusinessException("则一请求失败,返回结果为空!");
  405 + }
  406 + if(httpResponseData.getStatus() == HttpURLConnection.HTTP_UNAUTHORIZED) {
  407 + //重新获取token再次请求
  408 + httpResponseData = zyClient.doPost(Constants.TEST_HOST +
  409 + "/oms-service-api/warehouseOrder/release", "accessToken", jsonData);
  410 + }
  411 + }
  412 +}
  413 +```
  414 +
  415 +
  416 +
  417 +## 货权转移(订单移库)
  418 +
  419 +### 简要描述
  420 +
  421 +·货权转移接口
  422 +
  423 +### 请求URL
  424 +
  425 +· 测试环境：https://test.shjiuze.cn/oms-service-api/warehouseOrder/transferStock
  426 +
  427 +· 生产环境：https://gw.shjiuze.cn/oms-service-api/warehouseOrder/transferStock
  428 +
  429 +### 请求示例
  430 +
  431 +#### Java-sdk方式 [下载SDK](https://zeyi-tms-product.oss-cn-hangzhou.aliyuncs.com/file/jar/java-sdk/zy-java-sdk-1.0.0.jar)
  432 +
  433 +```java
  434 +public class Sample {
  435 + public static void main(String[] args_) {
  436 + String appKey = "appkey";
  437 + String appSecret = "appSecret";
  438 + String jsonData = "货权转移Body参数JSON数据";
  439 + ZYClient zyClient = new ZYClient(appKey, appSecret);
  440 + HttpResponseData httpResponseData =
  441 +zyClient.doPost(Constants.TEST_HOST + "/oms-service-api/warehouseOrder/transferStock", "accessToken", jsonData);
  442 + if(httpResponseData == null) {
  443 + throw new BusinessException("则一请求失败,返回结果为空!");
  444 + }
  445 + if(httpResponseData.getStatus() == HttpURLConnection.HTTP_UNAUTHORIZED) {
  446 + //重新获取token再次请求
  447 + httpResponseData = zyClient.doPost(Constants.TEST_HOST +
  448 + "/oms-service-api/warehouseOrder/transferStock", "accessToken", jsonData);
  449 + }
  450 + }
  451 +}
  452 +```
  453 +
  454 +### Headers参数
  455 +
  456 +| 名称 | 类型 | 必填 | 示例值 | 描述 |
  457 +| ------------- | ------ | -------------------------- | -------------------------------- | ------------------------------------------------------------ |
  458 +| Authorization | String | 是&nbsp;&nbsp;&nbsp;&nbsp; | Bearer a2c5680001 | 调用服务端API的应用凭证accessToken，通过调用获取访问凭证接口获取。 |
  459 +| appKey | String | 是 | 0867ef5f23ef446483749e19e1692b40 | 则一提供 |
  460 +| timestamp | String | 是 | 1643251533306 | 当前时间戳毫秒值 |
  461 +| nonce | String | 是 | gdst9t | 6位小写字母数字组合随机串 |
  462 +| sign | String | 是 | fa3ed338d6dfe18e7273c8692234ee70 | 签名：appKey(则一提供) + appSecret(则一提供) + timestamp + nonce(6位随机码) + data(body参数)通过md5(32位小写)算法生成 |
  463 +
  464 +### Body参数
  465 +
  466 +| 参数名 | 必传 | 类型 | 说明 |
  467 +| -------------------------------------------- | ---- | ------ | --------------------------------------------- |
  468 +| code | 是 | string | 入库单号 |
  469 +| planTime | 否 | string | 预计操作日期 |
  470 +| billTime | 否 | string | 单据日期时间戳(毫秒)(如无默认当前时间) |
  471 +| goodList | 是 | list | 商品集合 |
  472 +| &nbsp;&nbsp;&nbsp;&nbsp;inWarehouseCode | 是 | string | 调入仓库编号 |
  473 +| &nbsp;&nbsp;&nbsp;&nbsp;inWarehouseAreaCode | 否 | string | 调入库区编号 |
  474 +| &nbsp;&nbsp;&nbsp;&nbsp;inWarehouseLocCode | 否 | string | 调入库位编号 |
  475 +| &nbsp;&nbsp;&nbsp;&nbsp;inWarehouseStatus | 是 | string | 调入库存状态（KCZ00 【正常】、KCZ01【冻结】） |
  476 +| &nbsp;&nbsp;&nbsp;&nbsp;outWarehouseCode | 是 | string | 调出仓库编号 |
  477 +| &nbsp;&nbsp;&nbsp;&nbsp;outWarehouseAreaCode | 否 | string | 调出库区编号 |
  478 +| &nbsp;&nbsp;&nbsp;&nbsp;outWarehouseLocCode | 否 | string | 调出库位编号 |
  479 +| &nbsp;&nbsp;&nbsp;&nbsp;outWarehouseStatus | 是 | string | 调出库存状态（KCZ00 【正常】、KCZ01【冻结】） |
  480 +| &nbsp;&nbsp;&nbsp;&nbsp;inCustomerCode | 否 | string | 调入客户编号 |
  481 +| &nbsp;&nbsp;&nbsp;&nbsp;inCustomerName | 否 | string | 调入客户名称 |
  482 +| &nbsp;&nbsp;&nbsp;&nbsp;outCustomerCode | 否 | string | 调出客户编号 |
  483 +| &nbsp;&nbsp;&nbsp;&nbsp;outCustomerName | 否 | string | 调出客户名称 |
  484 +| &nbsp;&nbsp;&nbsp;&nbsp;code | 是 | string | 商品编码 |
  485 +| &nbsp;&nbsp;&nbsp;&nbsp;name | 否 | string | 商品名称 |
  486 +| &nbsp;&nbsp;&nbsp;&nbsp;barCode | 否 | string | 商品条码 |
  487 +| &nbsp;&nbsp;&nbsp;&nbsp;packageType | 否 | string | 包装规格 |
  488 +| &nbsp;&nbsp;&nbsp;&nbsp;unit | 否 | string | 单位 |
  489 +| &nbsp;&nbsp;&nbsp;&nbsp;produceDate | 否 | string | 生产日期时间戳(毫秒) |
  490 +| &nbsp;&nbsp;&nbsp;&nbsp;expiryDate | 否 | string | 过期日期时间戳(毫秒) |
  491 +| &nbsp;&nbsp;&nbsp;&nbsp;number | 是 | int | 移库数量 |
  492 +| &nbsp;&nbsp;&nbsp;&nbsp;weight | 否 | int | 重量 |
  493 +| &nbsp;&nbsp;&nbsp;&nbsp;volume | 否 | int | 体积 |
  494 +| &nbsp;&nbsp;&nbsp;&nbsp;lineNumber | 否 | string | 单据行号 |
  495 +| &nbsp;&nbsp;&nbsp;&nbsp;batchNumber | 否 | string | 批次号 |
  496 +| &nbsp;&nbsp;&nbsp;&nbsp;transactionSubCode | 否 | string | 交易子单号 |
  497 +| &nbsp;&nbsp;&nbsp;&nbsp;ediSkuNo | 否 | string | ediSkuNo |
  498 +| &nbsp;&nbsp;&nbsp;&nbsp;pciCode | 否 | string | pciCode |
  499 +| &nbsp;&nbsp;&nbsp;&nbsp;factoryLineNumber | 否 | string | 工厂行号 |
  500 +
  501 +### 返回正常示例
  502 +
  503 + { "success": true, "businessException": false}
  504 +
  505 +### 返回异常示例
  506 +
  507 + { "success": false, "businessException": true, "errorCode": "500", "message": "XXX异常!"}
  508 +
  509 +
  510 +
  511 +------------------------------------------------------------------------------------------
  512 +
  513 +## 2022-05-05更新日志
  514 +
  515 +1. 接口初始化
  516 +
  517 +
  518 +
  519 +## 2022-05-07更新日志
  520 +
  521 +1. 出入库接口外层中warehouseStatus字段删除，商品集合中增加warehouseStatus字段。
  522 +2. 移库接口商品集合中的inStockCount、outStockCount移除，增加number字段。
  523 +
  524 +
  525 +
  526 +## 2022-05-08更新日志
  527 +
  528 +1. 出入库接口请求参数商品集合中’库区编号‘命名更改为warehouseAreaCode ，增加’库位编号‘（warehouseLocCode）必填。
  529 +
  530 +2. 移库接口请求参数商品集合中’入库库区编号‘、’出库库区编号‘命名更改为inWarehouseAreaCode、 outWarehouseAreaCode ，增加’入库库位编号‘、‘出库库位编号’（inWarehouseLocCode、outWarehouseLocCode）字段且必填。
  531 +
  532 +
  533 +
  534 +## 2022-08-15更新日志
  535 +
  536 +1. 增加 pciCode 和 工厂行号
  537 +2. 增加则一入库下单接口和出库下单接口
  538 +3. 增加库存释放接口
  539 +4. 增加货权转移接口
... ...