Документация для разработчиков

Общие сведения


С целью взаимодействия с нашей информационный системой предлагается получать данные по ценам и другую информацию с помощью программного интерфейса - Web-сервисов.
Преимущества :

  • Данные сервисов можно получать в любой программе;
  • Данные сервисов можно отображать и обрабатывать автоматически (без участия оператора);

Недостатки :

  • Сервисы передают данные в формате XML, что требует некоторого дополнительного программирования для распаковки данных;
  • Соединение с сервисами может представлять некоторую проблему в смысле настроек администратором Вашего предприятия.

# Метод XML - TestConnection


Описание

Метод для тестирования соединения

Входные параметры

Параметр Тип Описание
usr_login String Логин (необязательный)
usr_passwd String Пароль (необязательный)

Пример использования

1. https://souz.kh.ua/api/testconnection - проверка соединения

2. https://souz.kh.ua/api/testconnection?login=user7&pswd=111111 - проверка авторизации


Возвращает

XML ответ следующего вида :
<?xml version="1.0" encoding="utf-8"?> 
1. <string xmlns="https://schemas.microsoft.com/2003/10/Serialization/">Соединение установлено</string>

2. <string xmlns="https://schemas.microsoft.com/2003/10/Serialization/">Авторизация прошла успешно</string>
или <string xmlns="https://schemas.microsoft.com/2003/10/Serialization/">Пользователь не авторизован</string> (если авторизация не прошла)

# Метод XML - CurrencyRate


Описание

Метод для получения курсов валют

Входные параметры

Параметр Тип Описание
Нет параметров

Пример использования

1. https://souz.kh.ua/api/currencyrate - курсы валют

Возвращает

XML ответ следующего вида :
    <?xml version="1.0" encoding="utf-8"?> 
<ArrayOfCurrencyRate xmlns:i="https://www.w3.org/2001/XMLSchema-instance" xmlns="https://schemas.datacontract.org/2004/07/ShopTest.Concrete">
	<CurrencyRate>
		<id>1</id>
		<name>UAH</name>
		<rate>1.000</rate>
	</CurrencyRate>
	<CurrencyRate>
		<id>2</id>
		<name>USD</name>
		<rate>26.900</rate>
	</CurrencyRate>
	<CurrencyRate>
		<id>3</id>
		<name>EUR</name>
		<rate>30.200</rate>
	</CurrencyRate>
	<CurrencyRate>
		<id>4</id>
		<name>RUB</name>
		<rate>0.410</rate>
	</CurrencyRate>
</ArrayOfCurrencyRate>

# Метод XML - FindDetail


Описание

Метод для получения списка запчастей

Входные параметры

Параметр Тип Описание
login String Логин
passwd String Пароль
number String номер для поиска запчасти
brand String бренд производителя (необязательный)
currency String валюта цен(UAH,USD,EUR. Если не указана, то UAH)
analog String флаг поиска по аналогам (если не указан, то true - список с аналогами)

Пример использования

1. https://souz.kh.ua/api/finddetail?login=user7&passwd=111111&number=OC90 - уточняющий запрос, выводит список брендов по номеру поиска

2. https://souz.kh.ua/api/finddetail?login=user7&passwd=111111&number=OC90&brand=KNECHT - список запчастей с аналогами, валюта UAH

3. https://souz.kh.ua/api/finddetail?login=user7&passwd=111111&number=OC90&brand=KNECHT&currency=USD - список с аналогами, валюта USD

4. https://souz.kh.ua/api/finddetail?login=user7&passwd=111111&number=OC90&brand=KNECHT&analog=false - список запчастей без аналогов


Возвращает

XML ответ следующего вида :
    1.<?xml version="1.0" encoding="utf-8"?>  
<ArrayOfProductBrand xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ShopTest.api">
	<ProductBrand>
		<brand>KNECHT</brand>
		<name>Масляный фильтр</name>
		<number>OC90</number>
	</ProductBrand>
	<ProductBrand>
		<brand>MAHLE ORIGINAL</brand>
		<name>Масляный фильтр</name>
		<number>OC90</number>
	</ProductBrand>
	<ProductBrand>
		<brand>JC PREMIUM</brand>
		<name>ФИЛЬТР МАСЛЯНЫЙ</name>
		<number>OC90</number>
	</ProductBrand>
</ArrayOfProductBrand>

    2.<?xml version="1.0" encoding="utf-8"?> 
<ArrayOfProduct xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ShopTest.api">
	<Product>
		<brand>DAEWOO</brand>
		<name>Масляный фильтр</name>
		<number>94797406</number>
		<company>parus-auto.com.ua</company>
		<currency>UAH</currency>
		<delivery>2</delivery>
		<price>46</price>
		<quantity>99</quantity>
	</Product>
	<Product>
		<brand>DAEWOO</brand>
		<name>Масляный фильтр</name>
		<number>94797406</number>
		<company>hw1</company>
		<currency>UAH</currency>
		<delivery>1</delivery>
		<price>52</price>
		<quantity>20</quantity>
	</Product>
..........
</Product>
</ArrayOfProduct>