---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.3
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/fbs.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/fbs.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/fbs.md
  - href: zh/step-by-step/fbs.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt

# 处理过程 FBS-命令

Yandex Market API 它允许您执行在机柜中执行的所有相同操作：查看新订单，为其接收标签，必要时更改其中的某些内容，等等。

{% note tip "了解一切是如何发生的" %}

读吧 [一篇关于订单处理的文章](https://yandex.ru/support/marketplace/orders/fbs/process.html).

{% endnote %}

## 第1步。 接收订单 {#new-orders}

阅读说明: [接收订单 — 空气污染指数调查或通知](https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/orders-receive.md)

确保所有物品都有库存。 如果一切正常，请继续执行步骤2。 如果缺少某些内容，请先阅读说明。 [推迟、取消和减少订单](#cancel-by-seller).


## 第二步。 生成装配表 {#shipment-list}

生成需要时间，因此首先需要对生成本身提出请求，然后获取完成的装配表。

<!-- source: zh/_includes/mermaid/shipment-list.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as 您的店铺
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: 获取装箱单
        Merchant ->>+ Market: POST v2/reports/documents/shipment-list/generate
        Market ->> Market: 将装箱单<br>加入生成队列。
        Market -->>- Merchant: OK: 用于获取最终装箱单的标识符，<br>以及预计生成时间<br>(reportId + estimatedGenerationTime)。
    end

    opt
      rect rgb(251, 243, 232)
        note right of Merchant: 可选步骤
        note right of Merchant: 检查生成状态
        Merchant ->> Market: GET v2/reports/info/<report_id>
        Market -->> Merchant: OK: 状态及剩余时间<br>(status + estimatedGenerationTime)。
      end
    end

    rect rgb(251, 243, 232)
        note right of Merchant: 在estimatedGenerationTime指定时间后获取最终装箱单
        Merchant ->> Market: GET v2/reports/info/<report_id>
        Market -->> Merchant: OK: 状态及链接。<br>如果生成成功 — status = DONE + file。<br>如果生成失败 — status = FAILED 或 status = NODATA。
end
```
<!-- endsource: zh/_includes/mermaid/shipment-list.md -->

1. 提出要求 [POST v2/reports/documents/shipment-list/generate](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateShipmentListDocumentReport.md).
2. 要了解构建表是否已准备就绪，请提出请求 [GET v2/reports/info/{reportId}](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/getReportInfo.md). 您将收到生成状态和估计的剩余时间，直到它完成。
3. 生成时间结束后，重复请求。 [GET v2/reports/info/{reportId}](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/getReportInfo.md). 如果生成了构建表，您将收到一个下载它的链接。


## 第三步。 标签代码的转移和货物的分箱 {#order-info}

此信息在单个请求中同时传输。: [PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/setOrderBoxLayout.md).

<!-- source: zh/_includes/mermaid/fbs-order-info.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as 您的店铺
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: 传递商品标记代码（如适用），<br>并将商品分配到包装箱中

        Merchant ->> Market: PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes
        Market -->> Merchant: OK
    end
    opt
        rect rgb(251, 243, 232)
            note right of Merchant: 可选步骤
            note right of Merchant: 获取标记代码验证状态
            Merchant ->> Market: POST v2/campaigns/{campaignId}/orders/{orderId}/identifiers/status
            Market -->> Merchant: OK: 验证信息
        end
    end
```
<!-- endsource: zh/_includes/mermaid/fbs-order-info.md -->

### 标记代码 {#marking-codes}

{% note info "系统中货物的标签 ["诚实的标志"](https://честныйзнак.рф/) 个人订单可选" %}

 

{% endnote %}

如果产品被标记在 «Честном знаке» 或其他标签系统，给市场每个销售副本的代码。

例如，如果一个人订购了三双相同的拖鞋，则必须在订单中为此项目提供三个代码。

如果订单包含在诚实标志系统中标记的珠宝或商品，在传输代码后，市场将开始检查它们。 [如何获取验证状态](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getOrderIdentifiersStatus.md)


### 按箱派发 {#boxes}

在运送订单之前，您需要向市场提供有关货物如何在盒子中分配的信息。 如果出现问题，有时需要这些信息。

{% note info "如果我需要更改订单信息，我该怎么办？" %}

应要求 [PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/setOrderBoxLayout.md) 您可以根据需要多次使用它，直到订单状态发生变化 **准备装运**. 每个新的请求替换与先前的请求传输的数据。

{% endnote %}

## 第四步。 标签打印和"准备装运"状态传输 {#fulfillment}

{% list tabs %}

- 单个订单的标签

  <!-- source: zh/_includes/mermaid/fbs-fulfillment.md -->
  ```mermaid
  %%{
    init: {
      'theme': 'base',
      'themeVariables': {
        'primaryColor': '#FDF3E8',
        'primaryTextColor': '#000000',
        'primaryBorderColor': '#BA9C80',
        'lineColor': '#BA9C80',
        'secondaryColor': '#94E1C4',
        'tertiaryColor': '#F84E57',
        'noteBkgColor': '#FED58D'
      }
    }
  }%%

  sequenceDiagram
      participant Merchant as 您的店铺
      participant Market as Yandex Market

      opt
        rect rgb(251, 243, 232)
          note right of Merchant: 可选步骤
          note right of Merchant: 传递外部订单ID
          Merchant ->> Market: POST v2/campaigns/{campaignId}/orders/{orderId}/external-id
          Market -->>+ Merchant: OK
        end
      end

      rect rgb(251, 243, 232)
          note right of Merchant: 获取物流标签

          Merchant ->> Market: GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels
          Market -->>+ Merchant: OK: 订单的物流标签
          Merchant ->>- Merchant: 打包订单
      end

      rect rgb(251, 243, 232)
          note right of Merchant: 传递“准备发货”状态 ("status": "PROCESSING" "substatus": "READY_TO_SHIP")
          Merchant ->> Market: PUT v2/campaigns/{campaignId}/orders/{orderId}/status<br>或<br>POST v2/campaigns/{campaignId}/orders/status-update
          Market -->> Merchant: OK
      end
  ```
  <!-- endsource: zh/_includes/mermaid/fbs-fulfillment.md -->

- 多个订单的快捷方式

  <!-- source: zh/_includes/mermaid/fbs-fulfillment-mass-generation.md -->
  ```mermaid
  %%{
    init: {
      'theme': 'base',
      'themeVariables': {
        'primaryColor': '#FDF3E8',
        'primaryTextColor': '#000000',
        'primaryBorderColor': '#BA9C80',
        'lineColor': '#BA9C80',
        'secondaryColor': '#94E1C4',
        'tertiaryColor': '#F84E57',
        'noteBkgColor': '#FED58D'
      }
    }
  }%%

  sequenceDiagram
      participant Merchant as 您的店铺
      participant Market as Yandex Market

      opt
        rect rgb(251, 243, 232)
          note right of Merchant: 可选步骤
          note right of Merchant: 传递外部订单标识符
          Merchant ->> Market: POST v2/campaigns/{campaignId}/orders/{orderId}/external-id
          Market -->>+ Merchant: OK
        end
      end

      rect rgb(251, 243, 232)
          note right of Merchant: 获取多个订单的标签
          Merchant ->>+ Market: POST v2/reports/documents/labels/generate
          Market ->> Market: 将标签<br>加入生成队列
          Market -->>- Merchant: OK: 可用于获取标签的标识符，<br>以及预计生成时间 (reportId + estimatedGenerationTime)
      end

      opt
        rect rgb(251, 243, 232)
          note right of Merchant: 可选步骤
          note right of Merchant: 检查生成状态
          Merchant ->> Market: GET v2/reports/info/<report_id>
          Market -->> Merchant: OK: 状态及预计剩余时间<br>(status + estimatedGenerationTime)
        end
      end

      rect rgb(251, 243, 232)
          note right of Merchant: 在estimatedGenerationTime指定时间后获取标签
          Merchant ->> Market: GET v2/reports/info/<report_id>
          Market -->>+ Merchant: OK: 状态及下载链接<br>若生成成功 — status = DONE + file<br>若生成失败 — status = FAILED 或 status = NODATA
          Merchant ->>- Merchant: 打包订单
      end

      rect rgb(251, 243, 232)
          note right of Merchant: 传递“准备发货”状态 ("status": "PROCESSING" "substatus": "READY_TO_SHIP")
          Merchant ->> Market: PUT v2/campaigns/{campaignId}/orders/{orderId}/status<br>或<br>POST v2/campaigns/{campaignId}/orders/status-update
          Market -->> Merchant: OK
      end
  ```
  <!-- endsource: zh/_includes/mermaid/fbs-fulfillment-mass-generation.md -->

{% endlist %}

1. 根据详细描述的规则打包收集的订单 [在市场对卖家的帮助](https://yandex.ru/support/marketplace/orders/fbs/packaging/index.html).

1. 当订单处于状态时 `PROCESSING` 具有子状态 `STARTED`，你可以通过它的外部ID — [POST v2/campaigns/{campaignId}/orders/{orderId}/external-id](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/updateExternalOrderId.md).

1. 使用请求获取快捷方式:

    * [GET v2/campaigns/{campaignId}/orders/{orderId}/delivery/labels](https://yandex.com/dev/market/partner-api/doc/zh/reference/order-labels/generateOrderLabels.md) — 对于一个单一的订单。
    * [POST v2/reports/documents/labels/generate](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateMassOrderLabelsReport.md) — 对于多个订单。

1. 在包装订单上贴上标签。

1. 将订单设置为状态**准备装运**（`"status": "PROCESSING" "substatus": "READY_TO_SHIP"`)使用请求:

    * [PUT v2/campaigns/{campaignId}/orders/{orderId}/status](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/updateOrderStatus.md) — 对于一个单一的订单。
    * [POST v2/campaigns/{campaignId}/orders/status-update](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/updateOrderStatuses.md) — 对于多个订单。

    通过这样做，您确认产品有库存并将发货。

    处于状态的产品 **准备装运** 它们包含在验收和转让证书中。

## 第五步。 处理装运 {#shipment}

<!-- source: zh/_includes/mermaid/fbs-shipment.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as 您的店铺
    participant Market as Yandex Market


    rect rgb(251, 243, 232)
        note right of Merchant: 发货工作流程

        opt
            note right of Merchant: 可选步骤
            note right of Merchant: 用于无需重新计数的商品发货（信任验收）

            Merchant ->> Market: 包装数量<br>PUT v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallets
            Market -->> Merchant: OK

            note right of Merchant: 获取标签
            Merchant ->> Market: GET v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallet/labels
            Market -->> Merchant: OK: 包装标签
        end

        note right of Merchant: 获取交接单并确认发货
        Merchant ->> Market: GET v2/campaigns/{campaignId}/shipments/reception-transfer-act
        Market -->> Merchant: OK
    end
```
<!-- endsource: zh/_includes/mermaid/fbs-shipment.md -->

要装运订单,司机需要一份验收证书. 使用请求 [GET v2/campaigns/{campaignId}/shipments/reception-transfer-act](https://yandex.com/dev/market/partner-api/doc/zh/reference/shipments/downloadShipmentReceptionTransferAct.md) 你可以:

1. 通过API接收并签署验收证书. 有关如何使用电子验收证书启用工作的信息，请参阅 [燕基科斯.对卖家的市场帮助](https://yandex.ru/support/marketplace/ru/start/models/fbs#manual).

1. 确认装运。 在办公室工作时没有这样的步骤，但是在通过API工作时 — 有。

{% note warning "我什么时候可以收到报告并确认装运?" %}

只有在所有订单都转换为状态后 **准备装运**. 如果货件中有未确认的订单，则会发送包含订单列表的错误消息以响应请求。

{% endnote %}

{% cut "计划[保密验收](*trust-acceptance)" %}

使用请求发送包数 [PUT v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallets](https://yandex.com/dev/market/partner-api/doc/zh/reference/shipments/setShipmentPalletsCount.md).

要获取它们的快捷方式，请使用请求 [GET v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/pallet/labels](https://yandex.com/dev/market/partner-api/doc/zh/reference/shipments/downloadShipmentPalletLabels.md).

{% endcut %}

## 如果产品不够：推迟，取消和减少订单 {#cancel-by-seller}

在准备订单期间，您的仓库可能会发现缺少一个或多个项目。 如果发生这种情况，您将不得不推迟订单的交付或全部或部分取消订单。

推迟交货日期和完全取消订单是通过单独的请求进行的。

要更改订单组合，请使用 [PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/setOrderBoxLayout.md) — 同样的请求，发送标签代码和货物在盒子里的分配。

<!-- source: zh/_includes/mermaid/fbs-cancel.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as 您的店铺
    participant Market as Yandex Market

    opt
      note right of Merchant: 可选步骤

      rect rgb(251, 243, 232)
        note right of Merchant: 如果仓库中没有大量所需商品，您可以取消订单
        Merchant ->> Market: "status": "CANCELLED", "substatus": "SHOP_FAILED"<br>PUT v2/campaigns/{campaignId}/orders/{orderId}/status
        Market -->> Merchant: OK
      end

      rect rgb(251, 243, 232)
        note right of Merchant: 如果仓库中缺少部分商品，您可以将它们从订单中移除
        Merchant ->> Market: PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes
        Market -->> Merchant: OK
      end

      rect rgb(251, 243, 232)
        note right of Merchant: 如果商品已在运输途中，您可以调整交付日期
        Merchant ->> Market: POST v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/orders/transfer
        Market -->> Merchant: OK
      end
    end
```
<!-- endsource: zh/_includes/mermaid/fbs-cancel.md -->

|**命令行动**| **请求**|
|-------------|-------------|
|转移到下一批货物|[POST v2/campaigns/{campaignId}/first-mile/shipments/{shipmentId}/orders/transfer](../reference/shipments/transferOrdersFromShipment.md)|
|完全取消订单|请求 [PUT v2/campaigns/{campaignId}/orders/{orderId}/status](../reference/orders/updateOrderStatus.md). （将订单转移至 `"status":"CANCELLED"` `"substatus": "SHOP_FAILED"`.)|
|将产品排除在订单之外|[PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes](../reference/orders/setOrderBoxLayout.md)|

{% note warning "你不能经常这样做。" %}

任何这些操作都会降低[质量指数](*quality-index) 那家商店。 当质量指数下降时，商店面临限制。

{% endnote %}

[*trust-acceptance]: Доверительная приемка — это передача заказов Маркету без пересчета в общей таре. [Узнать больше](https://yandex.ru/support/marketplace/orders/fbs/process.html#by-places)

[*quality-index]: Индекс качества — число от 0 до 100. Если магазин работает по модели FBY, индекс качества показывает, насколько хорошо продавец делает поставки на склады Маркета, а в моделях FBS, DBS и Экспресс индекс оценивает работу с заказами. [Узнать больше](https://yandex.ru/support/marketplace/quality/score/index.html)