Товары в интернет-магазине

Товары

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

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

Путь: /wp-json/usam/v1/products

Метод запроса: GET

  • fields (массив) (не обязательно) дополнительные поля, которые нужно получить;
  • search (строка) (не обязательно) — поиск по номеру товар, по артикулу товара, по названию товара или его части;
  • status (массив) (не обязательно) — массив кодов статусов;
  • from_price (число) (не обязательно) — цена больше либо равно;
  • to_price (число) (не обязательно) — цена меньше либо равно;
  • from_stock (число) (не обязательно) — остаток больше либо равно;
  • to_stock (число) (не обязательно) — остаток меньше либо равно;
  • from_views (число) (не обязательно) — просмотров больше либо равно;
  • to_views (число) (не обязательно) — просмотров меньше либо равно;
  • count (число) (не обязательно) — количество, по умолчанию 10;
  • paged (число) (не обязательно) — страница списка;
  • orderby (строка) (не обязательно) — сортировать по полю;
  • order (строка) (не обязательно) — направление сортировки ASC или DESC;

fields может содержать:

  • sku — артикул товара
  • virtual — вид товара
  • total_balance — доступный остаток (общий остаток мину резерв)
  • stock — общий остаток
  • code — внешний код товара
  • weight — вес товара
  • barcode — штрих код товара
  • views — количество просмотров
  • rating — рейтинг товара
  • rating_count — количество проголосовавших
  • underprice — наценка товара
  • price — цена товара
  • old_price — старая цена товара
  • storages — получить массив остатков, где ключ номер склада, а значение остаток
  • external_storages — получить массив остатков, где ключ внешний код склада, а значение остаток
  • prices — получить массив цен, где ключ код типа цены, а значение цена
  • external_prices — получить массив цен, где ключ внешний код типа цены, а значение цена
  • category — получить массив объектов категорий
  • brand — получить объект бренда
  • attributes — массив атрибутов товара
  • thumbnail — ссылка на основную фотографию

Пример запроса

/wp-json/usam/v1/products

{"fields":["brand","category","prices","storages"],"count":2}

Возвращает

Ответы в формате JSON

{
    "count": 21,
    "items": [
        {
            "ID": 189,
            "post_author": "1",
            "post_date": "2018-03-07 21:06:34",
            "post_date_gmt": "2018-03-07 19:36:34",
            "post_content": "",
            "post_title": "Программа для ЭВМ "Универсам". Лицензия Бизнес",
            "post_excerpt": "",
            "post_status": "publish",
            "comment_status": "closed",
            "ping_status": "closed",
            "post_password": "",
            "post_name": "programma-dlya-evm-upravlenie-internet-magazinom-licenziya-biznes",
            "to_ping": "",
            "pinged": "",
            "post_modified": "2021-07-29 23:18:05",
            "post_modified_gmt": "2021-07-29 21:18:05",
            "post_content_filtered": "",
            "post_parent": 0,
            "guid": "http://wp-universam.ru/products/programma-dlya-evm-upravlenie-internet-magazinom-licenziya-biznes/",
            "menu_order": 3,
            "post_type": "usam-product",
            "post_mime_type": "",
            "comment_count": "0",
            "filter": "raw",
            "brand": "",
            "category": [
                {
                    "term_id": 6,
                    "name": "Лицензии",
                    "slug": "licenses",
                    "term_group": 0,
                    "term_taxonomy_id": 6,
                    "taxonomy": "usam-category",
                    "description": "",
                    "parent": 0,
                    "count": 5,
                    "filter": "raw"
                }
            ],
            "prices": {              
                "tp_2": 49900,
                "tp_1": 49900
            },
            "storages": {
                "1": "40"
            }
        },
        {
            "ID": 192,
            "post_author": "1",
            "post_date": "2018-03-07 21:12:34",
            "post_date_gmt": "2018-03-07 19:42:34",
            "post_content": "",
            "post_title": "Программа для ЭВМ "Универсам". Лицензия Старт",
            "post_excerpt": "<p>Лицензия Старт прекрасно подает для интернет магазина не большой компании или как начала освоения платформы и в будущем перейти на другие лицензии с большими возможностями. В лицензию включены все инструменты для начала работы интернет-магазина. В комплект входит стандартная бесплатная тема, готовая к работе.</p>",
            "post_status": "publish",
            "comment_status": "open",
            "ping_status": "closed",
            "post_password": "",
            "post_name": "programma-dlya-evm-upravlenie-internet-magazinom-licenziya-start",
            "to_ping": "",
            "pinged": "",
            "post_modified": "2020-05-15 11:14:20",
            "post_modified_gmt": "2020-05-15 09:14:20",
            "post_content_filtered": "",
            "post_parent": 0,
            "guid": "http://wp-universam.ru/products/programma-dlya-evm-upravlenie-internet-magazinom-licenziya-start/",
            "menu_order": 1,
            "post_type": "usam-product",
            "post_mime_type": "",
            "comment_count": "0",
            "filter": "raw",
            "brand": "",
            "category": [
                {
                    "term_id": 6,
                    "name": "Лицензии",
                    "slug": "licenses",
                    "term_group": 0,
                    "term_taxonomy_id": 6,
                    "taxonomy": "usam-category",
                    "description": "",
                    "parent": 0,
                    "count": 5,
                    "filter": "raw"
                }
            ],
            "prices": {
                "tp_2": 5900,
                "tp_1": 5900
            },
            "storages": {
                "1": "6"
            }
        }
    ]
}

Создать товары

Путь: /wp-json/usam/v1/products

Метод запроса: POST

  • items — массив содержащий данные для создания (обязательный)

Значения items смотрите ниже.

/wp-json/usam/v1/products

{"items":[{
       "post_title":"Кастрюля 26 см",
       "post_status":"publish",
       "weight":1,
       "sku":"436ds",
       "code":"dzfst54",
       "barcode":3426470022811,
       "thumbnail":"http://radov39.ru/wp-content/uploads/2014/03/kastryulya-clow-cook-red-29-sm_1-60x60.jpg",
       "prices":[{"sdff":2300},{"ert":2300}],
       "storages":[{"fgg":0},{"ghjk":20}],
       "category":["frrgfghg","gdfhjhjk"],
       "attributes":[{"fgg65":"Железо"},{"xfgfj":20},{"dfgfth":"Красный"}]
}]}

Пример запроса

Обновить товары

Путь: /wp-json/usam/v1/products

Метод запроса: PUT

  • items — массив содержащий данные для обновления (обязательный)

Для обновление необходимо для каждого товара передать внешний код, артикул или его ID в базе.

Пример запроса

/wp-json/usam/v1/products

{"items":[{
       "code":"dzfst54",
       "post_title":"Кастрюля красная 26 см",
       "post_status":"publish",
       "barcode":3426470022811,
       "prices":[{"sdff":2300},{"ert":2300}],
       "storages":[{"fgg":0},{"ghjk":20}],
       "category":["frrgfghg","gdfhjhjk"],
       "attributes":[{"fgg65":"Железо"},{"xfgfj":20},{"dfgfth":"Красный"}]
}]}

Данные, которые содержит items для создания и обновления товара

post_title (строка) (обязательно)
Название товара.

ID (число) (не обязательно)
Номер товара в базе. Используется только для обновления.

post_name (строка) (не обязательно)
Ссылка товара.

post_excerpt (строка) (не обязательно)
Краткое описание товара.

post_content (строка) (не обязательно)
Основной контент товара.

menu_order (число) (не обязательно)
Порядок сортировки товара. Если используется ручная сортировка, то сортируется по этому числу.

post_date (дата время) (не обязательно)
Дата создания товара.

post_status (строка) (не обязательно)
Код статуса товара.

post_author (число) (не обязательно)
Автор создания товара.

weight (число) (не обязательно)
Вес товара.

sku (строка) (не обязательно)
Артикул товара.

virtual (строка) (не обязательно)
Тип товара. По умолчанию, тип «физический товар» (product).

  • product — физические товары
  • service — услуга
  • subscription — виртуальный товар
  • electronic_product — подписка

code (строка) (не обязательно)
Внешний код товара, для последующего обновления

barcode (число) (не обязательно)
Штрих код товара.

views (число) (не обязательно)
Количество просмотров товара.

rating (число) (не обязательно)
Рейтинг товара.

rating_count (число) (не обязательно)
Количество количество проголосовавших.

unit (число) (не обязательно)
Единица измерения товара.

unit_measure (число) (не обязательно)
Код единицы измерения товара. По умолчанию thing (штуки).

thumbnail (строка) (не обязательно)
Ссылка для миниатюры (главной фотографии).

images (массив строк) (не обязательно)
Массив ссылок на картинки товара.

not_limited (число) (не обязательно)
Установить неограниченный запас.

storages (массив) (не обязательно)
Массив, в котором ключ внешний код склада, а значение остаток на складе.

prices (массив) (не обязательно)
Массив, в котором ключ внешний код цены, а значение цена.

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

brand (строка) (не обязательно)
Внешний код бренда.

attributes (массив) (не обязательно)
Массив, в котором ключ внешний код атрибута, а значение массива значение атрибута.

crosssell (массив строк) (не обязательно)
Массив внешних кодов товаров для создания связи с сопутствующими товарами.

similar (массив строк) (не обязательно)
Массив внешних кодов товаров, для создания связи с аналогами.

Обновить цены

Обновляет цены у товаров

Путь: /wp-json/usam/v1/products/price

Метод запроса: PUT

  • items — массив содержащий данные для обновления (обязательный)

Данные, которые содержит items для обновления цен

price (число) (обязательно)
Цена товара.

external_code_price (строка) (не обязательно)
Внешний код цены.

code_price (строка) (не обязательно)
Код цены.

code (строка) (обязательно)
Код товара.

обязательно используйте code_price или external_code_price в запросе

Пример запроса

/wp-json/usam/v1/products/price

{"items":[
    {"code":"7676","price":12,"code_price":"tp_1"},
    {"code":"7676","price":12,"code_price":"tp_4"}
]}

Значения характеристик товаров

Получить список значений характеристик товаров

Путь: /wp-json/usam/v1/attribute_values

Метод запроса: GET

  • search — поиск коду и значению(не обязательный);
  • attribute_id — массив чисел или число id характеристики (не обязательный);
  • attribute_external_code — внешний код характеристики, тип строка (не обязательный);
  • code — массив кодов характеристик(не обязательный);
  • include — id значений которые нужно получить (не обязательный);
  • count — количество заказов, по умолчанию 10 заказов (не обязательный);
  • paged — страница списка (не обязательный);
  • orderby — сортировать по полю (не обязательный);
  • order — направление сортировки ASC или DESC (не обязательный);

Возвращает

  • items — массив значений
  • count — количество значений

Пример запроса

/wp-json/usam/v1/products/price

{"items":[
     {
        "id": "1",
        "attribute_id": "9",
        "value": "не оказывается",
        "code": "",
        "sort": "0"
    },
],
"count":100}