按照ID获取货件信息

POST

/v3/posting/fbs/get

FBS

请求参数

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

可选

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

legal_info

boolean

可选

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

product_exemplars

boolean

可选

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

related_postings

boolean

可选

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

translit

boolean

完成返回值的拼写。

可选

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-seller.ozon.ru/v3/posting/fbs/get' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "posting_number": "57195475-0050-3",
    "with": {
        "analytics_data": false,
        "barcodes": false,
        "financial_data": false,
        "legal_info": false,
        "product_exemplars": false,
        "related_postings": true,
        "translit": false
    }
}'

返回响应

🟢200成功

application/json

货件信息

Body

result

object (object)

货件信息。

可选

additional_data

array[object (object) {2}]

可选

addressee

object (object)

收件人联系方式。

可选

analytics_data

object (object)

分析数据。

可选

available_actions

array[string]

可选

可用的操作和货件信息包括：

arbitration — 提出争议；

awaiting_delivery — 转为“等待发运”状态；

can_create_chat — 与买家开启聊天；

cancel — 取消货件；

click_track_number — 在个人中心通过追踪号查看状态历史；

customer_phone_available — 获取买家电话号码；

has_weight_products — 货件中包含以重量结算；

hide_region_and_city — 在报告中隐藏买家的地区和城市；

invoice_get — 获取发票信息；

invoice_send — 创建发票；

invoice_update — 编辑发票；

label_download_big — 下载大标签；

label_download_small — 下载小标签；

label_download — 下载标签；

non_int_delivered — 转为“可能已收”状态；

non_int_delivering — 转为“运输中”状态；

non_int_last_mile — 转为“快递员派件中”状态；

product_cancel — 取消部分货件中的商品；

set_cutoff — 需要指定发货日期，请使用方法/v1/posting/cutoff/set；

set_timeslot — 修改买家的送货时间；

set_track_number — 指定或更改追踪号；

ship_async_in_process — 货件备货中；

ship_async_retry — 发生错误后重新发货；

ship_async — 备货货件；

ship_with_additional_info — 需要填写额外信息；

ship — 备货货件;

update_cis — 修改附加信息。

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。

legal_info

object (v2FboSinglePostingLegalInfo)

买方的法律信息。

可选

optional

object (object)

可选

带有附加特征的商品列表。

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 —— 由卖家发送。

previous_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

货件跟踪号。

可选

tariffication

array[object (v3FbsTariffication) {9}]

发运的计费信息。

可选

示例

{
    "result": {
        "posting_number": "57195475-0050-3",
        "order_id": 438764970,
        "order_number": "57195475-0050",
        "status": "awaiting_packaging",
        "substatus": "posting_awaiting_passport_data",
        "previous_substatus": "posting_transferring_to_delivery",
        "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": "",
        "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,
        "addressee": null,
        "products": [
            {
                "currency_code": "RUB",
                "price": "279.0000",
                "offer_id": "250-7898-1",
                "name": "醇香咖啡 \"巧克力香橙\" 250克",
                "sku": 180550365,
                "quantity": 1,
                "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,
        "legal_info": {
            "company_name": "string",
            "inn": "string",
            "kpp": "string"
        },
        "related_postings": {
            "related_posting_numbers": [
                "string"
            ]
        },
        "requirements": {
            "products_requiring_gtd": [],
            "products_requiring_country": []
        },
        "product_exemplars": null,
        "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": ""
            }
        ]
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误

修改于 2025-06-10 08:30:17

货件列表（第三版）

按条形码获取有关货件的信息