Уведомление о смене статуса заказа

Уведомляет магазин о смене статуса заказа.

Таймаут на получение ответа: 10 секунд.

Request

POST

/order/status

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,
        "buyerItemsTotal": 0,
        "buyerTotal": 0,
        "buyerItemsTotalBeforeDiscount": 0,
        "buyerTotalBeforeDiscount": 0,
        "paymentType": "PREPAID",
        "paymentMethod": "SHOP_PREPAID",
        "fake": false,
        "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,
                "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"
                    }
                ]
            }
        ],
        "notes": "string",
        "taxSystem": "OSN",
        "expiryDate": "23-09-2022",
        "electronicAcceptanceCertificateCode": "string",
        "buyer": {
            "id": "string",
            "lastName": "string",
            "firstName": "string",
            "middleName": "string",
            "type": "PERSON"
        },
        "delivery": {
            "id": "string",
            "shopDeliveryId": "string",
            "type": "DELIVERY",
            "serviceName": "string",
            "price": 0,
            "subsidy": 0,
            "deliveryOptionId": "string",
            "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",
                "parent": {
                    "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	Type	Description
order*	OrderStatusShopOrderDTO	Заказ.

OrderStatusShopOrderDTO

Name	Type	Description
businessId	integer<int64>	Идентификатор бизнеса-аккаунта.
id	integer<int64>	Идентификатор заказа.
status	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	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	string<date-dd-MM-yyyy-HH-mm-ss>	Дата и время оформления заказа. Формат даты и времени: `ДД-ММ-ГГГГ ЧЧ:ММ:СС`. Часовой пояс — UTC+03:00 (Москва). Example: `23-09-2022 09:12:41`
currency	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	number<decimal>	Общая сумма заказа в валюте заказа без учета стоимости доставки и вознаграждения партнеру за скидки по промокодам, купонам и акциям (параметр `subsidyTotal`). Для отделения целой части от дробной используется точка.
total	number<decimal>	Общая сумма заказа в валюте заказа с учетом стоимости доставки, но без учета вознаграждения партнеру за скидки по промокодам, купонам, кешбэку и акциям (параметр `subsidyTotal`). Для отделения целой части от дробной используется точка.
deliveryTotal	number<decimal>	Стоимость доставки в валюте заказа. Для отделения целой части от дробной используется точка.
subsidyTotal	number<decimal>	Общее вознаграждение партнеру за скидки: по промокодам; по купонам; по баллам Плюса; по акциям. Передается в валюте, указанной в параметре `currency`. Для отделения целой части от дробной используется точка.
totalWithSubsidy	number<decimal>	Сумма стоимости всех товаров в заказе и вознаграждения за них в валюте магазина (сумма параметров `total` и `subsidyTotal`).
buyerItemsTotal	number<decimal>	Стоимость всех товаров в заказе в валюте покупателя после применения скидок и без учета стоимости доставки.
buyerTotal	number<decimal>	Стоимость всех товаров в заказе в валюте покупателя после применения скидок и с учетом стоимости доставки.
buyerItemsTotalBeforeDiscount	number<decimal>	Стоимость всех товаров в заказе в валюте покупателя до применения скидок и без учета стоимости доставки.
buyerTotalBeforeDiscount	number<decimal>	Стоимость всех товаров в заказе в валюте покупателя до применения скидок и с учетом стоимости доставки.
paymentType	OrderPaymentType	Тип оплаты заказа: `PREPAID` — оплата при оформлении заказа. `POSTPAID` — оплата при получении заказа. `UNKNOWN` — неизвестный тип. Если параметр отсутствует, заказ будет оплачен при получении. Enum: `PREPAID`, `POSTPAID`, `UNKNOWN`
paymentMethod	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: `SHOP_PREPAID`, `BANK_CARD`, `YANDEX_MONEY`, `CASH_ON_DELIVERY`, `CARD_ON_DELIVERY`, `YANDEX`, `APPLE_PAY`, `EXTERNAL_CERTIFICATE`, `CREDIT`, `INSTALLMENT`, `GOOGLE_PAY`, `TINKOFF_CREDIT`, `SBP`, `TINKOFF_INSTALLMENTS`, `B2B_ACCOUNT_PREPAYMENT`, `B2B_ACCOUNT_POSTPAYMENT`, `UNKNOWN`
fake	boolean	Тип заказа: `false` — настоящий заказ покупателя. `true` — тестовый заказ Маркета.
items	ShopOrderItemDTO[]	Список товаров в заказе. Список товаров в заказе.
notes	string	Комментарий к заказу.
taxSystem	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`
expiryDate	string<date-dd-MM-yyyy>	Дата, после которой заказ будет отменен, если не сменит статус. Формат даты: `ДД-ММ-ГГГГ`. Example: `23-09-2022`
electronicAcceptanceCertificateCode	string	Только для модели FBS Шестизначный код подтверждения для: передачи экспресс-заказа курьеру; получения невыкупленного экспресс-заказа от курьера. Подробно о работе с кодами рассказано в Справке для продавцов.
buyer	OrderBuyerDTO	Информация о покупателе. Параметры `id`, `lastName`, `firstName` и `middleName` возвращаются, только если вы работаете по модели DBS. Информация о покупателе с базовыми полями.
delivery	OrderStatusDeliveryDTO	Информация о доставке.

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

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

ShopOrderItemDTO

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

Name	Type	Description
id	integer<int64>	Идентификатор товара в заказе. Позволяет идентифицировать товар в рамках данного заказа.
feedId	integer<int64>	Идентификатор каталога товаров.
offerId	string	Идентификатор вашего товарного предложения для определенного товара. Описание поля в Справке для продавцов Min length: `1` Max length: `80`
feedCategoryId	string	Только для модели DBS Идентификатор категории, указанный в каталоге.
offerName	string	Только для модели DBS Название товара.
fulfilmentShopId	integer<int64>	Только для модели DBS Идентификатор поставщика товара. Чтобы узнать его, войдите в кабинет продавца на Маркете и нажмите на его название. Идентификатор указан в поле ID магазина в строке нужного склада.
price	number<decimal>	Цена товара в валюте заказа без учета вознаграждения партнеру за скидки по промокодам, купонам и акциям (параметр `subsidy`). Для отделения целой части от дробной используется точка.
buyerPrice	number<decimal>	Цена товара в валюте покупателя. В цене уже учтены скидки по: акциям; купонам; промокодам. Для отделения целой части от дробной используется точка. Внимание Для поддержания обратной совместимости также заполняется устаревшее поле `buyer-price`. В будущем оно будет удалено. Пожалуйста, используйте поле `buyerPrice`.
buyerPriceBeforeDiscount	number<decimal>	Стоимость товара в валюте покупателя до применения скидок. Для отделения целой части от дробной используется точка.
priceBeforeDiscount	number<decimal>	Стоимость товара в валюте магазина до применения скидок. Для отделения целой части от дробной используется точка.
count	integer	Количество единиц товара.
delivery	boolean	Только для модели FBS Доставка товара в указанный в запросе регион: `false` — товар не доставляется в указанный регион. `true` — значение по умолчанию, товар доставляется в указанный регион. Принимает значение, которое вы передали в параметре `delivery`, вложенном в `items`, в ответе на запрос POST cart.
vat	OrderVatType	Ставка налога на добавленную стоимость (НДС) на товар. Используется только совместно с параметром `"paymentMethod": "YANDEX"`. Enum: `NO_VAT`, `VAT_0`, `VAT_10`, `VAT_10_110`, `VAT_20`, `VAT_20_120`, `VAT_18`, `VAT_18_118`, `UNKNOWN_VALUE`
shopSku	string	Ваш SKU — идентификатор товара в вашей системе. Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы `. , / \ ( ) [ ] - = _` Правила использования SKU: У каждого товара SKU должен быть свой. SKU товара нельзя менять — можно только удалить товар и добавить заново с новым SKU. Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге. Что такое SKU и как его назначать Min length: `1` Max length: `80`
sku	string	SKU на Маркете — идентификатор текущей карточки товара на Маркете.
subsidy	number<decimal>	Общее вознаграждение партнеру за все скидки на товар: по промокодам; по купонам; по баллам Плюса; по акциям. Передается в валюте заказа, для отделения целой части от дробной используется точка.
warehouseId	integer<int64>	Только для модели FBS Идентификатор склада на Маркете.
partnerWarehouseId	string	Только для модели FBS Идентификатор склада в системе партнера, на который сформирован заказ. Внимание Параметр устарел, временно поддерживается, но не доступен для ввода и редактирования.
params	string	Характеристики товара (например, его цвет).
promos	OrderItemPromoDTO[]	Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям. Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям.
instances	OrderItemInstanceDTO[]	Информация о маркировке единиц товара. Возвращаются данные для маркировки, переданные в запросе PUT campaigns/{campaignId}/orders/{orderId}/cis. Если магазин еще не передавал коды для этого заказа, `instances` отсутствует. Переданные вами для данной позиции коды маркировки или УИНы. Коды «Честного знака» возвращаются в двух вариантах — с криптохвостом и без.

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`

OrderBuyerDTO

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

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

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

OrderStatusDeliveryDTO

Name	Type	Description
id	string	Только для модели FBS Идентификатор доставки. Для модели DBS: передавайте идентификатор доставки, присвоенный магазином, в параметре `shopDeliveryId`.
shopDeliveryId	string	Только для модели DBS Идентификатор доставки, присвоенный магазином. Указывается, только если магазин передал данный идентификатор в ответе на запрос методом POST cart в параметре `id`, вложенном в `deliveryOptions`.
type	OrderDeliveryType	Способ доставки заказа. Enum: `DELIVERY`, `PICKUP`, `POST`, `DIGITAL`, `UNKNOWN`
serviceName	string	Наименование службы доставки.
price	number<decimal>	До 1 июля 2021 в нем возвращалась ваша стоимость доставки заказа. Сейчас Маркет всегда передает в этом поле 0, так как поле устарело и не используется, а стоимость доставки заказа рассчитывает автоматически, по единому тарифу на доставку. Подробнее о тарифе на доставку
subsidy	number<decimal>	Субсидия за доставку в валюте заказа. Для отделения целой части от дробной используется точка.
deliveryOptionId	string	Идентификатор опции доставки, переданный магазином.
deliveryPartnerType	OrderDeliveryPartnerType	Тип сотрудничества со службой доставки в рамках конкретного заказа. Enum: `SHOP`, `YANDEX_MARKET`, `UNKNOWN`
dates	OrderDeliveryDatesDTO	Только для модели DBS Диапазон дат доставки.
region	ShopRegionDTO	Регион доставки.
vat	OrderVatType	Только для модели DBS Ставка налога на добавленную стоимость (НДС) на услугу доставки заказа. Enum: `NO_VAT`, `VAT_0`, `VAT_10`, `VAT_10_110`, `VAT_20`, `VAT_20_120`, `VAT_18`, `VAT_18_118`, `UNKNOWN_VALUE`
deliveryServiceId	integer<int64>	Идентификатор службы доставки. Информацию о службе доставки можно получить с помощью запроса GET delivery/services.
liftType	OrderLiftType	Только для модели DBS Тип подъема заказа на этаж. Enum: `NOT_NEEDED`, `MANUAL`, `ELEVATOR`, `CARGO_ELEVATOR`, `FREE`, `UNKNOWN`
liftPrice	number<decimal>	Только для модели DBS Стоимость подъема на этаж.
outlet	ShopOutletDTO	Только для модели DBS Пункт самовывоза, выбранный покупателем для получения заказа. Не возвращается в ответе, если покупатель выбрал получение заказа в брендированном пункте выдачи заказов Маркета (значение `MARKET_BRANDED_OUTLET` параметра `dispatchType`).
dispatchType	OrderDeliveryDispatchType	Только для модели DBS Способ отгрузки. Enum: `UNKNOWN`, `BUYER`, `MARKET_PARTNER_OUTLET`, `MARKET_BRANDED_OUTLET`, `SHOP_OUTLET`, `DROPOFF`
shipments	ShopOrderShipmentDTO[]	Информация о посылках. Для модели DBS: передается, если заказ был создан в пункт выдачи Маркета. Список посылок.
estimated	boolean	Только для модели DBS Признак, который показывает, что дата доставки по заказу не подтверждена. Передается для товаров на заказ с долгим сроком доставки (31–60 дней). Окончательную дату доставки нужно передать Маркету в течение 7 дней с даты оформления заказа в запросе PUT campaigns/{campaignId}/orders/{orderId}/delivery/date.
eacType	OrderDeliveryEacType	Только для модели Экспресс Тип кода подтверждения ЭАПП. Enum: `MERCHANT_TO_COURIER`, `COURIER_TO_MERCHANT`, `CHECKING_BY_MERCHANT`
courier	OrderCourierDTO	Только для модели Экспресс Информация о курьере.
address	ShopOrderDeliveryAddressDTO	Только для модели DBS Адрес доставки. Передается, если параметр `type` имеет значение `DELIVERY`. Адрес доставки. Передается, если параметр `type` имеет значение `DELIVERY`.

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	Type	Description
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`
subsidy	number<decimal>	Вознаграждение партнеру от Маркета за товар, проданный в рамках акции. Передается в валюте заказа, для отделения целой части от дробной используется точка.
marketPromoId	string	Идентификатор акции в рамках соглашения на оказание услуг по продвижению сервиса между Маркетом и партнером. Параметр передается, только если параметр `type=MARKET_DEAL`.

OrderItemInstanceDTO

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

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

OrderBuyerType

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

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

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

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`

OrderDeliveryDatesDTO

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

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

ShopRegionDTO

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

Name	Type	Description
id	integer<int64>	Идентификатор региона.
name*	string	Название региона.
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`
parent	ShopRegionDTO	Информация о родительском регионе. Указываются родительские регионы до уровня страны.

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	Type	Description
code	string	Идентификатор пункта самовывоза, присвоенный магазином.

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`

ShopOrderShipmentDTO

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

Name	Type	Description
id	integer<int64>	Идентификатор посылки, присвоенный Маркетом.
status	OrderParcelStatusType	Статус заказа в партнерской службе доставки: `NEW` — новый. `CREATED` — создан в службе доставки. `READY_TO_SHIP` — готов к передаче в службу доставки. `ERROR` — ошибка создания заказа. `UNKNOWN` — неизвестный статус. Enum: `NEW`, `CREATED`, `READY_TO_SHIP`, `ERROR`, `UNKNOWN`
shipmentDate	string<date-dd-MM-yyyy>	День, в который нужно отгрузить заказ службе доставки. Формат даты: `ДД-ММ-ГГГГ`. Для модели FBS: если заказ сделан организацией, параметр не возвращается до согласования даты доставки. Для модели DBS: если вы не передали параметр `shipmentDate`, то датой отгрузки будет считаться дата доставки `fromDate`. Example: `23-09-2022`
shipmentTime	string<time>	Только для модели Экспресс Время, к которому магазин должен упаковать заказ и перевести его в статус `READY_TO_SHIP`. После смены статуса за заказом приедет курьер. Формат времени: 24-часовой, `ЧЧ:ММ`. Если заказ сделан организацией, параметр не возвращается до согласования даты доставки.
weight	integer<int64>	Вес упакованного заказа в граммах. Указывается, если заказ доставляет служба-партнер Маркета (`deliveryPartnerType=YANDEX_MARKET`).
width	integer<int64>	Ширина упакованного заказа в сантиметрах. Указывается, если заказ доставляет служба-партнер Маркета (`deliveryPartnerType=YANDEX_MARKET`).
height	integer<int64>	Высота упакованного заказа в сантиметрах. Указывается, если заказ доставляет служба-партнер Маркета (`deliveryPartnerType=YANDEX_MARKET`).
depth	integer<int64>	Глубина упакованного заказа в сантиметрах. Указывается, если заказ доставляет служба-партнер Маркета (`deliveryPartnerType=YANDEX_MARKET`).
boxes	ShopOrderParcelBoxDTO[]	Список грузовых мест. Информация о грузоместе.

OrderDeliveryEacType

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

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

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

OrderCourierDTO

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

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

ShopOrderDeliveryAddressDTO

Name	Type	Description
country	string	Страна. Обязательный параметр.
postcode	string	Почтовый индекс. Указывается, если выбрана доставка почтой (`delivery type=POST`).
city	string	Город или населенный пункт. Обязательный параметр.
district	string	Район.
subway	string	Станция метро.
street	string	Улица.
house	string	Дом или владение. Обязательный параметр.
block	string	Корпус или строение.
entrance	string	Подъезд.
entryphone	string	Код домофона.
floor	string	Этаж.
apartment	string	Квартира или офис.
lat	number<decimal>	Широта. Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета. Не гарантируем заполнение, так как это опциональное поле.
lon	number<decimal>	Долгота. Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета. Не гарантируем заполнение, так как это опциональное поле.
notes	string	Примечание к адресу. Например, вход со двора. Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета.
outletPhones	string[]	Телефоны пункта выдачи в формате `8 812 123-45-67 890` (`890` — добавочный). Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета.
schedule	ShopOutletScheduleItemDTO[]	Расписание работы пункта выдачи. Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета. Расписание работы точки продаж.
phone	string	Телефон получателя заказа. Обязательный параметр.
recipient	string	Фамилия, имя и отчество получателя заказа. Обязательный параметр.

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

ShopRegionType

Тип региона:

CITY_DISTRICT — район города.
CITY — крупный город.
CONTINENT — континент.
COUNTRY_DISTRICT — федеральный округ.
COUNTRY — страна.
REGION — регион.
METRO_STATION — станция метро.
MONORAIL_STATION — станция монорельса.
OVERSEAS_TERRITORY — отдельная территория какого-либо государства, расположенная в другой части света (например, Ангилья, Гренландия, Бермудские острова и т. д.).
SECONDARY_DISTRICT — район города второго уровня (например, для ВАО Москвы районами второго уровня являются Измайлово, Новокосино, Перово и т. д.).
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`

OrderParcelStatusType

Статус заказа в партнерской службе доставки:

NEW — новый.
CREATED — создан в службе доставки.
READY_TO_SHIP — готов к передаче в службу доставки.
ERROR — ошибка создания заказа.
UNKNOWN — неизвестный статус.

Type	Description
OrderParcelStatusType	Enum: `NEW`, `CREATED`, `READY_TO_SHIP`, `ERROR`, `UNKNOWN`

ShopOrderParcelBoxDTO

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

Name	Type	Description
id	integer<int64>	Идентификатор грузового места.
weight	integer<int64>	Вес грузового места в граммах.
width	integer<int64>	Ширина грузового места в сантиметрах.
height	integer<int64>	Высота грузового места в сантиметрах.
depth	integer<int64>	Глубина грузового места в сантиметрах.
items	ShopOrderBoxItemDTO[]	Информация о коробке.

ShopOutletScheduleItemDTO

Расписание работы точки продаж.

Name	Type	Description
fromDay*	DayOfWeekType	День недели, в который пункт выдачи начинает работать: `MONDAY` — понедельник. `TUESDAY` — вторник. `WEDNESDAY` — среда. `THURSDAY` — четверг. `FRIDAY` — пятница. `SATURDAY` — суббота. `SUNDAY` — воскресенье. Обязательный параметр. Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`
toDay*	DayOfWeekType	День недели, в который пункт выдачи заканчивает работать: `MONDAY` — понедельник. `TUESDAY` — вторник. `WEDNESDAY` — среда. `THURSDAY` — четверг. `FRIDAY` — пятница. `SATURDAY` — суббота. `SUNDAY` — воскресенье. Обязательный параметр. Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`
fromTime*	string	Время начала работы пункта выдачи. Формат времени: 24-часовой, `ЧЧ:ММ`. Обязательный параметр. Min length: `1`
toTime*	string	Время окончания работы пункта выдачи. Формат времени: 24-часовой, `ЧЧ:ММ`. Обязательный параметр. Min length: `1`

ShopOrderBoxItemDTO

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

Name	Type	Description
id	integer<int64>	Идентификатор коробки.
count	integer	Количество товара в коробке.

DayOfWeekType

День недели:

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

Type	Description
DayOfWeekType	Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`

Уведомление о смене статуса заказа

Request

Body

OrderStatusShopOrderDTO

OrderStatusType

OrderSubstatusType

CurrencyType

OrderPaymentType

OrderPaymentMethodType

ShopOrderItemDTO

OrderTaxSystemType

OrderBuyerDTO

OrderStatusDeliveryDTO

OrderVatType

OrderItemPromoDTO

OrderItemInstanceDTO

OrderBuyerType

OrderDeliveryType

OrderDeliveryPartnerType

OrderDeliveryDatesDTO

ShopRegionDTO

OrderLiftType

ShopOutletDTO

OrderDeliveryDispatchType

ShopOrderShipmentDTO

OrderDeliveryEacType

OrderCourierDTO

ShopOrderDeliveryAddressDTO

OrderPromoType

ShopRegionType

OrderParcelStatusType

ShopOrderParcelBoxDTO

ShopOutletScheduleItemDTO

ShopOrderBoxItemDTO

DayOfWeekType

Responses

200 OK

400 Bad Request

500 Internal Server Error

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

Уведомление о смене статуса заказа

RequestRequest

BodyBody

OrderStatusShopOrderDTOOrderStatusShopOrderDTO

OrderStatusTypeOrderStatusType

OrderSubstatusTypeOrderSubstatusType

CurrencyTypeCurrencyType

OrderPaymentTypeOrderPaymentType

OrderPaymentMethodTypeOrderPaymentMethodType

ShopOrderItemDTOShopOrderItemDTO

OrderTaxSystemTypeOrderTaxSystemType

OrderBuyerDTOOrderBuyerDTO

OrderStatusDeliveryDTOOrderStatusDeliveryDTO

OrderVatTypeOrderVatType

OrderItemPromoDTOOrderItemPromoDTO

OrderItemInstanceDTOOrderItemInstanceDTO

OrderBuyerTypeOrderBuyerType

OrderDeliveryTypeOrderDeliveryType

OrderDeliveryPartnerTypeOrderDeliveryPartnerType

OrderDeliveryDatesDTOOrderDeliveryDatesDTO

ShopRegionDTOShopRegionDTO

OrderLiftTypeOrderLiftType

ShopOutletDTOShopOutletDTO

OrderDeliveryDispatchTypeOrderDeliveryDispatchType

ShopOrderShipmentDTOShopOrderShipmentDTO

OrderDeliveryEacTypeOrderDeliveryEacType

OrderCourierDTOOrderCourierDTO

ShopOrderDeliveryAddressDTOShopOrderDeliveryAddressDTO

OrderPromoTypeOrderPromoType

ShopRegionTypeShopRegionType

OrderParcelStatusTypeOrderParcelStatusType

ShopOrderParcelBoxDTOShopOrderParcelBoxDTO

ShopOutletScheduleItemDTOShopOutletScheduleItemDTO

ShopOrderBoxItemDTOShopOrderBoxItemDTO

DayOfWeekTypeDayOfWeekType

ResponsesResponses

200 OK200 OK

400 Bad Request400 Bad Request

500 Internal Server Error500 Internal Server Error

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

Request

Body

OrderStatusShopOrderDTO

OrderStatusType

OrderSubstatusType

CurrencyType

OrderPaymentType

OrderPaymentMethodType

ShopOrderItemDTO

OrderTaxSystemType

OrderBuyerDTO

OrderStatusDeliveryDTO

OrderVatType

OrderItemPromoDTO

OrderItemInstanceDTO

OrderBuyerType

OrderDeliveryType

OrderDeliveryPartnerType

OrderDeliveryDatesDTO

ShopRegionDTO

OrderLiftType

ShopOutletDTO

OrderDeliveryDispatchType

ShopOrderShipmentDTO

OrderDeliveryEacType

OrderCourierDTO

ShopOrderDeliveryAddressDTO

OrderPromoType

ShopRegionType

OrderParcelStatusType

ShopOrderParcelBoxDTO

ShopOutletScheduleItemDTO

ShopOrderBoxItemDTO

DayOfWeekType

Responses

200 OK

400 Bad Request

500 Internal Server Error