今麦郎

提交退机申请

POST

/device-return/submit-device-return

退机申请相关接口

请求参数

Authorization

在 header 添加参数

access-token

示例：

access-token: ********************

Body 参数application/json

applyName

string

申请人

可选

assetCode

string

设备条码

可选

businessAgentId

integer <int64>

业代 id

可选

cardNumber

string

退款卡号

可选

channelKey

string

门店渠道key

可选

channelName

string

门店渠道名称

可选

city

string

城市

可选

cityCode

string

城市code

可选

contactAddress

string

联系人地址

可选

contactName

string

联系人

可选

contactPhone

string

联系人电话

可选

customerAddress

string

客户地址

可选

customerCode

string

客户编码

可选

customerId

integer <int64>

客户 id

可选

customerLevel

string

客户阶别

可选

customerName

string

客户

可选

deviceBrand

string

设备品牌

可选

deviceModel

string

设备规格

可选

district

string

区县

可选

districtCode

string

区县Code

可选

frontViewUrl

string

效果图

可选

integer <int64>

唯一标识

可选

lat

number

纬度

可选

lon

number

经度

可选

note

string

备注

可选

photoResult

integer <int32>

可选

资质识别结果(-1->未知;0->未通过;1>通过)

photoResultDesc

string

资质识别结果描述

可选

photoUrl

string

可选

门店资质照片,多个用逗号隔开

processId

string

关联审批流程id

可选

province

string

省份

可选

provinceCode

string

省份code

可选

reason

integer <int32>

可选

退机原因(0->冰箱质量问题;1->冰箱性能问题;2->不想要了)

recentPhotoId

string

可选

设备近三天照片id,关联smart_detect_photo_daily,多个用逗号隔开

serialNumber

string

申请单号

可选

sourceType

integer <int32>

可选

(0->今麦便利-店主版;1->今麦便利-便利版;2->勤策;3->网点通)

warehouseVirtuallyId

integer <int64>

仓库id

可选

示例

{
    "applyName": "string",
    "assetCode": "string",
    "businessAgentId": 0,
    "cardNumber": "string",
    "channelKey": "string",
    "channelName": "string",
    "city": "string",
    "cityCode": "string",
    "contactAddress": "string",
    "contactName": "string",
    "contactPhone": "string",
    "customerAddress": "string",
    "customerCode": "string",
    "customerId": 0,
    "customerLevel": "string",
    "customerName": "string",
    "deviceBrand": "string",
    "deviceModel": "string",
    "district": "string",
    "districtCode": "string",
    "frontViewUrl": "string",
    "id": 0,
    "lat": 0,
    "lon": 0,
    "note": "string",
    "photoResult": 0,
    "photoResultDesc": "string",
    "photoUrl": "string",
    "processId": "string",
    "province": "string",
    "provinceCode": "string",
    "reason": 0,
    "recentPhotoId": "string",
    "serialNumber": "string",
    "sourceType": 0,
    "warehouseVirtuallyId": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/device-return/submit-device-return' \
--header 'Content-Type: application/json' \
--header 'access-token;' \
--data-raw '{
    "applyName": "string",
    "assetCode": "string",
    "businessAgentId": 0,
    "cardNumber": "string",
    "channelKey": "string",
    "channelName": "string",
    "city": "string",
    "cityCode": "string",
    "contactAddress": "string",
    "contactName": "string",
    "contactPhone": "string",
    "customerAddress": "string",
    "customerCode": "string",
    "customerId": 0,
    "customerLevel": "string",
    "customerName": "string",
    "deviceBrand": "string",
    "deviceModel": "string",
    "district": "string",
    "districtCode": "string",
    "frontViewUrl": "string",
    "id": 0,
    "lat": 0,
    "lon": 0,
    "note": "string",
    "photoResult": 0,
    "photoResultDesc": "string",
    "photoUrl": "string",
    "processId": "string",
    "province": "string",
    "provinceCode": "string",
    "reason": 0,
    "recentPhotoId": "string",
    "serialNumber": "string",
    "sourceType": 0,
    "warehouseVirtuallyId": 0
}'

返回响应

🟢200成功

*/*

Body

code

string

可选

data

string

可选

message

string

可选

success

boolean

可选

示例

{
    "code": "string",
    "data": "string",
    "message": "string",
    "success": true
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

退机列表

校验app版本