API
更新订单尺重
更新时间: 2022-11-04 18:43:02 访问次数:1041

接口说明

更新重量接口
更新完成后,需再次调用获取面单接口

使用场景

创建LMA订单后(仅已下单状态),验货发现尺重不一致时,可调用此接口更新尺重,无需取消订单后再重新下单

接口名称

lma.shipment.updateWeight

请求说明

URL

https://openapi.winit.com.cn/openapi/service

接口测试

https://sandboxopenapi.winit.com.cn/openapi/service

验证方法

Token,md5

格式

json

字符编码

UTF-8

http请求方式

http

请求数限制

默认每分钟1000,有需要可申请加大。

请求入参

名称

类型

必填

说明

示例

orderNo

String(60)

Y

winit订单号

LMA010000000250CN

weight

BigDecimal(16)

Y

重量(KG)

0.1

length

BigDecimal(16)

N

(CM)

15

width

BigDecimal(16)

N

(CM)

10

height

BigDecimal(16)

N

(CM)

3

请求示例

{
    "action": "lma.shipment.updateWeight",
    "app_key": "rebecca",
    "data": {
        "orderNo": "LMA010000000250CN",
        "weight": "1.2",
        "length": "15",
        "width": "10",
        "height": "3"
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "leaddeal",
    "sign": "00000000000000000000000000000000",
    "sign_method": "md5",
    "timestamp": "2022-06-30 14:42:11",
    "version": "1.0"
}

返回出参

名称

类型

必填

说明

示例

 

code

String

Y

状态码,0代表失败 

0

msg

String

Y

错误信息

 

isUpdateLabel

String

O

是否更新面单:Y是,N

 

tip

String

O

提示描述


返回示例

1、成功示例:(备注:isUpdateLabel=Y 时,需要重新获取面单)
{
   "code": "0",
   "msg": "操作成功",
   "data":    {
      "isUpdateLabel": "Y",
      "tip": "服务已更新面单,请重新调用获取面单接口获取新面单和新跟踪号"
   }
}

2、失败:
{
   "code": "01020243025",
   "msg": "订单已发货,无法更新订单重量和尺寸",
   "data": ""
}




关键词