未处理货件列表（第三版）

返回指定时间段的未处理货件列表 —— 不应超过一年。

可能的货件运输状态：

awaiting_registration — 等待注册，

acceptance_in_progress — 正在验收，

awaiting_approve — 等待确认，

awaiting_packaging — 等待包装，

awaiting_deliver — 等待装运，

arbitration — 仲裁，

client_arbitration — 快递客户仲裁，

delivering — 运输中，

driver_pickup — 司机处，

cancelled — 已取消，

not_accepted — 分拣中心未接受，

sent_by_seller – 由卖家发送。

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

dir

string

可选

分类方向：

asc — 从小到大，

desc — 从大到小。

filter

object (object)

必需

请求过滤。

请按装运时间使用过滤器 — cutoff, 或者按照货件交付给快递的时间 — delivering_date。
如果一起使用，则会在响应中返回错误。

要按装运时间使用过滤器，请填 cutoff_from 和 cutoff_to字段。

要按货件交付给快递的时间使用过滤器, 请填 delivering_date_from 和 delivering_date_to字段。

cutoff_from

string <date-time>

必需

按卖家需要收订单的时间进行筛选。时间段开始。

格式： YYYY-MM-DDThh:mm:ss.mcsZ.
例子： 2020-03-18T07:34:50.359Z.

cutoff_to

string <date-time>

必需

按卖家需要收订单的时间进行筛选。时间段结束。

格式： YYYY-MM-DDThh:mm:ss.mcsZ.
例子： 2020-03-18T07:34:50.359Z.

delivering_date_from

string <date-time>

可选

将货件交给物流的最快日期。

delivering_date_to

string <date-time>

可选

将货件交给物流的最迟日期。

delivery_method_id

array[integer <int64>]

可选

快递方式ID。按照运输方式筛选。可以使用方法 /v1/delivery-method/list获取。

fbpFilter

string

可选

从合作伙伴仓库（FBP）发货时的货件筛选器：

ALL — 响应中将显示所有符合其他筛选器条件的货件；

ONLY — 仅显示FBP货件；

WITHOUT — 显示除FBP外的所有货件。

默认值为 ALL。

provider_id

array[integer <int64>]

可选

快递服务ID。按照运输方式筛选。可以使用方法 /v1/delivery-method/list获取。

status

string

可选

货件运输状态：

acceptance_in_progress — 正在验收，

awaiting_approve — 等待确认，

awaiting_packaging — 等待包装，

awaiting_registration — 等待注册，

awaiting_deliver — 等待装运，

arbitration — 仲裁，

client_arbitration — 快递客户仲裁，

delivering — 运输中，

driver_pickup — 司机处，

not_accepted — 分拣中心未接受。

warehouse_id

array[integer <int64>]

可选

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

limit

integer <int64>

必需

响应中值的数量：

最大值 — 1000，

最小值 — 1。

offset

integer <int64>

必需

将在响应中跳过的元素数。例如，如果“offset=10”，那么响应将从找到的第11个元素开始。

with

object (object)

可选

要添加到响应的附加字段。

analytics_data

boolean

可选

将分析数据添加到响应中。

barcodes

boolean

可选

将货件条形码添加到响应中。

financial_data

boolean

可选

将财务数据添加到响应中。

legal_info

boolean

可选

将法律信息添加到响应中。

translit

boolean

完成返回值的拼写。

可选

示例

{
    "dir": "ASC",
    "filter": {
        "cutoff_from": "2021-08-24T14:15:22Z",
        "cutoff_to": "2021-08-31T14:15:22Z",
        "delivery_method_id": [],
        "provider_id": [],
        "status": "awaiting_packaging",
        "warehouse_id": []
    },
    "limit": 100,
    "offset": 0,
    "with": {
        "analytics_data": true,
        "barcodes": true,
        "financial_data": true,
        "legal_info": false,
        "translit": true
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

未处理货件列表

Body

result

object (object)

请求结果。

可选

count

integer <int64>

可选

在响应中的元素计数器。

postings

array[object (object) {25}]

可选

货件清单和每个货物的详细信息。

示例

{
    "result": {
        "postings": [
            {
                "posting_number": "23713478-0018-3",
                "order_id": 559293114,
                "order_number": "33713378-0051",
                "status": "awaiting_packaging",
                "delivery_method": {
                    "id": 15110442724000,
                    "name": "Ozon 物流快递员，莫斯科",
                    "warehouse_id": 15110442724000,
                    "warehouse": "列宁街道仓库",
                    "tpl_provider_id": 24,
                    "tpl_provider": "Ozon Логистика"
                },
                "tracking_number": "",
                "tpl_integration_type": "ozon",
                "in_process_at": "2021-08-25T10:48:38Z",
                "shipment_date": "2021-08-26T10:00:00Z",
                "delivering_date": null,
                "optional": {
                    "products_with_possible_mandatory_mark": [
                        0
                    ]
                },
                "cancellation": {
                    "cancel_reason_id": 0,
                    "cancel_reason": "",
                    "cancellation_type": "",
                    "cancelled_after_ship": false,
                    "affect_cancellation_rating": false,
                    "cancellation_initiator": ""
                },
                "customer": null,
                "products": [
                    {
                        "price": "1259",
                        "currency_code": "RUB",
                        "offer_id": "УТ-0001365",
                        "name": "球，颜色： 黑色, 5千克",
                        "sku": 140048123,
                        "quantity": 1
                    }
                ],
                "addressee": null,
                "barcodes": {
                    "upper_barcode": "%101%806044518",
                    "lower_barcode": "23024930500000"
                },
                "analytics_data": {
                    "region": "圣彼得堡",
                    "city": "圣彼得堡",
                    "delivery_type": "PVZ",
                    "is_premium": false,
                    "payment_type_group_name": "付款卡",
                    "warehouse_id": 15110442724000,
                    "warehouse": "列宁街道仓库",
                    "tpl_provider_id": 24,
                    "tpl_provider": "Ozon物流",
                    "delivery_date_begin": "2022-08-28T14:00:00Z",
                    "delivery_date_end": "2022-08-28T18:00:00Z",
                    "is_legal": false
                },
                "financial_data": {
                    "products": [
                        {
                            "commission_amount": 0,
                            "commission_percent": 0,
                            "payout": 0,
                            "product_id": 140048123,
                            "old_price": 1888,
                            "price": 1259,
                            "total_discount_value": 629,
                            "total_discount_percent": 33.32,
                            "actions": [
                                "卖家的系统虚拟折扣"
                            ],
                            "quantity": 1
                        }
                    ]
                },
                "is_express": false,
                "legal_info": {
                    "company_name": "string",
                    "inn": "string",
                    "kpp": "string"
                },
                "requirements": {
                    "products_requiring_gtd": [],
                    "products_requiring_country": []
                },
                "tariffication": [
                    {
                        "current_tariff_rate": 0,
                        "current_tariff_type": "",
                        "current_tariff_charge": "",
                        "current_tariff_charge_currency_code": "",
                        "next_tariff_rate": 0,
                        "next_tariff_type": "",
                        "next_tariff_charge": "",
                        "next_tariff_starts_at": "2023-11-13T08:05:57.657Z",
                        "next_tariff_charge_currency_code": ""
                    }
                ]
            }
        ],
        "count": 55
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误

未处理货件列表 （第三 版）

请求参数

示例代码

返回响应

未处理货件列表（第三版）