申诉

提交申诉

接口说明

用户针对任务识别结果发起申诉或复核，并描述具体问题及原因。

请求信息

配置说明	参数值
URL	/appeal
Method	POST
Content-Type	application/json

Body参数

参数名	类型	描述	是否必填
plan_id	string	访店计划id	是
scene_code	string	场景编码	是
appeal_user	string	申诉用户	是
appeal_time	int64	用户提交申诉时间（毫秒时间戳）	是
appeals	[]object	申诉清单	是
+ task_id	string	任务id	是
+ problems	[]object	问题列表	是
++ problem_category	int32	问题类型 1: 分销识别 2: 数量KPI 3: 质量KPI	是
++ problem_code	string	问题键值：分销时为barcode，数量和质量时为具体的KPI编码	是
++ wrong_type	int32	错误类型 - 分销识别： 10: 在架显示不在架 11: 不在架显示在架 12: 价格识别错误 - 数量KPI： 20: 数量小于预期 21: 数量大于预期 - 质量KPI： 30: 合格显示不合格 31: 不合格显示合格	是
++ remark	string	备注	是
++ proof_photos	[]string	证明照片列表	否
callback_url	string	申诉回调url，具体回调规则请查看callback通知, 回调的具体数据结构查看申诉结果推送	是

Body数据样例

{
    "plan_id":"P2207290611226274600",
    "scene_code":"ST-169-1",
    "appeal_user":"visitor_01",
    "appeal_time":1677808307000,
    "appeals": [
        {
            "task_id":"8a2a4c10-1aa1-11f0-bda7-2be9caeeb110",
            "problems":[
                {
                    "problem_category":1,
                    "problem_code":"6903148045060",
                    "wrong_type":10,
                    "remark":"问题描述备注",
                    "proof_photos":["https://xxx.jpg","https://xxx.jpg"]
                }
            ]
        }
    ],
    "callback_url": "https://www.clobotics.cn/callback"
}

响应数据

data数据格式

参数名	类型	描述
appeal_id	string	创建的申诉id

响应数据样例

{
  "code": 0,
  "message": "",
  "data": {
    "appeal_id": "A2207290611226274600"
  }
}

复申

接口说明

用户对申诉结果有异议时，重新提交复审。

请求信息

配置说明	参数值
URL	/appeal/<appeal_id>
Method	PUT
Content-Type	application/json

路径参数

参数名	类型	描述	是否必填
appeal_id	string	要复核的申诉id	是

Body参数

参数名	类型	描述	是否必填
reappeal_id	string	复审请求id，每次复申唯一	是
reappeal_time	int64	用户复申时间（毫秒时间戳）	是
reason	string	复审理由	是
callback_url	string	复申回调url，具体回调规则请查看callback通知, 回调的具体数据结构查看申诉结果推送	是

Body数据样例

{
    "reappeal_id":"A2207290611226274600_1",
    "reappeal_time":1677808307000,
    "reason":"货架质量第2项应为通过",
    "callback_url": "https://www.clobotics.cn/callback"
}

响应数据

data数据格式

参数名	类型	描述
appeal_id	string	申诉id
reappeal_id	string	复申请求id

响应数据样例

{
  "code": 0,
  "message": "",
  "data": {
    "appeal_id": "A2207290611226274600",
    "reappeal_id": "A2207290611226274600_1"
  }
}