API продавца — это набор инструментов для управления товарами на платформе "Своё фермерство". Он позволяет создавать, удалять, отключать и изменять товары, что делает его незаменимым для поддержания актуальности и точности информации о товарах на сайте.

С помощью API продавца вы можете добавлять новые товары в каталог, указывая их название, описание, цену, изображения и другие характеристики. Также вы можете редактировать существующие товары, изменяя их информацию или добавляя новые варианты товара.

Если какой-то товар больше не доступен для продажи, вы можете отключить его в каталоге с помощью API продавца. Это поможет избежать путаницы и недовольства клиентов, которые могут пытаться приобрести недоступный товар.

Если вы хотите удалить товар из каталога полностью, вы можете воспользоваться функцией удаления товара в API продавца. Это поможет поддерживать актуальность каталога и избавиться от товаров, которые больше не актуальны или не соответствуют требованиям вашего бизнеса.

В целом, API продавца — это мощный инструмент для управления товарами на платформе "Своё фермерство", который поможет вам поддерживать актуальность и точность информации о товарах, а также эффективно управлять каталогом.

Инструкция по работе с API для создания, изменения и удаления товара

Введение

Данная инструкция описывает, как использовать API для создания, изменения, удаления и получения информации о товарах. Вы можете отправлять запросы для управления товарами на платформе.

Эндпоинты

Создание и изменение товара:

URL: /api-public/v1/product/import Метод: 
POST (для создания товара)

Удаление и отключение товара:

URL: /api-public/v1/product/import/disable Метод: 
POST Описание: Позволяет отключить или удалить товары по их SKU.

Информация о статусе импорта товара:

URL: /api-public/v1/product/import/info Метод: 
POST Описание: Позволяет получить информацию о статусе импорта товара по его идентификатору задачи (task_id).

Тело запроса

Создание и изменение товара:

{
   "items":[
      {
         "sku":"d8f8ed827d0eaa9a3c1e",
         "name":"Трактор МТЗ",
         "price":100,
         "category_id":545,
         "quantity":5,
         "available":false,
         "manufacturer":"МТЗ",
         "special_price":800,
         "delivery":true,
         "pickup":false,
         "sale_location":[
            77,
            23
         ],
         "unit_value":1,
         "unit_measure":"шт",
         "images":[
            "string"
         ],
         "description":"string",
         "attributes":[
            {
               "attribute_code":"vendor_code",
               "values":[
                  {
                     "value":"d8f8ed827"
                  }
               ]
            }
         ]
      }
   ]
} 

Удаление и отключение товара:

{
   "disable":[
      "d8f8ed827d0eaa9a3c1e"
   ],
   "delete":[
      "d8f8ed827d0eaa9a3c1e"
   ]
}

Информация о статусе импорта товара:

{ "task_id": 10201 // Идентификатор задачи импорта }

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

Создание нового товара:

{
   "items":[
      {
         "sku":"d8f8ed827d0eaa9a3c1e",
         "name":"Трактор МТЗ",
         "price":100,
         "category_id":545,
         "quantity":5,
         "available":false,
         "manufacturer":"МТЗ",
         "special_price":800,
         "delivery":true,
         "pickup":false,
         "sale_location":[
            77,
            23
         ],
         "unit_value":1,
         "unit_measure":"шт",
         "images":[
            "string"
         ],
         "description":"string",
         "attributes":[
            {
               "attribute_code":"vendor_code",
               "values":[
                  {
                     "value":"d8f8ed827"
                  }
               ]
            }
         ]
      }
   ]
}

Изменение существующего товара:

{
   "items":[
      {
         "sku":"d8f8ed827d0eaa9a3c1e",
         "name":"Трактор МТЗ Обновленный",
         "price":110,
         "category_id":545,
         "quantity":10,
         "available":true,
         "manufacturer":"МТЗ",
         "special_price":900,
         "delivery":true,
         "pickup":false,
         "sale_location":[
            77,
            23
         ],
         "unit_value":1,
         "unit_measure":"шт",
         "images":[
            "string"
         ],
         "description":"Обновленное описание товара",
         "attributes":[
            {
               "attribute_code":"vendor_code",
               "values":[
                  {
                     "value":"d8f8ed827"
                  }
               ]
            }
         ]
      }
   ]
}

Отключение или удаление товара:

{
   "disable":[
      "d8f8ed827d0eaa9a3c1e"
   ],
   "delete":[
      "d8f8ed827d0eaa9a3c1e"
   ]
}

Получение информации о статусе импорта товара:

{ "task_id": 10201 }

Обработка ошибок

При работе с API могут возникать различные ошибки. Убедитесь, что вы обрабатываете следующие коды состояния HTTP:

• 200 OK: Запрос выполнен успешно.
• 201 Created: Товар успешно создан.
• 204 No Content: Операция выполнена успешно (например, товар отключен или удален).
• 400 Bad Request: Ошибка в запросе (например, неверные данные).
• 404 Not Found: Товар не найден (например, неверный SKU).
• 500 Internal Server Error: Ошибка на стороне сервера.

Заключение

Эта инструкция поможет вам эффективно использовать API для создания, изменения, удаления и получения статуса товаров. Убедитесь, что вы следуете всем рекомендациям и требованиям для успешной интеграции. Если у вас возникнут вопросы, обратитесь в техническую поддержку API.