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

Описание
Передаваемые магазину данные
Ответные данные от магазина
Описание ошибок
Примеры

Описание

POST order/status

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

URL ресурса:

https://<URL_запроса>/order/status

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

Передаваемые магазину данные

Порядок следования параметров не гарантируется.

FBS

DBS

{
  "order":
  {
    "businessId": {int64},
    "creationDate": "{date}",
    "currency": "{enum}",
    "fake": {boolean},
    "id": {int64},
    "paymentType": "{enum}",
    "paymentMethod": "{enum}",
    "status": "{enum}",
    "substatus": "{enum}",
    "vehicleNumber": "{string}",
    "taxSystem": "{enum}",
    "buyerItemsTotalBeforeDiscount": {double},
    "buyerTotalBeforeDiscount": {double},
    "buyerItemsTotal": {double},
    "buyerTotal": {double},
    "itemsTotal": {double},
    "total": {double},
    "subsidyTotal": {double},
    "totalWithSubsidy": {double},
    "deliveryTotal": {double},
    "delivery":
    {
      "deliveryPartnerType": "{enum}",
      "courier":
      {
        "fullName": "{string}",
        "phone": "{string}",
        "phoneExtension": "{string}",
        "vehicleNumber": "{string}",
        "vehicleDescription": "{string}"
      },
      "deliveryServiceId": {int64},
      "id": "{string}",
      "serviceName": "{string}",
      "type": "{enum}",
      "region":
      {
        "id": {int32},
        "name": "{string}",
        "type": "{enum}",
        "parent":
        {
          "id": {int32},
          "name": "{string}",
          "type": "{enum}",
          "parent":
          {
            ...
          }
        }
      },
      "shipments":
      [
        {
          "id": {int64},
          "shipmentDate": "{date}",
          "depth": {int64},
          "height": {int64},
          "status": "{enum}",
          "weight": {int64},
          "width": {int64}
          "boxes":
          [
            {
              "id": {int64}
            },
            ...
          ]
        },
        ...
      ]
    },
    "items":
    [
      {
        "count": {int32},
        "feedId": {int64},
        "offerId": "{string}",
        "price": {double},
        "buyer-price": {double},
        "buyerPriceBeforeDiscount": {double},
        "priceBeforeDiscount": {double},
        "subsidy": {double},
        "vat": "{enum}",
        "warehouseId": {int64},
        "partnerWarehouseId": "{string}",
        "instances":
        [
          {
            "cis": "{string}"
          },
          ...
        ],
        "promos":
        [
          {
            "marketPromoId": "{string}",
            "subsidy": {float},
            "type": "{enum}"
          },
          ...
        ]
      },
      ...
    ],
    "electronicAcceptanceCertificateCode": "{string}",
    "notes": "{string}"
  }
}

{
  "order":
  {
    "businessId": {int64},
    "creationDate": "{date}",
    "currency": "{enum}",
    "fake": {boolean},
    "id": {int64},
    "itemsTotal": {double},
    "paymentType": "{enum}",
    "paymentMethod": "{enum}",
    "status": "{enum}",
    "substatus": "{enum}",
    "taxSystem": "{enum}",
    "buyerItemsTotalBeforeDiscount": {double},
    "buyerTotalBeforeDiscount": {double},
    "buyerItemsTotal": {double},
    "buyerTotal": {double},
    "itemsTotal": {double},
    "totalWithSubsidy": {double},
    "deliveryTotal": {double},
    "total": {double},
    "subsidyTotal": {double},
    "buyer":
    {
      "id": "{string}",
      "lastName": "{string}",
      "firstName": "{string}",
      "middleName": "{string}"
    },
    "delivery":
    {
      "dispatchType": "{enum}",
      "deliveryPartnerType": "{enum}",
      "deliveryServiceId": {int64},
      "shopDeliveryId": "{string}",
      "price": {double},
      "serviceName": "{string}",
      "type": "{enum}",
      "vat": "{enum}",
      "address":
      {
        "country": "{string}",
        "city": "{string}",
        "subway": "{string}",
        "street": "{string}",
        "house": "{string}",
        "block": "{string}",
        "entrance": "{string}",
        "entryphone": "{string}",
        "floor": "{string}",
        "apartment": "{string}",
        "recipient": "{string}"
      },
      "dates":
      {
        "fromDate": "{date}",
        "toDate": "{date}",
        "fromTime": "{time}",
        "toTime": "{time}"
      },
      "outlet":
      {
        "code": "{string}"
      },
      "region":
      {
        "id": {int32},
        "name": "{string}",
        "type": "{enum}",
        "parent":
        {
          "id": {int32},
          "name": "{string}",
          "type": "{enum}",
          "parent":
          {
            ...
          }
        }
      }
    },
    "items":
    [
      {
        "id": {int64},
        "feedId": {int64},
        "offerId": "{string}",
        "offerName": "{string}",
        "feedCategoryId": "{string}",
        "fulfilmentShopId": {int64},
        "count": {int32},
        "price": {double},
        "buyer-price": {double},
        "buyerPriceBeforeDiscount": {double},
        "priceBeforeDiscount": {double},
        "subsidy": {double},
        "vat": "{enum}",
        "promos":
        [
          {
            "type": "{enum}",
            "marketPromoId": "{string}",
            "subsidy": {float}
          },
          ...
        ]
      },
      ...
    ],
    "notes": "{string}"
  }
}

Параметр	Тип	Значение
`order`	Описание	Описание заказа.

Параметры, вложенные в `order`

Параметр	Тип	Значение
`businessId`	Int64	Идентификатор бизнеса-аккаунта.
`creationDate`	Date	Дата и время оформления заказа. Формат даты и времени: ДД-ММ-ГГГГ ЧЧ:ММ:СС. Часовой пояс — UTC+03:00 (Москва).
`currency`	Enum	Валюта, в которой выражены цены товаров в заказе. Возможные значения: `RUR` — российский рубль.
`fake`	Boolean	Тип заказа. Возможные значения: `false` — настоящий заказ покупателя. `true` — тестовый заказ Маркета.
`id`	Int64	Идентификатор заказа.
`paymentType`	Enum	Тип оплаты заказа. Возможные значения: `PREPAID` — оплата при оформлении заказа. `POSTPAID` — оплата при получении заказа. Если параметр отсутствует, заказ будет оплачен при получении.
`paymentMethod`	Enum	Способ оплаты заказа. Возможные значения, если выбрана оплата при оформлении заказа (`"paymentType": "PREPAID"`): `YANDEX` — банковской картой. `APPLE_PAY` — Apple Pay. `GOOGLE_PAY` — Google Pay. `CREDIT` — в кредит. `TINKOFF_CREDIT` — в кредит в Тинькофф Банке. `TINKOFF_INSTALLMENTS` — рассрочка в Тинькофф Банке. `EXTERNAL_CERTIFICATE` — подарочным сертификатом (например, из приложения «Сбербанк Онлайн»). `SBP` — через систему быстрых платежей. Возможные значения, если выбрана оплата при получении заказа (`"paymentType": "POSTPAID"`): `CARD_ON_DELIVERY` — банковской картой. `CASH_ON_DELIVERY` — наличными. Значение по умолчанию: `CASH_ON_DELIVERY`. `B2B_ACCOUNT_PREPAYMENT` — заказ оплачивает организация.
`status`	Enum	FBS DBS Статус заказа: `CANCELLED` — заказ отменен. `DELIVERED` — заказ получен покупателем. `DELIVERY` — заказ передан в службу доставки. `PICKUP` — заказ доставлен в пункт самовывоза. `PROCESSING` — заказ находится в обработке. `PENDING` — по заказу требуются дополнительные действия со стороны Маркета. `UNPAID` — заказ оформлен, но еще не оплачен (если выбрана оплата при оформлении). Также могут передаваться другие значения. Обрабатывать их не требуется. Статус заказа: `CANCELLED` — заказ отменен. `PROCESSING` — заказ находится в обработке. `RESERVED` — заказ в резерве (ожидается подтверждение от пользователя). `UNPAID` — заказ оформлен, но еще не оплачен (если выбрана оплата при оформлении). Также могут передаваться другие значения. Обрабатывать их не требуется.
`substatus`	Enum	FBS DBS Указывает: этап обработки заказа (если он имеет статус `PROCESSING`); действие, которое Маркет выполняет с заказом (если он имеет статус `PENDING`);* причину отмены заказа (если он имеет статус `CANCELLED`). Возможные значения для заказа в статусе `PROCESSING`: `STARTED` — заказ подтвержден, его можно начать обрабатывать. `PACKAGING` — заказ комплектуется на складе. `READY_TO_SHIP` — заказ готов к отгрузке. `COURIER_SEARCH` — поиск курьера. `COURIER_FOUND` — курьер назначен. `COURIER_IN_TRANSIT_TO_SENDER` — курьер едет за заказом. `COURIER_ARRIVED_TO_SENDER` — курьер приехал за заказом. `COURIER_NOT_FOUND` — курьер не найден. Возможные значения для заказа в статусе `PENDING`: `ANTIFRAUD` — Маркет проверяет, является ли заказ мошенническим. Возможные значения для заказа в статусе `CANCELLED`: `CUSTOM` — причина отмены заказа в свободной форме. `DELIVERY_SERVICE_UNDELIVERED` — служба доставки не смогла доставить заказ. `FULL_NOT_RANSOM`— покупатель отказался покупать все товары из заказа. `PENDING_EXPIRED` — магазин не ответил на запрос POST order/accept о новом заказе в течение: 2 часов — при отгрузке в сортировочный центр или пункт приема; 30 минут — при отгрузке курьерам Яндекс Go. `PROCESSING_EXPIRED` — значение более не используется. `REPLACING_ORDER` — покупатель решил заменить товар другим по собственной инициативе. `RESERVATION_EXPIRED` — покупатель не завершил оформление зарезервированного заказа в течение 10 минут. `RESERVATION_FAILED` — Маркет не может продолжить дальнейшую обработку заказа. `SHOP_FAILED` — магазин не может выполнить заказ. `SHOP_PENDING_CANCELLED` — магазин отклонил новый заказ в ответ на запрос POST order/accept. `WAREHOUSE_FAILED_TO_SHIP` — вы не отгрузили товар со склада. `USER_BOUGHT_CHEAPER` — покупатель нашел дешевле. `USER_CHANGED_MIND` — покупатель отменил заказ по собственным причинам. `USER_FORGOT_TO_USE_BONUS` — покупатель не использовал бонусы. `USER_NOT_PAID` — покупатель не оплатил заказ (для типа оплаты `PREPAID`) в течение 30 минут. `USER_REFUSED_DELIVERY` — покупателя не устраивают условия доставки. `USER_REFUSED_PRODUCT` — покупателю не подошел товар. `USER_REFUSED_QUALITY` — покупателя не устраивает качество товара. `USER_UNREACHABLE` — не удалось связаться с покупателем. Для отмены с этой причиной необходимо выполнить условия: не менее 3 звонков с 8 до 21 в часовом поясе покупателя; перерыв между первым и третьим звонком не менее 90 минут; соединение не короче 5 секунд. Если хотя бы одно из этих условий не выполнено (кроме случая, когда номер недоступен), отменить заказ не получится. Вернется ответ с кодом ошибки 400. `USER_WANTS_TO_CHANGE_DELIVERY_DATE` — покупатель хочет получить заказ в другой день. `CANCELLED_COURIER_NOT_FOUND` — не удалось найти курьера. Возможные значения для заказа в статусе `PICKUP` `PICKUP_SERVICE_RECEIVED` – заказ поступил в пункт выдачи. Подстатус актуален только для заказов с типом доставки почтой, в пункт выдачи заказов и постаматы. `PICKUP_USER_RECEIVED` – покупатель получил заказ. Подстатус не является финальным. Если пользователь вернет заказ, подстатус изменится на `PICKUP_SERVICE_RECEIVED`. Также могут передаваться другие значения. Обрабатывать их не требуется. Причины отмены заказа: `PENDING_EXPIRED` — магазин не ответил на запрос POST order/accept о новом заказе в течение 2 часов. `PROCESSING_EXPIRED` — значение более не используется. `RESERVATION_EXPIRED` — покупатель не завершил оформление зарезервированного заказа в течение 10 минут. `RESERVATION_FAILED` — Маркет не может продолжить дальнейшую обработку заказа. `SHOP_PENDING_CANCELLED` — магазин отклонил новый заказ в ответ на запрос POST order/accept. `USER_CHANGED_MIND` — покупатель отменил заказ по собственным причинам. `USER_FORGOT_TO_USE_BONUS` — покупатель не использовал бонусы. `USER_NOT_PAID` — покупатель не оплатил заказ (для типа оплаты `PREPAID`) в течение 30 минут. `COURIER_NOT_FOUND` — курьер не найден. Также могут передаваться другие значения. Обрабатывать их не требуется.
`vehicleNumber` FBS	String	Номер автомобиля службы доставки. Если курьер пеший, в элементе возвращается значение `NULL`.
`taxSystem`	Enum	Система налогообложения (СНО) магазина на момент оформления заказа. Используется только совместно с параметром `"paymentMethod": "YANDEX"`. Возможные значения: `ECHN` — единый сельскохозяйственный налог (ЕСХН). `ENVD` — единый налог на вмененный доход (ЕНВД). `OSN` — общая система налогообложения (ОСН). `PSN` — патентная система налогообложения (ПСН). `USN` — упрощенная система налогообложения (УСН). `USN_MINUS_COST` — упрощенная система налогообложения, доходы, уменьшенные на величину расходов (УСН «Доходы минус расходы»).
`buyerItemsTotalBeforeDiscount`	Double	Стоимость всех товаров в заказе в валюте покупателя: До применения скидок. Без учета стоимости доставки.
`buyerTotalBeforeDiscount`	Double	Стоимость всех товаров в заказе в валюте покупателя: До применения скидок. С учетом стоимости доставки.
`buyerItemsTotal`	Double	Стоимость всех товаров в заказе в валюте покупателя: После применения скидок. Без учета стоимости доставки.
`buyerTotal`	Double	Стоимость всех товаров в заказе в валюте покупателя: После применения скидок. С учетом стоимости доставки.
`itemsTotal`	Double	Стоимость всех товаров в заказе в валюте магазина: После применения скидок. Без учета стоимости доставки.
`total`	Double	Стоимость всех товаров в заказе в валюте магазина: После применения скидок. С учетом стоимости доставки.
`subsidyTotal`	Double	Общее вознаграждение партнеру за скидки по всем товарам в заказе: по промокодам; по купонам; по акциям Маркета со скидкой. Передается в валюте, указанной в параметре `currency`. Для отделения целой части от дробной используется точка.
`totalWithSubsidy`	Double	Сумма стоимости всех товаров в заказе и вознаграждения за них в валюте магазина (сумма параметров `total` и `subsidyTotal`).
`deliveryTotal`	Double	Стоимость доставки в валюте заказа. Для отделения целой части от дробной используется точка.
`delivery`	Описание	Информация о доставке.
`items`	Описание	Список товаров в заказе.
`electronicAcceptanceCertificateCode` FBS	String	Шестизначный код подтверждения для: передачи экспресс-заказа курьеру; получения невыкупленного экспресс-заказа от курьера. Подробно о работе с кодами рассказано в Справке для продавцов.
`notes`	String	Комментарий к заказу.
`buyer`	Описание	Информация о покупателе.

Параметры, вложенные в `buyer`

FBS

DBS

Параметр	Тип	Значение
`type`	enum	Тип плательщика: `PERSON` — физическое лицо, `BUSINESS` — юридическое лицо.

Параметр	Тип	Значение
`id`	String	Идентификатор покупателя.
`lastName`	String	Фамилия покупателя.
`firstName`	String	Имя покупателя.
`middleName`	String	Отчество покупателя.

Параметры, вложенные в `delivery`

FBS

DBS

Параметр	Тип	Значение
`deliveryPartnerType`	Enum	Тип сотрудничества со службой доставки в рамках конкретного заказа. Возможные значения: `SHOP` — магазин работает со службой доставки напрямую или доставляет заказы самостоятельно.
`deliveryServiceId`	Enum	Идентификатор службы доставки. Информацию о службе доставки можно получить с помощью запроса GET delivery/services.
`id`	String	Идентификатор доставки.
`serviceName`	String	Наименование службы доставки.
`type`	Enum	Способ доставки заказа. Возможные значения: `DELIVERY` — курьерская доставка. `PICKUP` — самовывоз. `POST` — почта.
`region`	Описание	Регион доставки.
`shipments`	Описание	Список посылок.
`courier`	Описание	Информация о курьере.

Параметр	Тип	Значение
`dispatchType`	Enum	Способ отгрузки: `BUYER` — доставка покупателю. `MARKET_BRANDED_OUTLET` — доставка в ПВЗ Маркета. `SHOP_OUTLET` — доставка в ПВЗ магазина.
`deliveryPartnerType`	Enum	Тип сотрудничества со службой доставки в рамках конкретного заказа: `SHOP` — магазин работает со службой доставки напрямую или доставляет заказы самостоятельно.
`deliveryServiceId`	Enum	Идентификатор службы доставки. Информацию о службе доставки можно получить с помощью запроса GET delivery/services.
`shopDeliveryId`	String	Идентификатор доставки, присвоенный магазином. Передается, только если магазин передал данный идентификатор в ответе на запрос POST cart, в параметре `id`, вложенном в `deliveryOptions`.
`price`	Double	Маркет всегда передает в этом поле 0 — поле устарело и не используется, в будущем будет удалено. До 1 июля 2021 в нем возвращалась ваша стоимость доставки заказа. Сейчас Маркет рассчитывает ее автоматически, по единому тарифу на доставку. Подробнее о тарифе на доставку
`serviceName`	String	Наименование службы доставки.
`type`	Enum	Способ доставки заказа. Возможные значения: `DELIVERY` — курьерская доставка. `PICKUP` — самовывоз.
`vat`	Enum	Ставка налога на добавленную стоимость (НДС) на услугу доставки заказа: `NO_VAT` — НДС не облагается, используется только для отдельных видов услуг. `VAT_0` — НДС 0 %. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров. `VAT_10` — НДС 10 %. Применяется для некоторых товаров, например, для лекарств. `VAT_10_110` — НДС 10/110. Расчетная ставка НДС 10 %, применяется только для случая предоплаты. `VAT_20` — НДС 20%. Основная ставка НДС. `VAT_20_120` — НДС 20/120. Расчетная ставка НДС 20 %, применяется только для случая предоплаты.
`address`	Описание	Адрес доставки. Передается, если параметр `type` имеет значение `DELIVERY`.
`dates`	Описание	Диапазон дат доставки.
`outlet`	Описание	Пункт самовывоза, выбранный покупателем для получения заказа. Не возвращается в ответе, если покупатель выбрал получение заказа в брендированном пункте выдачи заказов Маркета (значение `MARKET_BRANDED_OUTLET` параметра `dispatchType`).
`region`	Описание	Регион доставки.

Параметры, вложенные в `shipments`

Параметр	Тип	Значение
`id`	Int64	Идентификатор грузового места.
`shipmentDate`	Date	День, в который нужно отгрузить заказы службе доставки. Формат даты: ДД-ММ-ГГГГ. Если заказ сделала огранизация, параметр отсутствует до согласования даты доставки.
`boxes`		Список грузовых мест.
`depth`	Int64	Глубина упакованного заказа в сантиметрах. Указывается, если заказ доставляет служба-партнер Маркета (`deliveryPartnerType=YANDEX_MARKET`). Для формата XML является атрибутом параметра `shipment`.
`height`	Int64	Высота упакованного заказа в сантиметрах. Указывается, если заказ доставляет служба-партнер Маркета (`deliveryPartnerType=YANDEX_MARKET`). Для формата XML является атрибутом параметра `shipment`.
`status`	Enum	Статус заказа в партнерской службе доставки. Возможные значения: `CREATED` — заказ создан в партнерской службе доставки и по нему получен номер посылки. `ERROR` — ошибка создания заказа в партнерской службе доставки. `NEW` — Маркет сформировал заявку на создание заказа в службе доставки. `READY_TO_SHIP` — заказ готов к доставке и по нему получен ярлык. Указывается, если заказ доставляет служба-партнер Маркета (`deliveryPartnerType=YANDEX_MARKET`). Для формата XML является атрибутом параметра `shipment`.
`weight`	Int64	Вес упакованного заказа, отгруженного в партнерскую службу доставки, в граммах. Указывается, если заказ доставляет служба-партнер Маркета (`deliveryPartnerType=YANDEX_MARKET`). Для формата XML является атрибутом параметра `shipment`.
`width`	Int64	Ширина упакованного заказа, отгруженного в партнерскую службу доставки, в сантиметрах. Указывается, если заказ доставляет служба-партнер Маркета (`deliveryPartnerType=YANDEX_MARKET`). Для формата XML является атрибутом параметра `shipment`.

Параметры, вложенные в `address`

Параметр	Тип	Значение
`country`	String	Страна
`city`	String	Город или населенный пункт
`subway`	String	Станция метро
`street`	String	Улица
`house`	String	Дом или владение
`block`	String	Корпус или строение
`floor`	String	Этаж
`entrance`	String	Подъезд
`entryphone`	String	Код домофона
`apartment`	String	Квартира или офис
`recipient`	String	Фамилия, имя и отчество получателя заказа.

Параметры, вложенные в `dates`

Параметр	Тип	Значение
`fromDate`	Date	Ближайшая возможная дата доставки. Формат даты: ДД-ММ-ГГГГ.
`toDate`	Date	Самая поздняя дата доставки. Формат даты: ДД-ММ-ГГГГ.
`fromTime`	Time	Начало интервала времени доставки. Формат времени: 24-часовой, ЧЧ:ММ. В качестве минут всегда должно быть указано `00` (исключение — `23:59`). Минимальное значение: `00:00`.
`toTime`	Time	Конец интервала времени доставки. Формат времени: 24-часовой, ЧЧ:ММ. В качестве минут всегда должно быть указано `00` (исключение — `23:59`). Максимальное значение: `23:59`.

Параметры, вложенные в `outlet`

Параметр	Тип	Значение
`code`	String	Идентификатор пункта самовывоза, присвоенный магазином.

Параметры, вложенные в `region`

Параметр	Тип	Значение
`id`	Int32	Идентификатор региона.
`name`	String	Название региона.
`type`	Enum	Тип региона. Возможные значения: `CITY` — город. `CITY_DISTRICT` — район города. `CONTINENT` — континент. `COUNTRY` — страна. `COUNTRY_DISTRICT` — федеральный округ. `METRO_STATION` — станция метро. `MONORAIL_STATION` — станция монорельса. `OTHERS_UNIVERSAL` — другой тип населенного пункта. `OVERSEAS_TERRITORY` — отдельная территория какого-либо государства, расположенная в другой части света (например, Ангилья, Гренландия, Бермудские острова и т. д.). `REGION` — регион. `SECONDARY_DISTRICT` — район города второго уровня (например, для ВАО Москвы районами второго уровня являются Измайлово, Новокосино, Перово и т. д.). `SETTLEMENT` — поселение. `SUBJECT_FEDERATION` — субъект федерации. `SUBJECT_FEDERATION_DISTRICT` — район субъекта федерации. `SUBURB` — пригород. `VILLAGE`— село.
`parent`	`region`	Родительский регион. Указываются родительские регионы до уровня страны включительно (`type=COUNTRY`).

Параметры, вложенные в `courier`

Параметр	Тип	Значение
`fullName`	String	ФИО курьера.
`phone`	String	Номер телефона.
`phoneExtension`	String	Добавочный номер.
`vehicleNumber`	String	Номер машины. Формат: А111АА222.
`vehicleDescription`	String	Описание машины. Например, модель и цвет.

Параметры, вложенные в `boxes`

Параметр	Тип	Значение
`id`	Int64	Идентификатор грузового места.

Параметры, вложенные в `items`

FBS

DBS

Параметр	Тип	Значение
`id`	Int64	Идентификатор товара. Получить идентификатор можно с помощью запроса GET campaigns/{campaignId}/orders/{orderId} или GET campaigns/{campaignId}/orders.
`count`	Int32	Количество единиц товара в грузовом месте.
`offerId`	String	Идентификатор вашего товарного предложения для определенного товара (ваш SKU).
`price`	Double	Цена товара, которую оплачивает покупатель, в валюте магазина. В цене уже учтены скидки по: акциям; купонам; промокодам. Для отделения целой части от дробной используется точка.
`buyer-price`	Double	Цена товара в валюте покупателя. В цене уже учтены скидки по: акциям; купонам; промокодам. Для отделения целой части от дробной используется точка.
`subsidy`	Double	Общее вознаграждение партнеру от Маркета за все акции Маркета, в которых участвует товар. Передается в валюте заказа, для отделения целой части от дробной используется точка.
`buyerPriceBeforeDiscount`	Double	Стоимость товара в валюте покупателя до применения скидок. Для отделения целой части от дробной используется точка.
`priceBeforeDiscount`	Double	Стоимость товара в валюте магазина до применения скидок. Для отделения целой части от дробной используется точка.
`vat`	Enum	Ставка налога на добавленную стоимость (НДС) на товар. Используется только совместно с параметром `"paymentMethod": "YANDEX"`. Возможные значения: `NO_VAT` — НДС не облагается, используется только для отдельных видов услуг. `VAT_0` — НДС 0 %. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров. `VAT_10_110` — НДС 10/110. Расчетная ставка НДС 10 %, применяется только для случая предоплаты. `VAT_20_120` — НДС 20/120. Расчетная ставка НДС 20 %, применяется только для случая предоплаты. `VAT_18_118` — НДС 18/118. Ставка использовалась до 1 января 2019 года.
`warehouseId`	Int64	Идентификатор склада на Маркете.
`partnerWarehouseId`	String	Идентификатор склада в системе партнера. Важно Параметр устарел, временно поддерживается, но не доступен для ввода и редактирования.
`feedId`	String	Идентификатор каталога товаров.
`feedCategoryId`	String	Идентификатор категории, указанной в прайс-листе.
`instances`		Информация о маркировке единиц товара. Возвращаются данные для маркировки, переданные в запросе PUT campaigns/{campaignId}/orders/{orderId}/cis.
`promos`	Описание	Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям.

Параметр	Тип	Значение
`id`	Int64	Идентификатор товара. Позволяет идентифицировать товар в рамках данного заказа.
`feedId`	Int64	Идентификатор прайс-листа, содержащего предложение.
`offerId`	String	Идентификатор предложения из прайс-листа.
`offerName`	String	Название товара.
`feedCategoryId`	String	Идентификатор категории, указанной в прайс-листе.
`fulfilmentShopId`	Int64	Идентификатор поставщика товара. Чтобы узнать его, войдите в личный кабинет магазина и нажмите на его название. Идентификатор указан в поле ID магазина в строке нужного склада.
`count`	Int32	Количество единиц товара.
`price`	Double	Цена товара, которую оплачивает покупатель, в валюте магазина. В цене уже учтены скидки по: акциям; купонам; промокодам. Для отделения целой части от дробной используется точка.
`buyer-price`	Double	Цена товара в валюте покупателя. В цене уже учтены скидки по: акциям; купонам; промокодам. Для отделения целой части от дробной используется точка.
`subsidy`	Double	Общее вознаграждение партнеру от Маркета за все акции Маркета, в которых участвует товар. Передается в валюте заказа, для отделения целой части от дробной используется точка.
`buyerPriceBeforeDiscount`	Double	Стоимость товара в валюте покупателя до применения скидок. Передается в валюте заказа, для отделения целой части от дробной используется точка.
`priceBeforeDiscount`	Double	Стоимость товара в валюте магазина до применения скидок. Для отделения целой части от дробной используется точка.
`vat`	Enum	Ставка налога на добавленную стоимость (НДС) на товар. Используется только совместно с параметром `"paymentMethod": "YANDEX"`. Возможные значения: `NO_VAT` — НДС не облагается, используется только для отдельных видов услуг. `VAT_0` — НДС 0 %. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров. `VAT_10` — НДС 10 %. Применяется для некоторых товаров, например, для лекарств. `VAT_10_110` — НДС 10/110. Расчетная ставка НДС 10 %, применяется только для случая предоплаты. `VAT_20` — НДС 20 %. Основная ставка НДС. `VAT_20_120` — НДС 20/120. Расчетная ставка НДС 20 %, применяется только для случая предоплаты.
`promos`	Описание	Информация о вознаграждениях партнеру за скидки на товар по промокодам, купонам и акциям.

Параметры, вложенные в `instances`

Параметр	Тип	Значение
`cis`	String	Код идентификации единицы товара в системе «Честный ЗНАК».

Параметры, вложенные в `promos`

Параметр	Тип	Значение
`marketPromoId`	String	Идентификатор акции в рамках соглашения на оказание услуг по продвижению сервиса между Маркетом и партнером. Параметр передается, только если параметр `type=MARKET_DEAL`.
`subsidy`	Float	Вознаграждение партнеру от Маркета за товар, проданный в рамках акции. Передается в валюте заказа, для отделения целой части от дробной используется точка.
`type`	Enum	Тип акции. Возможные значения: `MARKET_COUPON` — скидка по промокоду от Маркета. `MARKET_COIN` — скидка по купонам. `MARKET_PROMOCODE` — скидка по промокоду магазина. `CHEAPEST_AS_GIFT` — самый дешевый товар в подарок.

Ответные данные от магазина

Не ожидаются.

Если запрос от Маркета вернется повторно, на него необходимо ответить со статусом 200, поскольку Маркет не ожидает ответ от магазина.

Описание ошибок

Магазин может вернуть следующие статусы ответов:

Описание	Пояснение
Ошибка `400 Bad Request`	Если магазин считает запрос, поступающий от Маркета, некорректным, магазин должен вернуть статус ответа 400 с описанием причины ошибки в теле ответа. Такие ответы будут анализироваться на предмет нарушений и недоработок API со стороны Маркета.
Ошибка `500 Internal Server Error`	В случае технической ошибки на стороне магазина он должен вернуть статус ответа 500. Магазины с большим количеством таких ответов могут быть отключены от Маркета.

Примеры

FBS

DBS

{
  "order":
  {
    "businessId": 95291,
    "creationDate": "10-12-2019 13:53:17",
    "currency": "RUR",
    "fake": false,
    "id": 12345,
    "paymentType": "PREPAID",
    "paymentMethod": "YANDEX",
    "status": "PROCESSING",
    "substatus": "STARTED",
    "vehicleNumber": "А123НН750",
    "taxSystem": "OSN",
    "subsidyTotal": 150,
    "buyerItemsTotalBeforeDiscount": 5800,
    "buyerTotalBeforeDiscount": 6150,
    "buyerItemsTotal": 5650,
    "buyerTotal": 6000,
    "itemsTotal": 5650,
    "total": 6000,
    "totalWithSubsidy": 6150,
    "deliveryTotal": 350,
    "delivery":
    {
      "serviceName": "СПСР",
      "type": "DELIVERY",
      "courier":
      {
        "fullName": "Иванов Иван Иванович",
        "phone": "+79123456789",
        "phoneExtension": "1234",
        "vehicleNumber": "A777AА750",
        "vehicleDescription": "Mazda 6 зеленый"
      },
      "region":
      {
        "id": 213,
        "name": "Москва",
        "type": "CITY",
        "parent":
        {
          "id": 1,
          "name": "Москва и Московская область",
          "type": "SUBJECT_FEDERATION",
          "parent":
          {
            "id": 3,
            "name": "Центральный федеральный округ",
            "type": "COUNTRY_DISTRICT",
            "parent":
            {
              "id": 225,
              "name": "Россия",
              "type": "COUNTRY"
            }
          }
        }
      },
      "shipments":
      [
        {
          "id": 90141,
          "weight": 350,
          "width": 10,
          "height": 20,
          "depth": 7,
          "status": "CREATED",
          "shipmentDate": "11-12-2019"
          "boxes":
          [ {
            "id": 288532885
          } ]
        }
      ]
    },
    "items":
    [
      {
        "offerId": "100423035876",
        "count": 3,
        "price": 1150,
        "buyer-price": 1150,
        "buyerPriceBeforeDiscount": 1200,
        "priceBeforeDiscount": 1200,
        "subsidy": 50,
        "vat": "VAT_20",
        "warehouseId": 12345,
        "partnerWarehouseId": "67890",
        "instances":
        [
          {
            "cis": "010465006531553121CtPoNqNB7qOdc"
          }
        ],
        "promos":
        [
          {
            "marketPromoId": "abc",
            "subsidy": 50,
            "type": "MARKET_DEAL"
          }
        ]
      },
      {
        "offerId": "100556386844",
        "count": 1,
        "price": 2200,
        "buyer-price": 2200,
        "buyerPriceBeforeDiscount": 2200,
        "priceBeforeDiscount": 2200,
        "subsidy": 0,
        "vat": "VAT_20",
        "warehouseId": 12345,
        "partnerWarehouseId": "67890"
      }
    ],
    "electronicAcceptanceCertificateCode": "123456",
    "notes": "Привезите побыстрее, пожалуйста!"
  }
}

{
  "order":
  {
    "businessId": 95291,
    "creationDate": "15-09-2020 00:42:42",
    "currency": "RUR",
    "fake": false,
    "id": 12345,
    "paymentType": "PREPAID",
    "paymentMethod": "YANDEX",
    "status": "PROCESSING",
    "taxSystem": "OSN",
    "subsidyTotal": 150,
    "buyerItemsTotalBeforeDiscount": 5800,
    "buyerTotalBeforeDiscount": 6150,
    "buyerItemsTotal": 5650,
    "buyerTotal": 6000,
    "itemsTotal": 5650,
    "total": 6000,
    "totalWithSubsidy": 6150,
    "deliveryTotal": 350,
    "buyer":
    {
      "id": "LEgMQuuxR8",
      "lastName": "Иванов",
      "firstName": "Иван",
      "middleName": "Иванович"
    },
    "delivery":
    {
      "price": 350,
      "serviceName": "СПСР",
      "type": "DELIVERY",
      "dispatchType": "BUYER",
      "vat": "VAT_10",
      "address":
      {
        "country": "Россия",
        "city": "Москва",
        "subway": "Проспект Вернадского",
        "street": "Ленинский проспект",
        "house": "90",
        "floor": "6"
      },
      "dates":
      {
        "fromDate": "15-09-2020",
        "toDate": "15-09-2020",
        "fromTime": "09:00",
        "toTime": "21:00"
      },
      "region":
      {
        "id": 213,
        "name": "Москва",
        "type": "CITY",
        "parent":
        {
          "id": 1,
          "name": "Москва и Московская область",
          "type": "SUBJECT_FEDERATION",
          "parent":
          {
            "id": 3,
            "name": "Центральный федеральный округ",
            "type": "COUNTRY_DISTRICT",
            "parent":
            {
              "id": 225,
              "name": "Россия",
              "type": "COUNTRY"
            }
          }
        }
      }
    },
    "items":
    [
      {
        "count": 3,
        "feedCategoryId": "35",
        "fulfilmentShopId": 1234567,
        "feedId": 12345,
        "offerId": "4609283881",
        "offerName": "Чайник электрический 100 W",
        "price": 1150,
        "buyer-price": 1150,
        "buyerPriceBeforeDiscount": 1200,
        "priceBeforeDiscount": 1200,
        "subsidy": 50,
        "vat": "VAT_20",
        "promos":
        [
          {
            "marketPromoId": "abc",
            "subsidy": 300,
            "type": "MARKET_DEAL"
          }
        ]
      },
      {
        "count": 1,
        "feedCategoryId": "41",
        "fulfilmentShopId": 1234567,
        "feedId": 12345,
        "offerId": "4607632101",
        "offerName": "Тостер",
        "price": 2200,
        "buyer-price": 2200,
        "buyerPriceBeforeDiscount": 2200,
        "priceBeforeDiscount": 1200,
        "subsidy": 0,
        "vat": "VAT_20"
      }
    ],
    "notes": "Не работает звонок. Пожалуйста, стучите."
  }
}

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

ОписаниеОписание

Передаваемые магазину данныеПередаваемые магазину данные

Параметры, вложенные в order

Параметры, вложенные в buyer

Параметры, вложенные в delivery

Параметры, вложенные в shipments

Параметры, вложенные в address

Параметры, вложенные в dates

Параметры, вложенные в outlet

Параметры, вложенные в region

Параметры, вложенные в courier

Параметры, вложенные в boxes

Параметры, вложенные в items

Параметры, вложенные в instances

Параметры, вложенные в promos

Ответные данные от магазинаОтветные данные от магазина

Описание ошибокОписание ошибок

ПримерыПримеры

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