Shipping Solution API 文档 Shipping Solution API 文档
首页
  • 商户获取token(通用)
  • UPS下单
  • UPS费用预览
  • UPS发件地信息
  • MI下单
  • MI费用预览
  • LSO下单
  • LSO费用预览
  • LSO轨迹查询
  • UPS轨迹查询
  • Fedex下单
  • Fedex费用预览
  • Fedex轨迹查询
  • Amazon下单
  • Amazon费用预览
  • Amazon轨迹查询
  • 返回单号和费用(通用)
  • 退款申请(通用)
  • 返回面单(通用)
  • FEDEX发件地信息
  • 下单常见问题
首页
  • 商户获取token(通用)
  • UPS下单
  • UPS费用预览
  • UPS发件地信息
  • MI下单
  • MI费用预览
  • LSO下单
  • LSO费用预览
  • LSO轨迹查询
  • UPS轨迹查询
  • Fedex下单
  • Fedex费用预览
  • Fedex轨迹查询
  • Amazon下单
  • Amazon费用预览
  • Amazon轨迹查询
  • 返回单号和费用(通用)
  • 退款申请(通用)
  • 返回面单(通用)
  • FEDEX发件地信息
  • 下单常见问题
  • 接口说明

    • 接口说明
    • 更新日志
  • 接口定义

    • 商户获取token(通用)
    • UPS下单
    • UPS费用预览
    • UPS轨迹查询
    • UPS发件地信息
    • MI渠道下单
    • MI渠道费用预览
    • LSO下单
    • LSO费用预览
      • 请求参数
      • 返回结果
    • LSO轨迹查询
    • Fedex下单
    • Fedex费用预览
    • Fedex轨迹查询
    • Fedex发件地信息
    • AMAZON下单
    • AMAZON费用预览
    • AMAZON轨迹查询
    • AMAZON发件地信息
    • 返回单号和费用(通用)
    • 退款申请(通用)
    • 返回面单(通用)
目录

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:- 下单请求逻辑
    1. 商户获取token(通用) (opens new window) :获取到token,后续接口需要使用此token校验请求合法性
    2. LSO费用预览 (opens new window) :进行运价预览(系统要求调用方先获取价格再进行下单)
    3. LSO下单 (opens new window) :进行下单请求(系统为异步下单,请调用下单后稍后主动调用返回单号和费用(通用) (opens new window) 接口获取下单情况或使用回调方式)
    4. 返回单号和费用(通用) (opens new window) :运单下单后,系统需要异步去执行下单逻辑,期间会存在一定的时间差,所以下单后请稍微间隔几秒后再行调用查询接口。若查询接口返回的code不为200,当code=1024时表示 平台下单还未完成,您可以稍后重试查询直到code为200时获取运单信息,再根据运单状态判断执行后续业务逻辑,其余code值则为下单失败。
    5. 返回面单(通用) (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
LSO下单
LSO轨迹查询

← LSO下单 LSO轨迹查询→

Theme by Vdoing | Copyright © 2022-2025 hnfsu
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式