Интеграция с другими системами

Внимание! Данный способ интеграции устарел, и будет удален в последующих релизах системы!

Для интеграции сервиса ShopManager.by с другими системами предусмотрено два метода API:

• Экспорт категорий
• Экспорт продуктов

При необходимости расширенного набора данных для интеграции с вашей системой обратитесь в Службу поддержки.

Ссылки на API методы можно найти на странице Профиль - Магазин.
Дополнительно на данной странице вы можете сгенерировать новый API ключ, при этом использование ссылок с ранее сгенерированным ключом будет невозможно!

Экспорт категорий

Для получения списка категории и количества позиций (предложений) для каждой категории используется метод

https://my.shopmanager.by/d/api/categories.json?shopId=XXX&key=YYY

XXX - ID вашего магазина
YYY - API ключ

Тип данных в ответе: application/json

Пример ответа:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
  "categories":[
    {
      "categoryId": 135,
      "categoryName": "Варочные панели",
      "productsCount": 13
    },
    {
      "categoryId": 2,
      "categoryName": "Мобильные телефоны",
      "productsCount": 2
    }
  ]
}

Экспорт продуктов

Для получения списка всех товаров из Сводного прайс-листа и прайс-листов используется метод

https://my.shopmanager.by/d/api/products.json?shopId=XXX&key=YYY

XXX - ID вашего магазина
YYY - API ключ

Тип данных в ответе: application/json

Пример ответа:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

{
  "products":[
    {
      "priceId":33258,
      "brand":"bosch",
      "categoryName": "Варочные панели",
      "onlinerName":"Bosch PIA611F18E",
      "onlinerUrl":"/hob_cooker/bosch/pia611f18e",
      "inStock":true,
      "stock": 1,
      "lastUpdateDate":"2018-05-10T20:56:06Z",
      "price":892.20
    }, 
    [...]
  ],
  "prices":[
    {
      "id":33258,
      "priceConfigId":29241,
      "fileName":"Триовист-цены.xls",
      "priceConfigName":"Триовист"
    },
    [...]
  ]
}

Для получения одного товара из Сводного прайс-листа используется метод

https://my.shopmanager.by/d/api/product.json/ID?shopId=XXX&key=YYY

ID - ID вашего товара
XXX - ID вашего магазина
YYY - API ключ

Тип данных в ответе: application/json

Пример ответа:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
  "productId": 123,
  "priceId": 33258,
  "stockValue": "1",
  "inStock": false,
  "stock": 0,
  "lastUpdateDate": "2020-11-11T19:14:53Z",
  "price": 28.47,
  "optPrice": 22.7788,
  "extraPrices": [
    {
      "priceId": 33259,
      "inStock": false,
      "price": 45.34,
      "optPrice": 36.27
    },
    {
      "priceId": 33212,
      "inStock": false,
      "price": 30.13,
      "optPrice": 24.102
    }
  ]
}

Значения, которые принимает параметр stock: 0 - под заказ, 1 - В наличии, 2 - нет в наличии, 3 - не определен;

Если вам нужно в ответе получать не только текущую розничную цену и выбранного поставщика,
но также цены на товар от остальных поставщиков (если товар продается сразу у нескольких поставщиков)
вы можете добавить у URL параметр &extraPrices=true - чтобы получить список всех поставщиков и их цены на товар