更改订单的状态

Info

Console

方法适用于模式：FBS, Express 和 DBS.

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

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

更改订单状态。可能的状态更改:

如果商店已确认并准备装运订单，则订单从状态 "status": "PROCESSING" 和处理阶段 "substatus": "STARTED" 它需要转换为状态 "status": "PROCESSING" 和处理阶段 "substatus": "READY_TO_SHIP".
如果商店已确认订单，但无法发货（例如，产品已在数据库中列出，但没有库存或没有所需的颜色），则订单状态为 "status": "PROCESSING" 和处理阶段 "substatus": "STARTED" 它需要转换为状态 "status": "CANCELLED" 与取消订单的原因 "substatus": "SHOP_FAILED".
如果商店已准备装运订单，但无法完成订单（例如，最后一件商品已损坏或有缺陷），则订单状态为 "status": "PROCESSING" 和处理阶段 "substatus": "READY_TO_SHIP" 它需要转换为状态 "status": "CANCELLED" 与取消订单的原因 "substatus": "SHOP_FAILED".

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

Request

PUT

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

Path parameters

Name

Description

campaignId*

Type: integer<int64>

活动ID。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置在左边的菜单中，选择 Api和模块:

座 运动ID;
标签 查询日志 →块中的下拉列表 显示日志.

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

Min value: 1

orderId*

Type: integer<int64>

的订单ID。

Body

application/json

{
    "order": {
        "status": "PLACING",
        "substatus": "RESERVATION_EXPIRED",
        "delivery": {
            "dates": {
                "realDeliveryDate": "string"
            }
        }
    }
}

Name

Description

order*

Type: OrderStatusChangeDTO

秩序。

OrderStatusChangeDTO

秩序。

Name	Description
status*	Type: OrderStatusType 订单状况: `PLACING` — 它正在处理，准备预订。 `RESERVED` — 预订，但预订不足。 `UNPAID` — 已发出，但尚未付款（如果在结账时选择付款）。 `PROCESSING` — 它正在处理中。 `DELIVERY` — 转移到送货服务。 `PICKUP` — 送到取件点。 `DELIVERED` — 由买方接收。 `CANCELLED` — 取消。 `PENDING` — 等待卖方处理。 `PARTIALLY_RETURNED` — 部分退款。 `RETURNED` — 全额回来了。 `UNKNOWN` — 状态不明。也可以返回其他值。您不需要处理它们。 Enum: `PLACING`, `RESERVED`, `UNPAID`, `PROCESSING`, `DELIVERY`, `PICKUP`, `DELIVERED`, `CANCELLED`, `PENDING`, `PARTIALLY_RETURNED`, `RETURNED`, `UNKNOWN`
delivery	Type: OrderStatusChangeDeliveryDTO 交付信息。
substatus	Type: OrderSubstatusType 订单处理的阶段（如果它具有状态 `PROCESSING`）或取消订单的原因（如果它具有状态 `CANCELLED`). 状态中的订单值 `PROCESSING`: `STARTED` — 订单已确认，可以处理。 `READY_TO_SHIP` — 订单已组装并准备装运。状态中的订单值 `CANCELLED`: `RESERVATION_EXPIRED` — 客户没有在10分钟内完成预订订单。 `USER_NOT_PAID` — 买方没有为订单付款（对于付款类型 `PREPAID`）30分钟。 `USER_UNREACHABLE` — 无法联系买家。为此取消，必须满足以下条件: 至少3个电话从8到21在买方的时区; 第一次和第三次通话之间的休息时间至少为90分钟; 连接不短于5秒。如果不满足其中至少一个条件（号码不可用时除外），您将无法取消订单。将返回带有错误代码400的响应。 `USER_CHANGED_MIND` — 客户因个人原因取消了订单。 `USER_REFUSED_DELIVERY` — 买方对交货条件不满意. `USER_REFUSED_PRODUCT` — 该产品不适合买方。 `SHOP_FAILED` — 商店无法完成订单。 `USER_REFUSED_QUALITY` — 买方对产品的质量不满意。 `REPLACING_ORDER` — 买方决定主动更换另一种产品。 `PROCESSING_EXPIRED` — 值不再使用。 `PICKUP_EXPIRED` — 订单在PVZ中的存储期已过期。 `TOO_MANY_DELIVERY_DATE_CHANGES` — 订单被推迟了太多次。 `TOO_LONG_DELIVERY` — 订单太长时间无法交付。 `INCORRECT_PERSONAL_DATA` — 对于来自国外的订单，收件人的信息不正确，订单将不会在海关检查。 `TECHNICAL_ERROR` — 市场方面的技术错误。联系支持。也可以返回其他值。您不需要处理它们。 Enum: `RESERVATION_EXPIRED`, `USER_NOT_PAID`, `USER_UNREACHABLE`, `USER_CHANGED_MIND`, `USER_REFUSED_DELIVERY`, `USER_REFUSED_PRODUCT`, `SHOP_FAILED`, `USER_REFUSED_QUALITY`, `REPLACING_ORDER`, `PROCESSING_EXPIRED`, `PENDING_EXPIRED`, `SHOP_PENDING_CANCELLED`, `PENDING_CANCELLED`, `USER_FRAUD`, `RESERVATION_FAILED`, `USER_PLACED_OTHER_ORDER`, `USER_BOUGHT_CHEAPER`, `MISSING_ITEM`, `BROKEN_ITEM`, `WRONG_ITEM`, `PICKUP_EXPIRED`, `DELIVERY_PROBLEMS`, `LATE_CONTACT`, `CUSTOM`, `DELIVERY_SERVICE_FAILED`, `WAREHOUSE_FAILED_TO_SHIP`, `DELIVERY_SERVICE_UNDELIVERED`, `PREORDER`, `AWAIT_CONFIRMATION`, `STARTED`, `PACKAGING`, `READY_TO_SHIP`, `SHIPPED`, `ASYNC_PROCESSING`, `WAITING_USER_INPUT`, `WAITING_BANK_DECISION`, `BANK_REJECT_CREDIT_OFFER`, `CUSTOMER_REJECT_CREDIT_OFFER`, `CREDIT_OFFER_FAILED`, `AWAIT_DELIVERY_DATES_CONFIRMATION`, `SERVICE_FAULT`, `DELIVERY_SERVICE_RECEIVED`, `USER_RECEIVED`, `WAITING_FOR_STOCKS`, `AS_PART_OF_MULTI_ORDER`, `READY_FOR_LAST_MILE`, `LAST_MILE_STARTED`, `ANTIFRAUD`, `DELIVERY_USER_NOT_RECEIVED`, `DELIVERY_SERVICE_DELIVERED`, `DELIVERED_USER_NOT_RECEIVED`, `USER_WANTED_ANOTHER_PAYMENT_METHOD`, `USER_RECEIVED_TECHNICAL_ERROR`, `USER_FORGOT_TO_USE_BONUS`, `DELIVERY_SERVICE_NOT_RECEIVED`, `DELIVERY_SERVICE_LOST`, `SHIPPED_TO_WRONG_DELIVERY_SERVICE`, `DELIVERED_USER_RECEIVED`, `WAITING_TINKOFF_DECISION`, `COURIER_SEARCH`, `COURIER_FOUND`, `COURIER_IN_TRANSIT_TO_SENDER`, `COURIER_ARRIVED_TO_SENDER`, `COURIER_RECEIVED`, `COURIER_NOT_FOUND`, `COURIER_NOT_DELIVER_ORDER`, `COURIER_RETURNS_ORDER`, `COURIER_RETURNED_ORDER`, `WAITING_USER_DELIVERY_INPUT`, `PICKUP_SERVICE_RECEIVED`, `PICKUP_USER_RECEIVED`, `CANCELLED_COURIER_NOT_FOUND`, `COURIER_NOT_COME_FOR_ORDER`, `DELIVERY_NOT_MANAGED_REGION`, `INCOMPLETE_CONTACT_INFORMATION`, `INCOMPLETE_MULTI_ORDER`, `INAPPROPRIATE_WEIGHT_SIZE`, `TECHNICAL_ERROR`, `SORTING_CENTER_LOST`, `COURIER_SEARCH_NOT_STARTED`, `LOST`, `AWAIT_PAYMENT`, `AWAIT_LAVKA_RESERVATION`, `USER_WANTS_TO_CHANGE_ADDRESS`, `FULL_NOT_RANSOM`, `PRESCRIPTION_MISMATCH`, `DROPOFF_LOST`, `DROPOFF_CLOSED`, `DELIVERY_TO_STORE_STARTED`, `USER_WANTS_TO_CHANGE_DELIVERY_DATE`, `WRONG_ITEM_DELIVERED`, `DAMAGED_BOX`, `AWAIT_DELIVERY_DATES`, `LAST_MILE_COURIER_SEARCH`, `PICKUP_POINT_CLOSED`, `LEGAL_INFO_CHANGED`, `USER_HAS_NO_TIME_TO_PICKUP_ORDER`, `DELIVERY_CUSTOMS_ARRIVED`, `DELIVERY_CUSTOMS_CLEARED`, `FIRST_MILE_DELIVERY_SERVICE_RECEIVED`, `AWAIT_AUTO_DELIVERY_DATES`, `AWAIT_USER_PERSONAL_DATA`, `NO_PERSONAL_DATA_EXPIRED`, `CUSTOMS_PROBLEMS`, `AWAIT_CASHIER`, `WAITING_POSTPAID_BUDGET_RESERVATION`, `AWAIT_SERVICEABLE_CONFIRMATION`, `POSTPAID_BUDGET_RESERVATION_FAILED`, `AWAIT_CUSTOM_PRICE_CONFIRMATION`, `READY_FOR_PICKUP`, `TOO_MANY_DELIVERY_DATE_CHANGES`, `TOO_LONG_DELIVERY`, `DEFERRED_PAYMENT`, `POSTPAID_FAILED`, `INCORRECT_PERSONAL_DATA`, `UNKNOWN`

OrderStatusType

订单状况:

PLACING — 它正在处理，准备预订。
RESERVED — 预订，但预订不足。
UNPAID — 已发出，但尚未付款（如果在结账时选择付款）。
PROCESSING — 它正在处理中。
DELIVERY — 转移到送货服务。
PICKUP — 送到取件点。
DELIVERED — 由买方接收。
CANCELLED — 取消。
PENDING — 等待卖方处理。
PARTIALLY_RETURNED — 部分退款。
RETURNED — 全额回来了。
UNKNOWN — 状态不明。

也可以返回其他值。您不需要处理它们。

Type	Description
OrderStatusType	Enum: `PLACING`, `RESERVED`, `UNPAID`, `PROCESSING`, `DELIVERY`, `PICKUP`, `DELIVERED`, `CANCELLED`, `PENDING`, `PARTIALLY_RETURNED`, `RETURNED`, `UNKNOWN`

OrderStatusChangeDeliveryDTO

交付信息。

Name

Description

dates

Type: OrderStatusChangeDeliveryDatesDTO

交货日期的范围。

OrderSubstatusType

订单处理的阶段（如果它具有状态 PROCESSING）或取消订单的原因（如果它具有状态 CANCELLED).

状态中的订单值 PROCESSING:
- STARTED — 订单已确认，可以处理。
- READY_TO_SHIP — 订单已组装并准备装运。
状态中的订单值 CANCELLED:
- RESERVATION_EXPIRED — 客户没有在10分钟内完成预订订单。
- USER_NOT_PAID — 买方没有为订单付款（对于付款类型 PREPAID）30分钟。
- USER_UNREACHABLE — 无法联系买家。为此取消，必须满足以下条件:
  - 至少3个电话从8到21在买方的时区;
  - 第一次和第三次通话之间的休息时间至少为90分钟;
  - 连接不短于5秒。
  如果不满足其中至少一个条件（号码不可用时除外），您将无法取消订单。将返回带有错误代码400的响应。
- USER_CHANGED_MIND — 客户因个人原因取消了订单。
- USER_REFUSED_DELIVERY — 买方对交货条件不满意.
- USER_REFUSED_PRODUCT — 该产品不适合买方。
- SHOP_FAILED — 商店无法完成订单。
- USER_REFUSED_QUALITY — 买方对产品的质量不满意。
- REPLACING_ORDER — 买方决定主动更换另一种产品。
- PROCESSING_EXPIRED — 值不再使用。
- PICKUP_EXPIRED — 订单在PVZ中的存储期已过期。
- TOO_MANY_DELIVERY_DATE_CHANGES — 订单被推迟了太多次。
- TOO_LONG_DELIVERY — 订单太长时间无法交付。
- INCORRECT_PERSONAL_DATA — 对于来自国外的订单，收件人的信息不正确，订单将不会在海关检查。
TECHNICAL_ERROR — 市场方面的技术错误。联系支持。

也可以返回其他值。您不需要处理它们。

Type

Description

OrderSubstatusType

Enum: RESERVATION_EXPIRED, USER_NOT_PAID, USER_UNREACHABLE, USER_CHANGED_MIND, USER_REFUSED_DELIVERY, USER_REFUSED_PRODUCT, SHOP_FAILED, USER_REFUSED_QUALITY, REPLACING_ORDER, PROCESSING_EXPIRED, PENDING_EXPIRED, SHOP_PENDING_CANCELLED, PENDING_CANCELLED, USER_FRAUD, RESERVATION_FAILED, USER_PLACED_OTHER_ORDER, USER_BOUGHT_CHEAPER, MISSING_ITEM, BROKEN_ITEM, WRONG_ITEM, PICKUP_EXPIRED, DELIVERY_PROBLEMS, LATE_CONTACT, CUSTOM, DELIVERY_SERVICE_FAILED, WAREHOUSE_FAILED_TO_SHIP, DELIVERY_SERVICE_UNDELIVERED, PREORDER, AWAIT_CONFIRMATION, STARTED, PACKAGING, READY_TO_SHIP, SHIPPED, ASYNC_PROCESSING, WAITING_USER_INPUT, WAITING_BANK_DECISION, BANK_REJECT_CREDIT_OFFER, CUSTOMER_REJECT_CREDIT_OFFER, CREDIT_OFFER_FAILED, AWAIT_DELIVERY_DATES_CONFIRMATION, SERVICE_FAULT, DELIVERY_SERVICE_RECEIVED, USER_RECEIVED, WAITING_FOR_STOCKS, AS_PART_OF_MULTI_ORDER, READY_FOR_LAST_MILE, LAST_MILE_STARTED, ANTIFRAUD, DELIVERY_USER_NOT_RECEIVED, DELIVERY_SERVICE_DELIVERED, DELIVERED_USER_NOT_RECEIVED, USER_WANTED_ANOTHER_PAYMENT_METHOD, USER_RECEIVED_TECHNICAL_ERROR, USER_FORGOT_TO_USE_BONUS, DELIVERY_SERVICE_NOT_RECEIVED, DELIVERY_SERVICE_LOST, SHIPPED_TO_WRONG_DELIVERY_SERVICE, DELIVERED_USER_RECEIVED, WAITING_TINKOFF_DECISION, COURIER_SEARCH, COURIER_FOUND, COURIER_IN_TRANSIT_TO_SENDER, COURIER_ARRIVED_TO_SENDER, COURIER_RECEIVED, COURIER_NOT_FOUND, COURIER_NOT_DELIVER_ORDER, COURIER_RETURNS_ORDER, COURIER_RETURNED_ORDER, WAITING_USER_DELIVERY_INPUT, PICKUP_SERVICE_RECEIVED, PICKUP_USER_RECEIVED, CANCELLED_COURIER_NOT_FOUND, COURIER_NOT_COME_FOR_ORDER, DELIVERY_NOT_MANAGED_REGION, INCOMPLETE_CONTACT_INFORMATION, INCOMPLETE_MULTI_ORDER, INAPPROPRIATE_WEIGHT_SIZE, TECHNICAL_ERROR, SORTING_CENTER_LOST, COURIER_SEARCH_NOT_STARTED, LOST, AWAIT_PAYMENT, AWAIT_LAVKA_RESERVATION, USER_WANTS_TO_CHANGE_ADDRESS, FULL_NOT_RANSOM, PRESCRIPTION_MISMATCH, DROPOFF_LOST, DROPOFF_CLOSED, DELIVERY_TO_STORE_STARTED, USER_WANTS_TO_CHANGE_DELIVERY_DATE, WRONG_ITEM_DELIVERED, DAMAGED_BOX, AWAIT_DELIVERY_DATES, LAST_MILE_COURIER_SEARCH, PICKUP_POINT_CLOSED, LEGAL_INFO_CHANGED, USER_HAS_NO_TIME_TO_PICKUP_ORDER, DELIVERY_CUSTOMS_ARRIVED, DELIVERY_CUSTOMS_CLEARED, FIRST_MILE_DELIVERY_SERVICE_RECEIVED, AWAIT_AUTO_DELIVERY_DATES, AWAIT_USER_PERSONAL_DATA, NO_PERSONAL_DATA_EXPIRED, CUSTOMS_PROBLEMS, AWAIT_CASHIER, WAITING_POSTPAID_BUDGET_RESERVATION, AWAIT_SERVICEABLE_CONFIRMATION, POSTPAID_BUDGET_RESERVATION_FAILED, AWAIT_CUSTOM_PRICE_CONFIRMATION, READY_FOR_PICKUP, TOO_MANY_DELIVERY_DATE_CHANGES, TOO_LONG_DELIVERY, DEFERRED_PAYMENT, POSTPAID_FAILED, INCORRECT_PERSONAL_DATA, UNKNOWN

OrderStatusChangeDeliveryDatesDTO

交货日期的范围。

Name

Description

realDeliveryDate

Type: string<date>

只适用于型号 DBS

实际交货日期。

何时传递参数 realDeliveryDate:

如果:
- 将订单转移到除 PICKUP 或 DELIVERED;
- 将订单状态更改为 PICKUP 或 DELIVERED 交货当天 — 将注明请求完成日期。
如果您要将订单转换为状态，请发送交货日期 PICKUP 或 DELIVERED 不是在交货当天。您不能指定未来的交货日期。

在截止日期后转移状态会降低质量指数

阅读截止日期在市场对卖家的帮助.

Responses

200 OK

如果订单状态更改成功，则返回更新后的订单信息。

Body

application/json

{
    "order": {
        "id": 0,
        "externalOrderId": "string",
        "status": "PLACING",
        "substatus": "RESERVATION_EXPIRED",
        "creationDate": "23-09-2022 09:12:41",
        "updatedAt": "23-09-2022 09:12:41",
        "currency": "RUR",
        "itemsTotal": 0,
        "deliveryTotal": 0,
        "buyerItemsTotal": 0,
        "buyerTotal": 0,
        "buyerItemsTotalBeforeDiscount": 0,
        "buyerTotalBeforeDiscount": 0,
        "paymentType": "PREPAID",
        "paymentMethod": "CASH_ON_DELIVERY",
        "fake": false,
        "items": [
            {
                "id": 0,
                "offerId": "string",
                "offerName": "string",
                "price": 0,
                "buyerPrice": 0,
                "buyerPriceBeforeDiscount": 0,
                "priceBeforeDiscount": 0,
                "count": 0,
                "vat": "NO_VAT",
                "shopSku": "string",
                "subsidy": 0,
                "partnerWarehouseId": "string",
                "promos": [
                    {
                        "type": "DIRECT_DISCOUNT",
                        "discount": 0,
                        "subsidy": 0,
                        "shopPromoId": "string",
                        "marketPromoId": "string"
                    }
                ],
                "instances": [
                    {
                        "cis": "string",
                        "cisFull": "string",
                        "uin": "string",
                        "rnpt": "string",
                        "gtd": "string",
                        "countryCode": "RU"
                    }
                ],
                "details": [
                    {
                        "itemCount": 0,
                        "itemStatus": "REJECTED",
                        "updateDate": "23-09-2022"
                    }
                ],
                "subsidies": [
                    {
                        "type": "YANDEX_CASHBACK",
                        "amount": 0
                    }
                ],
                "requiredInstanceTypes": [
                    "CIS"
                ],
                "tags": [
                    "ULTIMA"
                ]
            }
        ],
        "subsidies": [
            {
                "type": "YANDEX_CASHBACK",
                "amount": 0
            }
        ],
        "delivery": {
            "id": "string",
            "type": "DELIVERY",
            "serviceName": "string",
            "price": 0,
            "deliveryPartnerType": "SHOP",
            "courier": {
                "fullName": "string",
                "phone": "string",
                "phoneExtension": "string",
                "vehicleNumber": "string",
                "vehicleDescription": "string"
            },
            "dates": {
                "fromDate": "23-09-2022",
                "toDate": "23-09-2022",
                "fromTime": "string",
                "toTime": "string",
                "realDeliveryDate": "23-09-2022"
            },
            "region": {
                "id": 0,
                "name": "string",
                "type": "OTHER"
            },
            "address": {
                "country": "string",
                "postcode": "string",
                "city": "string",
                "district": "string",
                "subway": "string",
                "street": "string",
                "house": "string",
                "estate": "string",
                "block": "string",
                "building": "string",
                "entrance": "string",
                "entryphone": "string",
                "floor": "string",
                "apartment": "string",
                "phone": "string",
                "recipient": "string",
                "gps": {
                    "latitude": 0,
                    "longitude": 0
                }
            },
            "vat": "NO_VAT",
            "deliveryServiceId": 0,
            "liftType": "NOT_NEEDED",
            "liftPrice": 0,
            "outletCode": "string",
            "outletStorageLimitDate": "23-09-2022",
            "dispatchType": "UNKNOWN",
            "tracks": [
                {
                    "trackCode": "string",
                    "deliveryServiceId": 0
                }
            ],
            "shipments": [
                {
                    "id": 0,
                    "shipmentDate": "23-09-2022",
                    "shipmentTime": "string",
                    "tracks": [
                        {
                            "trackCode": "string",
                            "deliveryServiceId": 0
                        }
                    ],
                    "boxes": [
                        {
                            "id": 0,
                            "fulfilmentId": "string"
                        }
                    ]
                }
            ],
            "estimated": false,
            "eacType": "MERCHANT_TO_COURIER",
            "eacCode": "string"
        },
        "buyer": {
            "id": "string",
            "lastName": "string",
            "firstName": "string",
            "middleName": "string",
            "type": "PERSON"
        },
        "notes": "string",
        "taxSystem": "OSN",
        "cancelRequested": false,
        "expiryDate": "23-09-2022 09:12:41"
    }
}

Name

Description

order

Type: OrderDTO

秩序。

OrderDTO

秩序。

Name

Description

buyer*

Type: OrderBuyerDTO

有关买方的信息。

参数 id, lastName, firstName 和 middleName 只有当您根据模型工作时，才会返回它们。 DBS.
有关买方的基本字段的信息。

buyerItemsTotalBeforeDiscount*

Type: number

订单中所有项目的成本以买方的货币计算，不包括运费和在:

股份;
优惠券;
促销代码。

creationDate*

Type: string<date-dd-MM-yyyy-HH-mm-ss>

订单的日期和时间。

日期和时间格式: DD-MM-YYYY HH:MM:SS. 时区 — UTC+03:00（莫斯科）。

Example: 23-09-2022 09:12:41

currency*

Type: CurrencyType

Валюта, в которой указаны цены на товары в заказе.

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

delivery*

Type: OrderDeliveryDTO

交付信息。

deliveryTotal*

Type: number

交付的成本。

fake*

Type: boolean

订单类别:

false — 真正的客户的订单。
true — 测试的市场秩序。

id*

Type: integer<int64>

的订单ID。

items*

Type: OrderItemDTO[]

订单中的产品列表。
订单中的产品列表。

itemsTotal*

Type: number

买方付款。

paymentMethod*

Type: OrderPaymentMethodType

订购付款方法:

如果在结账时选择付款，则值（"paymentType": "PREPAID"):
- YANDEX — 通过银行卡。
- APPLE_PAY — 苹果支付。
- GOOGLE_PAY — 谷歌支付。
- CREDIT — 赊帐。
- TINKOFF_CREDIT — 从廷科夫银行贷到的。
- TINKOFF_INSTALLMENTS — 分期付款在廷科夫银行。
- EXTERNAL_CERTIFICATE — 与礼券（例如，从Sberbank在线应用程序）。
- SBP — 通过快速支付系统。
- B2B_ACCOUNT_PREPAYMENT — 组织支付订单。
如果在收到订单时选择付款的值（"paymentType": "POSTPAID"):
- CARD_ON_DELIVERY — 通过银行卡。
- BOUND_CARD_ON_DELIVERY — 收到时附有连结的银行卡。
- BNPL_BANK_ON_DELIVERY — 超级分裂。
- BNPL_ON_DELIVERY — 分裂。
- CASH_ON_DELIVERY — 现金。
- B2B_ACCOUNT_POSTPAYMENT — 订单在交货后由组织支付。
UNKNOWN — 未知类型。

默认值: CASH_ON_DELIVERY.

Enum: CASH_ON_DELIVERY, CARD_ON_DELIVERY, BOUND_CARD_ON_DELIVERY, BNPL_BANK_ON_DELIVERY, BNPL_ON_DELIVERY, YANDEX, APPLE_PAY, EXTERNAL_CERTIFICATE, CREDIT, GOOGLE_PAY, TINKOFF_CREDIT, SBP, TINKOFF_INSTALLMENTS, B2B_ACCOUNT_PREPAYMENT, B2B_ACCOUNT_POSTPAYMENT, UNKNOWN

paymentType*

Type: OrderPaymentType

订购付款类别:

PREPAID — 结账时付款。
POSTPAID — 在收到订单后付款。
UNKNOWN — 未知类型。

如果省略此参数，订单将在收到时支付。

Enum: PREPAID, POSTPAID, UNKNOWN

status*

Type: OrderStatusType

订单状况:

PLACING — 它正在处理，准备预订。
RESERVED — 预订，但预订不足。
UNPAID — 已发出，但尚未付款（如果在结账时选择付款）。
PROCESSING — 它正在处理中。
DELIVERY — 转移到送货服务。
PICKUP — 送到取件点。
DELIVERED — 由买方接收。
CANCELLED — 取消。
PENDING — 等待卖方处理。
PARTIALLY_RETURNED — 部分退款。
RETURNED — 全额回来了。
UNKNOWN — 状态不明。

也可以返回其他值。您不需要处理它们。

Enum: PLACING, RESERVED, UNPAID, PROCESSING, DELIVERY, PICKUP, DELIVERED, CANCELLED, PENDING, PARTIALLY_RETURNED, RETURNED, UNKNOWN

substatus*

Type: OrderSubstatusType

订单处理的阶段（如果它具有状态 PROCESSING）或取消订单的原因（如果它具有状态 CANCELLED).

状态中的订单值 PROCESSING:
- STARTED — 订单已确认，可以处理。
- READY_TO_SHIP — 订单已组装并准备装运。
状态中的订单值 CANCELLED:
- RESERVATION_EXPIRED — 客户没有在10分钟内完成预订订单。
- USER_NOT_PAID — 买方没有为订单付款（对于付款类型 PREPAID）30分钟。
- USER_UNREACHABLE — 无法联系买家。为此取消，必须满足以下条件:
  - 至少3个电话从8到21在买方的时区;
  - 第一次和第三次通话之间的休息时间至少为90分钟;
  - 连接不短于5秒。
  如果不满足其中至少一个条件（号码不可用时除外），您将无法取消订单。将返回带有错误代码400的响应。
- USER_CHANGED_MIND — 客户因个人原因取消了订单。
- USER_REFUSED_DELIVERY — 买方对交货条件不满意.
- USER_REFUSED_PRODUCT — 该产品不适合买方。
- SHOP_FAILED — 商店无法完成订单。
- USER_REFUSED_QUALITY — 买方对产品的质量不满意。
- REPLACING_ORDER — 买方决定主动更换另一种产品。
- PROCESSING_EXPIRED — 值不再使用。
- PICKUP_EXPIRED — 订单在PVZ中的存储期已过期。
- TOO_MANY_DELIVERY_DATE_CHANGES — 订单被推迟了太多次。
- TOO_LONG_DELIVERY — 订单太长时间无法交付。
- INCORRECT_PERSONAL_DATA — 对于来自国外的订单，收件人的信息不正确，订单将不会在海关检查。
TECHNICAL_ERROR — 市场方面的技术错误。联系支持。

也可以返回其他值。您不需要处理它们。

taxSystem*

Type: OrderTaxSystemType

下订单时商店的税收制度:

ECHN — 统一农业税（UST）。
ENVD — 统一计算所得税（UTII）。
OSN — 一般税收制度。
PSN — 专利税制（PSN）。
USN — 简化税制（STS）。
USN_MINUS_COST — 简化的税收制度，收入减少的费用数额（USN"收入减去费用"）。
NPD — 专业收入税（NAP）。
UNKNOWN_VALUE — 未知值。仅与参数结合使用 付款方法=氨纶.

Enum: OSN, USN, USN_MINUS_COST, ENVD, ECHN, PSN, NPD, UNKNOWN_VALUE

buyerItemsTotal

⦸

Type: number

订单中所有项目的成本在应用折扣后以买方的货币计算，不包括运费。

buyerTotal

⦸

Type: number

订单中所有项目的成本，在应用折扣后，以买方的货币计算，并考虑到运输成本。

buyerTotalBeforeDiscount

⦸

Type: number

订单中所有项目在应用折扣之前以买方货币计算的成本，包括运费（buyerItemsTotalBeforeDiscount +运费）。

cancelRequested

Type: boolean

只适用于型号 DBS

是否已要求取消。

expiryDate

Type: string<date-dd-MM-yyyy-HH-mm-ss>

如果状态没有改变，订单将被取消的日期。

日期格式: DD-MM-YYYY.

Example: 23-09-2022 09:12:41

externalOrderId

Type: string

您提交的订单的外部ID POST v2/campaigns/{campaignId}/orders/{orderId}/external-id.

Min length: 1

notes

Type: string

对订单进行评论。

subsidies

Type: OrderSubsidyDTO[]

按类型划分的补贴清单。
向卖方支付的总报酬 DBS-交货和产品的所有折扣:

通过促销代码、优惠券和促销;
按加分;
交货时（DBS).

包括增值税。

Min items: 1

updatedAt

Type: string<date-dd-MM-yyyy-HH-mm-ss>

上次订单更新的日期和时间。

日期和时间格式: DD-MM-YYYY HH:MM:SS. 时区 — UTC+03:00（莫斯科）。

Example: 23-09-2022 09:12:41

OrderBuyerDTO

有关买方的信息。

参数 id, lastName, firstName 和 middleName 只有当您根据模型工作时，才会返回它们。 DBS.

Name	Description
type*	Type: OrderBuyerType Тип покупателя: физическое лицо или организация. Этот параметр используется FBS- и FBY-магазинами, размещающими товары на витрине business.market.yandex.ru. Enum: `PERSON`, `BUSINESS`
firstName	Type: string 买家的名字。
id	Type: string 买方的ID。
lastName	Type: string 买方的姓氏。
middleName	Type: string 买方的父权。

CurrencyType

货币代码:

RUR — 俄罗斯卢布。
UAH — 乌克兰格里夫纳。
BYR — 白俄罗斯卢布。
KZT — 哈萨克斯坦坚戈。
UZS — 乌兹别克总和。

Type

Description

CurrencyType

OrderDeliveryDTO

交付信息。

Name

Description

dates*

Type: OrderDeliveryDatesDTO

交货日期的范围。

deliveryPartnerType*

Type: OrderDeliveryPartnerType

Тип сотрудничества со службой доставки в рамках конкретного заказа.

Enum: SHOP, YANDEX_MARKET, UNKNOWN

deliveryServiceId*

Type: integer<int64>

送服务ID。

serviceName*

Type: string

送货服务的名称。

type*

Type: OrderDeliveryType

Способ доставки заказа.

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

address

Type: OrderDeliveryAddressDTO

送货地址。

如果参数指定 type 取值 DELIVERY, POST 或 PICKUP （仅适用于模型 DBS). 如果 类型=皮卡，返回取件点的地址。

courier

Type: OrderCourierDTO

关于快递员的信息。

dispatchType

Type: OrderDeliveryDispatchType

装运方法:

BUYER — 快递交付给买方。
MARKET_BRANDED_OUTLET — 送到市场的取货点。
SHOP_OUTLET — 送货到商店的订单提货点.
UNKNOWN — 未知类型。

Enum: UNKNOWN, BUYER, MARKET_BRANDED_OUTLET, SHOP_OUTLET

eacCode

Type: string

EAPP确认码（适用于类型 MERCHANT_TO_COURIER).

eacType

Type: OrderDeliveryEacType

Тип кода подтверждения ЭАПП.

Enum: MERCHANT_TO_COURIER, COURIER_TO_MERCHANT, CHECKING_BY_MERCHANT

estimated

Type: boolean

交货日期是否近似。

⦸

Type: string

店分配的配送ID。

仅当存储使用该方法在对请求的响应中传递此标识符时，才指定此标识符 POST cart.

liftPrice

Type: number

上地板的费用。

liftType

Type: OrderLiftType

将订单提升到地板的类型:

NOT_NEEDED — 不需要。
MANUAL — 手册。
ELEVATOR — 电梯。
CARGO_ELEVATOR — 货运电梯。
FREE — 上述任何一项，如果启用了自由升降选项。
UNKNOWN — 未知类型。

Enum: NOT_NEEDED, MANUAL, ELEVATOR, CARGO_ELEVATOR, FREE, UNKNOWN

outletCode

Type: string

店分配的取件点ID。

outletStorageLimitDate

Type: string<date-dd-MM-yyyy>

日期格式: DD-MM-YYYY.

Example: 23-09-2022

price

⦸

Type: number

请参阅参数中的运费 deliveryTotal.

以订单货币交付的成本。

region

Type: RegionDTO

的输送区域。

shipments

Type: OrderShipmentDTO[]

有关包裹的信息。
的包列表。

可以在参数中指定多个宗地。

Min items: 1

tracks

Type: OrderTrackDTO[]

跟踪包裹移动的信息。
有关包裹轨道号码的资料(DBS).

Min items: 1

vat

Type: OrderVatType

产品的增值税（VAT）:

NO_VAT — 增值税不收取，它仅用于某些类型的服务。
VAT_0 — 0%增值税。例如，它用于销售在出口海关程序中出口的货物，或为国际货物运输提供服务。
VAT_10 — 10%增值税。例如，它用于销售某些食品和医疗产品。
VAT_10_110 — 增值税 10/110. 10%增值税，仅适用于预付款。
VAT_20 — 增值税20%。基本增值税从2019年开始。
VAT_20_120 — 增值税 20/120. 增值税为20％，仅适用于预付款。
VAT_18 — 增值税18%。基本增值税至2019年。
VAT_18_118 — 增值税 18/118. 增值税用于预付款，直到2019年1月1日。
VAT_12 — 增值税是12％。它仅在乌兹别克斯坦使用。
VAT_05 — 增值税是5％。简化税制（USN）的增值税。
VAT_07 — 增值税是7％。简化税制（USN）的增值税。
UNKNOWN_VALUE — 未知类型。

仅与参数结合使用 付款方法=氨纶.

Enum: NO_VAT, VAT_0, VAT_10, VAT_10_110, VAT_20, VAT_20_120, VAT_18, VAT_18_118, VAT_12, VAT_05, VAT_07, UNKNOWN_VALUE

OrderItemDTO

订单中的产品列表。

Name

Description

buyerPrice*

Type: number

以买方货币计算的产品价格。价格已经包括折扣:

股份;
优惠券;
促销代码。

buyerPriceBeforeDiscount*

Type: number

在应用折扣之前，以买方货币计算的产品成本:

股份;
优惠券;
促销代码。

count*

Type: integer

积单元的数量。

id*

Type: integer<int64>

订单中的产品ID。

允许您在此订单范围内识别产品。

offerId*

Type: string

Идентификатор вашего товарного предложения для определенного товара. Описание поля в Справке Маркета для продавцов

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

offerName*

Type: string

产品名称。

price*

Type: number

以订单货币计算的产品价格，不包括促销代码、优惠券和促销折扣给卖方的报酬（参数） subsidies).

包括增值税。

vat*

Type: OrderVatType

Налог на добавленную стоимость (НДС) на товар.

Enum: NO_VAT, VAT_0, VAT_10, VAT_10_110, VAT_20, VAT_20_120, VAT_18, VAT_18_118, VAT_12, VAT_05, VAT_07, UNKNOWN_VALUE

details

⦸

Type: OrderItemDetailDTO[]

要获取有关非购买和退款的信息，请使用 GET v2/campaigns/{campaignId}/returns.

有关订单中未购买或退回物品的信息。
订单中的产品详细信息。

Min items: 1

instances

Type: OrderItemInstanceDTO[]

品单元的标签的信息。

返回请求中传递的标记数据。 PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers.

如果商店尚未发送此订单的代码, instances 缺席。
您为此职位提供的标记或故障代码。 "公平标志"代码以两个版本返回 — 有和没有密码。

Min items: 1

partnerWarehouseId

Type: string

只适用于型号 FBY

订单所在仓库的ID。

priceBeforeDiscount

⦸

Type: number

在应用折扣之前，以商店货币计算的产品成本。

promos

Type: OrderItemPromoDTO[]

有关使用促销代码，优惠券和促销活动向卖家提供商品折扣的奖励的信息。
有关使用促销代码，优惠券和促销活动向卖家提供商品折扣的奖励的信息。

Min items: 1

requiredInstanceTypes

Type: OrderItemInstanceType[]

所需产品标记的列表。
产品标签类型:

CIS — KIZ，系统中某个产品单元的标识符 "诚实的标志" 或 "ASL BELGISI" （对于Yandex Go市场的卖家）。需要填写。
CIS_OPTIONAL — KIZ，系统中某个产品单元的标识符 "诚实的标志". 填写是可选的，但在不久的将来需要转移。
UIN — WIN，唯一的标识号。
RNPT — RNPT，批次注册号。
GTD — GTD编号，货物报关。

Enum: CIS, CIS_OPTIONAL, UIN, RNPT, GTD

Min items: 1

Unique items

shopSku

⦸

Type: string

Вместо него используйте offerId.

Ваш SKU — идентификатор товара в вашей системе.

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

subsidies

Type: OrderItemSubsidyDTO[]

按类型划分的补贴清单。
对产品的所有折扣给卖方的总报酬:

通过促销代码、优惠券和促销;
加分。

包括增值税。

Min items: 1

subsidy

⦸

Type: number

相反，使用 subsidies.

向卖方支付的总报酬 DBS-交货和产品的所有折扣:

通过促销代码;
通过优惠券;
按加分;
在股票上。

OrderPaymentMethodType

订购付款方法:

如果在结账时选择付款，则值（"paymentType": "PREPAID"):
- YANDEX — 通过银行卡。
- APPLE_PAY — 苹果支付。
- GOOGLE_PAY — 谷歌支付。
- CREDIT — 赊帐。
- TINKOFF_CREDIT — 从廷科夫银行贷到的。
- TINKOFF_INSTALLMENTS — 分期付款在廷科夫银行。
- EXTERNAL_CERTIFICATE — 与礼券（例如，从Sberbank在线应用程序）。
- SBP — 通过快速支付系统。
- B2B_ACCOUNT_PREPAYMENT — 组织支付订单。
如果在收到订单时选择付款的值（"paymentType": "POSTPAID"):
- CARD_ON_DELIVERY — 通过银行卡。
- BOUND_CARD_ON_DELIVERY — 收到时附有连结的银行卡。
- BNPL_BANK_ON_DELIVERY — 超级分裂。
- BNPL_ON_DELIVERY — 分裂。
- CASH_ON_DELIVERY — 现金。
- B2B_ACCOUNT_POSTPAYMENT — 订单在交货后由组织支付。
UNKNOWN — 未知类型。

默认值: CASH_ON_DELIVERY.

Type	Description
OrderPaymentMethodType	Enum: `CASH_ON_DELIVERY`, `CARD_ON_DELIVERY`, `BOUND_CARD_ON_DELIVERY`, `BNPL_BANK_ON_DELIVERY`, `BNPL_ON_DELIVERY`, `YANDEX`, `APPLE_PAY`, `EXTERNAL_CERTIFICATE`, `CREDIT`, `GOOGLE_PAY`, `TINKOFF_CREDIT`, `SBP`, `TINKOFF_INSTALLMENTS`, `B2B_ACCOUNT_PREPAYMENT`, `B2B_ACCOUNT_POSTPAYMENT`, `UNKNOWN`

OrderPaymentType

订购付款类别:

PREPAID — 结账时付款。
POSTPAID — 在收到订单后付款。
UNKNOWN — 未知类型。

如果省略此参数，订单将在收到时支付。

Type	Description
OrderPaymentType	Enum: `PREPAID`, `POSTPAID`, `UNKNOWN`

OrderTaxSystemType

下订单时商店的税收制度:

ECHN — 统一农业税（UST）。
ENVD — 统一计算所得税（UTII）。
OSN — 一般税收制度。
PSN — 专利税制（PSN）。
USN — 简化税制（STS）。
USN_MINUS_COST — 简化的税收制度，收入减少的费用数额（USN"收入减去费用"）。
NPD — 专业收入税（NAP）。
UNKNOWN_VALUE — 未知值。仅与参数结合使用 付款方法=氨纶.

Type	Description
OrderTaxSystemType	Enum: `OSN`, `USN`, `USN_MINUS_COST`, `ENVD`, `ECHN`, `PSN`, `NPD`, `UNKNOWN_VALUE`

OrderSubsidyDTO

向卖方支付的总报酬 DBS-交货和产品的所有折扣:

通过促销代码、优惠券和促销;
按加分;
交货时（DBS).

包括增值税。

Name

Description

amount*

Type: number

补助金额。

type*

Type: OrderSubsidyType

资助类别:

YANDEX_CASHBACK — Yandex Plus订阅折扣。
SUBSIDY — 燕基科斯. 市场折扣(促销、促销代码、优惠券等))
DELIVERY — 航运折扣(DBS).

Enum: YANDEX_CASHBACK, SUBSIDY, DELIVERY

OrderBuyerType

买方类型:

PERSON — 一个自然人。
BUSINESS — 组织。

Type	Description
OrderBuyerType	Enum: `PERSON`, `BUSINESS`

OrderDeliveryDatesDTO

交货日期的范围。

Name	Description
fromDate*	Type: string<date-dd-MM-yyyy> 日期格式: `DD-MM-YYYY`. Example: `23-09-2022`
fromTime	Type: string<time> 送时间间隔的开始。它仅与参数一起传递 `类型=交付`. 时间格式：24小时, `HH：MM`. 应始终指定分钟 `00` （例外 — `23:59`). 最小值: `00:00`.
realDeliveryDate	Type: string<date-dd-MM-yyyy> 日期格式: `DD-MM-YYYY`. Example: `23-09-2022`
toDate	Type: string<date-dd-MM-yyyy> 日期格式: `DD-MM-YYYY`. Example: `23-09-2022`
toTime	Type: string<time> 送时间间隔的结束。它仅与参数一起传递 `类型=交付`. 时间格式：24小时, `HH：MM`. 应始终指定分钟 `00` （例外 — `23:59`). 最大值: `23:59`.

OrderDeliveryPartnerType

在特定订单内与送货服务的合作类型:

SHOP — 商店直接与送货服务合作或独立交付订单。
YANDEX_MARKET — 这家商店通过市场提供送货服务.
UNKNOWN — 未知类型。

Type	Description
OrderDeliveryPartnerType	Enum: `SHOP`, `YANDEX_MARKET`, `UNKNOWN`

OrderDeliveryType

订单交付方式:

DELIVERY — 快递送货。
PICKUP — 皮卡。
POST — 邮件。
DIGITAL — 用于数字商品。
UNKNOWN — 未知类型。

Type	Description
OrderDeliveryType	Enum: `DELIVERY`, `PICKUP`, `POST`, `DIGITAL`, `UNKNOWN`

OrderDeliveryAddressDTO

送货地址。

如果参数指定 type 取值 DELIVERY, POST 或 PICKUP （仅适用于模型 DBS). 如果 类型=皮卡，返回取件点的地址。

Name	Description
apartment	Type: string 公寓或办公室号码。
block	Type: string 身体。
building	Type: string 建筑。
city	Type: string 一个城市或地方。
country	Type: string 一个国家。
district	Type: string 区。
entrance	Type: string 入口号码。
entryphone	Type: string 的对讲代码。
estate	Type: string 所有权号码。
floor	Type: string 地板。
gps	Type: GpsDTO GPS-координаты.
house	Type: string 门牌号。
phone	Type: string 订单的收件人的电话号码。
postcode	Type: string 邮政编码。如果选择了邮件传递，则表示（`交货类型=POST`).
recipient	Type: string 订单收件人的姓氏，名字和父名。
street	Type: string 街道。
subway	Type: string 地铁站。

OrderCourierDTO

关于快递员的信息。

Name	Description
fullName	Type: string 快递员的全名。
phone	Type: string 快递员的电话号码。
phoneExtension	Type: string 分机电话号码。
vehicleDescription	Type: string 汽车的描述。例如，模型和颜色。
vehicleNumber	Type: string 车辆号码。

OrderDeliveryDispatchType

装运方法:

BUYER — 快递交付给买方。
MARKET_BRANDED_OUTLET — 送到市场的取货点。
SHOP_OUTLET — 送货到商店的订单提货点.
UNKNOWN — 未知类型。

Type	Description
OrderDeliveryDispatchType	Enum: `UNKNOWN`, `BUYER`, `MARKET_BRANDED_OUTLET`, `SHOP_OUTLET`

OrderDeliveryEacType

EAPP确认码的类型:

MERCHANT_TO_COURIER (暂时不退款) — 卖方将代码传送给快递员以接收非购买。
COURIER_TO_MERCHANT — 快递员将代码传送给卖方以接收订单。
CHECKING_BY_MERCHANT — 卖方检查他身边的代码。

Type	Description
OrderDeliveryEacType	Enum: `MERCHANT_TO_COURIER`, `COURIER_TO_MERCHANT`, `CHECKING_BY_MERCHANT`

OrderLiftType

将订单提升到地板的类型:

NOT_NEEDED — 不需要。
MANUAL — 手册。
ELEVATOR — 电梯。
CARGO_ELEVATOR — 货运电梯。
FREE — 上述任何一项，如果启用了自由升降选项。
UNKNOWN — 未知类型。

Type	Description
OrderLiftType	Enum: `NOT_NEEDED`, `MANUAL`, `ELEVATOR`, `CARGO_ELEVATOR`, `FREE`, `UNKNOWN`

RegionDTO

的输送区域。

Name	Description
id*	Type: integer<int64> 区域的ID。
name*	Type: string 区域的名称。
type*	Type: RegionType 区域的类型。可能的值: `CITY_DISTRICT` — 城市的面积。 `CITY` — 一个大城市。 `CONTINENT` — 大陆。 `COUNTRY_DISTRICT` — 区域。 `COUNTRY` — 国家。 `REGION` — 地区。 `REPUBLIC_AREA` — 联的主体的区。 `REPUBLIC` — 联的主体。 `SUBWAY_STATION` — 地铁站。 `VILLAGE` — 城市。 `OTHER` — 未知区域。 Enum: `OTHER`, `CONTINENT`, `REGION`, `COUNTRY`, `COUNTRY_DISTRICT`, `REPUBLIC`, `CITY`, `VILLAGE`, `CITY_DISTRICT`, `SUBWAY_STATION`, `REPUBLIC_AREA`
parent	Type: RegionDTO 的输送区域。

OrderShipmentDTO

的包列表。

可以在参数中指定多个宗地。

Name	Description
boxes	Type: OrderParcelBoxDTO[] 货物位置列表。有关货物位置的信息。 Min items: `1`
id ⦸	Type: integer<int64> Yandex分配的包裹ID。市场。
shipmentDate	Type: string<date-dd-MM-yyyy> 日期格式: `DD-MM-YYYY`. Example: `23-09-2022`
shipmentTime	Type: string 只适用于型号 Express 商店必须打包订单并将其设置为状态的时间 `READY_TO_SHIP`. 状态更改后，快递员将到达取货。该字段可能不会立即显示。在5-10分钟内请求有关订单的信息，直到它被退回。时间格式：24小时, `HH：MM`. 如果订单是由组织发出的，则在商定交货日期之前不会返回参数。
tracks	Type: OrderTrackDTO[] 只适用于型号 DBS 跟踪包裹移动的信息。有关包裹轨道号码的资料(DBS). Min items: `1`

OrderTrackDTO

有关包裹轨道号码的资料(DBS).

Name

Description

deliveryServiceId*

Type: integer<int64>

送服务ID。有关派递服务的资料，可透过要求 GET delivery/services.

trackCode

Type: string

包裹的轨道号码。

OrderVatType

产品的增值税（VAT）:

NO_VAT — 增值税不收取，它仅用于某些类型的服务。
VAT_0 — 0%增值税。例如，它用于销售在出口海关程序中出口的货物，或为国际货物运输提供服务。
VAT_10 — 10%增值税。例如，它用于销售某些食品和医疗产品。
VAT_10_110 — 增值税 10/110. 10%增值税，仅适用于预付款。
VAT_20 — 增值税20%。基本增值税从2019年开始。
VAT_20_120 — 增值税 20/120. 增值税为20％，仅适用于预付款。
VAT_18 — 增值税18%。基本增值税至2019年。
VAT_18_118 — 增值税 18/118. 增值税用于预付款，直到2019年1月1日。
VAT_12 — 增值税是12％。它仅在乌兹别克斯坦使用。
VAT_05 — 增值税是5％。简化税制（USN）的增值税。
VAT_07 — 增值税是7％。简化税制（USN）的增值税。
UNKNOWN_VALUE — 未知类型。

仅与参数结合使用 付款方法=氨纶.

Type	Description
OrderVatType	Enum: `NO_VAT`, `VAT_0`, `VAT_10`, `VAT_10_110`, `VAT_20`, `VAT_20_120`, `VAT_18`, `VAT_18_118`, `VAT_12`, `VAT_05`, `VAT_07`, `UNKNOWN_VALUE`

OrderItemDetailDTO

订单中的产品详细信息。

Name	Description
itemCount*	Type: integer<int64> 积单元的数量。
itemStatus*	Type: OrderItemStatusType 非购买或退货的商品: `REJECTED` — 不间断。 `RETURNED` — 回来了。 Enum: `REJECTED`, `RETURNED`
updateDate*	Type: string<date-dd-MM-yyyy> 日期格式: `DD-MM-YYYY`. Example: `23-09-2022`

OrderItemInstanceDTO

您为此职位提供的标记或故障代码。 "公平标志"代码以两个版本返回 — 有和没有密码。

Name	Description
cis	Type: string 系统中的单元识别码 "诚实的标志" 没有密码或 "ASL BELGISI" （对于Yandex Go市场的卖家）。
cisFull	Type: string 系统中的单元识别码 "诚实的标志" 用密码锁。
countryCode	Type: string 生产国采用ISO3166-1alpha-2格式。如何获得 Example: `RU` Min length: `2` Max length: `2` Pattern: `^[A-Z]{2}$`
gtd	Type: string 货物报关。它是由斜杠分隔的三个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXXXX。第一部分 — 登记进口货物申报的海关代码。进一步 — 声明的日期和编号。
rnpt	Type: string 品批次的注册号。它是由斜杠分隔的四个数字组成的字符串：XXXXXXX/XXXXXXX/XXXXXXX/XXX。第一部分 — 登记货物申报的海关办公室的代码。进一步 — 声明的日期、编号和声明中标记产品的编号。
uin	Type: string 珠宝的UIN(16位数字代码) 当制造商在贵金属和宝石的周转控制系统中注册产品时，他就会获得胜利。 — GIIS DMDK。

OrderItemPromoDTO

有关使用促销代码，优惠券和促销活动向卖家提供商品折扣的奖励的信息。

Name	Description
subsidy*	Type: number 作为促销活动的一部分销售的产品从市场上向卖方支付报酬。
type*	Type: OrderPromoType Тип скидки. Enum: `DIRECT_DISCOUNT`, `BLUE_SET`, `BLUE_FLASH`, `GENERIC_BUNDLE`, `MARKET_COUPON`, `MARKET_PROMOCODE`, `MARKET_BLUE`, `MARKET_COIN`, `PRICE_DROP_AS_YOU_SHOP`, `SECRET_SALE`, `CHEAPEST_AS_GIFT`, `CASHBACK`, `SPREAD_DISCOUNT_COUNT`, `SPREAD_DISCOUNT_RECEIPT`, `DISCOUNT_BY_PAYMENT_TYPE`, `PERCENT_DISCOUNT`, `DCO_EXTRA_DISCOUNT`, `UNKNOWN`
discount	Type: number 以买方货币计算的用户折扣金额。
marketPromoId	Type: string 在市场和卖方之间提供服务以促进服务的协议框架内促销的标识符。
shopPromoId	Type: string 供应商促销的ID。

OrderItemInstanceType

产品标签类型:

CIS — KIZ，系统中某个产品单元的标识符 "诚实的标志" 或 "ASL BELGISI" （对于Yandex Go市场的卖家）。需要填写。
CIS_OPTIONAL — KIZ，系统中某个产品单元的标识符 "诚实的标志". 填写是可选的，但在不久的将来需要转移。
UIN — WIN，唯一的标识号。
RNPT — RNPT，批次注册号。
GTD — GTD编号，货物报关。

Type	Description
OrderItemInstanceType	Enum: `CIS`, `CIS_OPTIONAL`, `UIN`, `RNPT`, `GTD`

OrderItemSubsidyDTO

对产品的所有折扣给卖方的总报酬:

通过促销代码、优惠券和促销;
加分。

包括增值税。

Name

Description

amount*

Type: number

补助金额。

type*

Type: OrderItemSubsidyType

资助类别:

YANDEX_CASHBACK — Yandex Plus订阅折扣。
SUBSIDY — 燕基科斯. 市场折扣(促销、促销代码、优惠券等)).

Enum: YANDEX_CASHBACK, SUBSIDY

OrderItemTagType

产品属性:

ULTIMA — 优质产品。
SAFE_TAG — 附有[防伪标签]的产品(*safe-tag).
TURBO — 迅速售罄的产品。

Type	Description
OrderItemTagType	Enum: `ULTIMA`, `SAFE_TAG`, `TURBO`

OrderSubsidyType

资助类别:

YANDEX_CASHBACK — Yandex Plus订阅折扣。
SUBSIDY — 燕基科斯. 市场折扣(促销、促销代码、优惠券等))
DELIVERY — 航运折扣(DBS).

Type	Description
OrderSubsidyType	Enum: `YANDEX_CASHBACK`, `SUBSIDY`, `DELIVERY`

GpsDTO

纬度和经度的GPS坐标。

Name

Description

latitude*

Type: number

宽度。

longitude*

Type: number

经度。

RegionType

区域的类型。

可能的值:

CITY_DISTRICT — 城市的面积。
CITY — 一个大城市。
CONTINENT — 大陆。
COUNTRY_DISTRICT — 区域。
COUNTRY — 国家。
REGION — 地区。
REPUBLIC_AREA — 联的主体的区。
REPUBLIC — 联的主体。
SUBWAY_STATION — 地铁站。
VILLAGE — 城市。
OTHER — 未知区域。

Type	Description
RegionType	Enum: `OTHER`, `CONTINENT`, `REGION`, `COUNTRY`, `COUNTRY_DISTRICT`, `REPUBLIC`, `CITY`, `VILLAGE`, `CITY_DISTRICT`, `SUBWAY_STATION`, `REPUBLIC_AREA`

OrderParcelBoxDTO

有关货物位置的信息。

Name

Description

fulfilmentId*

Type: string

店的信息系统中的货位的标识符。

id*

Type: integer<int64>

货物位置ID。

OrderItemStatusType

非购买或退货的商品:

REJECTED — 不间断。
RETURNED — 回来了。

Type	Description
OrderItemStatusType	Enum: `REJECTED`, `RETURNED`

OrderPromoType

折扣类型:

DIRECT_DISCOUNT — 直接折扣，这是由卖方或市场设置。
BLUE_SET — 工具包。
BLUE_FLASH — 一个闪光的促销。
MARKET_COUPON — 使用Yandex的折扣。市场促销代码。
MARKET_PROMOCODE — 商店促销代码的折扣。
MARKET_BLUE — Yandex的折扣。市场。
CHEAPEST_AS_GIFT — 作为礼物最便宜的项目。
CASHBACK — 现金返还。
SPREAD_DISCOUNT_COUNT — 相同商品数量的折扣。
SPREAD_DISCOUNT_RECEIPT — 收据金额的折扣.
DISCOUNT_BY_PAYMENT_TYPE — 使用Plus卡付款时可享受直接折扣。
PERCENT_DISCOUNT — 直接百分比折扣。
DCO_EXTRA_DISCOUNT — 从市场计算补贴所需的额外折扣。
UNKNOWN — 未知类型。

过时的类型:

GENERIC_BUNDLE.
MARKET_COIN.
PRICE_DROP_AS_YOU_SHOP.
SECRET_SALE.

Type	Description
OrderPromoType	Enum: `DIRECT_DISCOUNT`, `BLUE_SET`, `BLUE_FLASH`, `GENERIC_BUNDLE`, `MARKET_COUPON`, `MARKET_PROMOCODE`, `MARKET_BLUE`, `MARKET_COIN`, `PRICE_DROP_AS_YOU_SHOP`, `SECRET_SALE`, `CHEAPEST_AS_GIFT`, `CASHBACK`, `SPREAD_DISCOUNT_COUNT`, `SPREAD_DISCOUNT_RECEIPT`, `DISCOUNT_BY_PAYMENT_TYPE`, `PERCENT_DISCOUNT`, `DCO_EXTRA_DISCOUNT`, `UNKNOWN`

OrderItemSubsidyType

资助类别:

YANDEX_CASHBACK — Yandex Plus订阅折扣。
SUBSIDY — 燕基科斯. 市场折扣(促销、促销代码、优惠券等)).

Type	Description
OrderItemSubsidyType	Enum: `YANDEX_CASHBACK`, `SUBSIDY`

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

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

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

这篇文章是否有用？

传送外部订单ID

订单状态的巨大变化