Open-Agent-Api

9.1 售后单申请

POST

/api/v2/aftersale/create

AfterSale

申请售后意愿单

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

channel

string

可选

默认值:

benlai

shopId

string

商城id

可选

默认值:

123

Body 参数application/json

申请模型

do_id

string

本网出库单号

必需

>= 10 字符<= 32 字符

type

string

服务类型

必需

EXCHANGE：换货
REFUND : 退货

>= 6 字符<= 10 字符

description

string

问题描述

可选

>= 0 字符<= 200 字符

description_img

array[string]

问题图片

可选

可多张,最多5张

contact

string

售后订单联系人

必需

>= 1 字符<= 20 字符

phone

string

售后订单联系人手机号

可选

手机号、电话两者必填一项

正则匹配:

^[1][0-9]{10}$

telephone

string

售后订单联系人电话

可选

手机号、电话两者必填一项

province

string

省

必需

>= 1 字符<= 20 字符

city

string

市

必需

>= 1 字符<= 20 字符

county

string

县（区）

必需

>= 1 字符<= 20 字符

receive_address

string

收货地址

必需

>= 1 字符<= 50 字符

product_list

array[object (Benlai.Open.Models.AfterSale.CreateProductInfo) {2}]

退换货商品列表

必需

product_id

string

商品编号

必需

>= 10 字符<= 32 字符

quantity

integer <int32>

商品数量

必需

out_rma_id

string

外部售后单号

可选

示例

{
  "out_rma_id": "RMAa7f3c562731645069e1687d21a4bc128",
  "do_id": "D661027264519",
  "type": "REFUND",
  "description": "商品包装破损",
  "description_img": [
    "http://example.com/img1.jpg",
    "http://example.com/img2.jpg"
  ],
  "contact": "张三",
  "phone": "13800138000",
  "telephone": null,
  "province": "北京市",
  "city": "北京市",
  "county": "朝阳区",
  "receive_address": "科技园南区",
  "product_list": [
    {
      "product_id": "P0000122741",
      "quantity": 1
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open-agent-branch.benlai.com/api/v2/aftersale/create' \
--header 'channel: benlai' \
--header 'shopId: 123' \
--header 'Content-Type: application/json' \
--data-raw '{
  "out_rma_id": "RMAa7f3c562731645069e1687d21a4bc128",
  "do_id": "D661027264519",
  "type": "REFUND",
  "description": "商品包装破损",
  "description_img": [
    "http://example.com/img1.jpg",
    "http://example.com/img2.jpg"
  ],
  "contact": "张三",
  "phone": "13800138000",
  "telephone": null,
  "province": "北京市",
  "city": "北京市",
  "county": "朝阳区",
  "receive_address": "科技园南区",
  "product_list": [
    {
      "product_id": "P0000122741",
      "quantity": 1
    }
  ]
}'

返回响应

🟢200成功

text/plain

Success

Body

退换货结果

rma_id

string

售后单号

可选

>= 10 字符<= 32 字符

out_rma_id

string

外部售后单号

可选

示例

成功示例异常示例

{
    "code": 0,
    "msg": "success",
    "value": {
        "rma_id": "8002098466"
    }
}

8.6 包裹单查询

9.2 获取可申请售后商品