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

异步方法：

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

保存份数数据。

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

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

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

仅适用于状态为 awaiting_packaging（等待包装）的货件，否则会返回错误 INVALID_POSTING_STATE。

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

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

与 /v4/fbs/posting/product/exemplar/set 之间的区别为 — 您可以在请求中传达更多的样件信息。

响应代码200并不保证商品数据已被接受。
它表示已创建任务以添加信息。
要检查任务状态，请使用方法/v4/fbs/posting/product/exemplar/status。

请求参数

Header 参数

Client-Id

string

用户识别号。

必需

Api-Key

string

API-密钥。

必需

Body 参数application/json

multi_box_qty

integer <int32>

可选

商品包装的箱子数量。

posting_number

string

发货号。

必需

products

array[object (v5FbsPostingProductExemplarSetV5RequestProduct) {6}]

商品清单。

必需

exemplars

array[object (v5FbsPostingProductExemplarSetV5RequestProductExemplar) {7}]

副本信息。

可选

is_gtd_needed

boolean

可选

说明需要递交产品和货件的货物报关单号码。

is_mandatory_mark_needed

boolean

可选

说明需要将标志递交给“诚实标志”。

is_rnpt_needed

boolean

可选

说明需要递交商品批次号码。

product_id

integer <int64>

必需

卖家系统中的商品标识符 — product_id。

quantity

integer <int32>

样件数量。

可选

示例

{
    "multi_box_qty": 0,
    "posting_number": "string",
    "products": [
        {
            "exemplars": [
                {
                    "exemplar_id": 0,
                    "gtd": "string",
                    "is_gtd_absent": true,
                    "is_rnpt_absent": true,
                    "mandatory_mark": "string",
                    "rnpt": "string",
                    "jw_uin": "string"
                }
            ],
            "is_gtd_needed": true,
            "is_mandatory_mark_needed": true,
            "is_rnpt_needed": true,
            "product_id": 0,
            "quantity": 0
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

请求已处理

Body

result

boolean

可选

请求处理结果。如果请求已被成功处理，那么结果将为true。

示例

{
    "result": true
}

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

请求参数

示例代码

返回响应