从12月31日开始,push API方法将不可用。 从10月1日开始,它们可能不稳定。

要接收有关订单取消的信息,请启用API通知。 怎么做

买方取消订单的通知

通知商店客户想要取消订单,该订单处于状态 DELIVERYPICKUP. 取消的原因在字段中注明 substatus.

请务必以请求响应请求。 PUT v2/campaigns/{campaignId}/orders/{orderId}/cancellation/accept — 如果买方尚未收到产品,则确认取消,或者如果产品已经由买方拥有,则拒绝请求。

订单收到后已选择付款。

不会有取消请求。 订单将自动取消,您将收到有关状态更改的通知。

如果您没有完成请求 PUT v2/campaigns/{campaignId}/orders/{orderId}/cancellation/accept 在48小时内,取消将自动确认。

有关买方和订单收件人的个人信息

状态下的订单 RESERVEDUNPAID,以及在变电站 RESERVATION_EXPIREDUSER_NOT_PAID 状况 CANCELLED 有关买方和订单收件人的个人信息不可用。 不显示以下参数:

  • 参数 apartment, entrance, entryphonerecipient,嵌套在参数中 address;
  • 参数 buyer 以及所有嵌套在其中的参数。

接收响应超时:10秒。

Request

POST

/order/cancellation/notify

Body

application/json
{
    "order": {
        "businessId": 0,
        "id": 0,
        "status": "PLACING",
        "substatus": "RESERVATION_EXPIRED",
        "creationDate": "23-09-2022 09:12:41",
        "currency": "RUR",
        "itemsTotal": 0,
        "total": 0,
        "deliveryTotal": 0,
        "subsidyTotal": 0,
        "totalWithSubsidy": 0,
        "subsidies": [
            {
                "type": "YANDEX_CASHBACK",
                "amount": 0
            }
        ],
        "buyerItemsTotal": 0,
        "buyerTotal": 0,
        "buyerItemsTotalBeforeDiscount": 0,
        "buyerTotalBeforeDiscount": 0,
        "paymentType": "PREPAID",
        "paymentMethod": "SHOP_PREPAID",
        "fake": false,
        "shopOrderId": "string",
        "items": [
            {
                "id": 0,
                "feedId": 0,
                "offerId": "string",
                "feedCategoryId": "string",
                "offerName": "string",
                "fulfilmentShopId": 0,
                "price": 0,
                "buyerPrice": 0,
                "buyerPriceBeforeDiscount": 0,
                "priceBeforeDiscount": 0,
                "count": 0,
                "delivery": false,
                "vat": "NO_VAT",
                "shopSku": "string",
                "sku": "string",
                "subsidy": 0,
                "subsidies": [
                    {
                        "type": "YANDEX_CASHBACK",
                        "amount": 0
                    }
                ],
                "warehouseId": 0,
                "partnerWarehouseId": "string",
                "params": "string",
                "promos": [
                    {
                        "type": "DIRECT_DISCOUNT",
                        "subsidy": 0,
                        "marketPromoId": "string"
                    }
                ],
                "instances": [
                    {
                        "cis": "string",
                        "cisFull": "string",
                        "uin": "string",
                        "rnpt": "string",
                        "gtd": "string",
                        "countryCode": "RU"
                    }
                ],
                "tags": [
                    "ULTIMA"
                ]
            }
        ],
        "notes": "string",
        "taxSystem": "OSN",
        "expiryDate": "23-09-2022",
        "electronicAcceptanceCertificateCode": "string",
        "tags": [
            "ULTIMA"
        ],
        "buyer": {
            "id": "string",
            "lastName": "string",
            "firstName": "string",
            "middleName": "string",
            "type": "PERSON"
        },
        "delivery": {
            "shopDeliveryId": "string",
            "type": "DELIVERY",
            "serviceName": "string",
            "price": 0,
            "subsidy": 0,
            "deliveryPartnerType": "SHOP",
            "dates": {
                "fromDate": "23-09-2022",
                "toDate": "23-09-2022",
                "fromTime": "string",
                "toTime": "string",
                "realDeliveryDate": "23-09-2022"
            },
            "region": {
                "id": 0,
                "name": "string",
                "type": "OTHER"
            },
            "vat": "NO_VAT",
            "deliveryServiceId": 0,
            "liftType": "NOT_NEEDED",
            "liftPrice": 0,
            "outlet": {
                "code": "string"
            },
            "dispatchType": "UNKNOWN",
            "shipments": [
                {
                    "id": 0,
                    "status": "NEW",
                    "shipmentDate": "23-09-2022",
                    "shipmentTime": "string",
                    "weight": 0,
                    "width": 0,
                    "height": 0,
                    "depth": 0,
                    "boxes": [
                        {
                            "id": 0,
                            "weight": 0,
                            "width": 0,
                            "height": 0,
                            "depth": 0,
                            "items": [
                                {
                                    "id": 0,
                                    "count": 0
                                }
                            ]
                        }
                    ]
                }
            ],
            "estimated": false,
            "eacType": "MERCHANT_TO_COURIER",
            "courier": {
                "fullName": "string",
                "phone": "string",
                "phoneExtension": "string",
                "vehicleNumber": "string",
                "vehicleDescription": "string"
            },
            "address": {
                "country": "string",
                "postcode": "string",
                "city": "string",
                "district": "string",
                "subway": "string",
                "street": "string",
                "house": "string",
                "block": "string",
                "entrance": "string",
                "entryphone": "string",
                "floor": "string",
                "apartment": "string",
                "lat": 0,
                "lon": 0,
                "notes": "string",
                "outletPhones": [
                    "string"
                ],
                "schedule": [
                    {
                        "fromDay": "MONDAY",
                        "toDay": "MONDAY",
                        "fromTime": "string",
                        "toTime": "string"
                    }
                ],
                "phone": "string",
                "recipient": "string"
            }
        }
    }
}

Name

Description

order*

Type: OrderStatusShopOrderDTO

秩序。

OrderStatusShopOrderDTO

Name

Description

businessId

Type: integer<int64>

内阁ID。

buyer

Type: OrderBuyerDTO

有关买方的信息。

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

buyerItemsTotal

Type: number<decimal>

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

buyerItemsTotalBeforeDiscount

Type: number<decimal>

在应用折扣和不包括运输成本之前,订单中所有项目的成本以买方的货币计算。

buyerTotal

Type: number<decimal>

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

buyerTotalBeforeDiscount

Type: number<decimal>

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

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

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

Принимает значение RUR — российский рубль.

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

交付信息。

deliveryTotal

Type: number<decimal>

以订单货币交付的成本。

electronicAcceptanceCertificateCode

Type: string

只适用于型号 FBS

一个六位数的确认代码:

  • 将快件订单转给速递员;
  • 收到快递员未付的快递订单。

提供了有关使用代码的详细信息 在市场对卖家的帮助.

expiryDate

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

Дата, после которой заказ будет отменен, если не сменит статус.

Формат даты: DD-MM-YYYY.

Example: 23-09-2022

fake

Type: boolean

订单类型:

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

  • true — 一个测试市场秩序。

id

Type: integer<int64>

的订单ID。

items

Type: ShopOrderItemDTO[]

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

itemsTotal

Type: number<decimal>

订单货币中的订单总额,不包括促销代码,优惠券和促销折扣的交付成本和报酬(参数 subsidyTotal).

notes

Type: string

对订单进行评论。

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: SHOP_PREPAID, BANK_CARD, YANDEX_MONEY, CASH_ON_DELIVERY, CARD_ON_DELIVERY, BOUND_CARD_ON_DELIVERY, BNPL_BANK_ON_DELIVERY, BNPL_ON_DELIVERY, YANDEX, APPLE_PAY, EXTERNAL_CERTIFICATE, CREDIT, INSTALLMENT, GOOGLE_PAY, TINKOFF_CREDIT, SBP, TINKOFF_INSTALLMENTS, B2B_ACCOUNT_PREPAYMENT, B2B_ACCOUNT_POSTPAYMENT, UNKNOWN

paymentType

Type: OrderPaymentType

订购付款类别:

  • PREPAID — 结账时付款。

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

  • UNKNOWN — 未知类型。

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

Enum: PREPAID, POSTPAID, UNKNOWN

shopOrderId

Type: string

商店中的订单ID。

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

subsidies

Type: OrderSubsidyDTO[]

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

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

subsidyTotal

Type: number<decimal>

给卖方折扣的报酬总额:

  • 通过促销代码;
  • 通过优惠券;
  • 对于股份;
  • 交付补贴。

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

tags

Type: OrderTag[]

命令的迹象。
订单属性:

  • ULTIMA — 优质产品的订单。

Enum: ULTIMA

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

total

Type: number<decimal>

以订单货币计算的订单总额,包括交货成本,但不包括对促销代码、优惠券、现金回赠和促销折扣的报酬(参数) subsidyTotal).

totalWithSubsidy

Type: number<decimal>

订单中所有商品的成本和商店货币的报酬之和(参数之和) totalsubsidyTotal).

OrderBuyerDTO

有关买方的信息。

参数 id, lastName, firstNamemiddleName 只有当您根据模型工作时,才会返回它们。 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

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

OrderStatusDeliveryDTO

Name

Description

address

Type: ShopOrderDeliveryAddressDTO

只适用于型号 DBS

送货地址。 如果参数传递 type 这很重要 DELIVERY.
送货地址。 如果参数传递 type 这很重要 DELIVERY.

courier

Type: OrderCourierDTO

Только для модели Express

Информация о курьере.

dates

Type: OrderDeliveryDatesDTO

Только для модели DBS

Диапазон дат доставки.

deliveryPartnerType

Type: OrderDeliveryPartnerType

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

Enum: SHOP, YANDEX_MARKET, UNKNOWN

deliveryServiceId

Type: integer<int64>

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

dispatchType

Type: OrderDeliveryDispatchType

Только для модели DBS

Способ отгрузки.

Enum: UNKNOWN, BUYER, MARKET_BRANDED_OUTLET, SHOP_OUTLET

eacType

Type: OrderDeliveryEacType

Только для модели Express

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

Enum: MERCHANT_TO_COURIER, COURIER_TO_MERCHANT, CHECKING_BY_MERCHANT

estimated

Type: boolean

只适用于型号 DBS

指示订单的交货日期尚未确认的标志。 它是根据订单发送的产品,交货时间很长(31-60天)。 最终交货日期必须发送给Yandex。自订单提交请求之日起7天内上市。 PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/date.

liftPrice

Type: number<decimal>

只适用于型号 DBS

上地板的费用。

liftType

Type: OrderLiftType

Только для модели DBS

Тип подъема заказа на этаж.

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

outlet

Type: ShopOutletDTO

Только для модели DBS

Пункт самовывоза, выбранный покупателем для получения заказа. Не возвращается в ответе, если покупатель выбрал получение заказа в брендированном пункте выдачи заказов Маркета (значение MARKET_BRANDED_OUTLET параметра dispatchType).

price

Type: number<decimal>

请勿使用此选项。

region

Type: ShopRegionDTO

的输送区域。

serviceName

Type: string

送货服务的名称。

shipments

Type: ShopOrderShipmentDTO[]

有关包裹的信息。

**对于模型 DBS:**如果订单是在市场提货点创建的,则会发送。
的包列表。

shopDeliveryId

Type: string

只适用于型号 DBS

店分配的配送ID。

仅当存储使用该方法在对请求的响应中传递此标识符时,才指定此标识符 POST cart 在参数中 id,嵌入在 deliveryOptions.

subsidy

Type: number<decimal>

交付补贴。

type

Type: OrderDeliveryType

订单交付方法:

  • DELIVERY — 快递送货。

  • PICKUP — 皮卡。

  • POST — 邮件。

  • DIGITAL — 用于数字商品。

  • UNKNOWN — 未知类型。

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

vat

Type: OrderVatType

Только для модели DBS

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

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

ShopOrderItemDTO

订单中的产品列表。

Name

Description

buyerPrice

Type: number<decimal>

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

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

向后兼容性

过时的参数也被填写。 buyer-price. 使用参数 buyerPrice.

buyerPriceBeforeDiscount

Type: number<decimal>

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

count

Type: integer

积单元的数量。

delivery

Type: boolean

只适用于型号 FBS

将产品交付到请求中指定的区域:

  • false — 产品没有交付到指定的区域。
  • true — 默认值是产品交付到指定区域。

接受在参数中传递的值 delivery,嵌入在 items,响应请求 POST cart.

feedCategoryId

Type: string

只适用于型号 DBS

文件夹中指定的类别的ID。

feedId

Type: integer<int64>

产品目录的ID。

fulfilmentShopId

Type: integer<int64>

产品供应商的ID。

要找到答案,请登录市场上的卖家帐户并点击其名称。 ID在字段中指定 商店ID 在所需仓库的行中。

id

Type: integer<int64>

订单中的产品ID。

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

instances

Type: OrderItemInstanceDTO[]

品单元的标签的信息。

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

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

offerId

Type: string

你的 SKU — 系统中的产品ID。

使用规则 SKU:

  • 对于每个产品 SKU 一定有一个。

  • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助.

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

offerName

Type: string

只适用于型号 DBS

产品名称。

params

Type: string

品特性(例如,其颜色)。

partnerWarehouseId

Type: string

只适用于型号 FBS

为其下订单的商店系统中仓库的ID。

price

Type: number<decimal>

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

priceBeforeDiscount

Type: number<decimal>

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

promos

Type: OrderItemPromoDTO[]

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

shopSku

Type: string

你的 SKU — 系统中的产品ID。

使用规则 SKU:

  • 对于每个产品 SKU 一定有一个。

  • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助.

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

sku

Type: string

SKU 在市场上 — 市场上当前产品卡的ID。

subsidies

Type: OrderItemSubsidyDTO[]

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

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

subsidy

Type: number<decimal>

相反,使用 subsidies.

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

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

tags

Type: ItemTag[]

产品属性。
产品属性:

  • ULTIMA — 优质产品。
  • SAFE_TAG — 有安全标签的物品。 它有助于消除退货时商品的替代。 如果没有购买时存在的保护标签,您将无法退回产品。
  • TURBO — 迅速售罄的产品。

Enum: ULTIMA, SAFE_TAG, TURBO

vat

Type: OrderVatType

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

Используется только совместно с параметром "paymentMethod": "YANDEX".

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

warehouseId

Type: integer<int64>

只适用于型号 FBS

市场上仓库的ID。

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: SHOP_PREPAID, BANK_CARD, YANDEX_MONEY, CASH_ON_DELIVERY, CARD_ON_DELIVERY, BOUND_CARD_ON_DELIVERY, BNPL_BANK_ON_DELIVERY, BNPL_ON_DELIVERY, YANDEX, APPLE_PAY, EXTERNAL_CERTIFICATE, CREDIT, INSTALLMENT, 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

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

OrderSubsidyDTO

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

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

Name

Description

amount

Type: number<decimal>

补助金额。

type

Type: OrderSubsidyType

资助类别:

  • YANDEX_CASHBACK — Yandex Plus订阅折扣。

  • SUBSIDY — 燕基科斯. 市场折扣(促销、促销代码、优惠券等))

  • DELIVERY — 航运折扣(DBS).

Enum: YANDEX_CASHBACK, SUBSIDY, DELIVERY

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

OrderTag

订单属性:

  • ULTIMA — 优质产品的订单。

Type

Description

OrderTag

Enum: ULTIMA

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

OrderBuyerType

买方类型:

  • PERSON — 一个自然人。

  • BUSINESS — 组织。

Type

Description

OrderBuyerType

Enum: PERSON, BUSINESS

ShopOrderDeliveryAddressDTO

Name

Description

apartment

Type: string

公寓或办公室号码。

block

Type: string

建筑物或建筑物。

city

Type: string

一个城市或地方。

所需参数。

country

Type: string

一个国家。

如果选择了将订单交付到市场提货点,则可选参数。

district

Type: string

区。

entrance

Type: string

入口号码。

entryphone

Type: string

的对讲代码。

floor

Type: string

地板。

house

Type: string

房屋或财产的编号。

所需参数。

lat

Type: number<decimal>

宽度。

如果客户选择将订单交付到品牌市场提货点,则指定此参数。

我们不保证它会被填写,因为这是一个可选字段。

lon

Type: number<decimal>

经度。

如果客户选择将订单交付到品牌市场提货点,则指定此参数。

我们不保证它会被填写,因为这是一个可选字段。

notes

Type: string

地址的注释。 例如, 从庭院入口.

如果客户选择将订单交付到品牌市场提货点,则指定此参数。

outletPhones

Type: string[]

接机点的电话号码格式 8 812 123-45-67 890 (890 — 延伸)。

如果客户选择将订单交付到品牌市场提货点,则指定此参数。

phone

Type: string

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

所需参数。

postcode

Type: string

邮政编码。

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

recipient

Type: string

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

所需参数。

schedule

Type: ShopOutletScheduleItemDTO[]

接送点的开放时间。

如果客户选择将订单交付到品牌市场提货点,则指定此参数。
销售点的开放时间。

street

Type: string

街道。

subway

Type: string

地铁站。

OrderCourierDTO

关于快递员的信息。

Name

Description

fullName

Type: string

快递员的全名。

phone

Type: string

快递员的电话号码。

phoneExtension

Type: string

分机电话号码。

vehicleDescription

Type: string

汽车的描述。 例如,模型和颜色。

vehicleNumber

Type: string

车辆号码。

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>

Дата, когда товар доставлен до пункта выдачи заказа (в случае самовывоза) или до покупателя (если заказ доставляет курьер).

Example: 23-09-2022

toDate

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

Самая поздняя дата доставки.

Если параметр toDate не указан, единственно возможной датой доставки считается дата, указанная в параметре fromDate.

Формат даты: 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

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

ShopOutletDTO

买方为接收订单而选择的提货点。 如果买方选择在品牌市场订单提货点(价值)接收订单,则不会在响应中返回 MARKET_BRANDED_OUTLET 参数 dispatchType).

Name

Description

code

Type: string

店分配的取件点ID。

ShopRegionDTO

的输送区域。

Name

Description

name*

Type: string

区域的名称。

type*

Type: ShopRegionType

Тип региона.

Enum: OTHER, CITY_DISTRICT, CITY, CONTINENT, COUNTRY_DISTRICT, COUNTRY, REGION, METRO_STATION, MONORAIL_STATION, OVERSEAS_TERRITORY, SECONDARY_DISTRICT, SETTLEMENT, SUBJECT_FEDERATION, SUBJECT_FEDERATION_DISTRICT, VILLAGE, SUBURB

id

Type: integer<int64>

区域的ID。

parent

Type: ShopRegionDTO

的输送区域。

ShopOrderShipmentDTO

的包列表。

Name

Description

boxes

Type: ShopOrderParcelBoxDTO[]

货物位置列表。
有关货物位置的信息。

depth

Type: integer<int64>

以厘米为单位的包装顺序的深度。

如果订单是由市场的合作伙伴服务(deliveryPartnerType=YANDEX_MARKET).

height

Type: integer<int64>

以厘米为单位的包装顺序的高度。

如果订单是由市场的合作伙伴服务(deliveryPartnerType=YANDEX_MARKET).

id

Type: integer<int64>

Yandex分配的包裹ID。市场。

shipmentDate

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

День, в который нужно отгрузить заказ службе доставки.

Формат даты: DD-MM-YYYY.

Для модели FBS: если заказ сделан организацией, параметр не возвращается до согласования даты доставки.

Для модели DBS: если вы не передали параметр shipmentDate, то днем отгрузки будет считаться дата, которая предшествует дате доставки в fromDate.

Example: 23-09-2022

shipmentTime

Type: string<time>

只适用于型号 Express

商店必须打包订单并将其设置为状态的时间 READY_TO_SHIP. 状态更改后,快递员将到达取货。

时间格式:24小时, HH:MM.

如果订单是由组织发出的,则在商定交货日期之前不会返回参数。

status

Type: OrderParcelStatusType

合作伙伴送货服务中的订单状态:

  • NEW — 新的。

  • CREATED — 交付服务中创建的。

  • READY_TO_SHIP — 准备转移到送货服务。

  • ERROR — 订单创建错误。

  • UNKNOWN — 状态不明。

Enum: NEW, CREATED, READY_TO_SHIP, ERROR, UNKNOWN

weight

Type: integer<int64>

以克为单位的包装订单的重量。

如果订单是由市场的合作伙伴服务(deliveryPartnerType=YANDEX_MARKET).

width

Type: integer<int64>

以厘米为单位的包装订单的宽度。

如果订单是由市场的合作伙伴服务(deliveryPartnerType=YANDEX_MARKET).

OrderDeliveryType

订单交付方法:

  • DELIVERY — 快递送货。

  • PICKUP — 皮卡。

  • POST — 邮件。

  • DIGITAL — 用于数字商品。

  • UNKNOWN — 未知类型。

Type

Description

OrderDeliveryType

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

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

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/XXXXXXXXX/XXXXXXXXXXX。

第一部分 — 登记进口货物申报的海关代码。 进一步 — 声明的日期和编号。

rnpt

Type: string

品批次的注册号。

它是由斜杠分隔的四个数字组成的字符串:XXXXXXX/XXXXXXX/XXXXXXX/XXX。

第一部分 — 登记货物申报的海关办公室的代码。 进一步 — 声明的日期、编号和声明中标记产品的编号。

uin

Type: string

珠宝的UIN(16位数字代码) 当制造商在贵金属和宝石的周转控制系统中注册产品时,他就会获得胜利。 — GIIS DMDK。

OrderItemPromoDTO

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

Name

Description

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

marketPromoId

Type: string

在市场和卖方之间提供服务以促进服务的协议框架内的促销标识符。

subsidy

Type: number<decimal>

作为促销活动的一部分销售的产品从市场上向卖方支付报酬。

OrderItemSubsidyDTO

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

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

Name

Description

amount

Type: number<decimal>

补助金额。

type

Type: OrderItemSubsidyType

资助类别:

  • YANDEX_CASHBACK — Yandex Plus订阅折扣。

  • SUBSIDY — 燕基科斯. 市场折扣(促销、促销代码、优惠券等)).

Enum: YANDEX_CASHBACK, SUBSIDY

ItemTag

产品属性:

  • ULTIMA — 优质产品。
  • SAFE_TAG — 有安全标签的物品。 它有助于消除退货时商品的替代。 如果没有购买时存在的保护标签,您将无法退回产品。
  • TURBO — 迅速售罄的产品。

Type

Description

ItemTag

Enum: ULTIMA, SAFE_TAG, TURBO

OrderSubsidyType

资助类别:

  • YANDEX_CASHBACK — Yandex Plus订阅折扣。

  • SUBSIDY — 燕基科斯. 市场折扣(促销、促销代码、优惠券等))

  • DELIVERY — 航运折扣(DBS).

Type

Description

OrderSubsidyType

Enum: YANDEX_CASHBACK, SUBSIDY, DELIVERY

ShopOutletScheduleItemDTO

销售点的开放时间。

Name

Description

fromDay*

Type: DayOfWeekType

День недели, в который пункт выдачи начинает работать:

  • MONDAY — понедельник.
  • TUESDAY — вторник.
  • WEDNESDAY — среда.
  • THURSDAY — четверг.
  • FRIDAY — пятница.
  • SATURDAY — суббота.
  • SUNDAY — воскресенье.

Обязательный параметр.

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

fromTime*

Type: string

接点的开始时间。 时间格式:24小时, HH:MM.

所需参数。

Min length: 1

toDay*

Type: DayOfWeekType

День недели, в который пункт выдачи заканчивает работать:

  • MONDAY — понедельник.
  • TUESDAY — вторник.
  • WEDNESDAY — среда.
  • THURSDAY — четверг.
  • FRIDAY — пятница.
  • SATURDAY — суббота.
  • SUNDAY — воскресенье.

Обязательный параметр.

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

toTime*

Type: string

取点的结束时间。 时间格式:24小时, HH:MM.

所需参数。

Min length: 1

ShopRegionType

地区类型:

  • CITY_DISTRICT — 城市的面积。

  • CITY — 一个大城市。

  • CONTINENT — 大陆。

  • COUNTRY_DISTRICT — 联邦区。

  • COUNTRY — 国家。

  • REGION — 地区。

  • METRO_STATION — 地铁站。

  • MONORAIL_STATION — 单轨铁路站。

  • OVERSEAS_TERRITORY — 位于世界另一地区的一个国家的一个单独领土(例如安圭拉、格陵兰、百慕大等)。).

  • SECONDARY_DISTRICT — 二级市辖区(例如,对于莫斯科自治区,二级区是Izmailovo,Novokosino,Perovo等。).

  • SETTLEMENT — 结算。

  • SUBJECT_FEDERATION — 联的主体。

  • SUBJECT_FEDERATION_DISTRICT — 联的主体的区。

  • VILLAGE — 城市。

  • SUBURB — 郊区。

  • OTHER — 未知区域。

Type

Description

ShopRegionType

Enum: OTHER, CITY_DISTRICT, CITY, CONTINENT, COUNTRY_DISTRICT, COUNTRY, REGION, METRO_STATION, MONORAIL_STATION, OVERSEAS_TERRITORY, SECONDARY_DISTRICT, SETTLEMENT, SUBJECT_FEDERATION, SUBJECT_FEDERATION_DISTRICT, VILLAGE, SUBURB

ShopOrderParcelBoxDTO

有关货物位置的信息。

Name

Description

depth

Type: integer<int64>

厘米为单位的货物区域的深度。

height

Type: integer<int64>

以厘米为单位的货物区域的高度。

id

Type: integer<int64>

货物区的ID。

items

Type: ShopOrderBoxItemDTO[]

箱的信息。

weight

Type: integer<int64>

以克为单位的货物空间的重量。

width

Type: integer<int64>

以厘米为单位的货物区域的宽度。

OrderParcelStatusType

合作伙伴送货服务中的订单状态:

  • NEW — 新的。

  • CREATED — 交付服务中创建的。

  • READY_TO_SHIP — 准备转移到送货服务。

  • ERROR — 订单创建错误。

  • UNKNOWN — 状态不明。

Type

Description

OrderParcelStatusType

Enum: NEW, CREATED, READY_TO_SHIP, ERROR, UNKNOWN

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

DayOfWeekType

星期几:

  • MONDAY — 星期一。
  • TUESDAY — 星期二。
  • WEDNESDAY — 星期三。
  • THURSDAY — 星期四。
  • FRIDAY — 星期五。
  • SATURDAY — 星期六。
  • SUNDAY — 星期天。

Type

Description

DayOfWeekType

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

ShopOrderBoxItemDTO

箱的信息。

Name

Description

count

Type: integer

箱内产品的数量。

id

Type: integer<int64>

箱的ID。

Responses

200 OK

一个空洞的答案。

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