---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/laas-order.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/laas-order.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/laas-order.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt


# 使用LaaS订单

在帮助下 Yandex Market API 您可以接收、创建、修改和取消订单。


## 创建订单 {#create}

<!-- source: zh/_includes/mermaid/create-order.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/businesses/{businessId}/logistics-points
          Market -->> Merchant: OK: 取件点列表
      end
    end

    rect rgb(251, 243, 232)
        note right of Merchant: 获取库存和仓库标识符
        Merchant ->> Market: POST v2/campaigns/{campaignId}/offers/stocks
        Market -->> Merchant: OK: 商品库存和仓库标识符
    end

    rect rgb(251, 243, 232)
        note right of Merchant: 获取订单配送选项
        Merchant ->> Market: POST v2/campaigns/{campaignId}/delivery-options
        Market -->> Merchant: OK: 配送选项
    end

    rect rgb(251, 243, 232)
        note right of Merchant: 创建订单
        Merchant ->>+ Market: POST v2/campaigns/{campaignId}/orders/create
        alt 订单创建为草稿 (draft=true)
            Market ->> Market: 创建状态为 RESERVED 的订单<br>
        else 订单非草稿创建 (draft=false)
            Market ->> Market: 创建状态为 PROCESSING STARTED 的订单<br>
        end
        Market -->>- Merchant: OK: 订单标识符
    end

    opt
        note right of Merchant: 如果订单以 draft=true 创建
        rect rgb(251, 243, 232)
            note right of Merchant: 确认订单
            Merchant ->>+ Market: 状态 PROCESSING 子状态 STARTED<br>PUT v2/campaigns/{campaignId}/orders/{orderId}/status
            Market ->> Market: 启动订单确认操作
            Market -->>- Merchant: OK: 操作标识符
        end
        rect rgb(251, 243, 232)
            note right of Merchant: 检查操作状态
            Merchant ->> Market: 操作标识符<br>POST v2/businesses/{businessId}/operations
            Market -->> Merchant: OK: 操作信息
        end
    end
```
<!-- endsource: zh/_includes/mermaid/create-order.md -->

1. **对于拾取：**如果需要，调用方法 [POST v1/businesses/{businessId}/logistics-points](https://yandex.com/dev/market/partner-api/doc/zh/reference/logistic-points/getLogisticPoints.md)，它返回市场订单拾取列表。

    定期请求这些信息，以保持商店系统中的最新信息。 例如，每天一次。

1. 查看剩余库存 — 方法 [POST v2/campaigns/{campaignId}/offers/stocks](https://yandex.com/dev/market/partner-api/doc/zh/reference/stocks/getStocks.md).

    响应还将返回存储货物的仓库的Id。

1. 获取可用的运输选项。 要做到这一点，在方法 [POST v1/campaigns/{campaignId}/delivery-options](https://yandex.com/dev/market/partner-api/doc/zh/reference/delivery-options/getDeliveryOptions.md) 提供订单中的所有物品和信息，以便快递送货或取货。

    如有必要，还提供要从中提取货物的仓库的Id。 如果不这样做，市场将选择仓库本身。

1. 使用该方法创建订单 [POST v1/campaigns/{campaignId}/orders/create](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/createOrder.md). 通过快递送货，提供完整的地址，包括地区。

    参数值 `draft`:

    * `true` — 燕基科斯.市场将创建一个具有状态的订单 `RESERVED` 它将等待商店的确认。
    * `false` — 燕基科斯.市场将创建一个具有状态的订单 `PROCESSING` 具有子状态 `STARTED` 它将开始处理它，不需要确认。

1. 如果订单处于状态 `RESERVED` 并且您已准备好确认，请发送状态 `PROCESSING` 具有子状态 `STARTED` 在方法 [PUT v2/campaigns/{campaignId}/orders/{orderId}/status](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/updateOrderStatus.md). 如果您在创建订单后一小时内不这样做，yandex。市场将取消订单.

    操作ID将在响应中返回。

1. 使用该方法检查操作状态 [POST v1/businesses/{businessId}/operations](https://yandex.com/dev/market/partner-api/doc/zh/reference/operations/getOperations.md).


## 更改订单 {#change}

你可以改变:

* 收件人的详细信息;
* 快递交货日期范围。

<!-- source: zh/_includes/mermaid/change-order.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: 修改快递配送日期区间
        note right of Merchant: 获取可用配送区间
        Merchant ->> Market: POST v2/campaigns/{campaignId}/orders/update-options
        Market -->> Merchant: OK: 配送区间
    end

    rect rgb(251, 243, 232)
        note right of Merchant: 修改订单
        Merchant ->>+ Market: POST v2/campaigns/{campaignId}/orders/update
        Market ->> Market: 启动订单修改操作<br>
        Market -->>- Merchant: OK: 操作标识符
    end

    rect rgb(251, 243, 232)
        note right of Merchant: 检查操作状态
        Merchant ->> Market: 操作标识符<br>POST v2/businesses/{businessId}/operations
        Market -->> Merchant: OK: 操作信息
    end
```
<!-- endsource: zh/_includes/mermaid/change-order.md -->

1. **要更改快递递送的日期间隔：**使用方法获取可用的时间间隔 [POST v1/campaigns/{campaignId}/orders/update-options](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getOrderUpdateOptions.md).

1. 启动更改顺序的操作。 为此，请在方法中指定订单ID和新数据 [POST v1/campaigns/{campaignId}/orders/update](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/updateOrder.md).

    仅传输要更改的信息。 如有必要，您可以在同一时间编辑收件人的数据和快递递送日期间隔。

1. 使用该方法检查操作状态 [POST v1/businesses/{businessId}/operations](https://yandex.com/dev/market/partner-api/doc/zh/reference/operations/getOperations.md).


## 取消订单 {#cancel}

<!-- source: zh/_includes/mermaid/cancel-order.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: 带取消原因`SHOP_FAILED`的`CANCELLED`状态<br>PUT v2/campaigns/{campaignId}/orders/{orderId}/status<br>或<br>POST v2/campaigns/{campaignId}/orders/status-update
        Market ->> Market: 启动订单取消操作
        Market -->>- Merchant: OK: 操作标识符
    end

    rect rgb(251, 243, 232)
        note right of Merchant: 操作状态检查
        Merchant ->> Market: 操作标识符<br>POST v2/businesses/{businessId}/operations
        Market -->> Merchant: OK: 操作信息
    end

    opt
      rect rgb(251, 243, 232)
          note right of Merchant: 可选步骤
          note right of Merchant: 订单或订单状态检查
          Merchant ->> Market: POST v1/businesses/{businessId}/orders
          Market -->> Merchant: OK: 订单或订单信息
      end
    end
```
<!-- endsource: zh/_includes/mermaid/cancel-order.md -->

1. 启动订单取消操作。 为此，请发送状态 `CANCELLED` 与取消的原因 `SHOP_FAILED` 在方法:

    * [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) — 对于多个订单。

    不要传输其他状态。

1. 检查操作状态 — 方法 [POST v1/businesses/{businessId}/operations](https://yandex.com/dev/market/partner-api/doc/zh/reference/operations/getOperations.md).

1. 如有必要，检查订单状态：使用方法 [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/zh/reference/orders/getBusinessOrders.md) 带过滤器 `orderIds`.