获取有关FBS退货的信息

请求参数

Body 参数application/json

filter

object (object)

过滤器。

可选

accepted_from_customer_moment

object (object)

可选

收到卖家退货的时间。

last_free_waiting_day

object (object)

可选

免费储存的最后一天。

order_id

integer <int64>

订单ID。

可选

posting_number

array[string]

发货ID。

可选

product_name

string

商品名称。

可选

product_offer_id

string

商品货号。

可选

status

string

可选

退货状态：

returned_to_seller — 退还给卖家，

waiting_for_seller — 等待卖家操作，

accepted_from_customer — 从买家处接收，

cancelled_with_compensation — 取消补贴，

ready_for_shipment — 准备发货。

limit

integer <int64>

可选

响应中值的数量:

最大值 — 1000,

最小值 — 1。

last_id

integer <int64>

可选

页面上最后一个数值的编号。

要得到以下数值，请在以下查询的参数中中提交得到的数值 last_id。

示例

{
  "filter": {
    "accepted_from_customer_moment": {
      "time_from": "2019-08-24T14:15:22Z",
      "time_to": "2019-08-24T14:15:22Z"
    },
    "last_free_waiting_day": {
      "time_from": "2019-08-24T14:15:22Z",
      "time_to": "2019-08-24T14:15:22Z"
    },
    "order_id": 0,
    "posting_number": [
      "string"
    ],
    "product_name": "string",
    "product_offer_id": "string",
    "status": "string"
  },
  "limit": 0,
  "last_id": 0
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api-seller.ozon.ru/v3/returns/company/fbs' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filter": {
        "accepted_from_customer_moment": {
            "time_from": "2019-08-24T14:15:22Z",
            "time_to": "2019-08-24T14:15:22Z"
        },
        "last_free_waiting_day": {
            "time_from": "2019-08-24T14:15:22Z",
            "time_to": "2019-08-24T14:15:22Z"
        },
        "order_id": 0,
        "posting_number": [
            "string"
        ],
        "product_name": "string",
        "product_offer_id": "string",
        "status": "string"
    },
    "limit": 0,
    "last_id": 0
}'

返回响应

🟢200退货信息

application/json

Body

last_id

integer <int64>

可选

页面上最后一个数值的编号。

要得到以下数值，请在以下查询的参数中中提交得到的数值 last_id。

returns

array[object (object) {29}]

退货信息。

可选

accepted_from_customer_moment

string

可选

收到买家退货的时间。

clearing_id

integer <int64>

原始货件的条形码。

可选

commission

number <double>

佣金。

可选

commission_percent

number <double>

佣金百分比。

可选

exemplar_id

integer <int64>

可选

在Ozon物流系统中的实例ID。

id

integer <int64>

可选

在Ozon账户系统中的退货ID。

is_moving

boolean

可选

如果商品在运输途中 — true。

is_opened

boolean

可选

表示包装的开启。如果包装已被打开，则为 true。

last_free_waiting_day

string

可选

免费存储的最后一天。

place_id

integer <int64>

可选

商品运往的仓库ID。

moving_to_place_name

string

可选

商品运往的仓库名称。

picking_amount

number <double>

快递价格。

可选

posting_number

string

快递号。

可选

picking_tag

string

可选

price

number <double>

可选

当前不含折扣的商品价格。

price_without_commission

number <double>

可选

不含佣金的商品价格。

product_id

integer <int64>

商品ID。

可选

product_name

string

商品名称。

可选

quantity

integer <int64>

商品数量。

可选

return_barcode

string

可选

退货发货标签上的条形码。请使用这个参数值来处理退货标签。

return_clearing_id

integer <int64>

可选

在Ozon物流系统中的货位ID。

return_date

string

退货日期。

可选

return_reason_name

string

退货原因。

可选

waiting_for_seller_date_time

string

可选

商品准备好交付给卖家的日期。

returned_to_seller_date_time

string

可选

商品交付给卖家的日期。

waiting_for_seller_days

integer <int64>

可选

以天为单位的退货保留日期。

returns_keeping_cost

number <double>

退货保留价格。

可选

sku

integer <int64>

可选

Ozon上的商品ID。

status

string

退货状态。

可选

示例

{
  "last_id": 0,
  "returns": [
    {
      "accepted_from_customer_moment": "string",
      "clearing_id": 0,
      "commission": 0,
      "commission_percent": 0,
      "exemplar_id": 0,
      "id": 0,
      "is_moving": true,
      "is_opened": true,
      "last_free_waiting_day": "string",
      "place_id": 0,
      "moving_to_place_name": "string",
      "picking_amount": 0,
      "posting_number": "string",
      "picking_tag": "string",
      "price": 0,
      "price_without_commission": 0,
      "product_id": 0,
      "product_name": "string",
      "quantity": 0,
      "return_barcode": "string",
      "return_clearing_id": 0,
      "return_date": "string",
      "return_reason_name": "string",
      "waiting_for_seller_date_time": "string",
      "returned_to_seller_date_time": "string",
      "waiting_for_seller_days": 0,
      "returns_keeping_cost": 0,
      "sku": 0,
      "status": "string"
    }
  ]
}

🔴500错误