一、WMS用户新建开发者

需要参数：开发者名称、Webhook地址
获取开发者 client_id, client_secret
注意：每个仓库服务商的接口请求域名、client_id、client_sercret 数据都是不一样的

二、授权

1、获取授权码

https://app.apifox.com/link/project/3972134/apis/api-145133310

2、通过授权码获取accessToken、refreshToken、userId等授权信息

https://app.apifox.com/link/project/3972134/apis/api-145133309

3、刷新accessToken

https://app.apifox.com/link/project/3972134/apis/api-145133308

首次授权调用1、2两个接口获取到 accessToken 和 refreshToken，调用具体的接口时使用 accessToken
accessToken为短效token（有效期24小时），失效后调用接口3，通过refreshToken获取新的accessToken
refreshToken为长效token（有效期1年以上），失效后需要重新进行授权操作即调用1、2两个接口

三、Webhook

WebHook数据格式

// 订单发货

{
          "timestamp":  "时间戳",
          "type":  "order",
          "data":  {
                    "userId":  "1 // oms用户id",
                    "erpNo":  "123123",
                    "warehouseCode": "xxx",// WMS仓库编号
                    "status":  "Shipped"，
                    "skuList": [{
			"sku": "2309-1Bei",// sku
			"total": 26,// 库存总数
			"locked": 0,// 已锁数量
			"available": 26,// 可用数量
			"nonGood": 0,// 不良品数量
			"totalChange": -1// 库存变动数量
                    }]
          }
}

// 入库单上架

{
          "timestamp":  "时间戳",
          "type":  "storage",
          "data":  {
                    "userId":  "24 // oms用户id",
                    "erpNo":  "Lucky1704360185 // ERP单号",
                    "warehouseCode": "xxx",// 仓库编号
                    "putawayNo":  "P11240104100153 // 入库单号",
                    "finishTime":  "2024-01-04T09:23:26.729",
                    "status":  "null // 单据完成是的话是Finish",
                    "skuList":  [
                              {
                                        "skuCode":  "BUG_more898 // ERP的商品GTIN码",
                                        "sku":  "BUG_more898 // sku",
                                        "num":  10,
                                        "badNum":  0,
                                        "thisTimeNum":  10
                              },
                              {
                                        "skuCode":  "BUG_more899",
                                        "sku":  "BUG_more899",
                                        "num":  "5 // 良品数量",
                                        "badNum":  "0 // 次品数量",
                                        "thisTimeNum":  "5 //本次上架数量"
                              }
                    ]
          }
}

// 退货入库单完成

{
          "timestamp":  "时间戳",
          "type":  "return",
          "finishTime":  "完成时间",
          "data":  {
                    "userId":  "1 //oms用户id",
                    "erpNo":  "ERP单号",
                    "warehouseCode": "xxx",// 仓库编号
                    "status":  "FINISH",
                    "skuList":  [
                              {
                                        "sku":  "sku",
                                        "num":  "1 // 良品数量",
                                        "badNum":  "0 // 次品数量"
                              }
                    ]
          }
}

// 订单截单（status: 成功：“success” 失败：“fail”）

{
          "timestamp":  "时间戳",
          "type":  "orderIntercept",
          "data":  {
                    "userId":  "1 // oms用户id",
                    "erpNo":  "123123",
                    "status":  "success"
          }
}

// 库存盘点

{
	"timestamp": 时间戳,
	"type": "inventoryCount",
	"data": {
		"warehouseCode": "xxx",// 仓库编号
		"documentNo": "xx",// 盘点单号
		"userId": 1, // oms用户id
		"finishTime": "2025-02-07T08:07:56.908",// 完成时间
		"skuList": [{
			"sku": "2309-1Bei",// sku
			"total": 26,// 库存总数
			"locked": 0,// 已锁数量
			"available": 26,// 可用数量
			"nonGood": 0,// 不良品数量
			"totalChange": -1,// 库存变动数量
			"lockedChange": null,// 已锁变动数量
			"availableChange": null,// 可用变动数量
			"nonGoodChange": null// 次品变动数量
		}]
	}
}

// 库存调整

{
	"timestamp": 时间戳,
	"type": "adjust",
	"data": {
		"warehouseCode": "01",// 仓库编号
		"documentNo": "ADSE02620",// 调整单号
		"userId": 1,// oms用户id
		"finishTime": "2025-02-07T09:10:03.951",// 完成时间
		"skuList": [{
			"sku": "819-Dark GL",// sku
			"total": 1,// 库存总数
			"locked": 0,// 已锁数量
			"available": 1,// 可用数量
			"nonGood": 0,// 不良品数量
			"totalChange": 1,// 库存变动数量
			"lockedChange": null,// 已锁变动数量
			"availableChange": null,// 可用变动数量
			"nonGoodChange": null // 次品变动数量
		}]
	}
}

// 移货

{
	"timestamp": 时间戳,
	"type": "move",
	"data": {
		"warehouseCode": "A",// 仓库编号
		"documentNo": "MOL703",// 移货单号
		"userId": 3256,// oms用户id
		"finishTime": "2025-02-06T03:59:21.009",// 完成时间
		"finishTime": "2025-02-07T09:10:03.951",// 完成时间
		"skuList": [{
			"sku": "819-Dark GL",// sku
			"total": 1,// 库存总数
			"locked": 0,// 已锁数量
			"available": 1,// 可用数量
			"nonGood": 0,// 不良品数量
			"totalChange": 1,// 库存变动数量
			"lockedChange": null,// 已锁变动数量
			"availableChange": null,// 可用变动数量
			"nonGoodChange": null // 次品变动数量
		}]
	}
}

// 创建订单

{
	"timestamp": 时间戳,
	"type": "orderCreate",
	"data": {
		"warehouseCode": "YK",// 仓库编号
		"documentNo": "BSZ1AF0608",// erp单号
		"userId": 3256,// oms用户id
                "packageNo": "PN4L2237607", // wms包裹号
                "orderStatus": 2,
		"finishTime": "2025-02-06T03:59:21.009",// 完成时间
		"finishTime": "2025-02-07T09:10:03.951",// 完成时间
		"skuList": [{
			"sku": "819-Dark GL",// sku
			"total": 1,// 库存总数
			"locked": 0,// 已锁数量
			"available": 1,// 可用数量
			"nonGood": 0,// 不良品数量
			"totalChange": 1,// 库存变动数量
			"lockedChange": null,// 已锁变动数量
			"availableChange": null,// 可用变动数量
			"nonGoodChange": null // 次品变动数量
		}]
	}
}

// 取消订单

{
	"timestamp": 时间戳,
	"type": "orderCancel",
	"data": {
		"warehouseCode": "YK",// 仓库编号
		"documentNo": "BSZ1AF0608",// erp单号
		"userId": 3256,// oms用户id
                "packageNo": "PN4L2237607", // wms包裹号
                "orderStatus": 2,
		"finishTime": "2025-02-06T03:59:21.009",// 完成时间
		"finishTime": "2025-02-07T09:10:03.951",// 完成时间
		"skuList": [{
			"sku": "819-Dark GL",// sku
			"total": 1,// 库存总数
			"locked": 0,// 已锁数量
			"available": 1,// 可用数量
			"nonGood": 0,// 不良品数量
			"totalChange": 1,// 库存变动数量
			"lockedChange": null,// 已锁变动数量
			"availableChange": null,// 可用变动数量
			"nonGoodChange": null // 次品变动数量
		}]
	}
}

// 库存转换

{
	"timestamp": 时间戳,
	"type": "convert",
	"data": {
		"warehouseCode": "A",// 仓库编号
		"documentNo": "MOL703",// 库存转换单号
		"userId": 3256,// oms用户id
		"finishTime": "2025-02-06T03:59:21.009",// 完成时间
		"finishTime": "2025-02-07T09:10:03.951",// 完成时间
		"skuList": [{
			"sku": "819-Dark GL",// sku
			"total": 1,// 库存总数
			"locked": 0,// 已锁数量
			"available": 1,// 可用数量
			"nonGood": 0,// 不良品数量
			"totalChange": 1,// 库存变动数量
			"lockedChange": null,// 已锁变动数量
			"availableChange": null,// 可用变动数量
			"nonGoodChange": null // 次品变动数量
		}]
	}
}

Webhook响应数据格式

{
    "code": "0是正确，其他异常",
    "msg": ""
}

Webhook签名

Map<String, Object> signMap = Maps.newHashMap();
signMap.put("data", "数据");
signMap.put("clientSecret", "客户端密码");
String sign =  Md5Utils.md5Hex(JSONUtil.objectToJson(signMap));

四、调用业务接口

1、所有业务接口请求方式均为post，业务请求参数均以JSON格式放在请求体中

2、请求头中必须带有以下公共参数

clientId：开发者id
accessToken：用户授权获取到的请求令牌
timestamp：时间戳，毫秒
nonce：随机数字（建议2位数），用于防止重复请求
userId：用户id-获取accessToken接口返回的用户id
sign：签名

3、签名生成方式

key：
accessToken、clientId、method（请求方式get/post，目前固定为post）、nonce、timestamp、url（接口请求路径）、userId
七个参数排序后用&拼接

eg：
accessToken=ds234ds&clientId=321321&method=post&nonce=14&timestamp=1692889556000&url=/api/order/get&userId=8

使用Hamc SHA256进行加密，开发者的client_secret为加密密钥

计算签名方法工具类：


    public static String sign(String key, String data) {
        return hmacsha256(key, data);
    }

    public static String hmacsha256(String key, String data) {
        try {
            Mac hmac = Mac.getInstance("HmacSHA256");
            SecretKeySpec secret_key = new SecretKeySpec(
                    key.getBytes(StandardCharsets.UTF_8),
                    "HmacSHA256");
            hmac.init(secret_key);
            return new String(Hex.encodeHex(hmac.doFinal(data.getBytes(StandardCharsets.UTF_8))));
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }

    public static void main(String[] args) {
        Map<String, Object> params = new HashMap<>();
        params.put("url","/api/order/get");
        params.put("method","post");
        params.put("accessToken","1b56814f081c432cb82751be145261d3");
        params.put("clientId","fe73489a9b5948dbafd07e7b28d6e268");
        params.put("timestamp","1692889556000");
        params.put("nonce","14");
        params.put("userId","8");
        String data = params.entrySet().stream().map(e -> e.getKey() + "=" + e.getValue()).sorted().collect(Collectors.joining("&"));
        // HmacSHA256签名
        String genSign = Signature.sign("4a506ccaf37e400bac4a42d2dc5f600a", data);
        System.out.println(data);
        System.out.println(genSign);
    }
}

main方法执行输出

accessToken=1b56814f081c432cb82751be145261d3&clientId=fe73489a9b5948dbafd07e7b28d6e268&method=post&nonce=14&timestamp=1692889556000&url=/api/order/get&userId=8

9bc08ba7552c5dfea4efab6bda78a4a9738010913f2403bd93f09c6bf974b939

4、调用接口示例：

请求链接
https://test.jfwms.com/api/order/get

请求头

clientId:fe73489a9b5948dbafd07e7b28d6e268
accessToken:1b56814f081c432cb82751be145261d3
timestamp:1692889556000
nonce:14
sign:9bc08ba7552c5dfea4efab6bda78a4a9738010913f2403bd93f09c6bf974b939
userId:8

请求体
{"erpNo":"123"}

{
    "code": 50017,
    "message": "The order was not found in the warehouse!",
    "data": null,
    "requestId": "7bb5ddef9aed415a88163e5d39b41691"
}

五、常见报错

报错返回多语言说明：
请求头header中参数Accept-Language控制
zh_CN：中文报错
en_US：英文报错
默认为英文报错返回

错误码	中文	英文
-1	系统维护升级中!	System maintenance and upgrade in progress!
0	成功	SUCCESS
1	服务异常，请重试！	server error, please try again later
10000	请求缺少必要参数	The request lacks necessary parameters
10001	请求参数错误	Request parameter error
10002	访问令牌已失效	Invalid ACCESS TOKEN
10003	刷新令牌已失效	Invalid REFRESH TOKEN
10004	访问令牌必填	ACCESS TOKEN required
10005	刷新令牌必填	REFRESH TOKEN required！
10006	客户端ID必填	CLIENT ID required！
10007	客户端密钥必填	CLIENT SECRET required！
10008	客户端应用信息已失效	Invalid client app info
10009	客户授权信息已失效	Invalid client auth info
10010	请求IP不在白名单中	Request ip not in whitelist
10011	找不到用户信息	could not find user info
10012	密码错误	wrong password
10013	找不到域名信息	could not find domain info
10014	找不到有效的应用信息	could not find valid app info
10015	令牌已过期	Token has expired
10016	令牌已失效	Invalid token
10017	请求过于频繁，请稍后重试	Request exceeds frequency limit
10018	请求过于频繁，请稍后重试	The request is too frequent, please try again later
10020	用户ID必填	USER ID required！
10021	签名必填	SIGN required！
10022	随机数必填	NONCE required！
10023	时间戳必填	TIMESTAMP required！
10024	随机数格式错误	NONCE format error
10025	时间戳格式错误	TIMESTAMP format error
10026	签名错误	SIGN error
10027	重复提交	Repeated commit
10028	时间戳已失效	Invalid TIMESTAMP
10029	用户ID格式错误	USER ID format error
10030	WEBHOOK类型必填	WEBHOOK TYPE IS required！
10030	授权识别码失效	Invalid authorization identification code
10031	请求参数 %s 格式错误	request params %s format error
10032	请提供有效的查询信息（%s）	Please provide valid query information (%s)
10040	OMS账号已被停用，请联系仓库服务商！	OMS account has been deactivated, Please contact the warehouse service provider!
10041	未识别到仓库，请联系仓库服务商！	The warehouse is not recognized, Please contact the warehouse service provider!
10042	未识别到仓库，请联系仓库服务商！	The warehouse is not recognized, Please contact the warehouse service provider!
10043	仓库必填！	Warehouse required!
10044	仓库已暂停接单，请联系仓库服务商！	The warehouse has suspended receiving goods, Please contact the warehouse service provider!
10045	仓库尚未为您分配计费方案，请联系仓库！	The warehouse has not assigned a billing plan to you, please contact the warehouse!
10046	商品SKU：%s在仓库中不存在，请先推送商品SKU	SKU:%s does not exist in the warehouse, please push the SKU first
10047	SKU：%s已被仓库设置禁售，请联系三方仓服务商！	The document contains goods that the warehouse is prohibited from receiving: %s
10048	仓库已暂停接单，请联系三方仓服务商！	The warehouse has stopped accepting orders, please contact the third-party warehouse service provider!
10049	您的余额不足，请登录OMS系统充值或联系仓库！	Your balance is not enough, please log in to OMS to recharge or contact the warehouse!
10050	仓库服务商没有为您分配仓库权限，请联系仓库服务商！	The warehouse service provider has not allocated warehouse permissions to you, please contact the warehouse service provider!
10051	未识别到仓库（%s），请联系仓库服务商！	The warehouse（%s） is not recognized, Please contact the warehouse service provider!
10052	分页参数必填！	Paging parameters is required!
10053	筛选时间必填！	Filter time period is required!
10054	代码必填	CODE is required
10055	代码格式错误	CODE format error
10056	运单号仅支持数字、字母、及特殊符号空格 ( ) _ . - * + #	The tracking number only supports numbers, letters, and special symbols: space ( ) _ . - * + #
10057	运单号重复	The tracking number is repeat
10058	可用余额过低，请登录OMS系统充值或联系仓库！	The available balance is too low, please log in to the OMS system to recharge or contact the warehouse!
20000	商品SKU必填！	SKU is required!
20001	商品名称必填！	SKU name is required!
20002	商品条码必填！	Barcode is required!
20003	商品SKU已创建，无需重复推送！	sku already exists!
20004	商品条码（%s）已存在！	sku barcode(%s) already exists!
20005	长宽高必须同时填写	Length, width and height must be filled in in full
20007	未找到sku，请检查是否在OMS作废了该SKU！	SKU not found. Please check if the SKU has been invalidated in the OMS!
20008	重量范围：0g-999999.99g	Weight range: 0g-999999.99g
20009	尺寸范围：0cm-999.99cm	Size range: 0cm-999.99cm
20010	商品SKU字符数量需在2~50范围内；仅支持数字、字母、空格及特殊符号 ( ) _. - * + # \ /% &	The number of characters in sku must be in the range of 2~50; only numbers, letters,space and special symbols such as: ( ) _. - * + # \ /% & are supported
20011	商品SKU条码字符数量需在2~50范围内；仅支持数字、字母、空格及特殊符号( ) _. - * + # \ /% &	The number of characters in Barcode must be in the range of 2~50; only numbers, letters, space and special symbols such as: ( ) _. - * + # \ /% & are supported
20012	一次最多推送300个商品	Up to 300 products can be pushed at one time
20013	商品名称最多255字符	sku name can be up to 255 characters
20014	商品条码最多50字符	sku barcode can contain up to 50 characters
20015	sku(%s)在仓库系统中已被占用，请修改SKU编号后重新推送	The sku(%s) has been occupied in the warehouse system. Please modify the SKU and push it again
20016	商品条码(%s)在仓库系统中已被占用，请修改商品条码后重新推送	The SKU barcode(%s) has been occupied in the warehouse system. Please modify the SKU barcode and push it again
20017	您没有权限获得仓库分销的商品信息，请联系仓库服务商！	You do not have permission to obtain product information for warehouse distribution. Please contact the warehouse service provider!
20018	最多一次查询50个商品	sku quantity limit of 50
20019	最多一次查询300个商品	sku quantity limit of 300
20020	该商品是您认领的分销商品，无需推送	This product is a distribution product that you import, no need to push
20021	条码%s存在退货单据或库存不为0，不允许更改	Barcode %s exists in the return document or the inventory is not 0, changes are not allowed
20022	仓库不允许截单，截单失败！	The warehouse does not allow interception of orders, interception of orders failed!
20023	截单已申请，仓库审核中！	Order interception has been applied and is under review by the warehouse!
20024	商品申报中文名必填	Sku declared chinese name is required
20025	商品申报中文名长度限制100	Sku declared chinese name length is limit of 100
20026	商品申报英文名必填	Sku declared english name is required
20027	商品申报英文名长度限制100	Sku declared english name length is limit of 100
20028	申报价格必填	Sku declared price is required
20029	申报价格范围：0.01-999999.999999	Sku declared price range: 0.01-999999.999999
20030	申报币种必填	Sku declared currency is required
20031	申报币种不合规	Sku declared currency is error
20032	申报属性必填	Sku declared attribute is required
20033	申报属性不合规	Sku declared attribute is error
20034	没有认领的分销商品	Sku isn't claimed
20035	截单失败，请稍后重试！	Interception of orders failed, please try again later!
40000	ERP单号必填！	erpNo is required!
40001	入库单在仓库中已存在，请勿重复推送！	The inbound order already exists in the warehouse, please do not push it again!
40002	单据中没有商品，请检查！	There are no items in the document, please check!
40003	商品数量必填！	Product quantity is required!
40004	在仓库中未找到该入库单！	The inbound order was not found in the warehouse!
40005	当前状态(%s)不允许取消入库单	The inbound order cannot be changed when the status of stock-in list is (%s)
40006	入库单状态(%s)时不能更改运单号	The trackingNo is not allowed to be modified when the status of the inbound order is (%s)
40007	入库单已有运单号，不允许更新	The inbound order already has a trackingNo and is not allowed to be updated
40008	一次最多推送500个商品	Up to 5000 products can be pushed at one time
40009	时间格式："yyyy-MM-dd'T'HH:mm:ss"（%s）	(%s)Time format: "yyyy-MM-dd'T'HH:mm:ss"
40010	订单号必填	platformOrderNo is required
40011	退货类型必填	Return type required
40012	退货类型填写错误	Return type incorrectly filled in
40013	备注最多300字符	Note can contain up to 300 characters.
40014	暂不支持退货类型为"买家退货"	The return type "Buyer Return" is not currently supported.
40015	订单未发货，请检查单据状态！	The order has not been shipped, please check the document status!
40016	找不到原订单	Original order not found！
40017	推送失败！请联系仓库服务商！	Push failed! Please contact the warehouse service provider!
40018	物流方式与原订单不一致！	The logisticsName is inconsistent with the original order！
40019	商品数量与原订单不一致，请检查！	The quantity of goods is inconsistent with the original order, please check!
40020	推送商品重复,请检查！	Repeated product push, please check!
40021	有箱子中没有商品，请检查！	There are no items in the box, please check!
40022	一次最多推送500个箱子	Up to 5000 boxs can be pushed at one time
40023	一个箱子最多装100个商品	The box can hold up to 100 pcs
40024	%s 必填	%s is required
40025	在仓库系统中未找到退货单	Return order not found in the warehouse system
40026	退货单已入库，取消失败！	The return order has been stocked in, failed to cancel
40027	您选择的到仓方式未识别到仓库计费策略，请联系仓库！	Selected Arrival of Warehouse Method has not been recognized the warehouse billing strategy. Please contact the warehouse
40028	入库单状态不支持当前操作！	The status of stock-in list does not support the current operation!
40029	[3] 代理仓单据创建失败:%s	[3] warehouse document create failed:%s
40030	[3] 代理仓单据取消失败:%s	[3] warehouse document cancellation failed:%s
40031	[3] 代理仓更新运单号失败:%s	[3] warehouse failed to update waybill number:%s
40032	SKU %s 尺寸重量未填写	SKU %s dimensions and weight not filled
40033	入库单运单号超长（%s）	The inbound order trackingNo exceeds the limit (%s).
40034	入库单运单号格式错误	The inbound order trackingNo format error
50000	面单URL必填！	labelUrl is required!
50001	面单URL最多2048字符	The labelUrl can have a maximum of 2048 characters.
50002	收件人(国家/地区)必填！	recipientCountry is required!
50003	ERP单号必填！	erpNo is required!
50004	物流名称必填！	logisticsId is required!
50005	运单号必填！	trackingNo is required!
50006	详细地址最多300字符	recipientAddress can contain up to 300 characters.
50007	国家/地区二字码必填！	Country code is required!
50008	ERP单号最多100字符！	erpNo can be up to 100 characters!
50009	平台订单号最多50字符！	platformOrderNo can be up to 50 characters!
50010	收件人姓名最多100字符！	buyerName can be up to 100 characters!
50011	手机号最多100字符！	buyerPhone number can be up to 100 characters!
50012	收件人(省/州)最多100字符！	recipientProvince can contain up to 100 characters!
50013	收件人(市/县)最多100字符！	There recipientCity can contain up to 100 characters!
50014	邮编最多100字符！	zipCode can contain up to 100 characters!
50015	物流名称最多100字符！	logisticsName can be up to 100 characters!
50016	运单号最多100字符！	trackingNo can be up to 100 characters!
50017	在仓库中未找到该订单！	The order was not found in the warehouse!
50018	订单已发货，请联系物流拦截！	The order has been shipped, please contact logistics to intercept it!
50019	ERP单号已存在	ERP order number already exists
50020	物流方式未识别，请联系仓库服务商！	The logistics method is not recognized, please contact the warehouse service provider!
50021	仓库未开启物流方式：%s,请联系仓库服务商！	The warehouse has not opened the logistics method: %s, Please contact the warehouse service provider!
50022	订单中没有商品，请检查！	There are no items in the order, please check!
50023	商品信息异常！	SKU num information error!
50024	商品SKU：%s在仓库中不存在，请先推送商品SKU	SKU:%s does not exist in the warehouse, please push the SKU first
50025	订单收件国家/地区与仓库所在国家/地区不一致，请检查！	recipientCountry is inconsistent with the country where the warehouse is located, please check!
50026	商品sku（%S）库存不足，请先同步三方仓库存！	The inventory of SKU (%s) is insufficient. Please synchronize the inventory of the third-party warehouse first!
50027	订单已取消	Order canceled
50028	一次性最多查询100条数据！	Query up to 100 pieces of data at one time!
50029	平台必填！	Platform is required!
50030	SKU：%s已被仓库设置禁售，请联系仓库服务商！	SKU: %s has been banned from sale by the warehouse, Please contact the warehouse service provider!
50031	面单信息异常！	labelUrl error!
50032	物流方式ID必填！	logisticsId is required!
50033	未找到客户物流渠道，请联系仓库服务商	No customer logistics channel found, please contact the warehouse service provider
50034	物流渠道已关闭，请联系仓库服务商	Logistics channels have been closed,please contact the warehouse service provider
50035	物流渠道已关闭，请联系仓库服务商	Logistics channels have been closed,please contact the warehouse service provider
50036	订单金额必填！	Order amount is required!
50037	货币单位必填！	Currency unit is required!
50038	订单正在处理中，请稍后再试！	The order is being processed, please try again later!
50039	收件人(省/州)必填！	recipientProvince is required!
50040	收件人(市/县)必填！	The recipientCity is required!
50041	收货人地址(详细地址)必填！	recipientAddress is required!
50042	邮编必填！	zipCode is required!
50046	包裹类型必填！（1:信封 2:Pack袋 3:自备包装）	packageType is required!(1: Envelope 2: Pack bag 3: Self-prepared packaging)
50047	sku海关编码必填！	hsCode is required!
50048	收件人姓名必填！	buyerName is required!
50049	收件人手机号必填！	buyerPhone is required!
50050	包裹重量超出物流方式重量区间(%sKG~%sKG)，请重新选择物流方式或联系三方仓检查商品实际重量！	The package weight exceeds the weight range of the logistics method (%sKG~%sKG). Please reselect the logistics method or contact the third-party warehouse to check the actual weight of the goods!
50051	包裹的收件省份错误！	The recipientProvince of the package is incorrectly filled!
50052	收件人(县)必填！	The recipient (area) is required!
50053	您的结算货币与商品分销价的货币不一致！	Your settlement currency does not match the currency of the product distribution price!
50054	%s 已无法进行分销，请联系仓库服务商	%s distribution is no longer possible, please contact the warehouse service provider
50055	邮编必须为8位纯数字	The postal code must be an 8 digit pure number
50056	电话必须少于12位	The phone number must be less than 12 digits
50057	税号必填！	The tax id is required!
50058	收件人姓名最多50字符！	Recipient name can be up to 50 characters!
50059	详细地址最多50字符！	Addresses can contain up to 50 characters!
50060	无法取消此订单，因为正在获取标签，请稍后再试	This order cannot be cancelled because the lable is being obtained，please try again later
50061	收件公司最多100字符！	The recipient company can contain a maximum of 100 characters!
50062	收件人公司必填！	Recipient's company is required!
50063	收件人州或省的长度超过了2个字符的限制！	The length of the destination state or province code exceeds the limit of 2 characters!
50064	仓库未绑定该物流渠道，请联系仓库！	The warehouse has not connected with this logistics, please contact the warehouse!
50065	没有权限使用该物流渠道，请更换物流渠道或联系仓库！	I do not have permission to use this logistics channel. Please change the logistics channel or contact the warehouse!
50065	费用记录未生成！	The cost of order has not been generated!
50066	不支持修改运单号	Not supported to modify tracking number
50067	不支持修改面单	Not supported to modify noodle list
50068	详细地址最多35字符	Addresses can contain up to 35 characters.
50069	公司名称最少3个字符，最多35个字符	The company requires a minimum of 3 characters and a maximum of 35 characters.
50070	商品SKU（%s）已被仓库归档，请联系仓库服务商！	The SKU (%s) of the product has been archived by the warehouse, Please contact the warehouse service provider!
50071	在仓库中未找到该订单！(ERP单号: %s)	The order was not found in the warehouse!(erpNo: %s)
50072	币种的长度超过了3个字符的限制！	The length of the currency exceeds the limit of 3 characters!
50073	TEMU直邮作废失败，%s	nullify_error, %s
50074	查询数量超过限制	The number of queries exceeds the limit
50075	创建订单note字段长度超过了200个字符的限制	The length of the note exceeds the limit of 200 characters.
50076	门牌号最多50字符！	HouseNumber can be up to 50 characters!
50077	店铺名称最多50字符！	ShopName can be up to 50 characters!
50078	收件人(区/县)最多150字符！	recipientArea can be up to 150 characters
50086	运单号已存在，请勿重复提交	Tracking number already exists
60000	自定义箱号规则匹配有误	custom no rule error
60001	到仓方式必填	receiptType required！
60002	您选择的到仓方式未识别到仓库计费策略，请联系仓库	Selected Arrival of Warehouse Method has not been recognized the warehouse billing strategy. Please contact the warehouse
60003	自定义箱号已存在	box custom no is exist
60004	单箱尺寸的长宽高最大值不能超过999.999	The maximum length, width, and height of a single box size cannot exceed 999.999
60005	单箱重量最大值不能超过999999.999	The maximum weight of a single box cannot exceed 999999.999
60006	sku数量需要大于0	The number of SKUs needs to be greater than 0
60007	到仓方式错误	receiptType error
60008	箱子序号需要从1开始	The box number needs to start from 1
60009	箱子序号不能重复	The box number cannot be repeated
60010	%s	%s
60011	箱子序号有误	The box number error
60012	自定义箱号字符数量需在2~20范围内；仅支持数字、字母、及特殊符号空格 () _. - *+# "%	The number of custom box number characters should be within the range of 2-20; Only supports numbers, letters, and special symbol spaces () _. - *+# "%
60013	箱子数量或序号有误	The number or serial number of the boxes is incorrect
70000	出库单不存在！	was not found in the warehouse!
70001	出库单ERP已存在！	ERP No is exist!
70002	目的地必填！	Destination is required！
70003	派送类型必填！	dispatch type is required!
70004	物流服务必填！	logistic type is required!
70005	运单号必填！	tracking no is required!
70006	收件信息必填！	address is required!
70007	收件人必填！	buyer name is required!
70008	收件手机号码必填！	buyer phone is required!
70009	邮政编码必填！	zipCode is required!
70010	国家/地区必填！	receipt country is required!
70011	省/州必填！	receipt province is required!
70012	市/府必填！	receipt city is required!
70012	区/县必填！	receipt area is required!
70013	地址1必填！	receipt address is required!
70014	物流面单必填！	label is required!
70015	箱子必填！	box is required!
70016	箱号必填！	box no is required!
70017	箱号SKU必填！	box sku is required!
70018	SKU必填！	sku is required!
70019	SKU数量必填！	sku count is required!
70020	新标签文件必填！	new label file count is required!
70021	商品不存在！	sku not exist!
70022	未匹配到合适的箱类型！	No suitable box type matched!
70023	箱号(%s)库存不足！	box no(%s)Insufficient inventory!
70024	文件格式错误：%s！	%s format error!
70025	目的地传值有误！	Destination error!
70026	物流服务传值有误！	logistics type error!
70027	派送类型传值有误！	dispatch type error!
80000	在仓库中未找到该单据！	The document was not found in the warehouse!
80001	在仓库中未找到该单据(%s)！	The document(%s) was not found in the warehouse!

API使用说明

一、WMS用户新建开发者#

二、授权#

1、获取授权码#

2、通过授权码获取accessToken、refreshToken、userId等授权信息#

3、刷新accessToken#

三、Webhook#

WebHook数据格式#

Webhook响应数据格式#

Webhook签名#

四、调用业务接口#

1、所有业务接口请求方式均为post，业务请求参数均以JSON格式放在请求体中#

2、请求头中必须带有以下公共参数#

3、签名生成方式#

计算签名方法工具类：#

4、调用接口示例：#

五、常见报错#