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

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

可能的货件运输状态：

awaiting_registration — 等待注册，

acceptance_in_progress — 正在验收，

awaiting_approve — 等待确认，

awaiting_packaging — 等待包装，

awaiting_deliver — 等待装运，

arbitration — 仲裁，

client_arbitration — 快递客户仲裁，

delivering — 运输中，

driver_pickup — 司机处，

delivered — 已送达，

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。

可选

fbpFilter

string

可选

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

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

only — 仅显示FBP货件；

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

默认值为 all。

FBP方案仅适用于中国卖家。

provider_id

array[integer <int64>]

快递服务ID。

可选

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。

可选

limit

integer <int64>

可选

响应中值的数量：

最大值 — 1000，

最小值 — 1。

offset

integer <int64>

可选

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

with

object (object)

可选

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

analytics_data

boolean

可选

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

barcodes

boolean

可选

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

financial_data

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,
    "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) {21}]

可选

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

示例

{
  "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,
        "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,
            "mandatory_mark": []
          }
        ],
        "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": [
                "卖家的系统虚拟折扣"
              ],
              "picking": null,
              "quantity": 1,
              "client_price": "",
              "item_services": {
                "marketplace_service_item_fulfillment": 0,
                "marketplace_service_item_pickup": 0,
                "marketplace_service_item_dropoff_pvz": 0,
                "marketplace_service_item_dropoff_sc": 0,
                "marketplace_service_item_dropoff_ff": 0,
                "marketplace_service_item_direct_flow_trans": 0,
                "marketplace_service_item_return_flow_trans": 0,
                "marketplace_service_item_deliv_to_customer": 0,
                "marketplace_service_item_return_not_deliv_to_customer": 0,
                "marketplace_service_item_return_part_goods_customer": 0,
                "marketplace_service_item_return_after_deliv_to_customer": 0
              }
            }
          ],
          "posting_services": {
            "marketplace_service_item_fulfillment": 0,
            "marketplace_service_item_pickup": 0,
            "marketplace_service_item_dropoff_pvz": 0,
            "marketplace_service_item_dropoff_sc": 0,
            "marketplace_service_item_dropoff_ff": 0,
            "marketplace_service_item_direct_flow_trans": 0,
            "marketplace_service_item_return_flow_trans": 0,
            "marketplace_service_item_deliv_to_customer": 0,
            "marketplace_service_item_return_not_deliv_to_customer": 0,
            "marketplace_service_item_return_part_goods_customer": 0,
            "marketplace_service_item_return_after_deliv_to_customer": 0
          }
        },
        "is_express": false,
        "requirements": {
          "products_requiring_gtd": [],
          "products_requiring_country": []
        }
      }
    ],
    "count": 55
  }
}

🟠400参数错误

🟠403访问拒绝

🟠404无响应

🟠409请求冲突

🔴500服务器内部错误

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

请求参数

示例代码

返回响应

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