目录

接入规范

异常推送


当运单有异常时,通过客户提供的回调URL推送异常信息给客户

POST
api/sync/uploadAbnormal

系统请求参数


参数名
中文参数名 类型 是否必填 描述
appKey 应用key string 客户提供的appKey
signStr 签名 string 客户提供的appKey和客户提供的appSecret加密生成
timeStamp 请求时间戳 long 单位:秒

业务请求参数


参数名 中文参数名 类型 是否必填 描述
thirdSn

客户的询价单号

string 对应询价传递的客户单号
abnormalCode 异常编号 string 每一次异常上报,都会对应唯一的异常编号
exceptionName 异常上报时间戳 long
单位:秒
totalAbnormalPrice 异常总金额 double 如果异常为业务异常,传参0.0
abnormalList
异常数据集合 array[object]

abnormalList类型说明


参数名 中文参数名 类型 是否必填 描述
abnormalType 异常类型编码(key) string 详见帮助中心-帮助文档的异常类型表
abnormalPrice 异常金额 double 如果异常为业务异常,传参0.0
abnormalDesc 异常描述 string
feeType 费用类型编码(key) integer  否 详见帮助中心-帮助文档的费用类型表
remark 备注 string
abnormlPicture 异常图片地址 string 最多三张图片地址,逗号隔开

返回参数


参数名
中文参数名 类型 是否必填 描述
code

返回码

string code = 0,请求成功
code  =1 , message = "XXX为空",
code = 2 , message = "单号不存在"
code = 3, message = "上报异常类型不合法", "费用类型不合法"
message 描述 string

请求示例


{
  "thirdSn" : "2342343243",
  "abnormalCode" : "123421429sd0023",
  "exceptionName" : 152323435,
  "totalAbnormalPrice" : 2343,
  "abnormalList" :[{
    "abnormalType" : 1,
    "abnormalPrice": 2000,
    "abnormalDesc" : "货主原因不走货",
    "feeType" : 2,
    "remark" : "备注",
    "abnormlPicture" : "http://picture.XXXXX",
  },
  {
    "abnormalType" : 2,
    "abnormalPrice": 343,
    "abnormalDesc" : "压车",
    "feeType" : 2,
    "remark" : "备注",
    "abnormlPicture" : "http://picture.XXXXX",
  }]
}

返回示例

{
  response" : {
    "message" : "异常上报信息成功",
    "code" : 0
  }
}