Отчет по товарам

status

Type: ApiResponseStatusType

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

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

Enum: OK, ERROR

height

Type: number

Высота товара в сантиметрах.

length

Type: number

Длина товара в сантиметрах.

weight

Type: number

Вес товара в килограммах.

width

Type: number

Ширина товара в сантиметрах.

count

Type: integer

Значение остатков.

type

Type: WarehouseStockType

Тип остатков.

Тип остатков товаров на складе:

• AVAILABLE (соответствует типу «Доступный к заказу» в отчете «Остатки на складе» в кабинете продавца на Маркете) — товар, доступный для продажи.

• DEFECT (соответствует типу «Брак») — товар с браком.

• EXPIRED (соответствует типу «Просрочен») — товар с истекшим сроком годности.

• FIT (соответствует типу «Годный») — товар, который доступен для продажи или уже зарезервирован.

• FREEZE — товар, который зарезервирован для заказов.

• QUARANTINE (соответствует типу «Карантин») — товар, временно недоступный для продажи (например, товар перемещают из одного помещения склада в другое).

• UTILIZATION — товар, который будет утилизирован.

Enum: FIT, FREEZE, AVAILABLE, QUARANTINE, UTILIZATION, DEFECT, EXPIRED

stocks

Type: WarehouseStockDTO[]

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

[
  {
    "type": "FIT",
    "count": 0
  }
]

id

Type: integer

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

name

Type: string

Название склада.

Example: example

name

Type: string

Название параметра.

Example: example

value

Type: string

Значение параметра.

Example: example

amount

Type: number

Значение тарифа.

currency

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

parameters

Type: TariffParameterDTO[]

Параметры расчета тарифа.

[
  {
    "name": "example",
    "value": "example"
  }
]

type

Type: TariffType

Услуга Маркета, за которую начисляется тариф.

Услуга Маркета или дополнительный тариф к услуге размещения:

• AGENCY_COMMISSION — прием платежа покупателя.

• PAYMENT_TRANSFER — перевод платежа покупателя.

• STORAGE — хранение товара на складе Маркета в течение суток.

• SURPLUS — хранение излишков на складе Маркета.

• WITHDRAW — вывоз товара со склада Маркета.

• FEE — размещение товара на Маркете.

• DELIVERY_TO_CUSTOMER — доставка покупателю.

• CROSSREGIONAL_DELIVERY — доставка в федеральный округ, город или населенный пункт.

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

• DISPOSAL — утилизация.

• SORTING_CENTER_STORAGE — хранение невыкупов и возвратов.

• EXPRESS_DELIVERY — экспресс-доставка покупателю.

• FF_XDOC_SUPPLY_BOX — поставка товара через транзитный склад (за короб).

• FF_XDOC_SUPPLY_PALLET — поставка товара через транзитный склад (за палету).

• SORTING — обработка заказа.

• MIDDLE_MILE — средняя миля.

• RETURN_PROCESSING — обработка невыкупов и возвратов.

• EXPRESS_CANCELLED_BY_PARTNER — отмена заказа с экспресс-доставкой.

• CROSSBORDER_DELIVERY — доставка из-за рубежа.

• INTAKE_SORTING_BULKY_CARGO — сортировка заказов с крупногабаритными товарами, которые Маркет забрал со склада продавца.

• INTAKE_SORTING_SMALL_GOODS — сортировка заказов с малогабаритными товарами, которые Маркет забрал со склада продавца.

• INTAKE_SORTING_DAILY — организация забора заказов со склада продавца.

• FF_STORAGE_BILLING — хранение товаров на складе.

• CANCELLED_ORDER_FEE_QI — отмена заказа по вине продавца.

• LATE_ORDER_EXECUTION_FEE_QI — несвоевременная отгрузка или доставка.

• VOLUME_STORAGE — стоимость хранения товара на складе — из расчёта за один кубический метр в сутки.

• GOODS_ACCEPTANCE — окончательная приемка товара на складе.

• CARGO_ACCEPTANCE — первичная приемка товара на складе.

• ORDER_PROCESSING — обработка заказа.

• WITHDRAW_EXTERNAL — отгрузка на внешний маркетплейс.

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

Enum: AGENCY_COMMISSION, PAYMENT_TRANSFER, STORAGE, WITHDRAW, SURPLUS, FEE, DELIVERY_TO_CUSTOMER, CROSSREGIONAL_DELIVERY, CROSSREGIONAL_DELIVERY_RETURN, DISPOSAL, SORTING_CENTER_STORAGE, EXPRESS_DELIVERY, FF_XDOC_SUPPLY_BOX, FF_XDOC_SUPPLY_PALLET, SORTING, MIDDLE_MILE, RETURN_PROCESSING, EXPRESS_CANCELLED_BY_PARTNER, CROSSBORDER_DELIVERY, INTAKE_SORTING_BULKY_CARGO, INTAKE_SORTING_SMALL_GOODS, INTAKE_SORTING_DAILY, FF_STORAGE_BILLING, CANCELLED_ORDER_FEE_QI, LATE_ORDER_EXECUTION_FEE_QI, VOLUME_STORAGE, GOODS_ACCEPTANCE, CARGO_ACCEPTANCE, ORDER_PROCESSING, WITHDRAW_EXTERNAL

percent

Type: number

Значение тарифа в процентах.

categoryId

Type: integer

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

categoryName

Type: string

Название категории товара на Маркете.

Example: example

marketSku

Type: MarketSku

SKU на Маркете — идентификатор карточки товара на Маркете.

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

Min value: 1

Example: 1

name

Type: string

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

Example: example

pictures

Type: Url[] | null

Ссылки (URL) изображений товара в хорошем качестве.

Min items: 1

Unique items: true

[
  "example"
]

price

Type: number

Цена товара в валюте, которая установлена в кабинете продавца на Маркете.

shopSku

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

tariffs

Type: TariffDTO[] | null

Информация о тарифах, по которым нужно заплатить за услуги Маркета.

По некоторым услугам могут возвращаться несколько разных стоимостей. Например, в модели FBS стоимость услуги SORTING (обработка заказа) зависит от способа отгрузки и количества заказов в отгрузке. Подробнее о тарифах на услуги читайте в Справке Маркета для продавцов.

Min items: 1

[
  {
    "type": "AGENCY_COMMISSION",
    "percent": 0.5,
    "amount": 0.5,
    "currency": "RUR",
    "parameters": [
      {
        "name": "example",
        "value": "example"
      }
    ]
  }
]

warehouses

Type: GoodsStatsWarehouseDTO[] | null

Информация о складах, на которых хранится товар.

Параметр не приходит, если товара нет ни на одном складе.

Min items: 1

[
  {
    "id": 0,
    "name": "example",
    "stocks": [
      {
        "type": "FIT",
        "count": 0
      }
    ]
  }
]

weightDimensions

Type: GoodsStatsWeightDimensionsDTO

Информация о весе и габаритах товара. Если товар уже привязан к карточке (marketSku), в ответе вернутся габариты из карточки Маркета, а не размеры, которые вы передаете.

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

Если товар уже привязан к карточке (marketSku), в ответе вернутся габариты из карточки Маркета, а не размеры, которые вы передаете.

{
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "weight": 0.5
}

shopSkus

Type: GoodsStatsGoodsDTO[]

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

[
  {
    "shopSku": "example",
    "marketSku": 1,
    "name": "example",
    "price": 0.5,
    "categoryId": 0,
    "categoryName": "example",
    "weightDimensions": {
      "length": 0.5,
      "width": 0.5,
      "height": 0.5,
      "weight": 0.5
    },
    "warehouses": [
      {
        "id": 0,
        "name": "example",
        "stocks": [
          {}
        ]
      }
    ],
    "tariffs": [
      {
        "type": "AGENCY_COMMISSION",
        "percent": 0.5,
        "amount": 0.5,
        "currency": "RUR",
        "parameters": [
          {}
        ]
      }
    ],
    "pictures": [
      "example"
    ]
  }
]

code

Type: string

Код ошибки.

Example: example

message

Type: string

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

Example: example