API

API (программный интерфейс приложения, интерфейс прикладного программирования) (англ. application programming interface, API [эй-пи-ай]) — описание способов (набор классов, процедур, функций, структур или констант), которыми одна компьютерная программа может взаимодействовать с другой программой.

1. Получение реквизитов товара по коду - getdata

Адрес запроса:

https://ussrauto.by/getdata?login={ваш логин}&pass={ваш пароль}&code={запрашиваемый код товара}&type={тип}

Параметры:

login - логин для авторизации в сервисной программе;

pass - пароль для авторизации в сервисной программе;

code - код товара из сервисной программы, можно перечислять несколько кодов товара через знак "," или ";", максимальное количество - 100;

type - тип / вид получаемых данных (не обязательно, по умолчанию 0):

0 - реквизиты товара;

1 - цена для текущего клиента;

2 - полный путь к фотографии изделия;

3 - доступный остаток;

4 - полный путь к сертификату;

Результат:

xml-структура

Узел Items, подчиненные узлы item со следующеми переменными:

code – код изделия;

descr – наименование изделия;

reference – артикул;

reference2 – артикул 2;

brand – брэнд;

unit – единица измерения;

fold – кратность;

weight – вес, кг.;

typepack – вид групповой упаковки;

pack – групповая упаковка;

item_img – полный путь к фотографии изделия;

price – цена;

quantitydiscount – признак количественной скидки;

quantity – количество для скидки;

discount – дополнительная скидка на данное количество;

stock – доступный остаток;

2. Получение прайс-листа - getprice

Адрес запроса:

https://ussrauto.by/getprice?login={ваш логин}&pass={ваш пароль}&supplier={код поставщика}&type={тип}&page={номер страницы}

Параметры:

login - логин для авторизации в сервисной программе. Параметр обязательный;

pass - пароль для авторизации в сервисной программе. Параметр обязательный;

supplier - код поставщика товара под заказ, узнать у менеджера. Выведит ТОЛЬКО товары под заказ этого поставщика, без остатков нашего склада. Параметр не обязательный;

type - тип возращаемого объекта (не обязательно, по умолчанию 0):

0 - xml-структура;

1 - csv-файл;

page - номер стрницы (не обязательно). Номера страниц с 1 до ..., на странице 30 000 записей, если не указывать параметр, выводит все записи, но при большом массиве выдает ошибку 500.

Результат:

xml-структура (type = 0 или не указан);

Узел Price со следующими переменными:

date - дата формирования прайс-листа;

clientid - код клиента (login);

Узел Items, подчиненные узлы item со следующеми переменными:

code – код изделия;

descr – наименование изделия;

reference – артикул;

reference2 – артикул 2;

brand – брэнд;

unit – единица измерения;

fold – кратность;

price – цена;

stock – доступный остаток;

keywords – ключевые слова;

csv-файл (type = 1)

3. Поиск товара по Бренду и Артикулу - getgoods

Адрес запроса:

https://ussrauto.by/getgoods?login={ваш логин}&pass={ваш пароль}&brand={бренд}&reference={артикул}&type={тип}

Параметры:

login - логин для авторизации в сервисной программе;

pass - пароль для авторизации в сервисной программе;

brand - Бренд / Марка товара (не обязательно, при указанном reference);

reference - Артикул или Артикул2 (не обязательно, при указанном brand);

type - тип возращаемого объекта (не обязательно, по умолчанию 0):

0 - xml-структура;

1 - csv-файл;

Результат:

xml-структура (type = 0 или не указан);

Узел Items, подчиненные узлы item со следующеми переменными:

code – код изделия;

descr – наименование изделия;

reference – артикул;

reference2 – артикул 2;

brand – брэнд;

unit – единица измерения;

fold – кратность;

price – цена;

stock – доступный остаток;

csv-файл (type = 1)

API-функции доступны только для зарегистрированных пользователей, с включенным параметром "API", который можно проверить в "Мой профиль / Настройки".