更改订单的状态

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

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

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

  • 如果商店已确认并准备装运订单，则订单从状态 "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: object

status*

Type: string

订单状况:

  • 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: object

dates
Type: object

realDeliveryDate

Type: string<date>

只适用于型号 DBS

实际交货日期。

何时传递参数 realDeliveryDate:

  • 如果:

    • 将订单转移到除 PICKUP 或 DELIVERED;
    • 将订单状态更改为 PICKUP 或 DELIVERED 交货当天 — 将注明请求完成日期。

  • 如果您要将订单转换为状态，请发送交货日期 PICKUP 或 DELIVERED 不是在交货当天。 您不能指定未来的交货日期。

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

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

    日期格式: YYYY-MM-DD.

交货日期的范围。

交付信息。

substatus

Type: string

订单处理阶段（状态 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 — 取货点的订单保质期已过期。

    • 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

秩序。

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,
            "logisticPointId": 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"
    },
    "operation": {
        "id": "string",
        "type": "ORDER_RECIPIENT_UPDATE"
    }
}

Name

Description

operation
Type: object

id*

Type: string

操作的ID。

Min length: 1

Max length: 1000

type*

Type: string

操作类型:

  • ORDER_RECIPIENT_UPDATE — 更改收件人的数据。

  • ORDER_DELIVERY_INTERVAL_UPDATE — 更改交货日期间隔。

  • ORDER_STATUS_UPDATE — 更新订单状态以将其取消。

  • RETURN_CANCELLATION — 取消退款。

Enum: ORDER_RECIPIENT_UPDATE, ORDER_DELIVERY_INTERVAL_UPDATE, ORDER_STATUS_UPDATE, RETURN_CANCELLATION

操作的信息。

order
Type: object

buyer*
Type: object

type*

Type: string

买方类型:

  • PERSON — 一个自然人。

  • BUSINESS — 组织。

Enum: PERSON, BUSINESS

firstName

Type: string

姓名。

id

Type: string

买方的ID。

lastName

Type: string

姓。

middleName

Type: string

中间名。

有关买方的信息。

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

buyerItemsTotalBeforeDiscount*

Type: number

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

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

creationDate*

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

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

currency*

Type: string

货币代码:

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

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: object

dates*
Type: object

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.

交货日期的范围。

deliveryPartnerType*

Type: string

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

  • SHOP — 商店直接与送货服务合作或独立交付订单。

  • YANDEX_MARKET — 这家商店通过市场提供送货服务.

  • UNKNOWN — 未知类型。

Enum: SHOP, YANDEX_MARKET, UNKNOWN

deliveryServiceId*

Type: integer<int64>

送服务ID。

serviceName*

Type: string

送货服务的名称。

type*

Type: string

订单交付方式:

  • DELIVERY — 快递送货。

  • PICKUP — 皮卡。

  • POST — 邮件。

  • DIGITAL — 用于数字商品。

  • UNKNOWN — 未知类型。

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

address
Type: object

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: object

latitude*

Type: number

宽度。

longitude*

Type: number

经度。

纬度和经度的GPS坐标。

house

Type: string

门牌号。

phone

Type: string

订单的收件人的电话号码。

postcode

Type: string

邮政编码。

如果选择了邮件传递，则表示（交货类型=POST).

recipient

Type: string

订单收件人的姓氏，名字和父名。

street

Type: string

街道。

subway

Type: string

地铁站。

送货地址。

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

courier
Type: object

fullName

Type: string

全名。

phone

Type: string

电话号码。

phoneExtension

Type: string

分机电话号码。

vehicleDescription

Type: string

车辆的描述。 例如，模型和颜色。

vehicleNumber

Type: string

车辆号码。

关于快递员的信息。

dispatchType

Type: string

装运方法:

  • BUYER — 快递交付给买方。

  • MARKET_BRANDED_OUTLET — 送到市场的取货点。

  • SHOP_OUTLET — 送货到商店的订单提货点.

  • UNKNOWN — 未知类型。

Enum: UNKNOWN, BUYER, MARKET_BRANDED_OUTLET, SHOP_OUTLET

eacCode

Type: string

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

eacType

Type: string

EAPP确认码的类型:

  • MERCHANT_TO_COURIER (暂时不退款) — 卖方将代码传送给快递员以接收非购买。

  • COURIER_TO_MERCHANT — 快递员将代码传送给卖方以接收订单。

  • CHECKING_BY_MERCHANT — 卖方检查他身边的代码。

Enum: MERCHANT_TO_COURIER, COURIER_TO_MERCHANT, CHECKING_BY_MERCHANT

estimated

Type: boolean

交货日期是否近似。

id

⦸

Type: string

店分配的配送ID。

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

liftPrice

Type: number

上地板的费用。

liftType

Type: string

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

  • NOT_NEEDED — 不需要。

  • MANUAL — 手册。

  • ELEVATOR — 电梯。

  • CARGO_ELEVATOR — 货运电梯。

  • FREE — 以上任何一项，如果启用了自由升降选项。

  • UNKNOWN — 未知类型。

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

logisticPointId

Type: integer<int64>

取件点的ID。

使用该方法可以找到 POST v1/businesses/{businessId}/logistics-points.

Min value: 1

outletCode

Type: string

店分配的取件点ID。

outletStorageLimitDate

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

日期格式: DD-MM-YYYY.

Example: 23-09-2022

price

⦸

Type: number

请参阅参数中的运费 deliveryTotal.

以订单货币交付的成本。

region
Type: object

id*

Type: integer<int64>

区域的ID。

name*

Type: string

区域的名称。

type*

Type: string

区域的类型。

可能的值:

  • 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: any

有关父区域的信息。

父区域指定到国家级别。

的输送区域。

shipments

Type: object[]

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

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

Min items: 1

tracks

Type: object[]

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

Min items: 1

vat

Type: string

产品或交付的增值税:

  • 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

交付信息。

deliveryTotal*

Type: number

交付的成本。

fake*

Type: boolean

订单类型:

  • false — 真正的客户的订单。

  • true — 测试订单 燕基科斯. 市场。

id*

Type: integer<int64>

的订单ID。

items*

Type: object[]

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

itemsTotal*

Type: number

买方付款。

paymentMethod*

Type: string

订购付款方法:

  • 如果在结账时选择付款，则值（"paymentType": "PREPAID"):

    • YANDEX — 通过银行卡。

    • APPLE_PAY — Apple Pay（未使用）。

    • GOOGLE_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: string

订购付款类别:

  • PREPAID — 结账时付款。

  • POSTPAID — 在收到订单后付款。

  • UNKNOWN — 未知类型。

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

Enum: PREPAID, POSTPAID, UNKNOWN

status*

Type: string

订单状况:

  • 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: string

订单处理阶段（状态 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 — 取货点的订单保质期已过期。

    • 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

taxSystem*

Type: string

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

  • 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>

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: object[]

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

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

包括增值税。

Min items: 1

updatedAt

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

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

秩序。

400 Bad Request

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

Body

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

401 Unauthorized

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

Body

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

403 Forbidden

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

Body

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

404 Not Found

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

Body

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

420 Method Failure

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

Body

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

500 Internal Server Error

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

Body

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

Name

Description

errors

Type: object[]

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

Min items: 1

status

Type: string

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

No longer supported, please use an alternative and newer version.

上一篇
传送外部订单ID
下一篇
订单状态的巨大变化