Информация о товарах, которые размещены в заданном магазине

status

Type: ApiResponseStatusType

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

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

Enum: OK, ERROR

nextPageToken

Type: string

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

Example: example

minQuantity

Type: integer

Минимальное количество единиц товара в заказе. Например, если указать 10, покупатель сможет добавить в корзину не меньше 10 единиц.

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

Min value: 1

stepQuantity

Type: integer

На сколько единиц покупатель сможет увеличить количество товара в корзине.

Например, если задать 5, покупатель сможет добавить к заказу только 5, 10, 15, ... единиц товара.

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

Min value: 1

Max value: 100

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

available

Type: boolean

Есть ли товар в продаже.

quantum

Type: QuantumDTO

Настройка продажи квантами. Что это значит?

Настройка продажи квантами.

Чтобы сбросить установленные ранее значения, передайте пустой параметр quantum.

{
  "offers": [
    {
      "offerId": "08e35dc1-89a2-11e3-8055-0015e9b8c48d",
      "quantum": {}
    }
  ]
}

{
  "minQuantity": 1,
  "stepQuantity": 1
}

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

Цена товара.

Min value: 0

Exclusive min: true

updatedAt

Type: string<date-time>

Время последнего обновления.

Example: 2025-01-01T00:00:00Z

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

discountBase

Type: DiscountBase

Зачеркнутая цена.

Число должно быть целым. Вы можете указать цену со скидкой от 5 до 99%.

Передавайте этот параметр при каждом обновлении цены, если предоставляете скидку на товар.

Min value: 0

Exclusive min: true

Example: 0

value

Type: number

Цена товара.

Min value: 0

Exclusive min: true

vat

Type: VatType

Идентификатор НДС, применяемый для товара:

• 2 — НДС 10%. Например, используется при реализации отдельных продовольственных и медицинских товаров.
• 5 — НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.
• 6 — НДС не облагается, используется только для отдельных видов услуг.
• 7 — НДС 20%. Основной НДС с 2019 года до 1 января 2026 года.
• 10 — НДС 5%. НДС для упрощенной системы налогообложения (УСН).
• 11 — НДС 7%. НДС для упрощенной системы налогообложения (УСН).
• 14 — НДС 22%. Основной НДС с 1 января 2026 года.

Если параметр не указан, используется НДС, установленный в кабинете.

Для продавцов Market Yandex Go недоступна передача и получение НДС.

Example: 0

comment

Type: string

Пояснение.

Example: example

message

Type: string

Тип ошибки.

Example: example

offers

Type: GetCampaignOfferDTO[]

Страница списка товаров.

[
  {
    "offerId": "example",
    "quantum": {
      "minQuantity": 1,
      "stepQuantity": 1
    },
    "available": true,
    "basicPrice": {
      "updatedAt": "2025-01-01T00:00:00Z"
    },
    "campaignPrice": {
      "value": 0,
      "discountBase": 0,
      "currencyId": "RUR",
      "vat": 0
    },
    "status": "PUBLISHED",
    "errors": [
      {
        "message": "example",
        "comment": "example"
      }
    ],
    "warnings": [
      null
    ]
  }
]

paging

Type: ScrollingPagerDTO

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

{
  "nextPageToken": "example",
  "prevPageToken": "example"
}

code

Type: string

Код ошибки.

Example: example

message

Type: string

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

Example: example