• 接口说明： 提交平台进行MI渠道订单下单，下单结果需要异步通知或查询
• 请求方式： POST
• 接口地址： https://syco-api.logssc.com/external-interface/mi/orderCommit

请求参数

参数名称	类型	是否必填	描述
appId	String	true	商户APP-KEY
token	String	true	token
url	String	false	订单下单完成回调通知URL[详见说明]
orders	List<Object>	true	运单集合
customerNumber	String	true	客户单号
province	String	true	收件人所在州[缩写]
city	String	true	收件人所在城市
receiver	String	true	收件人
receiverPhone	String	true	收件人电话
receiveCompany	String	true	收件公司
postcode	String	true	收件邮编
address1	String	true	地址1
address2	String	false	地址2
nationCode	String	true	国家二字码（现限：US）
packWeight	Decimal	true	货箱重量
referenceNo1	String	true	UPS标签referenceNo1
referenceNo2	String	false	UPS标签referenceNo2
packageCode	Integer	true	服务类型，取值范围：62(Irregulars (OZ)),63(Parcel Post (LB)),67(Standard Flat (OZ))[详见说明] 。
systemSenderName	String	false	所选系统发件地viewName(可用发件地查询此接口：发件地信息 (opens new window))

请求示例：

{
  "token": "商户APP-KEY",
  "appId": "token",
  "orders": [
    {
      "referenceNo1": "备注1",
      "referenceNo2": "备注2",
      "province": "省州",
      "city": "城市",
      "receiver": "收件人",
      "receiverPhone": "收件人电话",
      "postcode": "收件邮编",
      "address1": "收件地址1",
      "address2": "收件地址2",
      "nationCode": "收件国家US",
      "receiveCompany": "收件公司",
      "customerNumber": "客户单号",
      "fbaCode": "系统仓库编码",
      "packWeight": "货箱重量",
      "packageCode": "服务类型|62  | Irregulars (OZ) ||63  | Parcel Post (LB) ||67  | Standard Flat (OZ) |",
      "systemSenderName": "发件地址"
    }
  ],
  "url": "订单下单完成回调通知URL"
}

返回结果

参数名称	类型	描述
data	List<Object>	下单结果集合
orderNumber	String	订单号
customerNumber	String	客户单号
packageCode	String	MI服务类型
packWeight	String	货箱重量
referenceNo1	String	UPS标签referenceNo1
referenceNo2	String	UPS标签referenceNo2
code	Integer	状态码
err	string	错误信息
msg	String	结果描述

返回示例：

{
    "code": 200,
    "data": [
      {
        "orderNumber": "订单号",
        "customerNumber": "客户单号",
        "packageCode": "MI服务类型",
        "packWeight": "货箱重量",
        "referenceNo1": "UPS标签referenceNo1",
        "referenceNo2": "UPS标签referenceNo2"
      }
    ],
    "err": "",
    "msg": "数据请求成功!"
}

回调通知

订单下单完成会主动往此接口推送单号和费用数据。当通知失败时,平台最多尝试5次,每次尝试间隔5分钟。下单成功时回调报文与接口返回单号和费用响应报文一致。与若一直没有收到回调请主动调用返回单号和费用 (opens new window)接口查询订单下单结果。

下单成功时回调报文示例：

{
  "code": 200,
  "data": {
    "serviceNumber": "服务商主单号",
    "orderNumber": "订单号",
    "customerNumber": "客户单号",
    "prepaidPrice": "运费金额",
    "averagePrice": "平均价格/KG",
    "status": "状态",
    "piece": "件数",
    "weight": "重量",
    "nationName": "所属国家名称",
    "province": "收件省",
    "city": "收件城市",
    "postcode": "收件邮编",
    "address1": "地址1",
    "address2": "地址2",
    "address3": "地址3",
    "closeWeightAll": "计费重量（LB）",
    "averageFee": "平均价格",
    "commission": "佣金",
    "totalWeightlbs": "计费总重量(LB)",
    "totalWeightkg": "计费总重量(KG)",
    "masterServiceNumbers":["服务商主单号1", "服务商主单号2"],
    "details": [
      {
        "serviceNumber":  "服务单号",
        "masterServiceNumber":  "服务主单号（区分拆单）",
        "referenceNo1":  "备注1",
        "referenceNo2":  "备注2",
        "packWeight":  "货箱重量",
        "packageCode":  "MI服务类型"
      }
    ]
  },
  "err": "",
  "msg": "订单下单已完成!"
}

下单失败时回调报文示例：

{
  "code": 1001,
  "data": {
    "orderNumber": "订单编号",
    "errorMessage": "下单失败的具体错误信息描述"
  },
  "err": "",
  "msg": "下单失败"
}

MI服务类型

编码	类型
62	Irregulars (OZ)
63	Parcel Post (LB)
67	Standard Flat (OZ)