异常推送
当运单有异常时,通过客户提供的回调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",
}]
}
返回示例
{
status": {
"desc": "提交成功",
"code": 0
}
}