Request
Responses
200 OK
400 Bad Request
401 Unauthorized
- Body
403 Forbidden
- Body
404 Not Found
- Body
420 Method Failure
- Body
500 Internal Server Error
- Body

Изменение статуса заказа

Info

Console

Изменяет статус заказа. Возможные изменения статусов:

Если магазин подтвердил и подготовил заказ к отправке, то заказ из статуса "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".

⚙️ Лимит: 1 000 000 запросов в час

Request

PUT

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

Path parameters

Name

Description

campaignId*

Type: integer<int64>

Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете.

Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

orderId*

Type: integer<int64>

Идентификатор заказа.

Body

application/json

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

Name

Description

order*

Type: OrderStatusChangeDTO

Заказ.

OrderStatusChangeDTO

Заказ.

Name	Description
status*	Type: OrderStatusType Статус заказа: `CANCELLED` — отменен. `DELIVERED` — получен покупателем. `DELIVERY` — передан в службу доставки. `PICKUP` — доставлен в пункт самовывоза. `PROCESSING` — находится в обработке. `PENDING` — ожидает обработки со стороны продавца. `UNPAID` — оформлен, но еще не оплачен (если выбрана оплата при оформлении). `PLACING` — оформляется, подготовка к резервированию. `RESERVED` — зарезервирован, но недооформлен. `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`: `PROCESSING_EXPIRED` — значение более не используется. `REPLACING_ORDER` — покупатель решил заменить товар другим по собственной инициативе. `RESERVATION_EXPIRED` — покупатель не завершил оформление зарезервированного заказа в течение 10 минут. `SHOP_FAILED` — магазин не может выполнить заказ. `USER_CHANGED_MIND` — покупатель отменил заказ по личным причинам. `USER_NOT_PAID` — покупатель не оплатил заказ (для типа оплаты `PREPAID`) в течение 30 минут. `USER_REFUSED_DELIVERY` — покупателя не устроили условия доставки. `USER_REFUSED_PRODUCT` — покупателю не подошел товар. `USER_REFUSED_QUALITY` — покупателя не устроило качество товара. `USER_UNREACHABLE` — не удалось связаться с покупателем. Для отмены с этой причиной необходимо выполнить условия: не менее 3 звонков с 8 до 21 в часовом поясе покупателя; перерыв между первым и третьим звонком не менее 90 минут; соединение не короче 5 секунд. Если хотя бы одно из этих условий не выполнено (кроме случая, когда номер недоступен), отменить заказ не получится. Вернется ответ с кодом ошибки 400. Также могут возвращаться другие значения. Обрабатывать их не требуется. 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_SERIVCE_UNDELIVERED`, `DELIVERY_SERVICE_UNDELIVERED`, `PREORDER`, `AWAIT_CONFIRMATION`, `STARTED`, `PACKAGING`, `READY_TO_SHIP`, `SHIPPED`, `ASYNC_PROCESSING`, `USER_REFUSED_TO_PROVIDE_PERSONAL_DATA`, `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`, `RECEIVED_ON_DISTRIBUTION_CENTER`, `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`, `UNKNOWN`
delivery	Type: OrderStatusChangeDeliveryDTO Информация о доставке.

OrderStatusType

Статус заказа:

CANCELLED — отменен.
DELIVERED — получен покупателем.
DELIVERY — передан в службу доставки.
PICKUP — доставлен в пункт самовывоза.
PROCESSING — находится в обработке.
PENDING — ожидает обработки со стороны продавца.
UNPAID — оформлен, но еще не оплачен (если выбрана оплата при оформлении).
PLACING — оформляется, подготовка к резервированию.
RESERVED — зарезервирован, но недооформлен.
PARTIALLY_RETURNED — возвращен частично.
RETURNED — возвращен полностью.
UNKNOWN — неизвестный статус.

Также могут возвращаться другие значения. Обрабатывать их не требуется.

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

OrderSubstatusType

Этап обработки заказа (если он имеет статус PROCESSING) или причина отмены заказа (если он имеет статус CANCELLED).

Возможные значения для заказа в статусе PROCESSING:

STARTED — заказ подтвержден, его можно начать обрабатывать.
READY_TO_SHIP — заказ собран и готов к отправке.

Возможные значения для заказа в статусе CANCELLED:

PROCESSING_EXPIRED — значение более не используется.
REPLACING_ORDER — покупатель решил заменить товар другим по собственной инициативе.
RESERVATION_EXPIRED — покупатель не завершил оформление зарезервированного заказа в течение 10 минут.
SHOP_FAILED — магазин не может выполнить заказ.
USER_CHANGED_MIND — покупатель отменил заказ по личным причинам.
USER_NOT_PAID — покупатель не оплатил заказ (для типа оплаты PREPAID) в течение 30 минут.
USER_REFUSED_DELIVERY — покупателя не устроили условия доставки.
USER_REFUSED_PRODUCT — покупателю не подошел товар.
USER_REFUSED_QUALITY — покупателя не устроило качество товара.
USER_UNREACHABLE — не удалось связаться с покупателем. Для отмены с этой причиной необходимо выполнить условия:
- не менее 3 звонков с 8 до 21 в часовом поясе покупателя;
- перерыв между первым и третьим звонком не менее 90 минут;
- соединение не короче 5 секунд.
Если хотя бы одно из этих условий не выполнено (кроме случая, когда номер недоступен), отменить заказ не получится. Вернется ответ с кодом ошибки 400.

Также могут возвращаться другие значения. Обрабатывать их не требуется.

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_SERIVCE_UNDELIVERED, DELIVERY_SERVICE_UNDELIVERED, PREORDER, AWAIT_CONFIRMATION, STARTED, PACKAGING, READY_TO_SHIP, SHIPPED, ASYNC_PROCESSING, USER_REFUSED_TO_PROVIDE_PERSONAL_DATA, 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, RECEIVED_ON_DISTRIBUTION_CENTER, 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, UNKNOWN

OrderStatusChangeDeliveryDTO

Информация о доставке.

Name

Description

dates

Type: OrderStatusChangeDeliveryDatesDTO

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

OrderStatusChangeDeliveryDatesDTO

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

Name

Description

realDeliveryDate

Type: string<date>

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

Фактическая дата доставки.

Когда передавать параметр realDeliveryDate:

Не передавайте параметр, если:
- переводите заказ в любой статус, кроме PICKUP или DELIVERED;
- меняете статус заказа на PICKUP или DELIVERED в день доставки — будет указана дата выполнения запроса.
Передавайте дату доставки, если переводите заказ в статус PICKUP или DELIVERED не в день доставки. Нельзя указывать дату доставки в будущем.

Индекс качества

Передача статуса после установленного срока снижает индекс качества. О сроках читайте в Справке Маркета для продавцов.

Responses

200 OK

В случае успешного изменения статуса заказа возвращается обновленная информация о заказе.

Body

application/json

{
    "order": {
        "id": 0,
        "status": "PLACING",
        "substatus": "RESERVATION_EXPIRED",
        "creationDate": "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"
                    }
                ],
                "details": [
                    {
                        "itemCount": 0,
                        "itemStatus": "REJECTED",
                        "updateDate": "23-09-2022"
                    }
                ],
                "subsidies": [
                    {
                        "type": "YANDEX_CASHBACK",
                        "amount": 0
                    }
                ],
                "requiredInstanceTypes": [
                    "CIS"
                ]
            }
        ],
        "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",
                "parent": {
                    "id": 0,
                    "name": "string",
                    "type": "OTHER",
                    "children": [
                        null
                    ]
                },
                "children": [
                    null
                ]
            },
            "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",
                "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
id	Type: integer<int64> Идентификатор заказа.
status	Type: OrderStatusType Статус заказа: `CANCELLED` — отменен. `DELIVERED` — получен покупателем. `DELIVERY` — передан в службу доставки. `PICKUP` — доставлен в пункт самовывоза. `PROCESSING` — находится в обработке. `PENDING` — ожидает обработки со стороны продавца. `UNPAID` — оформлен, но еще не оплачен (если выбрана оплата при оформлении). `PLACING` — оформляется, подготовка к резервированию. `RESERVED` — зарезервирован, но недооформлен. `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`: `PROCESSING_EXPIRED` — значение более не используется. `REPLACING_ORDER` — покупатель решил заменить товар другим по собственной инициативе. `RESERVATION_EXPIRED` — покупатель не завершил оформление зарезервированного заказа в течение 10 минут. `SHOP_FAILED` — магазин не может выполнить заказ. `USER_CHANGED_MIND` — покупатель отменил заказ по личным причинам. `USER_NOT_PAID` — покупатель не оплатил заказ (для типа оплаты `PREPAID`) в течение 30 минут. `USER_REFUSED_DELIVERY` — покупателя не устроили условия доставки. `USER_REFUSED_PRODUCT` — покупателю не подошел товар. `USER_REFUSED_QUALITY` — покупателя не устроило качество товара. `USER_UNREACHABLE` — не удалось связаться с покупателем. Для отмены с этой причиной необходимо выполнить условия: не менее 3 звонков с 8 до 21 в часовом поясе покупателя; перерыв между первым и третьим звонком не менее 90 минут; соединение не короче 5 секунд. Если хотя бы одно из этих условий не выполнено (кроме случая, когда номер недоступен), отменить заказ не получится. Вернется ответ с кодом ошибки 400. Также могут возвращаться другие значения. Обрабатывать их не требуется. 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_SERIVCE_UNDELIVERED`, `DELIVERY_SERVICE_UNDELIVERED`, `PREORDER`, `AWAIT_CONFIRMATION`, `STARTED`, `PACKAGING`, `READY_TO_SHIP`, `SHIPPED`, `ASYNC_PROCESSING`, `USER_REFUSED_TO_PROVIDE_PERSONAL_DATA`, `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`, `RECEIVED_ON_DISTRIBUTION_CENTER`, `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`, `UNKNOWN`
creationDate	Type: string<date-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`
itemsTotal	Type: number<decimal> Платеж покупателя.
deliveryTotal	Type: number<decimal> Стоимость доставки.
buyerItemsTotal	Type: number<decimal> Этот параметр устарел. Стоимость всех товаров в заказе в валюте покупателя после применения скидок и без учета стоимости доставки.
buyerTotal	Type: number<decimal> Этот параметр устарел. Стоимость всех товаров в заказе в валюте покупателя после применения скидок и с учетом стоимости доставки.
buyerItemsTotalBeforeDiscount	Type: number<decimal> Цена продажи. Стоимость всех товаров в заказе в валюте покупателя до применения скидок и без учета стоимости доставки.
buyerTotalBeforeDiscount	Type: number<decimal> Стоимость всех товаров в заказе в валюте покупателя до применения скидок и с учетом стоимости доставки (`buyerItemsTotalBeforeDiscount` + стоимость доставки).
paymentType	Type: OrderPaymentType Тип оплаты заказа: `PREPAID` — оплата при оформлении заказа. `POSTPAID` — оплата при получении заказа. `UNKNOWN` — неизвестный тип. Если параметр отсутствует, заказ будет оплачен при получении. Enum: `PREPAID`, `POSTPAID`, `UNKNOWN`
paymentMethod	Type: OrderPaymentMethodType Способ оплаты заказа: Значения, если выбрана оплата при оформлении заказа (`"paymentType": "PREPAID"`): `YANDEX` — банковской картой. `APPLE_PAY` — Apple Pay. `GOOGLE_PAY` — Google Pay. `CREDIT` — в кредит. `TINKOFF_CREDIT` — в кредит в Тинькофф Банке. `TINKOFF_INSTALLMENTS` — рассрочка в Тинькофф Банке. `EXTERNAL_CERTIFICATE` — подарочным сертификатом (например, из приложения «Сбербанк Онлайн»). `SBP` — через систему быстрых платежей. `B2B_ACCOUNT_PREPAYMENT` — заказ оплачивает организация. Значения, если выбрана оплата при получении заказа (`"paymentType": "POSTPAID"`): `CARD_ON_DELIVERY` — банковской картой. `CASH_ON_DELIVERY` — наличными. `B2B_ACCOUNT_POSTPAYMENT` — заказ оплачивает организация после доставки. `UNKNOWN` — неизвестный тип. Значение по умолчанию: `CASH_ON_DELIVERY`. Enum: `CASH_ON_DELIVERY`, `CARD_ON_DELIVERY`, `YANDEX`, `APPLE_PAY`, `EXTERNAL_CERTIFICATE`, `CREDIT`, `GOOGLE_PAY`, `TINKOFF_CREDIT`, `SBP`, `TINKOFF_INSTALLMENTS`, `B2B_ACCOUNT_PREPAYMENT`, `B2B_ACCOUNT_POSTPAYMENT`, `UNKNOWN`
fake	Type: boolean Тип заказа: `false` — настоящий заказ покупателя. `true` — тестовый заказ Маркета.
items	Type: OrderItemDTO[] Список товаров в заказе. Список товаров в заказе.
subsidies	Type: OrderSubsidyDTO[] Список субсидий по типам. Общее вознаграждение партнеру за DBS-доставку и все скидки на товар: по промокодам, купонам и акциям; по баллам Плюса; по доставке (DBS). Передается в валюте заказа.
delivery	Type: OrderDeliveryDTO Информация о доставке.
buyer	Type: OrderBuyerDTO Информация о покупателе. Параметры `id`, `lastName`, `firstName` и `middleName` возвращаются, только если вы работаете по модели DBS. Информация о покупателе с базовыми полями.
notes	Type: string Комментарий к заказу.
taxSystem	Type: OrderTaxSystemType Система налогообложения (СНО) магазина на момент оформления заказа: `ECHN` — единый сельскохозяйственный налог (ЕСХН). `ENVD` — единый налог на вмененный доход (ЕНВД). `OSN` — общая система налогообложения (ОСН). `PSN` — патентная система налогообложения (ПСН). `USN` — упрощенная система налогообложения (УСН). `USN_MINUS_COST` — упрощенная система налогообложения, доходы, уменьшенные на величину расходов (УСН «Доходы минус расходы»). `NPD` — налог на профессиональный доход (НПД). `UNKNOWN_VALUE` — неизвестное значение. Используется только совместно с параметром `payment-method=YANDEX`. Enum: `OSN`, `USN`, `USN_MINUS_COST`, `ENVD`, `ECHN`, `PSN`, `NPD`, `UNKNOWN_VALUE`
cancelRequested	Type: boolean Только для модели DBS Запрошена ли отмена.
expiryDate	Type: string<date-dd-MM-yyyy-HH-mm-ss> Дата, после которой заказ будет отменен, если не сменит статус. Формат даты: `ДД-ММ-ГГГГ`. Example: `23-09-2022 09:12:41`

CurrencyType

Коды валют. Возможные значения:

BYR — белорусский рубль.
KZT — казахстанский тенге.
RUR — российский рубль.
UAH — украинская гривна.

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

OrderPaymentType

Тип оплаты заказа:

PREPAID — оплата при оформлении заказа.
POSTPAID — оплата при получении заказа.
UNKNOWN — неизвестный тип.

Если параметр отсутствует, заказ будет оплачен при получении.

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

OrderPaymentMethodType

Способ оплаты заказа:

Значения, если выбрана оплата при оформлении заказа ("paymentType": "PREPAID"):
- YANDEX — банковской картой.
- APPLE_PAY — Apple Pay.
- GOOGLE_PAY — Google Pay.
- CREDIT — в кредит.
- TINKOFF_CREDIT — в кредит в Тинькофф Банке.
- TINKOFF_INSTALLMENTS — рассрочка в Тинькофф Банке.
- EXTERNAL_CERTIFICATE — подарочным сертификатом (например, из приложения «Сбербанк Онлайн»).
- SBP — через систему быстрых платежей.
- B2B_ACCOUNT_PREPAYMENT — заказ оплачивает организация.
Значения, если выбрана оплата при получении заказа ("paymentType": "POSTPAID"):
- CARD_ON_DELIVERY — банковской картой.
- CASH_ON_DELIVERY — наличными.
- B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.
UNKNOWN — неизвестный тип.

Значение по умолчанию: CASH_ON_DELIVERY.

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

OrderItemDTO

Список товаров в заказе.

Name	Description
id	Type: integer<int64> Идентификатор товара в заказе. Позволяет идентифицировать товар в рамках данного заказа.
offerId	Type: string Идентификатор вашего товарного предложения для определенного товара. Описание поля в Справке Маркета для продавцов Min length: `1` Max length: `255` Pattern: `^[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
offerName	Type: string Название товара.
price	Type: number<decimal> Цена на товар в валюте заказа без учета вознаграждения партнеру за скидки по промокодам, купонам и акциям (параметр `subsidies`).
buyerPrice	Type: number<decimal> Цена на товар в валюте покупателя. В цене уже учтены скидки по: акциям; купонам; промокодам.
buyerPriceBeforeDiscount	Type: number<decimal> Цена продажи. Стоимость товара в валюте покупателя до применения скидок.
priceBeforeDiscount	Type: number<decimal> Этот параметр устарел. Стоимость товара в валюте магазина до применения скидок.
count	Type: integer Количество единиц товара.
vat	Type: OrderVatType Ставка налога на добавленную стоимость (НДС) на товар. Enum: `NO_VAT`, `VAT_0`, `VAT_10`, `VAT_10_110`, `VAT_20`, `VAT_20_120`, `VAT_18`, `VAT_18_118`, `UNKNOWN_VALUE`
shopSku	Type: string Этот параметр устарел. Вместо него используйте `offerId`. Ваш SKU — идентификатор товара в вашей системе. Min length: `1` Max length: `255` Pattern: `^[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
subsidy	Type: number<decimal> Этот параметр устарел. Вместо него используйте `subsidies`. Общее вознаграждение партнеру за DBS-доставку и все скидки на товар: по промокодам; по купонам; по баллам Плюса; по акциям. Передается в валюте заказа.
partnerWarehouseId	Type: string Этот параметр устарел. Не используйте его. Идентификатор склада в системе партнера, на который сформирован заказ.
promos	Type: OrderItemPromoDTO[] Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям. Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям.
instances	Type: OrderItemInstanceDTO[] Информация о маркировке единиц товара. Возвращаются данные для маркировки, переданные в запросе PUT campaigns/{campaignId}/orders/{orderId}/cis. Если магазин еще не передавал коды для этого заказа, `instances` отсутствует. Переданные вами для данной позиции коды маркировки или УИНы. Коды «Честного знака» возвращаются в двух вариантах — с криптохвостом и без.
details	Type: OrderItemDetailDTO[] Информация об удалении товара из заказа. Детали по товару в заказе.
subsidies	Type: OrderItemSubsidyDTO[] Список субсидий по типам. Общее вознаграждение партнеру за все скидки на товар: по промокодам, купонам и акциям; по баллам Плюса. Передается в валюте заказа.
requiredInstanceTypes	Type: OrderItemInstanceType[] Список необходимых маркировок товара. Вид маркировки товара: `CIS` — КИЗ, идентификатор единицы товара в системе «Честный ЗНАК». `UIN` — УИН, уникальный идентификационный номер. `RNPT` — РНПТ, регистрационный номер партии товара. `GTD` — номер ГТД, грузовой таможенной декларации. Enum: `CIS`, `UIN`, `RNPT`, `GTD`

OrderSubsidyDTO

Общее вознаграждение партнеру за DBS-доставку и все скидки на товар:

по промокодам, купонам и акциям;
по баллам Плюса;
по доставке (DBS).

Передается в валюте заказа.

Name

Description

type

Type: OrderSubsidyType

Тип субсидии:

YANDEX_CASHBACK — скидка по подписке Яндекс Плюс.
SUBSIDY — скидка Маркета (по акциям, промокодам, купонам и т. д.)
DELIVERY — скидка за доставку (DBS).

Enum: YANDEX_CASHBACK, SUBSIDY, DELIVERY

amount

Type: number<decimal>

Сумма субсидии.

OrderDeliveryDTO

Информация о доставке.

Name	Description
id	Type: string Идентификатор доставки, присвоенный магазином. Указывается, только если магазин передал данный идентификатор в ответе на запрос методом POST cart.
type	Type: OrderDeliveryType Способ доставки заказа. Enum: `DELIVERY`, `PICKUP`, `POST`, `DIGITAL`, `UNKNOWN`
serviceName	Type: string Наименование службы доставки.
price	Type: number<decimal> Этот параметр устарел. Стоимость доставки смотрите в параметре `deliveryTotal`. Стоимость доставки в валюте заказа.
deliveryPartnerType	Type: OrderDeliveryPartnerType Тип сотрудничества со службой доставки в рамках конкретного заказа. Enum: `SHOP`, `YANDEX_MARKET`, `UNKNOWN`
courier	Type: OrderCourierDTO Информация о курьере.
dates	Type: OrderDeliveryDatesDTO Диапазон дат доставки.
region	Type: RegionDTO Регион доставки.
address	Type: OrderDeliveryAddressDTO Адрес доставки. Указывается, если `type=DELIVERY`, `type=POST` или `type=PICKUP` (адрес пункта выдачи).
vat	Type: OrderVatType Ставка налога на добавленную стоимость (НДС) на товар: `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. Ставка использовалась до 1 января 2019 года при предоплате. `UNKNOWN_VALUE` — неизвестный тип. Используется только совместно с параметром `payment-method=YANDEX`. Enum: `NO_VAT`, `VAT_0`, `VAT_10`, `VAT_10_110`, `VAT_20`, `VAT_20_120`, `VAT_18`, `VAT_18_118`, `UNKNOWN_VALUE`
deliveryServiceId	Type: integer<int64> Идентификатор службы доставки.
liftType	Type: OrderLiftType Тип подъема заказа на этаж: `NOT_NEEDED` — не требуется. `MANUAL` — ручной. `ELEVATOR` — лифт. `CARGO_ELEVATOR` — грузовой лифт. `FREE` — любой из перечисленных выше, если включена опция бесплатного подъема. `UNKNOWN` — неизвестный тип. Enum: `NOT_NEEDED`, `MANUAL`, `ELEVATOR`, `CARGO_ELEVATOR`, `FREE`, `UNKNOWN`
liftPrice	Type: number<decimal> Стоимость подъема на этаж.
outletCode	Type: string Идентификатор пункта самовывоза, присвоенный магазином.
outletStorageLimitDate	Type: string<date-dd-MM-yyyy> Дата, до которой заказ будет храниться в пункте выдачи. Возвращается, когда заказ переходит в статус `PICKUP`. Один раз дату можно поменять с помощью метода PUT campaigns/{campaignId}/orders/{orderId}/delivery/storage-limit. Example: `23-09-2022`
dispatchType	Type: OrderDeliveryDispatchType Способ отгрузки: `BUYER` — доставка покупателю. `MARKET_PARTNER_OUTLET` — доставка в пункт выдачи партнера. `MARKET_BRANDED_OUTLET` — доставка в пункт выдачи заказов Маркета. `SHOP_OUTLET` — доставка в пункт выдачи заказов магазина. `DROPOFF` — доставка в пункт выдачи, который принимает заказы от продавцов и передает их курьерам. `UNKNOWN` — неизвестный тип. Enum: `UNKNOWN`, `BUYER`, `MARKET_PARTNER_OUTLET`, `MARKET_BRANDED_OUTLET`, `SHOP_OUTLET`, `DROPOFF`
tracks	Type: OrderTrackDTO[] Информация для отслеживания перемещений посылки. Информация о трек-номере посылки (DBS).
shipments	Type: OrderShipmentDTO[] Информация о посылках. Список посылок. В параметре может указываться несколько посылок.
estimated	Type: boolean Приблизительная ли дата доставки.
eacType	Type: OrderDeliveryEacType Тип кода подтверждения ЭАПП. Enum: `MERCHANT_TO_COURIER`, `COURIER_TO_MERCHANT`, `CHECKING_BY_MERCHANT`
eacCode	Type: string Код подтверждения ЭАПП (для типа `MERCHANT_TO_COURIER`).

OrderBuyerDTO

Информация о покупателе.

Параметры id, lastName, firstName и middleName возвращаются, только если вы работаете по модели DBS.

Name	Description
id	Type: string Идентификатор покупателя.
lastName	Type: string Фамилия покупателя.
firstName	Type: string Имя покупателя.
middleName	Type: string Отчество покупателя.
type	Type: OrderBuyerType Тип покупателя: физическое лицо или организация. Этот параметр используется FBS- и FBY-магазинами, размещающими товары на витрине business.market.yandex.ru. Enum: `PERSON`, `BUSINESS`

OrderTaxSystemType

Система налогообложения (СНО) магазина на момент оформления заказа:

ECHN — единый сельскохозяйственный налог (ЕСХН).
ENVD — единый налог на вмененный доход (ЕНВД).
OSN — общая система налогообложения (ОСН).
PSN — патентная система налогообложения (ПСН).
USN — упрощенная система налогообложения (УСН).
USN_MINUS_COST — упрощенная система налогообложения, доходы, уменьшенные на величину расходов (УСН «Доходы минус расходы»).
NPD — налог на профессиональный доход (НПД).
UNKNOWN_VALUE — неизвестное значение. Используется только совместно с параметром payment-method=YANDEX.

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

OrderVatType

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

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. Ставка использовалась до 1 января 2019 года при предоплате.
UNKNOWN_VALUE — неизвестный тип.

Используется только совместно с параметром payment-method=YANDEX.

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

OrderItemPromoDTO

Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям.

Name	Description
type*	Type: OrderPromoType Тип скидки. Enum: `DIRECT_DISCOUNT`, `BLUE_SET`, `BLUE_FLASH`, `GENERIC_BUNDLE`, `MARKET_COUPON`, `MARKET_PROMOCODE`, `MARKET_DEAL`, `MARKET_BLUE`, `MARKET_PRIME`, `YANDEX_PLUS`, `BERU_PLUS`, `MARKET_COIN`, `YANDEX_EMPLOYEE`, `LIMITED_FREE_DELIVERY_PROMO`, `FREE_DELIVERY_THRESHOLD`, `MULTICART_DISCOUNT`, `PRICE_DROP_AS_YOU_SHOP`, `FREE_DELIVERY_FOR_LDI`, `FREE_DELIVERY_FOR_LSC`, `SECRET_SALE`, `FREE_PICKUP`, `CHEAPEST_AS_GIFT`, `CASHBACK`, `SUPPLIER_MULTICART_DISCOUNT`, `SPREAD_DISCOUNT_COUNT`, `SPREAD_DISCOUNT_RECEIPT`, `ANNOUNCEMENT_PROMO`, `DISCOUNT_BY_PAYMENT_TYPE`, `PERCENT_DISCOUNT`, `DCO_EXTRA_DISCOUNT`, `EMPTY_PROMO`, `BLOCKING_PROMO`, `UNKNOWN`
discount	Type: number<decimal> Размер пользовательской скидки в валюте покупателя.
subsidy	Type: number<decimal> Вознаграждение партнеру от Маркета за товар, проданный в рамках акции. Передается в валюте заказа.
shopPromoId	Type: string Идентификатор акции поставщика.
marketPromoId	Type: string Идентификатор акции в рамках соглашения на оказание услуг по продвижению сервиса между Маркетом и партнером. Параметр передается, только если параметр `type=MARKET_DEAL`.

OrderItemInstanceDTO

Переданные вами для данной позиции коды маркировки или УИНы. Коды «Честного знака» возвращаются в двух вариантах — с криптохвостом и без.

Name	Description
cis	Type: string Код идентификации единицы товара в системе «Честный ЗНАК» без криптохвоста.
cisFull	Type: string Код идентификации единицы товара в системе «Честный ЗНАК» с криптохвостом.
uin	Type: string УИН ювелирного изделия (16-значный код) Производитель получает УИН, когда регистрирует изделие в системе контроля за оборотом драгоценных металлов и камней — ГИИС ДМДК.
rnpt	Type: string Регистрационный номер партии товара. Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации.
gtd	Type: string Грузовая таможенная декларация. Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации.

OrderItemDetailDTO

Детали по товару в заказе.

Name	Description
itemCount	Type: integer<int64> Количество единиц товара.
itemStatus	Type: OrderItemStatusType Возвращенный или невыкупленный товар: `REJECTED` — невыкупленный. `RETURNED` — возвращенный. Enum: `REJECTED`, `RETURNED`
updateDate	Type: string<date-dd-MM-yyyy> Формат даты: `ДД-ММ-ГГГГ`. Example: `23-09-2022`

OrderItemSubsidyDTO

Общее вознаграждение партнеру за все скидки на товар:

по промокодам, купонам и акциям;
по баллам Плюса.

Передается в валюте заказа.

Name

Description

type

Type: OrderItemSubsidyType

Тип субсидии:

YANDEX_CASHBACK — скидка по подписке Яндекс Плюс.
SUBSIDY — скидка Маркета (по акциям, промокодам, купонам и т. д.).

Enum: YANDEX_CASHBACK, SUBSIDY

amount

Type: number<decimal>

Сумма субсидии.

OrderItemInstanceType

Вид маркировки товара:

CIS — КИЗ, идентификатор единицы товара в системе «Честный ЗНАК».
UIN — УИН, уникальный идентификационный номер.
RNPT — РНПТ, регистрационный номер партии товара.
GTD — номер ГТД, грузовой таможенной декларации.

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

OrderSubsidyType

Тип субсидии:

YANDEX_CASHBACK — скидка по подписке Яндекс Плюс.
SUBSIDY — скидка Маркета (по акциям, промокодам, купонам и т. д.)
DELIVERY — скидка за доставку (DBS).

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

OrderDeliveryType

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

DELIVERY — курьерская доставка.
PICKUP — самовывоз.
POST — почта.
DIGITAL — для цифровых товаров.
UNKNOWN — неизвестный тип.

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

OrderDeliveryPartnerType

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

SHOP — магазин работает со службой доставки напрямую или доставляет заказы самостоятельно.
YANDEX_MARKET — магазин работает со службой доставки через Маркет.
UNKNOWN — неизвестный тип.

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

OrderCourierDTO

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

Name	Description
fullName	Type: string Полное имя курьера.
phone	Type: string Номер телефона курьера.
phoneExtension	Type: string Добавочный номер телефона.
vehicleNumber	Type: string Номер транспортного средства.
vehicleDescription	Type: string Описание машины. Например, модель и цвет.

OrderDeliveryDatesDTO

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

Name	Description
fromDate	Type: string<date-dd-MM-yyyy> Ближайшая дата доставки. Формат даты: `ДД-ММ-ГГГГ`. Example: `23-09-2022`
toDate	Type: string<date-dd-MM-yyyy> Самая поздняя дата доставки. Если параметр `toDate` не указан, единственно возможной датой доставки считается дата, указанная в параметре `fromDate`. Формат даты: `ДД-ММ-ГГГГ`. Example: `23-09-2022`
fromTime	Type: string<time> Начало интервала времени доставки. Передается только совместно с параметром `type=DELIVERY`. Формат времени: 24-часовой, `ЧЧ:ММ`. В качестве минут всегда должно быть указано `00` (исключение — `23:59`). Минимальное значение: `00:00`.
toTime	Type: string<time> Конец интервала времени доставки. Передается только совместно с параметром `type=DELIVERY`. Формат времени: 24-часовой, `ЧЧ:ММ`. В качестве минут всегда должно быть указано `00` (исключение — `23:59`). Максимальное значение: `23:59`.
realDeliveryDate	Type: string<date-dd-MM-yyyy> Дата, когда товар доставлен до пункта выдачи заказа (в случае самовывоза) или до покупателя (если заказ доставляет курьер). Example: `23-09-2022`

RegionDTO

Регион доставки.

Name	Description
id	Type: integer<int64> Идентификатор региона.
name*	Type: string Название региона.
type*	Type: RegionType Тип региона. Enum: `OTHER`, `CONTINENT`, `REGION`, `COUNTRY`, `COUNTRY_DISTRICT`, `REPUBLIC`, `CITY`, `VILLAGE`, `CITY_DISTRICT`, `SUBWAY_STATION`, `REPUBLIC_AREA`
parent	Type: RegionDTO Информация о родительском регионе. Указываются родительские регионы до уровня страны.
children	Type: RegionDTO[] Дочерние регионы. Регион доставки.

OrderDeliveryAddressDTO

Адрес доставки.

Указывается, если type=DELIVERY, type=POST или type=PICKUP (адрес пункта выдачи).

Name	Description
country	Type: string Страна. Обязательный параметр.
postcode	Type: string Почтовый индекс. Указывается, если выбрана доставка почтой (`delivery type=POST`).
city	Type: string Город или населенный пункт. Обязательный параметр.
district	Type: string Район.
subway	Type: string Станция метро.
street	Type: string Улица. Обязательный параметр.
house	Type: string Дом или владение. Обязательный параметр.
block	Type: string Корпус или строение.
entrance	Type: string Подъезд.
entryphone	Type: string Код домофона.
floor	Type: string Этаж.
apartment	Type: string Квартира или офис.
phone	Type: string Телефон получателя заказа. Обязательный параметр.
recipient	Type: string Фамилия, имя и отчество получателя заказа. Обязательный параметр.
gps	Type: GpsDTO GPS-координаты.

OrderLiftType

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

NOT_NEEDED — не требуется.
MANUAL — ручной.
ELEVATOR — лифт.
CARGO_ELEVATOR — грузовой лифт.
FREE — любой из перечисленных выше, если включена опция бесплатного подъема.
UNKNOWN — неизвестный тип.

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

OrderDeliveryDispatchType

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

BUYER — доставка покупателю.
MARKET_PARTNER_OUTLET — доставка в пункт выдачи партнера.
MARKET_BRANDED_OUTLET — доставка в пункт выдачи заказов Маркета.
SHOP_OUTLET — доставка в пункт выдачи заказов магазина.
DROPOFF — доставка в пункт выдачи, который принимает заказы от продавцов и передает их курьерам.
UNKNOWN — неизвестный тип.

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

OrderTrackDTO

Информация о трек-номере посылки (DBS).

Name

Description

trackCode

Type: string

Трек‑номер посылки.

deliveryServiceId

Type: integer<int64>

Идентификатор службы доставки. Информацию о службе доставки можно получить с помощью запроса GET delivery/services.

OrderShipmentDTO

Список посылок.

В параметре может указываться несколько посылок.

Name	Description
id	Type: integer<int64> Идентификатор посылки, присвоенный Маркетом.
shipmentDate	Type: string<date-dd-MM-yyyy> День, в который нужно отгрузить заказ службе доставки. Формат даты: `ДД-ММ-ГГГГ`. Если заказ сделан организацией, параметр не возвращается до согласования даты доставки. Example: `23-09-2022`
shipmentTime	Type: string Только для модели Экспресс Время, к которому магазин должен упаковать заказ и перевести его в статус `READY_TO_SHIP`. После смены статуса за заказом приедет курьер. Поле может появиться не сразу. Запрашивайте информацию о заказе в течении 5–10 минут, пока оно не вернется. Формат времени: 24-часовой, `ЧЧ:ММ`. Если заказ сделан организацией, параметр не возвращается до согласования даты доставки.
tracks	Type: OrderTrackDTO[] Только для модели DBS Информация для отслеживания перемещений посылки. Информация о трек-номере посылки (DBS).
boxes	Type: OrderParcelBoxDTO[] Список грузовых мест. Информация о грузоместе.

OrderDeliveryEacType

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

MERCHANT_TO_COURIER — продавец передает код курьеру.
COURIER_TO_MERCHANT — курьер передает код продавцу.
CHECKING_BY_MERCHANT — продавец проверяет код на своей стороне.

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

OrderBuyerType

Тип покупателя:

PERSON — физическое лицо.
BUSINESS — организация.

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

OrderPromoType

Тип скидки:

DIRECT_DISCOUNT — прямая скидка, которую устанавливает продавец или Маркет.
BLUE_SET — комплекты.
BLUE_FLASH — флеш-акция.
MARKET_COUPON — скидка по промокоду Маркета.
MARKET_PROMOCODE — скидка по промокоду магазина.
MARKET_BLUE — скидка на Маркете.
YANDEX_PLUS — бесплатная доставка с подпиской Яндекс Плюс.
YANDEX_EMPLOYEE — бесплатная доставка по определенным адресам.
LIMITED_FREE_DELIVERY_PROMO — бесплатная доставка по ограниченному предложению.
FREE_DELIVERY_THRESHOLD — бесплатная доставка при достижении определенной суммы заказа.
MULTICART_DISCOUNT — скидка за то, что оформлена мультикорзина.
FREE_DELIVERY_FOR_LDI — бесплатная доставка за то, что один из товаров крупногабаритный.
FREE_DELIVERY_FOR_LSC — бесплатная доставка за то, что одна из корзин в мультикорзине крупногабаритная.
FREE_PICKUP — бесплатная доставка в пункт выдачи заказов.
CHEAPEST_AS_GIFT — самый дешевый товар в подарок.
CASHBACK — кешбэк.
SUPPLIER_MULTICART_DISCOUNT — скидка за доставку.
SPREAD_DISCOUNT_COUNT — скидка за количество одинаковых товаров.
SPREAD_DISCOUNT_RECEIPT — скидка от суммы чека.
ANNOUNCEMENT_PROMO — информационная акция, скидка не применяется к товарам.
DISCOUNT_BY_PAYMENT_TYPE — прямая скидка при оплате картой Плюса.
PERCENT_DISCOUNT — прямая скидка в процентах.
DCO_EXTRA_DISCOUNT — дополнительная скидка, необходимая для расчета субсидии от Маркета.
EMPTY_PROMO — скрытые промокоды.
BLOCKING_PROMO — блокирующее промо.
UNKNOWN — неизвестный тип.

Неактуальные типы:

GENERIC_BUNDLE.
MARKET_DEAL.
MARKET_PRIME.
MARKET_COIN.
BERU_PLUS.
PRICE_DROP_AS_YOU_SHOP.
SECRET_SALE.

Type

Description

OrderPromoType

Enum: DIRECT_DISCOUNT, BLUE_SET, BLUE_FLASH, GENERIC_BUNDLE, MARKET_COUPON, MARKET_PROMOCODE, MARKET_DEAL, MARKET_BLUE, MARKET_PRIME, YANDEX_PLUS, BERU_PLUS, MARKET_COIN, YANDEX_EMPLOYEE, LIMITED_FREE_DELIVERY_PROMO, FREE_DELIVERY_THRESHOLD, MULTICART_DISCOUNT, PRICE_DROP_AS_YOU_SHOP, FREE_DELIVERY_FOR_LDI, FREE_DELIVERY_FOR_LSC, SECRET_SALE, FREE_PICKUP, CHEAPEST_AS_GIFT, CASHBACK, SUPPLIER_MULTICART_DISCOUNT, SPREAD_DISCOUNT_COUNT, SPREAD_DISCOUNT_RECEIPT, ANNOUNCEMENT_PROMO, DISCOUNT_BY_PAYMENT_TYPE, PERCENT_DISCOUNT, DCO_EXTRA_DISCOUNT, EMPTY_PROMO, BLOCKING_PROMO, UNKNOWN

OrderItemStatusType

Возвращенный или невыкупленный товар:

REJECTED — невыкупленный.
RETURNED — возвращенный.

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

OrderItemSubsidyType

Тип субсидии:

YANDEX_CASHBACK — скидка по подписке Яндекс Плюс.
SUBSIDY — скидка Маркета (по акциям, промокодам, купонам и т. д.).

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

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`

GpsDTO

GPS-координаты широты и долготы.

Name

Description

latitude*

Type: number<decimal>

Широта.

longitude*

Type: number<decimal>

Долгота.

OrderParcelBoxDTO

Информация о грузоместе.

Name

Description

Type: integer<int64>

Идентификатор грузоместа.

fulfilmentId

Type: string

Идентификатор грузового места в информационной системе магазина.

400 Bad Request

Запрос содержит неправильные данные.

Body

application/json

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

Name

Description

status

Type: ApiResponseStatusType

Тип ответа.
Enum: OK, ERROR

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

ApiResponseStatusType

Тип ответа.

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

ApiErrorDTO

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

Name

Description

status

Type: ApiResponseStatusType

Тип ответа.
Enum: OK, ERROR

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

Изменение статуса заказа

RequestRequest

Path parametersPath parameters

BodyBody

OrderStatusChangeDTOOrderStatusChangeDTO

OrderStatusTypeOrderStatusType

OrderSubstatusTypeOrderSubstatusType

OrderStatusChangeDeliveryDTOOrderStatusChangeDeliveryDTO

OrderStatusChangeDeliveryDatesDTOOrderStatusChangeDeliveryDatesDTO

ResponsesResponses

200 OK200 OK

BodyBody

OrderDTOOrderDTO

CurrencyTypeCurrencyType

OrderPaymentTypeOrderPaymentType

OrderPaymentMethodTypeOrderPaymentMethodType

OrderItemDTOOrderItemDTO

OrderSubsidyDTOOrderSubsidyDTO

OrderDeliveryDTOOrderDeliveryDTO

OrderBuyerDTOOrderBuyerDTO

OrderTaxSystemTypeOrderTaxSystemType

OrderVatTypeOrderVatType

OrderItemPromoDTOOrderItemPromoDTO

OrderItemInstanceDTOOrderItemInstanceDTO

OrderItemDetailDTOOrderItemDetailDTO

OrderItemSubsidyDTOOrderItemSubsidyDTO

OrderItemInstanceTypeOrderItemInstanceType

OrderSubsidyTypeOrderSubsidyType

OrderDeliveryTypeOrderDeliveryType

OrderDeliveryPartnerTypeOrderDeliveryPartnerType

OrderCourierDTOOrderCourierDTO

OrderDeliveryDatesDTOOrderDeliveryDatesDTO

RegionDTORegionDTO

OrderDeliveryAddressDTOOrderDeliveryAddressDTO

OrderLiftTypeOrderLiftType

OrderDeliveryDispatchTypeOrderDeliveryDispatchType

OrderTrackDTOOrderTrackDTO

OrderShipmentDTOOrderShipmentDTO

OrderDeliveryEacTypeOrderDeliveryEacType

OrderBuyerTypeOrderBuyerType

OrderPromoTypeOrderPromoType

OrderItemStatusTypeOrderItemStatusType

OrderItemSubsidyTypeOrderItemSubsidyType

RegionTypeRegionType

GpsDTOGpsDTO

OrderParcelBoxDTOOrderParcelBoxDTO

400 Bad Request400 Bad Request

BodyBody

ApiResponseStatusTypeApiResponseStatusType

ApiErrorDTOApiErrorDTO

401 Unauthorized401 Unauthorized

BodyBody

403 Forbidden403 Forbidden

BodyBody

404 Not Found404 Not Found

BodyBody

420 Method Failure420 Method Failure

BodyBody

500 Internal Server Error500 Internal Server Error

BodyBody

Была ли статья полезна?

Request

Path parameters

Body

OrderStatusChangeDTO

OrderStatusType

OrderSubstatusType

OrderStatusChangeDeliveryDTO

OrderStatusChangeDeliveryDatesDTO

Responses

200 OK

Body

OrderDTO

CurrencyType

OrderPaymentType

OrderPaymentMethodType

OrderItemDTO

OrderSubsidyDTO

OrderDeliveryDTO

OrderBuyerDTO

OrderTaxSystemType

OrderVatType

OrderItemPromoDTO

OrderItemInstanceDTO

OrderItemDetailDTO

OrderItemSubsidyDTO

OrderItemInstanceType

OrderSubsidyType

OrderDeliveryType

OrderDeliveryPartnerType

OrderCourierDTO

OrderDeliveryDatesDTO

RegionDTO

OrderDeliveryAddressDTO

OrderLiftType

OrderDeliveryDispatchType

OrderTrackDTO

OrderShipmentDTO

OrderDeliveryEacType

OrderBuyerType

OrderPromoType

OrderItemStatusType

OrderItemSubsidyType

RegionType

GpsDTO

OrderParcelBoxDTO

400 Bad Request

Body

ApiResponseStatusType

ApiErrorDTO

401 Unauthorized

Body

403 Forbidden

Body

404 Not Found

Body

420 Method Failure

Body

500 Internal Server Error

Body