文档

测试

12.申诉账单

websocket测试

POST

api_method:u-bill-appeal

调用注意事项

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

前端界面示例:

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

系统级请求参数

参数名

类型

描述

必填

api_method

string

接口方法名。请传“u-bill-appeal”

必填

api_version

string

接口版本号。请传固定值“1.0”

必填

app_key

string

开发者应用唯一app_key

必填

access_token

string

用户账户授权访问令牌

必填

nonce_str

string

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

必填

timestamp

number

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

必填

signature

string

签名值

必填

应用级请求参数(api_data数据结构)

参数名

类型

描述

必填

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 { "api_method":"u-bill-appeal", "api_version":"1.0", "app_key":"*****************", "access_token":"**********************", "signature":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "api_data":"{ \"order_display_id\":"137100800068\", \"type\":1, \"desc\":\"账单⾦额太少了，要给多点\", \"appeal_items\":[ { \"bill_type\":1, \"name\":\"⾼速费\", \"expect_fen\":100 } ] }" } ```

返回json示例:

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

返回状态码说明

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

上一篇 11.支付司机账单

nextDoc 13.查询历史下单记录