创建入库单(terminus.wms.inbound.order.create)

业务场景：

创建shipperGrid平台入库单

系统入参：

参数名称	类型	是否必填	说明
channelCode	String	是	请传入固定参数【SHIPPER_GRID】，参考请求示例

业务入参

参数名称	类型	是否必填	说明
inboundOrderCode	String	是	入库单号
warehouseCode	String	是	仓库编码
inboundTimeStamp	Long	否	预计入库时间 毫秒级时间戳
isAutoSubmitAudit	Boolean	否	是否自动提交审核，默认false。当值为true时，trackingNumber必填
trackingNumber	String	否	跟踪号/海柜号
remark	String	否	备注
items	List	是	入库单明细

入库单明细 - Item

参数名称	类型	是否必填	说明
boxMark	String	是	箱唛
boxNo	Integer	是	箱号，从1开始的连续正整数
trackingNumber	String	否	物流单号，如果存在多个物流单号请设置在明细中
boxDetails	List	是	商品信息列表

商品信息 - BoxDetail

参数名称	类型	是否必填	说明
skuCode	String	是	sku编码
quantity	Integer	是	数量

请求示例

public static void main(String[] args) {
        String appKey = "28cd819d0305402bb02e7d01091160c8";
        String secret = "xj1CnrTho1Bc1YSxaZa8ghdqRxwn079prFHqkjGXzdO64TQuy4aIzs06qv5htyXk";
        String url = "https://channelhub-uat.shippergrid.com/terminus/channelhub/api";
        ChannelClient client = new DefaultChannelClient( url, appKey, secret);
        //必填字段
        WmsInboundCreateRequest wmsInboundCreateRequest = new WmsInboundCreateRequest();
        wmsInboundCreateRequest.setChannelCode(OpenChannel.SHIPPER_GRID);
        //必填字段
        wmsInboundCreateRequest.setInboundOrderCode("TEST202504170000007");
        wmsInboundCreateRequest.setTransportType(WmsInboundCreateRequest.TransportTypeEnum.FCL_SEA);
        //仓库信息
        wmsInboundCreateRequest.setWarehouseCode("SH202408280003");
        //避免时区问题 这里传毫秒级时间戳
        wmsInboundCreateRequest.setInboundTimeStamp(System.currentTimeMillis()+24*60*60*1000);
        //物流单号
        wmsInboundCreateRequest.setTrackingNumber("981031213250417001");
        wmsInboundCreateRequest.setRemark("测试订单");
        WmsInboundCreateRequest.Item item = new WmsInboundCreateRequest.Item();
        //箱号
        item.setBoxNo(1);
        //箱唛
        item.setBoxMark("123");
        WmsInboundCreateRequest.BoxDetail boxDetail = new WmsInboundCreateRequest.BoxDetail();
        boxDetail.setQuantity(10);
        boxDetail.setSkuCode("2504UN0019");
        boxDetail.setItemCode("2504UN0019");
        item.setBoxDetails(Collections.singletonList(boxDetail));
        item.setTrackingNumber("981031213250417002");
        wmsInboundCreateRequest.setItems(Collections.singletonList(item));
        WmsInboundCreateResponse channelResult = client.execute(wmsInboundCreateRequest);
        System.out.println(JSON.toJSONString(channelResult));
    }

成功响应示例

{
    "code": 200,
    "createTime": 1747277200799,
    "headerContent": {
        "traceId": "2025-05-15-10-46-34-70000000-6383ba0c-3b13-459b-8b25-6a2ce87d4314",
        "sign": "9ff149d96029c014e2376ea6a77027431445db4525d266730eb37a10c5144408",
        "methodName": "terminus.wms.inbound.order.create",
        "appKey": "28cd819d0305402bb02e7d01091160c8",
        "Accept-Language": "zh_CN",
        "version": "1.0.0",
        "channelCode": "SHIPPER_GRID",
        "timestamp": "1747277194117"
    },
    "message": "success",
    "requestId": "2025-05-15-10-46-34-70000000-6383ba0c-3b13-459b-8b25-6a2ce87d4314",
    "requestUrl": "https://channelhub-uat.shippergrid.com/terminus/channelhub/api",
    "success": true,
    "thirdInboundOrderCode": "IB00000408"
}

返回参数说明

参数名	类型	说明
success	boolean	true为成功
message	string	提示信息
thirdInboundOrderCode	string	平台入库单号

异常响应示例

{
    "code":500,
    "message":"unknow error",
    "success":false
}