API: Додавання, оновлення, видалення товарів і категорій

Для отримання ключа форми - у вашому кабінеті SalesDrive перейдіть:

Приклад на PHP:

Опис API

Додавання і оновлення товарів

Одним запитом ви можете додати/оновити одразу декілька товарів. В одному запиті можна додавати/оновлювати не більше 100 товарів.

POST https://yourdomain.salesdrive.me/product-handler/

Content-Type: application/json

{
     "form": "ваш ключ форми",
     "action": "update",
     "dontUpdateFields": [],
     "product": [
         {
             "id": "",
             "name": "",
             "nameForDocuments": "",
             "costPerItem": "",
             "sku": "",
             "manufacturer": "",
             "currency": "",
             "discount": {
                 "value": "",
                 "date_start": "",
                 "date_end": ""
             },
             "weight": "",
             "volume": "",
             "length": "",
             "width": "",
             "height": "",
             "barcode": "",
             "stockBalance": "",
             "stockBalanceByStock": {
                 "": "",
                 "": ""
             },
             "expenses": "",
             "currencyExpenses": "",
             "category": {
                 "id": "",
                 "name": ""
             },
             "description": "",
             "url": "",
             "note": "",
             "supplier": "",
             "keywords": "",
             "parentProductId": "",
             "images": [
                 {
                     "fullsize": "",
                     "thumbnail": ""
                 },
                 {
                     "fullsize": "",
                     "thumbnail": ""
                 }
             ],
             "params": [
                 {
                     "name": "",
                     "type": "",
                     "value": ""
                 },
                 {
                     "name": "",
                     "type": "",
                     "value": ""
                 }
             ],
             "additionalPrices": [
                 {
                     "priceType": "",
                     "priceValue": "",
                     "priceCurrency": "",
                     "priceDiscount": ""
                 },
                 {
                     "priceType": "",
                     "priceValue": "",
                     "priceCurrency": "",
                     "priceDiscount": ""
                 }
             ]
         }
     ]
 }

 

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

dontUpdateFields не оновлювати ціну чи назву для існуючих товарів. Можливі елементи масиву: "price", "name"
product[i][id] id товару
product[i][name] назва товару
product[i][nameForDocuments] назва для документів
product[i][costPerItem] ціна
product[i][sku] SKU
product[i][manufacturer] виробник
product[i][currency] валюта (приклад: USD)
product[i][discount][value] значення знижки (можна вказувати в % або в абсолютному значенні)
product[i][discount][date_start] дата початку дії знижки (формат дати: ДД.ММ.РРРР)
product[i][discount][date_end] дата закінчення дії знижки (формат дати: ДД.ММ.РРРР)
product[i][weight] вага, кг
product[i][volume] об'єм, м3
product[i][length] довжина, см
product[i][width] ширина, см
product[i][height] висота, см
product[i][barcode] штрихкод
product[i][stockBalance] залишок на складі (якщо у вас декілька складів, то замість stockBalance - використовуйте stockBalanceByStock)
product[i][stockBalanceByStock] залишки по окремих скаладах, задається у форматі {"id складу1":"К-ть", "id складу2":"К-ть"}. id складів ви можете отримати у вашому кабінеті SalesDrive в розділі "Установки - Загальні налаштування і інтеграції - Інші сервіси - API".
product[i][expenses] собівартість
product[i][currencyExpenses] валюта собівартості (приклад: USD)
product[i][category][id] id категорії товару
product[i][category][name] назва категорії товару
product[i][description] опис товару
product[i][url] сторінка на сайті
product[i][note] нотатка
product[i][supplier] постачальник
product[i][keywords] ключові слова (через кому)
product[i][parentProductId] id головного товару групи різновидів
product[i][images] масив url фотографій товару
product[i][images][j][fullsize] url великого зображення
product[i][images][j][thumbnail] url зменшеного зображення
product[i][params] масив характеристик товару
product[i][params][j][name] назва характеристики
product[i][params][j][type] тип характеристики: select, multiselect, number або text
product[i][params][j][value] значення характеристики
product[i][additionalPrices] масив додаткових цін товару
product[i][additionalPrices][j][priceType] назва (тип) додаткової ціни
product[i][additionalPrices][j][priceValue] додаткова ціна
product[i][additionalPrices][j][priceCurrency] валюта додаткової ціни
product[i][additionalPrices][j][priceDiscount] знижка додаткової ціни

 

Видалення товарів

Одним запитом ви можете видалити одразу декілька товарів. В одному запиті можна видаляти не більше 100 товарів.

POST https://yourdomain.salesdrive.me/product-handler/

Content-Type: application/json

{
    "form": "ваш ключ форми",
    "action": "delete",
    "product": [
        {
            "id": ""
        }
    ]
}

 

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

product[i][id] id товару

 

Додавання/оновлення категорій

В одному запиті ви можете додати/оновити декілька категорій.

POST https://yourdomain.salesdrive.me/category-handler/

Content-Type: application/json

{
    "form": "ваш ключ форми",
    "action": "update",
    "category": [
        {
            "id": "",
            "name": "",
            "parentId": ""
        }
    ]
}

 

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

category[i][id] id категорії
category[i][id] назва категорії
category[i][parentId] id батьківської категорія

 

Видалення категорій

В одному запиті ви можете видалити декілька категорій.

POST https://yourdomain.salesdrive.me/category-handler/

Content-Type: application/json

{
    "form": "ваш ключ форми",
    "action": "delete",
    "category": [
        {
            "id": "",
            "name": "",
            "parentId": ""
        }
    ]
}

 

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

category[i][id] id категорії

Реєстрація в SalesDrive

.salesdrive.me

Реєструючись, ви погоджуєтеся на обробку персональних даних і приймаєте умови публічного договору (оферти).