Информация о заказах в кабинете

orders

Type: BusinessOrderDTO[]

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

Max items: 50

[
  {
    "orderId": 0,
    "campaignId": 1,
    "programType": "FBY",
    "externalOrderId": "example",
    "status": "PLACING",
    "substatus": "RESERVATION_EXPIRED",
    "creationDate": "2020-02-02T14:30:30+03:00",
    "updateDate": "2020-02-02T14:30:30+03:00",
    "paymentType": "PREPAID",
    "paymentMethod": "CASH_ON_DELIVERY",
    "fake": true,
    "items": [
      {
        "id": 0,
        "offerId": "example",
        "offerName": "example",
        "count": 0,
        "prices": {
          "payment": {},
          "subsidy": null,
          "cashback": null,
          "vat": "NO_VAT"
        },
        "instances": [
          {}
        ],
        "requiredInstanceTypes": [
          "CIS"
        ],
        "tags": [
          "ULTIMA"
        ]
      }
    ],
    "prices": {
      "payment": null,
      "subsidy": null,
      "cashback": null,
      "delivery": {
        "payment": null,
        "subsidy": null,
        "vat": null
      }
    },
    "delivery": {
      "type": "DELIVERY",
      "serviceName": "example",
      "deliveryServiceId": 0,
      "warehouseId": "example",
      "deliveryPartnerType": "SHOP",
      "dispatchType": "UNKNOWN",
      "dates": {
        "fromDate": "2025-01-01",
        "toDate": "2025-01-01",
        "fromTime": "12:00:00",
        "toTime": "12:00:00",
        "realDeliveryDate": "2025-01-01"
      },
      "shipment": {
        "id": 0,
        "shipmentDate": "2025-01-01",
        "shipmentTime": "12:00:00"
      },
      "courier": {
        "address": {
          "country": "example",
          "postcode": "example",
          "city": "example",
          "district": "example",
          "subway": "example",
          "street": "example",
          "house": "example",
          "block": "example",
          "entrance": "example",
          "entryphone": "example",
          "floor": "example",
          "apartment": "example",
          "gps": {}
        },
        "region": {
          "id": 0,
          "name": "example",
          "type": "OTHER",
          "parent": null
        }
      },
      "pickup": {
        "address": null,
        "region": null,
        "logisticPointId": 1,
        "outletCode": "example",
        "outletStorageLimitDate": "2025-01-01"
      },
      "transfer": {
        "courier": {
          "fullName": "example",
          "phone": "example",
          "phoneExtension": "example",
          "vehicleNumber": "example",
          "vehicleDescription": "example"
        },
        "eac": {
          "eacType": "MERCHANT_TO_COURIER",
          "eacCode": "example"
        }
      },
      "boxesLayout": [
        {
          "items": [
            null
          ],
          "boxId": 0,
          "barcode": "example"
        }
      ],
      "tracks": [
        {
          "trackCode": "example",
          "deliveryServiceId": 0
        }
      ],
      "estimated": true,
      "receiveCode": "example"
    },
    "services": {
      "liftType": "NOT_NEEDED"
    },
    "buyerType": "PERSON",
    "notes": "example",
    "cancelRequested": true,
    "sourcePlatform": "MARKET"
  }
]

paging

Type: ForwardScrollingPagerDTO

Информация о страницах результатов.

Идентификатор следующей страницы.

{
  "nextPageToken": "example"
}

currencyId

Type: CurrencyType

Валюта.

Коды валют:

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

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

value

Type: number

Значение.

cashback

Type: CurrencyValueDTO

Сумма, которая оплачена баллами Плюса.

Валюта и ее значение.

{
  "value": 0.5,
  "currencyId": "RUR"
}

payment

Type: CurrencyValueDTO

Общая стоимость всех единиц товара.

Валюта и ее значение.

{
  "value": 0.5,
  "currencyId": "RUR"
}

subsidy

Type: CurrencyValueDTO

Общая сумма вознаграждений продавцу.

Валюта и ее значение.

{
  "value": 0.5,
  "currencyId": "RUR"
}

vat

Type: OrderVatType

НДС на товар.

НДС на товар или доставку:

• NO_VAT — НДС не облагается, используется только для отдельных видов услуг.

• VAT_0 — НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.

• VAT_10 — НДС 10%. Например, используется при реализации отдельных продовольственных и медицинских товаров.

• VAT_10_110 — НДС 10/110. НДС 10%, применяется только при предоплате.

• VAT_20 — НДС 20%. Основной НДС с 2019 года до 1 января 2026 года.

• VAT_20_120 — НДС 20/120. НДС 20%, применяется только при предоплате.

• VAT_18 — НДС 18%. Основной НДС до 2019 года.

• VAT_18_118 — НДС 18/118. НДС использовался до 1 января 2019 года при предоплате.

• VAT_12 — НДС 12%. Используется только в Узбекистане.

• VAT_05 — НДС 5%. НДС для упрощенной системы налогообложения (УСН).

• VAT_07 — НДС 7%. НДС для упрощенной системы налогообложения (УСН).

• VAT_22 — НДС 22%. Основной НДС с 1 января 2026 года.

• UNKNOWN_VALUE — неизвестный тип.

Enum: NO_VAT, VAT_0, VAT_10, VAT_10_110, VAT_20, VAT_20_120, VAT_18, VAT_18_118, VAT_12, VAT_05, VAT_07, VAT_22, UNKNOWN_VALUE

cis

Type: string

Код идентификации единицы товара в системе «Честный ЗНАК» без криптохвоста или «ASL BELGISI» (для продавцов Market Yandex Go).

Example: example

cisFull

Type: string

Код идентификации единицы товара в системе «Честный ЗНАК» с криптохвостом.

Example: example

countryCode

Type: CountryCode

Страна производства в формате ISO 3166-1 alpha-2. Как получить

Min length: 2

Max length: 2

Pattern: ^[A-Z]{2}$

Example: RU

gtd

Type: string

Грузовая таможенная декларация.

Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации.

Example: example

rnpt

Type: string

Регистрационный номер партии товара.

Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации.

Example: example

uin

Type: string

УИН ювелирного изделия (16-значный код) Производитель получает УИН, когда регистрирует изделие в системе контроля за оборотом драгоценных металлов и камней — ГИИС ДМДК.

Example: example

count

Type: integer

Количество единиц товара.

id

Type: integer

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

Позволяет идентифицировать товар в рамках заказа.

offerId

Type: ShopSku

Идентификатор товарного предложения.

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

• У каждого товара SKU должен быть свой.

• Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

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

Example: example

offerName

Type: string

Название товара.

Example: example

instances

Type: OrderItemInstanceDTO[] | null

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

Возвращаются данные для маркировки, переданные в запросе:

• Для DBS — PUT v2/campaigns/{campaignId}/orders/{orderId}/identifiers или PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.
• Для FBS и EXPRESS — PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.

Для FBY возвращаются коды маркировки, переданные во время поставки.

Если магазин еще не передавал коды для этого заказа, instances отсутствует.

Min items: 1

[
  {
    "cis": "example",
    "cisFull": "example",
    "uin": "example",
    "rnpt": "example",
    "gtd": "example",
    "countryCode": "RU"
  }
]

prices

Type: ItemPriceDTO

Информация о выплатах и вознаграждениях.

Информация о выплатах и вознаграждениях.

{
  "payment": {
    "value": 0.5,
    "currencyId": "RUR"
  },
  "subsidy": null,
  "cashback": null,
  "vat": "NO_VAT"
}

requiredInstanceTypes

Type: OrderItemInstanceType[] | null

Список необходимых маркировок товара.

Min items: 1

Unique items: true

[
  "CIS"
]

tags

Type: OrderItemTagType[] | null

Признаки товара.

Min items: 1

Unique items: true

[
  "ULTIMA"
]

payment

Type: CurrencyValueDTO

Платеж покупателя за доставку.

Валюта и ее значение.

{
  "value": 0.5,
  "currencyId": "RUR"
}

subsidy

Type: CurrencyValueDTO

Вознаграждение Маркета за доставку.

Валюта и ее значение.

{
  "value": 0.5,
  "currencyId": "RUR"
}

vat

Type: OrderVatType

НДС на доставку.

НДС на товар или доставку:

• NO_VAT — НДС не облагается, используется только для отдельных видов услуг.

• VAT_0 — НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.

• VAT_10 — НДС 10%. Например, используется при реализации отдельных продовольственных и медицинских товаров.

• VAT_10_110 — НДС 10/110. НДС 10%, применяется только при предоплате.

• VAT_20 — НДС 20%. Основной НДС с 2019 года до 1 января 2026 года.

• VAT_20_120 — НДС 20/120. НДС 20%, применяется только при предоплате.

• VAT_18 — НДС 18%. Основной НДС до 2019 года.

• VAT_18_118 — НДС 18/118. НДС использовался до 1 января 2019 года при предоплате.

• VAT_12 — НДС 12%. Используется только в Узбекистане.

• VAT_05 — НДС 5%. НДС для упрощенной системы налогообложения (УСН).

• VAT_07 — НДС 7%. НДС для упрощенной системы налогообложения (УСН).

• VAT_22 — НДС 22%. Основной НДС с 1 января 2026 года.

• UNKNOWN_VALUE — неизвестный тип.

Enum: NO_VAT, VAT_0, VAT_10, VAT_10_110, VAT_20, VAT_20_120, VAT_18, VAT_18_118, VAT_12, VAT_05, VAT_07, VAT_22, UNKNOWN_VALUE

cashback

Type: CurrencyValueDTO

Сумма, которая оплачена баллами Плюса.

Возвращается баллами.

Валюта и ее значение.

{
  "value": 0.5,
  "currencyId": "RUR"
}

delivery

Type: DeliveryPriceDTO

Информация о стоимости доставки, включая подъем на этаж.

Информация о стоимости доставки, включая подъем на этаж.

{
  "payment": {
    "value": 0.5,
    "currencyId": "RUR"
  },
  "subsidy": null,
  "vat": "NO_VAT"
}

payment

Type: CurrencyValueDTO

Сумма платежа покупателя.

Валюта и ее значение.

{
  "value": 0.5,
  "currencyId": "RUR"
}

subsidy

Type: CurrencyValueDTO

Общая сумма вознаграждений продавцу.

Валюта и ее значение.

{
  "value": 0.5,
  "currencyId": "RUR"
}

fromDate

Type: string<date>

Ближайшая дата доставки.

Формат даты: ГГГГ-ММ-ДД.

Example: 2025-01-01

fromTime

Type: string<time>

Начало интервала времени доставки.

Передается только вместе с параметром type=DELIVERY.

Формат времени: 24-часовой, ЧЧ:ММ. Вместо ММ всегда указывайте 00 (исключение — 23:59).

Минимальное значение: 00:00.

Example: 12:00:00

realDeliveryDate

Type: string<date>

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

Формат даты: ГГГГ-ММ-ДД.

Example: 2025-01-01

toDate

Type: string<date>

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

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

Формат даты: ГГГГ-ММ-ДД.

Example: 2025-01-01

toTime

Type: string<time>

Конец интервала времени доставки.

Передается только вместе с параметром type=DELIVERY.

Формат времени: 24-часовой, ЧЧ:ММ. Вместо ММ всегда указывайте 00 (исключение — 23:59).

Максимальное значение: 23:59.

Example: 12:00:00

shipmentDate

Type: string<date>

Дата отгрузки.

Формат даты: ГГГГ-ММ-ДД.

Example: 2025-01-01

id

Type: integer | null

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

shipmentTime

Type: string<time> | null

Время отгрузки.

Example: 12:00:00

latitude

Type: number

Широта.

longitude

Type: number

Долгота.

apartment

Type: string

Номер квартиры или офиса.

Example: example

block

Type: string

Корпус.

Example: example

city

Type: string

Город или населенный пункт.

Example: example

country

Type: string

Страна.

Example: example

district

Type: string

Район.

Example: example

entrance

Type: string

Номер подъезда.

Example: example

entryphone

Type: string

Код домофона.

Example: example

floor

Type: string

Этаж.

Example: example

gps

Type: GpsDTO

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

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

{
  "latitude": 0.5,
  "longitude": 0.5
}

house

Type: string

Номер дома.

Example: example

postcode

Type: string

Почтовый индекс.

Example: example

street

Type: string

Улица.

Example: example

subway

Type: string

Станция метро.

Example: example

id

Type: integer

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

name

Type: string

Название региона.

Example: example

type

Type: RegionType

Тип региона.

Тип региона.

Возможные значения:

• CITY_DISTRICT — район города.

• CITY — крупный город.

• CONTINENT — континент.

• COUNTRY_DISTRICT — область.

• COUNTRY — страна.

• REGION — регион.

• REPUBLIC_AREA — район субъекта федерации.

• REPUBLIC — субъект федерации.

• SUBWAY_STATION — станция метро.

• VILLAGE — город.

• OTHER — неизвестный регион.

Enum: OTHER, CONTINENT, REGION, COUNTRY, COUNTRY_DISTRICT, REPUBLIC, CITY, VILLAGE, CITY_DISTRICT, SUBWAY_STATION, REPUBLIC_AREA

parent

Type: RegionDTO

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

Указываются родительские регионы до уровня страны.

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

{
  "id": 0,
  "name": "example",
  "type": "OTHER",
  "parent": null
}

address

Type: BusinessOrderDeliveryAddressDTO

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

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

{
  "country": "example",
  "postcode": "example",
  "city": "example",
  "district": "example",
  "subway": "example",
  "street": "example",
  "house": "example",
  "block": "example",
  "entrance": "example",
  "entryphone": "example",
  "floor": "example",
  "apartment": "example",
  "gps": {
    "latitude": 0.5,
    "longitude": 0.5
  }
}

region

Type: RegionDTO

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

{
  "id": 0,
  "name": "example",
  "type": "OTHER",
  "parent": null
}

address

Type: BusinessOrderDeliveryAddressDTO

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

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

{
  "country": "example",
  "postcode": "example",
  "city": "example",
  "district": "example",
  "subway": "example",
  "street": "example",
  "house": "example",
  "block": "example",
  "entrance": "example",
  "entryphone": "example",
  "floor": "example",
  "apartment": "example",
  "gps": {
    "latitude": 0.5,
    "longitude": 0.5
  }
}

logisticPointId

Type: LogisticPointId

Идентификатор пункта выдачи.

Его можно узнать с помощью метода POST v1/businesses/{businessId}/logistics-points.

Min value: 1

Example: 1

outletCode

Type: string

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

Example: example

outletStorageLimitDate

Type: string<date>

Дата, до которой заказ будет храниться в пункте выдачи. Возвращается, когда заказ переходит в статус PICKUP.

Один раз дату можно поменять с помощью метода PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/storage-limit.

Формат даты: ГГГГ-ММ-ДД.

Example: 2025-01-01

region

Type: RegionDTO

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

{
  "id": 0,
  "name": "example",
  "type": "OTHER",
  "parent": null
}

fullName

Type: string

Полное имя.

Example: example

phone

Type: string

Номер телефона.

Example: example

phoneExtension

Type: string

Добавочный номер телефона.

Example: example

vehicleDescription

Type: string

Описание транспортного средства. Например, модель и цвет.

Example: example

vehicleNumber

Type: string

Номер транспортного средства.

Example: example

eacType

Type: OrderDeliveryEacType

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

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

• MERCHANT_TO_COURIER (временно не возвращается) — продавец передает код курьеру для получения невыкупа.

• COURIER_TO_MERCHANT — курьер передает код продавцу для получения заказа.

• CHECKING_BY_MERCHANT — продавец проверяет код на своей стороне.

Enum: MERCHANT_TO_COURIER, COURIER_TO_MERCHANT, CHECKING_BY_MERCHANT

eacCode

Type: string

Код подтверждения ЭАПП (для типа MERCHANT_TO_COURIER).

Example: example

courier

Type: OrderCourierDTO

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

{
  "fullName": "example",
  "phone": "example",
  "phoneExtension": "example",
  "vehicleNumber": "example",
  "vehicleDescription": "example"
}

eac

Type: BusinessOrderEacDTO

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

{
  "eacType": "MERCHANT_TO_COURIER",
  "eacCode": "example"
}

current

Type: integer

Номер части, начиная с 1.

Min value: 1

total

Type: integer

На сколько всего частей разделен товар.

Min value: 2

cis

Type: Cis

[Код идентификации](*cis-regular-value) единицы товара в системе «Честный ЗНАК» или «ASL BELGISI» (для продавцов Market Yandex Go).

Example: example

countryCode

Type: CountryCode

Страна производства в формате ISO 3166-1 alpha-2. Как получить

Min length: 2

Max length: 2

Pattern: ^[A-Z]{2}$

Example: RU

gtd

Type: string

Грузовая таможенная декларация.

Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации.

Example: example

rnpt

Type: string

Регистрационный номер партии товара.

Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации.

Example: example

uin

Type: string

Уникальный идентификационный номер ювелирного изделия.

Представляет собой число из 16 цифр.

Example: example

id

Type: integer

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

Параметр id в items.

fullCount

Type: integer

Количество единиц товара в коробке.

Min value: 1

instances

Type: BriefOrderItemInstanceDTO[] | null

Переданные коды маркировки.

Min items: 1

[
  {
    "cis": "example",
    "uin": "example",
    "rnpt": "example",
    "gtd": "example",
    "countryCode": "RU"
  }
]

partialCount

Type: BusinessOrderBoxLayoutPartialCountDTO

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

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

{
  "current": 1,
  "total": 2
}

barcode

Type: string

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

Example: example

boxId

Type: integer

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

items

Type: BusinessOrderBoxLayoutItemDTO[]

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

Если в коробке едет часть большого товара, в списке может быть только один пункт.

Min items: 1

[
  {
    "id": 0,
    "fullCount": 1,
    "partialCount": {
      "current": 1,
      "total": 2
    },
    "instances": [
      {
        "cis": "example",
        "uin": "example",
        "rnpt": "example",
        "gtd": "example",
        "countryCode": "RU"
      }
    ]
  }
]

deliveryServiceId

Type: integer

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

trackCode

Type: string

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

Example: example

dates

Type: BusinessOrderDeliveryDatesDTO

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

{
  "fromDate": "2025-01-01",
  "toDate": "2025-01-01",
  "fromTime": "12:00:00",
  "toTime": "12:00:00",
  "realDeliveryDate": "2025-01-01"
}

deliveryPartnerType

Type: OrderDeliveryPartnerType

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

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

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

• YANDEX_MARKET — магазин работает со службой доставки через Маркет.

• UNKNOWN — неизвестный тип.

Enum: SHOP, YANDEX_MARKET, UNKNOWN

deliveryServiceId

Type: integer

Идентификатор службы доставки.

serviceName

Type: string

Название службы доставки.

Example: example

type

Type: OrderDeliveryType

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

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

• DELIVERY — курьерская доставка.

• PICKUP — самовывоз.

• POST — почта.

• DIGITAL — для цифровых товаров.

• UNKNOWN — неизвестный тип.

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

boxesLayout

Type: BusinessOrderBoxLayoutDTO[] | null

Раскладка товаров по коробкам.

Min items: 1

[
  {
    "items": [
      {
        "id": 0,
        "fullCount": 1,
        "partialCount": {
          "current": 1,
          "total": 2
        },
        "instances": [
          {}
        ]
      }
    ],
    "boxId": 0,
    "barcode": "example"
  }
]

courier

Type: BusinessOrderCourierDeliveryDTO

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

{
  "address": {
    "country": "example",
    "postcode": "example",
    "city": "example",
    "district": "example",
    "subway": "example",
    "street": "example",
    "house": "example",
    "block": "example",
    "entrance": "example",
    "entryphone": "example",
    "floor": "example",
    "apartment": "example",
    "gps": {
      "latitude": 0.5,
      "longitude": 0.5
    }
  },
  "region": {
    "id": 0,
    "name": "example",
    "type": "OTHER",
    "parent": null
  }
}

dispatchType

Type: OrderDeliveryDispatchType

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

• BUYER — курьерская доставка покупателю.

• MARKET_BRANDED_OUTLET — доставка в пункт выдачи заказов Маркета.

• SHOP_OUTLET — доставка в пункт выдачи заказов магазина.

• UNKNOWN — неизвестный тип.

Enum: UNKNOWN, BUYER, MARKET_BRANDED_OUTLET, SHOP_OUTLET

estimated

Type: boolean

Приблизительная ли дата доставки.

pickup

Type: BusinessOrderPickupDeliveryDTO

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

{
  "address": {
    "country": "example",
    "postcode": "example",
    "city": "example",
    "district": "example",
    "subway": "example",
    "street": "example",
    "house": "example",
    "block": "example",
    "entrance": "example",
    "entryphone": "example",
    "floor": "example",
    "apartment": "example",
    "gps": {
      "latitude": 0.5,
      "longitude": 0.5
    }
  },
  "region": {
    "id": 0,
    "name": "example",
    "type": "OTHER",
    "parent": null
  },
  "logisticPointId": 1,
  "outletCode": "example",
  "outletStorageLimitDate": "2025-01-01"
}

shipment

Type: BusinessOrderShipmentDTO

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

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

{
  "id": 0,
  "shipmentDate": "2025-01-01",
  "shipmentTime": "12:00:00"
}

tracks

Type: OrderTrackDTO[] | null

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

Min items: 1

[
  {
    "trackCode": "example",
    "deliveryServiceId": 0
  }
]

transfer

Type: BusinessOrderTransferDTO

Информация о курьере и код подтверждения.

{
  "courier": {
    "fullName": "example",
    "phone": "example",
    "phoneExtension": "example",
    "vehicleNumber": "example",
    "vehicleDescription": "example"
  },
  "eac": {
    "eacType": "MERCHANT_TO_COURIER",
    "eacCode": "example"
  }
}

warehouseId

Type: string

Идентификатор склада в системе магазина, на который сформирован заказ.

Example: example

liftType

Type: OrderLiftType

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

• NOT_NEEDED — не требуется.

• MANUAL — ручной.

• ELEVATOR — лифт.

• CARGO_ELEVATOR — грузовой лифт.

• FREE — любой из перечисленных выше, если включена опция бесплатного подъема.

• UNKNOWN — неизвестный тип.

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

campaignId

Type: CampaignId

Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия.

Его можно узнать с помощью запроса GET v2/campaigns или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули:

• блок Идентификатор кампании;
• вкладка Лог запросов → выпадающий список в блоке Показывать логи.

⚠️ Не путайте его с:

• идентификатором магазина, который отображается в личном кабинете продавца;
• рекламными кампаниями.

Min value: 1

Example: 1

creationDate

Type: string<date-time>

Дата и время оформления заказа.

Формат даты: ISO 8601 со смещением относительно UTC.

Example: 2020-02-02T14:30:30+03:00

delivery

Type: BusinessOrderDeliveryDTO

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

{
  "type": "DELIVERY",
  "serviceName": "example",
  "deliveryServiceId": 0,
  "warehouseId": "example",
  "deliveryPartnerType": "SHOP",
  "dispatchType": "UNKNOWN",
  "dates": {
    "fromDate": "2025-01-01",
    "toDate": "2025-01-01",
    "fromTime": "12:00:00",
    "toTime": "12:00:00",
    "realDeliveryDate": "2025-01-01"
  },
  "shipment": {
    "id": 0,
    "shipmentDate": "2025-01-01",
    "shipmentTime": "12:00:00"
  },
  "courier": {
    "address": {
      "country": "example",
      "postcode": "example",
      "city": "example",
      "district": "example",
      "subway": "example",
      "street": "example",
      "house": "example",
      "block": "example",
      "entrance": "example",
      "entryphone": "example",
      "floor": "example",
      "apartment": "example",
      "gps": {
        "latitude": 0.5,
        "longitude": 0.5
      }
    },
    "region": {
      "id": 0,
      "name": "example",
      "type": "OTHER",
      "parent": null
    }
  },
  "pickup": {
    "address": null,
    "region": null,
    "logisticPointId": 1,
    "outletCode": "example",
    "outletStorageLimitDate": "2025-01-01"
  },
  "transfer": {
    "courier": {
      "fullName": "example",
      "phone": "example",
      "phoneExtension": "example",
      "vehicleNumber": "example",
      "vehicleDescription": "example"
    },
    "eac": {
      "eacType": "MERCHANT_TO_COURIER",
      "eacCode": "example"
    }
  },
  "boxesLayout": [
    {
      "items": [
        {
          "id": 0,
          "fullCount": 1,
          "partialCount": {},
          "instances": [
            null
          ]
        }
      ],
      "boxId": 0,
      "barcode": "example"
    }
  ],
  "tracks": [
    {
      "trackCode": "example",
      "deliveryServiceId": 0
    }
  ],
  "estimated": true,
  "receiveCode": "example"
}

fake

Type: boolean

Тип заказа:

• false — настоящий заказ покупателя.

• true — тестовый заказ Маркета.

items

Type: BusinessOrderItemDTO[]

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

[
  {
    "id": 0,
    "offerId": "example",
    "offerName": "example",
    "count": 0,
    "prices": {
      "payment": {
        "value": 0.5,
        "currencyId": "RUR"
      },
      "subsidy": null,
      "cashback": null,
      "vat": "NO_VAT"
    },
    "instances": [
      {
        "cis": "example",
        "cisFull": "example",
        "uin": "example",
        "rnpt": "example",
        "gtd": "example",
        "countryCode": "RU"
      }
    ],
    "requiredInstanceTypes": [
      "CIS"
    ],
    "tags": [
      "ULTIMA"
    ]
  }
]

orderId

Type: integer

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

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 — банковской картой.

  • BOUND_CARD_ON_DELIVERY — привязанной картой при получении.

  • BNPL_BANK_ON_DELIVERY — супер Сплитом.

  • BNPL_ON_DELIVERY — Сплитом.

  • CASH_ON_DELIVERY — наличными.

  • B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.

• UNKNOWN — неизвестный тип.

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

Enum: CASH_ON_DELIVERY, CARD_ON_DELIVERY, BOUND_CARD_ON_DELIVERY, BNPL_BANK_ON_DELIVERY, BNPL_ON_DELIVERY, YANDEX, APPLE_PAY, EXTERNAL_CERTIFICATE, CREDIT, GOOGLE_PAY, TINKOFF_CREDIT, SBP, TINKOFF_INSTALLMENTS, B2B_ACCOUNT_PREPAYMENT, B2B_ACCOUNT_POSTPAYMENT, UNKNOWN

paymentType

Type: OrderPaymentType

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

• PREPAID — оплата при оформлении заказа.

• POSTPAID — оплата при получении заказа.

• UNKNOWN — неизвестный тип.

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

Enum: PREPAID, POSTPAID, UNKNOWN

status

Type: OrderStatusType

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

• PLACING — оформляется, подготовка к резервированию.

• RESERVED — зарезервирован, но недооформлен.

• UNPAID — оформлен, но еще не оплачен (если выбрана оплата при оформлении).

• PROCESSING — находится в обработке.

• DELIVERY — передан в службу доставки.

• PICKUP — доставлен в пункт выдачи.

• DELIVERED — получен покупателем.

• CANCELLED — отменен.

• PENDING — ожидает обработки со стороны продавца.

• PARTIALLY_RETURNED — возвращен частично.

• RETURNED — возвращен полностью.

• UNKNOWN — неизвестный статус.

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

Enum: PLACING, RESERVED, UNPAID, PROCESSING, DELIVERY, PICKUP, DELIVERED, CANCELLED, PENDING, PARTIALLY_RETURNED, RETURNED, UNKNOWN

substatus

Type: OrderSubstatusType

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

• Значения для заказа в статусе PROCESSING:

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

  • READY_TO_SHIP — заказ собран и готов к отправке.

• Значения для заказа в статусе CANCELLED:

  • RESERVATION_EXPIRED — покупатель не завершил оформление зарезервированного заказа в течение 10 минут.

  • USER_NOT_PAID — покупатель не оплатил заказ (для типа оплаты PREPAID) в течение 30 минут.

  • USER_UNREACHABLE — не удалось связаться с покупателем. Для отмены с этой причиной необходимо выполнить условия:

    • не менее 3 звонков с 8 до 21 в часовом поясе покупателя;
    • перерыв между первым и третьим звонком не менее 90 минут;
    • соединение не короче 5 секунд.

    Если хотя бы одно из этих условий не выполнено (кроме случая, когда номер недоступен), отменить заказ не получится. Вернется ответ с кодом ошибки 400.

  • USER_CHANGED_MIND — покупатель отменил заказ по личным причинам.

  • USER_REFUSED_DELIVERY — покупателя не устроили условия доставки.

  • USER_REFUSED_PRODUCT — покупателю не подошел товар.

  • SHOP_FAILED — магазин не может выполнить заказ.

  • USER_REFUSED_QUALITY — покупателя не устроило качество товара.

  • REPLACING_ORDER — покупатель решил заменить товар другим по собственной инициативе.

  • PROCESSING_EXPIRED — значение более не используется.

  • PICKUP_EXPIRED — закончился срок хранения заказа в пункт выдачи.

  • TOO_MANY_DELIVERY_DATE_CHANGES — заказ переносили слишком много раз.

  • TOO_LONG_DELIVERY — заказ доставляется слишком долго.

  • INCORRECT_PERSONAL_DATA — для заказа из-за рубежа указаны неправильные данные получателя, заказ не пройдет проверку на таможне.

• TECHNICAL_ERROR — техническая ошибка на стороне Маркета. Обратитесь в поддержку.

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

Enum: RESERVATION_EXPIRED, USER_NOT_PAID, USER_UNREACHABLE, USER_CHANGED_MIND, USER_REFUSED_DELIVERY, USER_REFUSED_PRODUCT, SHOP_FAILED, USER_REFUSED_QUALITY, REPLACING_ORDER, PROCESSING_EXPIRED, PENDING_EXPIRED, SHOP_PENDING_CANCELLED, PENDING_CANCELLED, USER_FRAUD, RESERVATION_FAILED, USER_PLACED_OTHER_ORDER, USER_BOUGHT_CHEAPER, MISSING_ITEM, BROKEN_ITEM, WRONG_ITEM, PICKUP_EXPIRED, DELIVERY_PROBLEMS, LATE_CONTACT, CUSTOM, DELIVERY_SERVICE_FAILED, WAREHOUSE_FAILED_TO_SHIP, DELIVERY_SERVICE_UNDELIVERED, PREORDER, AWAIT_CONFIRMATION, STARTED, PACKAGING, READY_TO_SHIP, SHIPPED, ASYNC_PROCESSING, WAITING_USER_INPUT, WAITING_BANK_DECISION, BANK_REJECT_CREDIT_OFFER, CUSTOMER_REJECT_CREDIT_OFFER, CREDIT_OFFER_FAILED, AWAIT_DELIVERY_DATES_CONFIRMATION, SERVICE_FAULT, DELIVERY_SERVICE_RECEIVED, USER_RECEIVED, WAITING_FOR_STOCKS, AS_PART_OF_MULTI_ORDER, READY_FOR_LAST_MILE, LAST_MILE_STARTED, ANTIFRAUD, DELIVERY_USER_NOT_RECEIVED, DELIVERY_SERVICE_DELIVERED, DELIVERED_USER_NOT_RECEIVED, USER_WANTED_ANOTHER_PAYMENT_METHOD, USER_RECEIVED_TECHNICAL_ERROR, USER_FORGOT_TO_USE_BONUS, DELIVERY_SERVICE_NOT_RECEIVED, DELIVERY_SERVICE_LOST, SHIPPED_TO_WRONG_DELIVERY_SERVICE, DELIVERED_USER_RECEIVED, WAITING_TINKOFF_DECISION, COURIER_SEARCH, COURIER_FOUND, COURIER_IN_TRANSIT_TO_SENDER, COURIER_ARRIVED_TO_SENDER, COURIER_RECEIVED, COURIER_NOT_FOUND, COURIER_NOT_DELIVER_ORDER, COURIER_RETURNS_ORDER, COURIER_RETURNED_ORDER, WAITING_USER_DELIVERY_INPUT, PICKUP_SERVICE_RECEIVED, PICKUP_USER_RECEIVED, CANCELLED_COURIER_NOT_FOUND, COURIER_NOT_COME_FOR_ORDER, DELIVERY_NOT_MANAGED_REGION, INCOMPLETE_CONTACT_INFORMATION, INCOMPLETE_MULTI_ORDER, INAPPROPRIATE_WEIGHT_SIZE, TECHNICAL_ERROR, SORTING_CENTER_LOST, COURIER_SEARCH_NOT_STARTED, LOST, AWAIT_PAYMENT, AWAIT_LAVKA_RESERVATION, USER_WANTS_TO_CHANGE_ADDRESS, FULL_NOT_RANSOM, PRESCRIPTION_MISMATCH, DROPOFF_LOST, DROPOFF_CLOSED, DELIVERY_TO_STORE_STARTED, USER_WANTS_TO_CHANGE_DELIVERY_DATE, WRONG_ITEM_DELIVERED, DAMAGED_BOX, AWAIT_DELIVERY_DATES, LAST_MILE_COURIER_SEARCH, PICKUP_POINT_CLOSED, LEGAL_INFO_CHANGED, USER_HAS_NO_TIME_TO_PICKUP_ORDER, DELIVERY_CUSTOMS_ARRIVED, DELIVERY_CUSTOMS_CLEARED, FIRST_MILE_DELIVERY_SERVICE_RECEIVED, AWAIT_AUTO_DELIVERY_DATES, AWAIT_USER_PERSONAL_DATA, NO_PERSONAL_DATA_EXPIRED, CUSTOMS_PROBLEMS, AWAIT_CASHIER, WAITING_POSTPAID_BUDGET_RESERVATION, AWAIT_SERVICEABLE_CONFIRMATION, POSTPAID_BUDGET_RESERVATION_FAILED, AWAIT_CUSTOM_PRICE_CONFIRMATION, READY_FOR_PICKUP, TOO_MANY_DELIVERY_DATE_CHANGES, TOO_LONG_DELIVERY, DEFERRED_PAYMENT, POSTPAID_FAILED, INCORRECT_PERSONAL_DATA, UNKNOWN

buyerType

Type: OrderBuyerType

Тип покупателя: физическое лицо или организация.

Только для FBS- и FBY-магазинов, которые размещают товары на витрине business.market.yandex.ru.

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

• PERSON — физическое лицо.

• BUSINESS — организация.

Enum: PERSON, BUSINESS

cancelRequested

Type: boolean

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

Запрошена ли отмена.

externalOrderId

Type: ExternalOrderId

Внешний идентификатор заказа, который вы передали в POST v2/campaigns/{campaignId}/orders/{orderId}/external-id.

Min length: 1

Example: example

notes

Type: string

Комментарий к заказу.

Example: example

prices

Type: OrderPriceDTO

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

Информация о стоимости заказа.

{
  "payment": {
    "value": 0.5,
    "currencyId": "RUR"
  },
  "subsidy": null,
  "cashback": null,
  "delivery": {
    "payment": null,
    "subsidy": null,
    "vat": "NO_VAT"
  }
}

programType

Type: SellingProgramType

Тип программы кампании магазина.

Модель работы:

• FBY — FBY.
• FBS — FBS.
• DBS — DBS.
• EXPRESS — Экспресс.

Enum: FBY, FBS, DBS, EXPRESS, LAAS

services

Type: BusinessOrderServicesDTO

Услуги, добавленные в заказ.

{
  "liftType": "NOT_NEEDED"
}

updateDate

Type: string<date-time>

Дата и время последнего обновления заказа.

Формат даты: ISO 8601 со смещением относительно UTC.

Example: 2020-02-02T14:30:30+03:00

nextPageToken

Type: string

Идентификатор следующей страницы результатов.

Example: example

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

• OK — ошибок нет.
• ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

code

Type: string

Код ошибки.

Example: example

message

Type: string

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

Example: example