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][stockBalance] остаток на складе (если у вас несколько складов, то вместо stockBalance – используйте stockBalanceByStock)
product[i][stockBalanceByStock] остатки по отдельным скаладам, задается в формате {"id склада1":"К-во", "id склада2":"К-во"}. id складов вы можете получить в вашем кабинете SalesDrive в разделе "Установки – Общие настройки и интеграции – Другие сервисы – API".
product[i][barcode] штрихкод
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][name] 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
  • Язык аккаунта:

Регистрируясь, вы соглашаетесь на обработку персональных данных и принимаете условия предоставления услуг.

Оберіть мову / Выберите язык:

Українська Русский