LSO费用预览
- 接口说明: 根据传入订单信息进行LSO费用查询预览
- 详细说明:
- 1:由于LSO官方接口仅支持单货物下单,但系统相同发件地,收货地多件货物可一次请求。通过orderDetails列表传入多件货物,详情请见下方请求示例
- 2:下单参数中systemSenderName为系统发件人名称(可登录系统(LSO运单录入(发件地下拉))查看可用系统发件人,不传则走系统默认发件地)
- 3:LSO面单官方尺寸为4x5,为了客户打印机能兼容LSO面单及UPS面单固调整尺寸为4X6,下方则会有一段空白。
- 4:当下单失败请及时调用退款接口,不然会占用余额!
- 5:LSO为区域服务商,系统会校验发件地和收货地是否有LSO服务,请关注返回信息!
- 6:系统未提供不同的发件地,收货地批量下单接口,不同的发件地,收货地批量下单请多次请求本接口下单!
- 7:【返回单号和费用(通用)】及【返回面单(通用)】接口请调用通用接口
- 8:下单参数中serviceType为LSO服务类型,现系统中仅支持GroundBasic,后续更多服务可关注本文档更新日志!
- 9:- 下单请求逻辑
- 商户获取token(通用) (opens new window) :获取到token,后续接口需要使用此token校验请求合法性
- LSO费用预览 (opens new window) :进行运价预览(系统要求调用方先获取价格再进行下单)
- LSO下单 (opens new window) :进行下单请求(系统为异步下单,请调用下单后稍后主动调用返回单号和费用(通用) (opens new window) 接口获取下单情况或使用回调方式)
- 返回单号和费用(通用) (opens new window) :运单下单后,系统需要异步去执行下单逻辑,期间会存在一定的时间差,所以下单后请稍微间隔几秒后再行调用查询接口。若查询接口返回的code不为200,当code=1024时表示 平台下单还未完成,您可以稍后重试查询直到code为200时获取运单信息,再根据运单状态判断执行后续业务逻辑,其余code值则为下单失败。
- 返回面单(通用) (opens new window) :标签为异步生成,当请求状态为1115(标签正在下载,请稍候!) 时候需要稍后重新调用本接口获取)
- 请求方式: POST
- 接口地址:
https://syco-api.logssc.com/external-interface/lso/orderPreFee
# 请求参数
参数名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
token | String | true | token |
appId | String | true | 商户APP-KEY |
province | String | true | 收件人所在州(缩写) |
city | String | true | 收件人所在城市 |
receiver | String | true | 收件人 |
receiverPhone | String | true | 收件人电话 |
postcode | String | true | 收件邮编 |
address1 | String | true | 地址1 |
address2 | String | false | 地址2 |
nationCode | String | true | 国家二字码(现限:US) |
receiveCompany | String | true | 收件公司 |
customerNumber | String | true | 客户单号 |
systemSenderName | String | false | 所选系统发件人名称(可用系统发件人登录系统查看,不传走系统默认) |
lsoServiceType | String | true | 服务类型=>现仅:GroundBasic |
orderDetails | List <Object> | true | 货物明细 |
packWeight | Decimal | true | 货箱重量(LSO) |
boxLength | Decimal | true | 长(IN) |
boxWidth | Decimal | true | 宽(IN) |
boxHight | Decimal | true | 高(IN) |
lsoDeclaredValue | Decimal | false | 申报价格 |
请求示例:
{
"appId": "商户APP-KEY",
"province": "收件人所在州(缩写)",
"city": "收件人所在城市",
"receiver": "收件人",
"receiverPhone": "收件人电话",
"postcode": "收件邮编",
"address1": "地址1",
"address2": "地址2",
"nationCode": "国家二字码",
"receiveCompany": "收件公司",
"customerNumber": "客户单号",
"systemSenderName": "XXX",
"lsoServiceType": "GroundBasic",
"orderDetails": [
{
"boxHight": "高",
"boxLength": "长",
"boxWidth": "宽",
"packWeight": "货箱重量",
"lsoDeclaredValue": "申报价格"
}
],
"token": "token"
}
# 返回结果
参数名称 | 类型 | 描述 |
---|---|---|
data | ||
baseFee | Decimal | 运费($) |
commission | Decimal | 佣金($) |
fee | Decimal | 总费用($) |
feePerKG | Decimal | 单价($)/KG |
orderServe | Integer | 服务类型[1:GFP,2:HundredWeight,3:Ground,4:SurePost,5:MI,6:LSO] |
piece | Integer | 件数 |
weight | Decimal | 计费重/LBS |
code | Integer | 状态码 |
err | string | 错误信息 |
msg | String | 结果描述 |
返回示例:
{
"code": 200,
"data": [
{
"baseFee": "运费($)",
"commission": "佣金($)",
"fee": "总费用($)",
"feePerKG": "单价($)/KG",
"orderServe": "服务类型",
"piece": "件数",
"weight": "计费重/LBS"
}
],
"err": "",
"msg": "数据请求成功!"
}
上次更新: 2023/07/17, 02:58:45