QUINCE API. Товари

Список методів

/product/list	Отримання списку товарів
/product/add	Створення нового товару
/product/update	Внесення змін до товару
/product/folder/list	Отримання списку папок
/product/folder/add	Створення нової папки
/product/folder/update	Внесення змін до папки

Отримання списку товарів

Назва методу: /product/list

Повертає список товарів. Для навігації використовується номер сторінки (page).

Розмір сторінки фіксований і дорівнює 100 елементам.

Параметри запиту:

filter Тип: object (необов'язковий)	Доступні поля для фільтрації (Фільтр завжди використовує логіку “AND“):
	ParentFolder - масив ідентифікаторів батьківських папок. Необов'язковий параметр. Для отримання товарів, які не належать до жодної з папок, тобто не мають прив'язки до папки, потрібно вказувати значення null.
	Id - ідентифікатор товару. Необов'язковий параметр
	PriceType - масив ідентифікаторів типиів цін. Необов'язковий параметр
	Store - масив ідентифікаторів складів. Необов'язковий параметр
	Archive - Ознака того, що треба повертати архівні елементи
	Kind - Тип товару. Можливі значення: P - товар, K - набір, U - товар SKU, B - базовий товар SKU. Якщо не вказати, буде встановлений тип P.
	IsManufacture - Товар є продукцією. Необов'язковий параметр
page Тип: integer (необов'язковий)	Якщо в запиті не передати, за замовчуванням буде встановлена перша сторінка.

Результат запиту:

Якщо в запиті фільтр відсутній, то повертається список товарів у порядку зростання Id.

Значення полей товарів, що повертаються методом:

Id	Ідентифікатор товару
Name	Назва товару (string)
ParentFolder	ID батьківської папки (integer)
PrintName	Назва для друку (string)
Memo	Коментар (string)
Barcode	Штрих код (string)
UnitName	Назва одиниці виміру (string)
Description	Опис товару (string)
Article	Артикул (string)
Brand	Бренд (об'єкт)
MainSuppliers	Основний постачальник (structure)
	Id - Ідентифікатор постачальника
	Name - Назва постачальника (string)
	RegCode - Реєстраційний код постачальника (string)
Images	Зображення (масив). Основна картинка товару завжди є першою в масиві.
Prices	Ціни (масив)
Stock	Залишки товару по складам (масив). Інформація передається, тільки якщо фільтр "Store" не пустий.

Приклад:

Запит:

{
    "filter": {
        "ParentFolder": 110,
        "PriceType": [
            335
        ],
        "Store": [
            113
        ],
        "Kind": "P"
    },
    "page": 1
}

Результат:

{
    "success": true,
    "data": [
        {
            "Id": 111,
            "ParentFolder": 110,
            "Name": "Product_1",
            "Images": [
                {
                    "Id": 586,
                    "Name": "flowers.jpg",
                    "Url": "https://qfinprod.blob.core.windows.net/images/8c87c4db-9e0f-4e34-bf8f-d4cbc20e9f44_flowers.jpg"
                },
                ...
            ],
            "Prices": [
                {
                    "Id": 106608,
                    "Date": "2022-07-15T00:00:00Z",
                    "PriceType": 335,
                    "Product": 89272,
                    "Price": 10.000000,
                    "Currency": "USD"
                },
              ...
            ],
            "MainSuppliers": [
                {
                    "Id": 110,
                    "Name": "Name1",
                    "RegCode": "12345678"
                }
            ],
            "Stock": [
                {
                    "Store": 346,
                    "Qty": 5.000
                },
                ...
            ]
        },
        ...
    ]
}

Створення або оновлення товару

Метод створення товару(ів): /api/v2/product/add

Метод оновлення товару(ів): /api/v2/product/update

Методи додають або оновлюють товари. Максимальна кількість товарів в одному пакеті - 100.

Параметри запитів у методів майже ідентичні. Тільки для методу /product/update обов'язковим є передача Id товару. Якщо в запиті відсутній Id, повертається помилка і жоден з товарів не оновлюється. Пошук Основного постачальника відбувається по назві та реєстраційному коду. Достатньо співпадіння по одному з полей. Якщо не буде співпадіння - створиться новий контрагент і буде вказаний як основний постачальник. Поля не обов'язкові для заповнення.

Якщо в запиті Id переданий, але не знайдений в довіднику товарів, жоден з товарів також не оновлюється і додатково повертається перелік не знайдених Id.

Параметри запиту:

array Тип: масив (Обов'язковий)	Кожен товар в масиві являє собою об'єкт з переліком полів. Доступні поля:
	id Ідентифікатор товару. Враховується та є обов'язковим тільки для методу /product/update
	Name Назва товару (string)
	ParentFolder ID батьківської папки (integer)
	PrintName Назва для друку (string)
	Memo Коментар (string)
	Barcode Штрих код (string)
	UnitName Одиниця виміру (string). Одиниця виміру має бути вказана без зайвих символів.
	BrandName Бренд (string). Бренд має бути вказано без зайвих символів.
	Description Опис (string)
	MainSupplierName Назва постачальника (string)
	MainSupplierRegCode Реєстраційний код постачальника (string)
	Article Артикул (string)
	IsManufacture Товар є продукцією (boolean)
	PriceType - ідентифікатор типу ціни
	PriceValue - значення ціни

Результат запиту:

Метод повертає масив:

success	true или false
data	Масив ідентифікаторів створених товарів
error	Код та зміст помилки (вказується, якщо success = false)

Приклад:

Запит:

{
    "array": [
        {
            "Name": "Hola_product_0",
            "Article": "5555",
            "ParentFolder": "110",
            ...
        },
        ...
    ]
}

Результат:

{
    "success": true,
    "data": [
        {
            "id": 116
        },
        ...
    ]
}

Отримання списку папок

Назва методу: /api/v2/product/folder/list

Повертає список папок товарного каталогу. Для навігації використовується номер сторінки (page).

Розмір сторінки фіксований і дорівнює 100 елементам.

Параметри запиту:

filter Тип: object (необов'язковий)	Доступні поля для фільтрації (Фільтр завжди використовує логіку “AND“):
	ParentFolder - Id батьківської папки. Необов'язковий параметр.<br><br>Для отримання папок першого рівня, потрібно вказувати значення null.
	Id - ідентифікатор папки. Необов'язковий параметр
page Тип: integer (необов'язковий)	Якщо в запиті не передати, за замовчуванням буде встановлена перша сторінка.

Результат запиту:

Якщо в запиті фільтр відсутній, то повертається список папок у порядку зростання Id.

Приклад:

{
    "success": true,
    "data": [
        {
            "Id": 118,
            "ParentFolder": 110,
            "Name": "Hola_Folder_111"
        },
        ...
    ]
}

Створення або оновлення папки

Метод створення папки(ок): /api/v2/product/folder/add

Метод оновлення папки(ок): /api/v2/product/folder/update

Методи додають або оновлюють папки. Максимальна кількість папок в одному пакеті - 100.

Параметри запитів у методів майже ідентичні. Тільки для методу /product/folder/update обов'язковим є передача Id папки. Якщо в запиті відсутній Id, повертається помилка і жодна з папок не оновлюється.

Якщо в запиті Id переданий, але не знайдений в довіднику папок, жодна з папок також не оновлється і додатково повертається перелік не знайдених Id.

Параметри запиту:

array Тип: масив (Обов'язковий)	Кожна папка в масиві являє собою об'єкт з переліком полів. Доступні поля:
	Id Ідентифікатор папки. Враховується та є обов'язковим тільки для методу /product/folder/update
	Name Назва папки (string)
	ParentFolder ID батьківської папки (integer)

Результат запиту:

Метод повертає масив:

success	true или false
data	Масив ідентифікаторів створених папок для методу /product/folder/add або масив ідентифікаторів оновлених папок для методу /product/folder/update
error	Код та зміст помилки (вказується, якщо success = false)

Приклад:

Запит:

{
    "array": [
        {
            "Id": 110,
            "Name": "Directory_111",
            "ParentFolder": 100
        },
      ...
    ]
}

Результат:

{
    "success": true,
    "data": [
        {
            "id": 129
        },
        ...
    ]
}

Оновлено: 05/06/2025