文档

测试

12.账单申诉

websocket测试

POST

api_method:u-bill-appeal

服务入口:

测试环境:https://openapi-stg.huolala.cn/v1 正式环境:https://openapi.huolala.cn/v1

调用注意事项

1.申诉是指什么？答:当司机发送了账单,用户收到账单后。如果用户对于司机账单中额外费用(高速费,停车费,等候费,搬运费)金额有异议。则可以发起申诉 2.外部应用何时显示申诉入口？答: - 当外部应用收到货拉拉账单通知后,可调“获取订单详情”接口,查询未付费用明细进行展示。 - 开发者判断订单详情中字段“appeal_enabled_status是否允许申诉”。如果值=1或者2则可以显示申诉入口 3.申诉结果通知？答:申诉处理完毕后,货拉拉会发出“申诉处理完毕通知”(详情请参考推送说明)。开发者收到推送消息后,可调订单详情接口,获取最新的订单状态及未付金额项

前端界面示例:

![image.png](https://cos.easydoc.net/48578360/files/k9455prj)

系统级请求参数

参数名

类型

描述

必填

api_method

string

接口方法

必填

api_version

string

接口版本，固定值:1.0

必填

app_key

string

应用唯一app_key

必填

access_token

string

货拉拉账户授权访问令牌

必填

nonce_str

string

随机数,用户自定义,60s内不可重复使用,用于确保请求不可重复

必填

timestamp

number

unix时间戳(单位:秒),时间戳应为60s内的值,超过60s则超时

必填

signature

string

签名值

必填

应用级请求参数

参数名

类型

描述

必填

order_display_id

string

货拉拉订单号

必填

type

number

申诉类型: 3 账单申述 4 费⽤协商

必填

appeal_items

object

申诉项

必填

bill_type

number

费用项ID

必填

name

string

费用项名称

必填

expect_fen

number

用户期望此项费用金额(单位:分)。(仅当type=4时,必传)

必填

desc

string

申诉描述说明

必填

响应参数

参数名

类型

描述

必填

ret

number

返回结果码，示例：0

必填

msg

string

返回结果描述，示例：

必填

data

object

数据字典

必填

请求json示例：

```json { "app_key":"*************************", "nonce_str":"12345", "timestamp":1574824293, "access_token":"****************", "order_display_id": "137100800068", "type":1, "desc": "账单⾦额太少了，要给多点", "img_url":"", "appeal_items":[{ "bill_type":1, "name":"⾼速费", "expect_fen":100 }] } ```

返回json示例:

```json { "ret": 0, "msg": "", "data": { } } ```

返回状态码说明

|ret状态码|描述| |-|-| |0|成功| |30012|订单ID错误|

上一篇 11.支付司机账单

nextDoc 13.查询历史订单记录