---
title: "Список товаров и категорий"
method: GET
path: "/goods"
tags: ["Goods"]
---

# Список товаров и категорий

`GET /goods`

Получение списка товаров и категорий в компании

## Query parameters

- `max` integer
- `offset` integer
- `nodeId` integer

## Response `200`

ОК.

- object
  - `rows` GoodsInfoType[] — Информация о товарах и категориях.
    - `id` integer — ID товара / категории.
    - `name` string, required — Название товара / категории.
    - `data` union, required — Свойства товара в зависимости от типа. Использует дискриминатор по полю `type`: CATEGORY — папка для организации товаров, ITEM — простой товар с ценой и остатками, VARYING_ITEM — товар с вариантами (например, размеры, цвета).
      - object
        - `type` 'CATEGORY' | 'ITEM' | 'VARYING_ITEM', required
      - object
        - `type` 'CATEGORY' | 'ITEM' | 'VARYING_ITEM', required
        - `sku` string, nullable — Артикул товара.
        - `price` number — Цена товара.
        - `description` string, nullable — Описание товара.
        - `offer` object, nullable — Акционный товар.
          - `offerPrice` number, nullable — Цена по акции.
          - `skipLoyalty` boolean — Не применять бонусную программу на товар.
        - `inventory` GoodsInventory, nullable — Доступное количество товара.
          - `inStock` integer, nullable — Доступное количество товара. Значение "null" обозначает - неограниченное количество.
        - `photos` string[] — Список идентификаторов изображений товара.
        - `measurement` 'PIECE' | 'CENTIMETRE' | 'METRE' | 'MILLILITRE' | 'LITRE' | 'GRAM' | 'KILOGRAM' | 'TON' | 'SQUARE_METRE' | 'CUBIC_METRE' | 'DAY' | 'HOUR' | 'MINUTE' | 'KILOMETRE' — Единицы измерения товаров.
        - `increment` number, nullable — Количество товара, которое покупатель может добавить или убрать за 1 шаг.
        - `minQuantity` number, nullable — Минимальное количество товара для заказа.
        - `vatCode` 'NO_NDS' | 'NDS_0' | 'NDS_10' | 'NDS_20' | 'NDS_10_110' | 'NDS_20_120', nullable — Коды ставок НДС.
        - `paymentSubject` 'COMMODITY' | 'EXCISE' | 'SERVICE', nullable — Признак предмета расчета: `COMMODITY` - Товар, `EXCISE` - Подакцизный товар, `SERVICE` - Услуга.
      - object — Товар с несколькими вариантами (например, размеры, цвета, вкусы). Каждый вариант имеет своё название, цену и остатки.
        - `type` 'CATEGORY' | 'ITEM' | 'VARYING_ITEM', required
        - `variants` GoodsVariantType[] — Список вариантов товара.
          - `name` string — Название варианта.
          - `sku` string, nullable — Артикул варианта.
          - `price` number — Цена варианта.
          - `offer` object, nullable — Акционный товар.
            - `offerPrice` number, nullable — Цена по акции.
            - `skipLoyalty` boolean — Не применять бонусную программу на товар.
          - `inventory` GoodsInventory, nullable — Доступное количество товара.
            - `inStock` integer, nullable — Доступное количество товара. Значение "null" обозначает - неограниченное количество.
        - `description` string, nullable — Описание товара с вариантами.
        - `photos` string[] — Список идентификаторов изображений товара.
        - `vatCode` 'NO_NDS' | 'NDS_0' | 'NDS_10' | 'NDS_20' | 'NDS_10_110' | 'NDS_20_120', nullable — Коды ставок НДС.
        - `paymentSubject` 'COMMODITY' | 'EXCISE' | 'SERVICE', nullable — Признак предмета расчета: `COMMODITY` - Товар, `EXCISE` - Подакцизный товар, `SERVICE` - Услуга.
    - `hidden` boolean — Скрыт ли товар / категория.
    - `blocked` boolean — Заблокирован ли товар / категория.
    - `nodeId` integer, nullable — ID категории, в которую вложен товар / категория.
    - `imageUrls` string[] — Список ссылок на изображение товара.
    - `externalId` string, nullable — Внешний идентификатор товара / категории.
    - `dateCreated` string, date-time — Дата создания товара / категории.
  - `total` integer — Количество товаров и категорий.

---

[API](https://skmtc.dev/uds/apis/uds-api-2.md) · [All operations](https://skmtc.dev/uds/apis/uds-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uds/uds-api-2/revisions/f4f284d76ad0/schema)