FBO和FBS退货信息 - Ozon Seller API

请求参数

Body 参数application/json

filter

object (object)

可选

筛选条件。在请求中仅使用一个筛选器：logistic_return_date、storage_tariffication_start_date 或visual_status_change_moment，否则会返回错误。

logistic_return_date

object (object)

可选

根据退货创建日期筛选。

storage_tariffication_start_date

object (object)

可选

根据存储费用开始日期筛选。

visual_status_change_moment

object (object)

可选

根据退货状态变更日期筛选。

order_id

integer <int64>

根据订单ID筛选。

可选

posting_numbers

array[string]

可选

根据货件编号筛选。请勿传递超过 50 个货盒单号。

product_name

string

根据商品名称筛选。

可选

offer_id

string

根据商品货号筛选。

可选

visual_status_name

string

可选

根据退货状态筛选：

DisputeOpened — 与买家有争议；

OnSellerApproval — 等待卖家批准；

ArrivedAtReturnPlace — 到达取货点；

OnSellerClarification — 等待卖家确认；

OnSellerClarificationAfterPartialCompensation — 部分补偿后等待卖家确认；

OfferedPartialCompensation — 提供部分补偿；

ReturnMoneyApproved — 退货款项已批准；

PartialCompensationReturned — 部分款项已退还；

CancelledDisputeNotOpen — 退货被拒绝，争议未开启；

Rejected — 申请被拒绝；

CrmRejected — Ozon拒绝申请；

Cancelled — 申请已取消；

Approved — 卖家批准了申请；

ApprovedByOzon — Ozon批准了申请；

ReceivedBySeller —卖家已收到退货；

MovingToSeller — 退货正在运往卖家；

ReturnCompensated —卖家已获得补偿；

ReturningToSellerByCourier — 快递员正在将退货送回卖家；

Utilizing — 正在销毁中；

Utilized — 已销毁；

MoneyReturned — 已退还全款给买家；

PartialCompensationInProcess — 部分退款已批准；

DisputeYouOpened — 卖家提出争议；

CompensationRejected — 补偿被拒绝；

DisputeOpening — 已向客服发送请求；

CompensationOffered — 等待您对补偿的决定；

WaitingCompensation —等待补偿；

SendingError — 发送客服请求时发生错误；

CompensationRejectedBySla — 补偿请求过期；

CompensationRejectedBySeller — 卖家拒绝补偿；

MovingToOzon — 正在运往Ozon仓库；

ReturnedToOzon — 已返回Ozon仓库；

MoneyReturnedBySystem — 快速退款；

WaitingShipment — 等待发货。

warehouse_id

integer <int64>

可选

根据仓库ID筛选。可以使用方法 /v1/warehouse/list获取。

barcode

string

可选

根据退货标签条形码筛选。

return_schema

string

可选

根据配送方案筛选：FBS 或FBO。

limit

integer <int32>

加载的退货数量。

必需

<= 500

last_id

integer <int64>

可选

最后加载的退货ID。

示例

{
    "filter": {
        "logistic_return_date": {
            "time_from": "2019-08-24T14:15:22Z",
            "time_to": "2019-08-24T14:15:22Z"
        },
        "storage_tariffication_start_date": {
            "time_from": "2019-08-24T14:15:22Z",
            "time_to": "2019-08-24T14:15:22Z"
        },
        "visual_status_change_moment": {
            "time_from": "2019-08-24T14:15:22Z",
            "time_to": "2019-08-24T14:15:22Z"
        },
        "order_id": "0",
        "posting_numbers": [
            "string"
        ],
        "product_name": "string",
        "offer_id": "string",
        "visual_status_name": "string",
        "warehouse_id": "911",
        "barcode": "string",
        "return_schema": "FBO"
    },
    "limit": 500,
    "last_id": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

退货信息

Body

returns

array[object (object) {19}]

退货信息。

可选

exemplars

array[object (object) {1}]

退货实例信息。

可选

integer <int64>

退货ID。

可选

company_id

integer <int64>

卖家ID。

可选

return_reason_name

string

退货或取消的原因。

可选

type

string

可选

退货类型：
Cancellation - 取消订单（交货前）；
FullReturn - 完全拒收（交货时）；
PartialReturn - 部分拒收（交货时）；
ClientReturn - 客户退货（交货后）；
Unknown - 技术退货。

schema

string

可选

退货方案：
FBS；
FBO。

order_id

integer <int64>

订单ID。

可选

order_number

string

订单编号。

可选

place

object (object)

可选

退货所在仓库的信息。

target_place

object (object)

可选

退货运往的仓库信息。

storage

object (object)

存储信息。

可选

product

object (object)

商品信息。

可选

logistic

object (object)

退货信息。

可选

visual

object (object)

退货状态信息。

可选

additional_info

object (object)

其他信息。

可选

source_id

integer <int64>

先前的退货ID。

可选

posting_number

string

货件编号。

可选

clearing_id

integer <int64>

初始货件条形码。

可选

return_clearing_id

integer <int64>

可选

初始货件的退货条形码。

has_next

boolean

可选

如果卖家有其他退货，显示true。

示例

{
    "returns": [
        {
            "exemplars": [
                {
                    "id": "1019562967545956"
                }
            ],
            "id": "1000015552",
            "company_id": "3058",
            "return_reason_name": "买家拒绝取货：对商品质量不满意",
            "type": "FullReturn",
            "schema": "Fbs",
            "order_id": "24540784250",
            "order_number": "58544282-0057",
            "place": {
                "id": "23869688194000",
                "name": "СЦ_Львовский_Возвраты",
                "address": "Россия, обл. Московская, г. Подольск, промышленная зона Львовский, ул. Московская, д. 69, стр. 5"
            },
            "target_place": {
                "id": "23869688194000",
                "name": "СЦ_Львовский_Возвраты",
                "address": "Россия, обл. Московская, г. Подольск, промышленная зона Львовский, ул. Московская, д. 69, стр. 5"
            },
            "storage": {
                "sum": {
                    "currency_code": "RUB",
                    "price": "1231"
                },
                "tariffication_first_date": "2024-07-30T06:15:48.998146Z",
                "tariffication_start_date": "2024-07-29T06:15:48.998146Z",
                "arrived_moment": "2024-07-29T06:15:48.998146Z",
                "days": "0",
                "utilization_sum": {
                    "currency_code": "RUB",
                    "price": "1231"
                },
                "utilization_forecast_date": "2024-07-29T06:15:48.998146Z"
            },
            "product": {
                "sku": "1100526203",
                "offer_id": "81451",
                "name": "Кукла Дотти Плачущий младенец Cry Babies Dressy Dotty",
                "price": {
                    "currency_code": "RUB",
                    "price": "3318"
                },
                "price_without_commission": {
                    "currency_code": "RUB",
                    "price": "3318"
                },
                "commission_percent": "1.2",
                "commission": {
                    "currency_code": "RUB",
                    "price": "2312"
                }
            },
            "logistic": {
                "technical_return_moment": "2024-07-29T06:15:48.998146Z",
                "final_moment": "2024-07-29T06:15:48.998146Z",
                "cancelled_with_compensation_moment": "2024-07-29T06:15:48.998146Z",
                "return_date": "2024-07-29T06:15:48.998146Z",
                "barcode": "ii5275210303"
            },
            "visual": {
                "status": {
                    "id": 3,
                    "display_name": "在取货点",
                    "sys_name": "ArrivedAtReturnPlace"
                },
                "change_moment": "2024-07-29T06:15:48.998146Z"
            },
            "additional_info": {
                "is_opened": true,
                "is_super_econom": false
            },
            "source_id": "90426223",
            "posting_number": "58544282-0057-1",
            "clearing_id": "21190893156000",
            "return_clearing_id": null
        }
    ],
    "has_next": false
}

🔴500服务器错误