按照ID获取货件信息 - Ozon Seller API

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

示例值:

Api-Key

string

API-密钥。

必需

示例值:

Body 参数application/json

posting_number

string

货件ID。

可选

with

object (object)

可选

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

analytics_data

boolean

可选

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

barcodes

boolean

可选

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

financial_data

boolean

可选

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

product_exemplars

boolean

可选

将有关产品及其份数的数据添加到响应中。

related_postings

boolean

可选

将相关货件数量添加到响应中。相关货件是在组装期间将母快递拆分的快递。

translit

boolean

完成返回值的拼写。

可选

示例

{
  "posting_number": "57195475-0050-3",
  "with": {
    "analytics_data": false,
    "barcodes": false,
    "financial_data": false,
    "product_exemplars": false,
    "translit": false
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200货件信息

application/json

Body

result

object (object)

货件信息。

可选

additional_data

array[object (object) {2}]

可选

addressee

object (object)

收件人联系方式。

可选

analytics_data

object (object)

分析数据。

可选

barcodes

object (object)

货件条码。

可选

cancellation

object (object)

取消原因。

可选

courier

object (object)

快递员信息。

可选

customer

object (object)

买家信息。

可选

delivering_date

string <date-time>

可选

货件交付物流的时间。

delivery_method

object (object)

快递方式。

可选

delivery_price

string

物流价格。

可选

financial_data

object (object)

可选

有关商品成本、折扣幅度、付款和佣金的信息。

in_process_at

string <date-time>

可选

开始处理货件的日期和时间。

is_express

boolean

可选

如果使用了快速物流Ozon Express —— true。

order_id

integer <int64>

可选

货件所属的订单ID。

order_number

string

货件所属的订单号。

可选

parent_posting_number

string

可选

母件编号，由该母件拆分出了该货件。

posting_number

string

货件号。

可选

product_exemplars

object (object)

可选

有关产品及其副本的信息。

响应包含 product_exemplars字段, 如果在请求中传递标志 with.product_exemplars = true。

products

array[object (object) {8}]

货物装运的数组。

可选

provider_status

string

快递服务状态。

可选

related_postings

object (object)

相关货件。

可选

requirements

object (object)

可选

需要上传商品制造国、货运报关单号（Cargo Customs Declaration）、商品批次注册号（Product Batch Registration Number）和“诚信标志”标签的产品列表，以更新货件状态。

shipment_date

string <date-time>

可选

必须完成货件装配的日期和时间。如果在此日期之前未完成货件装配，则运输自动取消。

status

string

可选

货运状态:

acceptance_in_progress —— 正在验收，

arbitration —— 仲裁，

awaiting_approve —— 等待确认，

awaiting_deliver —— 等待装运，

awaiting_packaging —— 等待包装，

awaiting_registration —— 等待注册，

awaiting_verification —— 已创建，

cancelled —— 已取消，

cancelled_from_split_pending —— 已取消，

client_arbitration —— 快递客户仲裁，

delivered —— 已送达，

delivering —— 运输中，

driver_pickup —— 司机处，

not_accepted —— 分拣中心未接受，

sent_by_seller —— 由卖家发送。

substatus

string

可选

发货子状态：

posting_acceptance_in_progress —— 正在验收，

posting_in_arbitration —— 仲裁，

posting_created —— 已创建，

posting_in_carriage —— 在运输途中，

posting_not_in_carriage —— 未在运输中，

posting_registered —— 已登记，

posting_transferring_to_delivery (status=awaiting_deliver) —— 移交给快递，

posting_awaiting_passport_data —— 等待护照资料，

posting_created —— 已创建，

posting_awaiting_registration —— 等待注册，

posting_registration_error —— 注册错误，

posting_transferring_to_delivery (status=awaiting_registration) —— 交给快递员,

posting_split_pending —— 已创建，

posting_canceled —— 已取消，

posting_in_client_arbitration —— 快递会员仲裁，

posting_delivered —— 已送达，

posting_received —— 已收到，

posting_conditionally_delivered —— 暂时送到，

posting_in_courier_service —— 快递员正在路上，

posting_in_pickup_point —— 在取货点，

posting_on_way_to_city —— 发往城市途中，

posting_on_way_to_pickup_point —— 正发往取货点，

posting_returned_to_warehouse —— 返回仓库，

posting_transferred_to_courier_service —— 转交给快递员，

posting_driver_pick_up —— 在司机那儿，

posting_not_in_sort_center —— 集散中心未收到，

sent_by_seller —— 由卖家发送。

tpl_integration_type

string

可选

快递服务集成类型：

ozon —— 通过Ozon物流的快递。

aggregator —— 外部服务快递，Ozon注册订单。

3pl_tracking —— 外部服务快递，卖家注册订单。

non_integrated —— 卖家自行配送物流。

tracking_number

string

货件跟踪号。

可选

示例

{
  "result": {
    "posting_number": "57195475-0050-3",
    "order_id": 438764970,
    "order_number": "57195475-0050",
    "status": "awaiting_packaging",
    "substatus": "posting_awaiting_passport_data",
    "delivery_method": {
      "id": 18114520187000,
      "name": "Ozon独立物流，莫斯科",
      "warehouse_id": 18114520187000,
      "warehouse": "莫斯科主要",
      "tpl_provider_id": 24,
      "tpl_provider": "Ozon物流"
    },
    "tracking_number": "",
    "tpl_integration_type": "ozon",
    "in_process_at": "2021-11-20T09:14:16Z",
    "shipment_date": "2021-11-23T10:00:00Z",
    "delivering_date": null,
    "provider_status": "",
    "delivery_price": "",
    "cancellation": {
      "cancel_reason_id": 0,
      "cancel_reason": "",
      "cancellation_type": "",
      "cancelled_after_ship": false,
      "affect_cancellation_rating": false,
      "cancellation_initiator": ""
    },
    "customer": null,
    "addressee": null,
    "products": [
      {
        "currency_code": "RUB",
        "price": "279.0000",
        "offer_id": "250-7898-1",
        "name": "醇香咖啡 \"巧克力香橙\" 250克",
        "sku": 180550365,
        "quantity": 1,
        "mandatory_mark": [],
        "dimensions": {
          "height": "40.00",
          "length": "240.00",
          "weight": "260",
          "width": "140.00"
        }
      }
    ],
    "barcodes": null,
    "analytics_data": null,
    "financial_data": null,
    "additional_data": [],
    "is_express": false,
    "requirements": {
      "products_requiring_gtd": [],
      "products_requiring_country": []
    },
    "product_exemplars": null
  }
}

🟠400参数有误

🟠403访问拒绝

🟠404无响应

🟠409请求冲突

🔴500服务器内部错误