从订单中删除项目或减少其数量

Info

Console

方法适用于模式DBS.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一

inventory-and-order-processing — 订单处理和商品核算
all-methods — 全面管理账户

如果按照FBS模型工作

使用方法 PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.

如果商店无法全部交付，则从订单中删除一个或多个项目。

订单必须具有状态 "状态":"处理中" 处理阶段 "substatus":"开始". 状态转移后无法更改组成 "substatus":"READY_TO_SHIP".

减少相同项目的数量

在参数中传递更新的值 count.

从订单中删除项目

传递值 0 在参数中 count 或者不要传递它 item.

您不能删除或减少项目的数量，如果它:

特别优惠增加;
相当于订单价值的99%;
订单中唯一的产品。

在这种情况下，取消方法中的订单 PUT v2/campaigns/{campaignId}/orders/{orderId}/status 发送订单状态 CANCELLED 与取消的原因 SHOP_FAILED.

这笔钱将如何退还

如果客户在结账时支付了产品，市场将在两天内退还从订单中移除的物品的钱:

使用银行卡付款时—从商店将订单转移到状态的那一刻起 SHIPPED;
通过支付时 Apple Pay 或 Google Pay -从商店从订单中删除产品的那一刻起。

⚙️ 限制：每小时100,000次请求

Request

PUT

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/{orderId}/items

Path parameters

Name

Description

campaignId*

Type: integer<int64>

活动ID。

您可以使用查询找到它 :no-translate[GET v2/campaigns] 或者在市场上的卖家办公室找到它-点击您的企业名称并转到页面:

模块和 API→区块 向Yandex发送数据。街市.
查询日志 →块中的下拉列表 显示日志.

，不要发送商店的ID，而不是，这是在卖方的帐户在市场上的商店名称旁边和一些报告。

Min value: 1

orderId*

Type: integer<int64>

的订单ID。

Body

application/json

{
    "items": [
        {
            "id": 0,
            "count": 0,
            "instances": [
                {
                    "cis": "string",
                    "uin": "string",
                    "rnpt": "string",
                    "gtd": "string",
                    "countryCode": "RU"
                }
            ]
        }
    ],
    "reason": "PARTNER_REQUESTED_REMOVE"
}

Name

Description

items*

Type: OrderItemModificationDTO[]

订单中的产品列表。

如果商店没有在输入数据中提供有关产品的信息，它将从订单中删除。

所需参数。
订单中的产品列表。

如果商店没有在输入数据中提供有关产品的信息，它将从订单中删除。

所需参数。

Min items: 1

reason

Type: OrderItemsModificationRequestReasonType

订单组成已更新的原因:

PARTNER_REQUESTED_REMOVE -商店已删除产品。
USER_REQUESTED_REMOVE -买家要求删除产品。

Enum: PARTNER_REQUESTED_REMOVE, USER_REQUESTED_REMOVE

OrderItemModificationDTO

订单中的产品列表。

如果商店没有在输入数据中提供有关产品的信息，它将从订单中删除。

所需参数。

Name	Description
count*	Type: integer<int32> 品的新数量。 Min value: `0`
id*	Type: integer<int64> 订单内产品的标识符。您可以使用资源获取ID GET v2/campaigns/{campaignId}/orders 或 GET v2/campaigns/{campaignId}/orders/{orderId}. 所需参数。
instances	Type: BriefOrderItemInstanceDTO[] 品单元的标签的信息。在请求中，指定要标记的所有项目。如果来自企业的订单包含在系统中需要贴标签的产品，则该参数是必需的。 «Честный ЗНАК» 或 «ASL BELGISI» （对于卖家 Market Yandex Go). 产品单元ID。只填写一个字段，具体取决于产品标记在哪个系统中。提供了有关使用标签商品的详细信息在市场对卖家的帮助. Min items: `1`

OrderItemsModificationRequestReasonType

订单组成已更新的原因:

PARTNER_REQUESTED_REMOVE -商店已删除产品。
USER_REQUESTED_REMOVE -买家要求删除产品。

Type	Description
OrderItemsModificationRequestReasonType	Enum: `PARTNER_REQUESTED_REMOVE`, `USER_REQUESTED_REMOVE`

BriefOrderItemInstanceDTO

产品单元ID。

只填写一个字段，具体取决于产品标记在哪个系统中。

提供了有关使用标签商品的详细信息在市场对卖家的帮助.

Name	Description
cis	Type: string 识别码系统中的产品单元 "诚实的标志" 或 "ASL BELGISI" （对于Yandex Go市场的卖家）。不要转义分隔符代码中的斜杠。 `\u001d` ✅ `01030410947874432155Qbag！\u001d93Zjqw` ❌ `01030410947874432155Qbag！\\u001d93Zjqw` 根据JSON规则在其他地方转义斜杠和引号。: `\\` 和 `\"`
countryCode	Type: string 生产国采用ISO3166-1alpha-2格式。如何获得 Example: `RU` Min length: `2` Max length: `2` Pattern: `^[A-Z]{2}$`
gtd	Type: string 货物报关。它是由斜杠分隔的三个数字组成的字符串：XXXXXXX/XXXXXXXXX/XXXXXXXXXXX。第一部分是登记进口货物申报的海关编码。接下来是声明的日期和编号。
rnpt	Type: string 品批次的注册号。它是由斜杠分隔的四个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXXXX/XXX。第一部分是注册货物申报的海关办公室的代码。接下来是日期、声明编号以及声明中标记产品的编号。
uin	Type: string 珠宝的唯一标识号。这是一个16位数字。

Responses

200 OK

燕基科斯. 市场已成功处理您的要求. 预计没有输出。

400 Bad Request

请求包含不正确的数据。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

ApiErrorDTO

一般错误格式。

Name

Description

code*

Type: string

的错误代码。

message

Type: string

错误的描述。

ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

401 Unauthorized

请求中未指定授权数据。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

403 Forbidden

授权数据不正确或禁止访问资源。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

404 Not Found

找不到请求的资源。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

420 Method Failure

已超出资源访问限制。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

500 Internal Server Error

Yandex的内部错误。市场。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

这篇文章是否有用？

发送确认代码

发送包裹的轨道号码