Ozon Seller API

检查并保存份数数据

POST

/v4/fbs/posting/product/exemplar/set

FBS&rFBSMarks

异步方法：

检查在“诚信标志”系统中流通份数的存在性；

保存份数数据。

为了获取已创建样件的数据，请使用 /v5/fbs/posting/product/exemplar/create-or-get方式。

必要时请在gtd参数中指出货运报关单号。如果没有，请赋值 is_gtd_absent = true。

如果您在一批货件中有多个相同的商品, 请为货件中的每个商品指出一个 product_id 和一组exemplars 。

请始终传输全套份数和商品数据。

例如，如果在您的系统里有10份。您已赋值并检查和储存。然后在自己的系统中还添加了60份。
当重新提交份数以供审查和保存时，请指出所有新旧份数。

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

posting_number

string

发货号。

可选

products

array[object (object) {2}]

商品清单。

可选

exemplars

array[object (object) {5}]

副本信息。

可选

product_id

integer <int64>

可选

在Ozon系统中的FBS商品ID — SKU。

示例

{
    "posting_number": "23281294-0063-2",
    "products": [
        {
            "exemplars": [
                {
                    "gtd": "",
                    "is_gtd_absent": true,
                    "mandatory_mark": "010290000151642731tVMohkbfFgunB"
                }
            ],
            "product_id": 476925391
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-seller.ozon.ru/v4/fbs/posting/product/exemplar/set' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "posting_number": "23281294-0063-2",
    "products": [
        {
            "exemplars": [
                {
                    "gtd": "",
                    "is_gtd_absent": true,
                    "mandatory_mark": "010290000151642731tVMohkbfFgunB"
                }
            ],
            "product_id": 476925391
        }
    ]
}'

返回响应

🟢200成功

application/json

请求已处理

Body

result

boolean

可选

处理请求的结果。 true，如果请求成功。

示例

{
    "result": true
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误

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

标志代码验证

检查并保存份数数据 (第5方案)