[toc]

仓储订单对接API

则一提供了不同规范的API，调用服务端API前，需了解开发前须知及调用流程。本文提供了调用则一服务端API示例，供开发者参考。

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">白名单

则一服务端API接口访问有IP白名单限制，需要接口调用方提供调用API的服务器IP地址。

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">数据加签

采用md5(32位小写)算法生成签名 appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒) + nonce(6位随机码大小写字母数子组合) + data(请求数据)

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">数据加密

数据加密采用AES算法 加密模式： CBC 填充方式：PKCS5Padding 偏移量：iv(则一提供) 加密内容：appKey(则一提供) + timestamp(当前时间戳毫秒) + nonce(6位随机码大小写字母数子组合) + data(加密数据) 密钥： appSecret(则一提供) 输出：base64 字符集：utf-8 注：无敏感数据则无需加密

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">获取访问凭证

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">概述

调用则一服务API时，都需要先获取对应权限类型的访问凭证accessToken。访问凭证（accessToken）是由则一权限系统颁发的，用来校验调用者的身份信息，确保调用者具有要执行的操作的权限。 说明： 在使用accessToken时，请注意：

• accessToken的有效期默认为30天，有效期内重复获取会返回相同结果，过期后获取会返回新的accessToken。
• 开发者需要缓存accessToken，用于后续接口的调用。不能频繁调用获取accessToken接口，否则会受到频率拦截。
• 当调用业务API时，如果返回状态码为401，则说明accessToken不正确或已过期，这时需要重新获取accessToken后再调用对应的API。

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">接口信息

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求方式：

post

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求地址：

• 生产：https://gw.shjiuze.cn/auth-service-api/login/password
• 测试：https://test.shjiuze.cn/auth-service-api/login/password

Body参数

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">返回参数

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求示例

Http方式

POST /auth-service-api/login/password HTTP/1.1
Host:test.shjiuze.cn
Content-Type:application/json

{
  "username" : "zeyi",
  "password" : "test1111"
}

Java-sdk方式

下载SDK

public class Sample {
    public static void main(String[] args_) {
        String appKey = "appkey";
        String appSecret = "appSecret";
        ZYClient zyClient = new ZYClient(appKey, appSecret);
        ZYTokenRequestDto zyTokenRequest = new ZYTokenRequestDto();
        zyTokenRequest.setUsername("zeyi");
        zyTokenRequest.setPassword("test1111");
        String body = gson.toJson(zyTokenRequest);
        HttpResponseData httpResponseData = zyClient.doPost(Constants.TEST_HOST + Constants.TOKEN_PATH, body);
        if(httpResponseData == null) {
            throw new TokenException("则一Token请求失败,返回为空!");
        }
        ZYResponse<ZYTokenDto> zyResponse = gson.fromJson(httpResponseData.getBody(), new      TypeToken<ZYResponse<ZYTokenDto>>(){}.getType());
        if(!Boolean.TRUE.equals(zyResponse.isSuccess())) {    
            throw new TokenException("则一Token请求返回失败!" + zyResponse.getMessage());
        }
        if(zyResponse.getResult() == null) {    
            throw new TokenException("则一Token请求返回失败,返回结果为空!" + zyResponse.getMessage());
        }
        if(StringUtils.isBlank(zyResponse.getResult().getAccessToken())) {    
            throw new TokenException("则一Token请求返回数据异常,AccessToken为空!" + zyResponse.getMessage());
        }
        // 结果 zyResponse.getResult();
    }
}

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">返回示例

{
    "success": true,
    "businessException": false,
    "errorCode": null,
    "message": null,
    "result": {
        "accessToken": "64d7f367-609b-4f7d-a84d-a3d2a0b5ad85",
        "expiresIn": 602105,
        "tokenType": "bearer"
    }
}

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">入库下单

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">简要描述

入库单创建接口， 通鲁提供

请求URL

· 测试环境：${host}/warehouseOrder/inStock

· 生产环境：${host}/warehouseOrder/inStock

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求方式

POST

Headers参数

Body参数

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">返回结果正常示例

{"success":true, "businessException":false, "result": {"inStockCode": "RK220928000001"}} //返回通鲁入库单号

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">返回结果异常示例

{ "success": false, "businessException": true, "errorCode": "500", "message": "XXX异常!"}

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求示例

Java-sdk方式 下载SDK

public class Sample {
    public static void main(String[] args_) {
        String appKey = "appkey";
        String appSecret = "appSecret";
        String jsonData = "订单下单Body参数JSON数据";
        ZYClient zyClient = new ZYClient(appKey, appSecret);
        HttpResponseData httpResponseData = 
zyClient.doPost(Constants.TEST_HOST + "/oms-service-api/warehouseOrder/inStock", "accessToken", jsonData);
        if(httpResponseData == null) {    
            throw new BusinessException("则一请求失败,返回结果为空!");
         }
        if(httpResponseData.getStatus() == HttpURLConnection.HTTP_UNAUTHORIZED) {   
        //重新获取token再次请求    
        httpResponseData = zyClient.doPost(Constants.TEST_HOST + 
        "/oms-service-api/warehouseOrder/inStock", "accessToken", jsonData);
        }
    }
}

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">出库下单

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">简要描述

出库单创建接口，通鲁提供

请求URL

· 测试环境：${host}/warehouseOrder/outStock

· 生产环境：${host}/warehouseOrder/outStock

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求方式

POST

Headers参数

Body参数

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">返回结果正常示例

{"success":true, "businessException":false, "result": {"outStockCode": "CK220928000001"}} //返回通鲁出库单号

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">返回结果异常示例

{ "success": false, "businessException": true, "errorCode": "500", "message": "XXX异常!"}

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求示例

Java-sdk方式 下载SDK

public class Sample {
    public static void main(String[] args_) {
        String appKey = "appkey";
        String appSecret = "appSecret";
        String jsonData = "订单下单Body参数JSON数据";
        ZYClient zyClient = new ZYClient(appKey, appSecret);
        HttpResponseData httpResponseData = 
zyClient.doPost(Constants.TEST_HOST + "/oms-service-api/warehouseOrder/outStock", "accessToken", jsonData);
        if(httpResponseData == null) {    
            throw new BusinessException("则一请求失败,返回结果为空!");
         }
        if(httpResponseData.getStatus() == HttpURLConnection.HTTP_UNAUTHORIZED) {   
        //重新获取token再次请求    
        httpResponseData = zyClient.doPost(Constants.TEST_HOST + 
        "/oms-service-api/warehouseOrder/outStock", "accessToken", jsonData);
        }
    }
}

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">库存状态转换

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">简要描述

基于入库单的状态转换(CIQ->正常)

请求URL

· 测试环境：https://test.shjiuze.cn/wms-service-api/warehouseOrder/transferStockStatus

· 生产环境：https://gw.shjiuze.cn/wms-service-api/warehouseOrder/transferStockStatus

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求方式

POST

Headers参数

Body参数

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">入库回调

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">简要描述

入库完成回调

请求URL

· 测试环境：https://test.shjiuze.cn/wms-service-api/warehouseOrder/inStockComplete

· 生产环境：https://gw.shjiuze.cn/wms-service-api/warehouseOrder/inStockComplete

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求方式

POST

Headers参数

Body参数

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">出库回调

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">简要描述

出库完成回调

请求URL

· 测试环境：https://test.shjiuze.cn/wms-service-api/warehouseOrder/outStockComplete

· 生产环境：https://gw.shjiuze.cn/wms-service-api/warehouseOrder/outStockComplete

cc0906b686840307c73bd4ddf777c1a198e62376/order/warehouse/2022092701/仓储接口.md#">请求方式

POST

Headers参数

Body参数

2022-09-28更新日志

1. 接口初始化