API
    (от англ. application programming interface) или Интерфейс программирования приложений — это набор готовых классов, процедур, функций, структур и констант, предоставляемых приложением, библиотекой или сервисом для использования во внешних программных продуктах. API используется для подключения разных программных приложений друг к другу.
    
API ROSSKO предоставляет две основные функции:
    1. Поиск и подбор товаров по кроссам
    Ваш интернет-магазин или торговая программа могут в реальном времени обращаться к нашему сервису и получать актуальную информацию об остатках и стоимости для определенных товарных групп. Если же искомого товара нет в наличии, то ваш интернет-магазин может запросить у нашего сервиса кроссы к нему.
    2. Оформление и актуализация данных о заказе
    Ваш интернет-магазин или другое программное обеспечение могут по созданным вами настройкам самостоятельно оформлять в нашем интернет-магазине заказы. После того как заказы оформлены, вы можете через свой программный продукт автоматизировано отслеживать их статус.
Преимущества использования API:
    - 
        Нет необходимости ежедневно скачивать обновленный прайс-лист ROSSKO,
    
- 100% достоверность информации об остатках и ценах,
- 
        Нет необходимости вручную вводить номера товаров в поисковую строку интернет-магазина ROSSKO,
    
- 
        Нет необходимости вручную оформлять и отслеживать актуальный статус заказа.
    
    Для подключения к API вы должны являться клиентом Росско и быть зарегистрированы на портале. Получить ключи можно в своем личном кабинете.
    Если у вас все еще есть вопросы по работе API, покажите этот текст своему программисту или обратитесь в службу поддержки ROSSKO. 
1. Сервис «GetSearch»
http://kuban.rossko.ru/service/v1/GetSearch?wsdl
Сервис, позволяющий искать товары по названию (можно использовать одно или несколько слов, разделенных пробелами), номеру или GUID товара.
Входные параметры:
    
        | Имя | Тип | Обязательный | Описание | Примечание | 
    
        | KEY1 | Строка | Да | Первый секретный ключ | 
 | 
    
        | KEY2 | Строка | Да | Второй секретный ключ | 
 | 
    
        | TEXT | Строка | Да | Значение для поиска (название, номер, GUID) товара | Пример значений: масло, свечи зажигания, 333114, NSIN0019620397 | 
Выходные параметры (элемент SearchResult):
    
        | Имя | Тип | Описание | Примечание | 
    
        | Success | Булевое значение | Результат запроса | true/false | 
    
        | Text | Строка | Значение для поиска (название, номер, GUID) товара | Пример значений: масло, свечи зажигания, 333114, NSIN0019620397 | 
    
        | Message | Строка | Сообщение об ошибке. | Выводится, когда возникает ошибка. Пример значения: Вы не ввели логин и/или пароль!
 | 
    
        | PartsList | Список объектов (элемент Part) | Список найденных товаров | 
 | 
Элемент Part:
    
        | Имя | Тип | Описание | 
    
        | GUID | Строка | Уникальный идентификатор товара | 
    
        | Brand | Строка | Наименование производителя товара | 
    
        | PartNumber | Строка | Код товара (присвоенный производителем) | 
    
        | Name | Строка | Наименование товара | 
    
        | StocksList | Список объектов (элемент Stock) | Список складов, если товар есть на складе | 
    
        | CrossesList | Список объектов (элемент Part) | Список кроссов | 
Элемент Stock:
    
        | Имя | Тип | Описание | 
    
        | StockID | Строка | Уникальный идентификатор склада | 
    
        | Price | Число | Цена товара | 
    
        | Count | Число | Остаток товара на складе | 
    
        | DeliveryTime | Число | Время доставки со склада в днях | 
Принцип работы:
- 
    Находим товары для заданного значения поиска. В случае, если товар не найден или произошла какая-то ошибка, элемент «Success» будет «false», если найдено, то «Success» будет «true»;
- 
    Если товар не найден, то элемент PartsList отсутствует;
- 
    Для найденного товара выводим информацию по нему в секции PartsList → Part;
- 
    Для найденного товара остатки на складах будут отажены в секции StocksList → Stock;
- 
    Для найденного товара выводим информацию о кроссах в секции CrossesList → Part;
2. Сервис «GetCheckoutDetails»
http://kuban.rossko.ru/service/v1/GetCheckoutDetails?wsdl
Позволяет показать способы доставки и оплаты, адреса доставки, реквизитов при оформлении заказа.
Входные параметры:
    
        | Имя | Тип | Обязательный | Описание | Примечание | 
    
        | KEY1 | Строка | Да | Первый секретный ключ | 
 | 
    
        | KEY2 | Строка | Да | Второй секретный ключ | 
 | 
Выходные параметры (элемент SearchResult):
    
        | Имя | Тип | Описание | Примечание | 
    
        | Success | Булевое значение | Результат запроса | true/false | 
    
        | Message | Строка | Сообщение об ошибке | Выводится, когда возникает ошибка. Пример значения: Вы не ввели логин и/или пароль!
 | 
    
        | TypeDelivery | Список объектов (элемент Delivery) | Способ доставки | 
 | 
    
        | TypePayment | Список объектов (элемент Payment) | Способ оплаты | 
 | 
    
        | AddressDelivery | Список объектов (элемент Address) | Адрес доставки | 
 | 
    
        | CompanyList | Список объектов (элемент Company) | Реквизит | 
 | 
Элемент Delivery:
    
        | Имя | Тип | Описание | 
    
        | ID | Число | Уникальный идентификатор способа доставки | 
    
        | Name | Строка | Наименование способа доставки | 
    
        | WarehouseList | Список объектов (элемент Warehouse) | Склады | 
Элемент Warehouse:
    
        | Имя | Тип | Описание | 
    
        | ID | Число | Уникальный идентификатор склада | 
    
        | Name | Строка | Наименование склада | 
Элемент Payment:
    
        | Имя | Тип | Описание | 
    
        | ID | Число | Уникальный идентификатор способа оплаты | 
    
        | Name | Строка | Наименование способа оплаты | 
Элемент Address:
    
        | Имя | Тип | Описание | 
    
        | City | Строка | Город | 
    
        | Street | Строка | Улица | 
    
        | Dom | Строка | Дом | 
    
        | Office | Строка | Офис | 
    
        | Name | Строка | Наименование склада | 
Элемент Company:
    
        | Имя | Тип | Описание | 
    
        | Name | Строка | Наименование организации | 
    
        | Requisites | Строка | Реквизиты организации | 
3. Сервис «GetCheckout»
http://kuban.rossko.ru/service/v1/GetCheckout?wsdl
Оформление заказа.
Входные параметры:
    
        | Имя | Тип | Обязательный | Описание | Примечание | 
    
        | KEY1 | Строка | Да | Первый секретный ключ | 
 | 
    
        | KEY2 | Строка | Да | Второй секретный ключ | 
 | 
    
        | COMMENT | Строка | Нет | Комментарий | 
 | 
    
        | TYPE_DELIVERY | Список объектов (элемент Delivery) | Да | Способ доставки | 
 | 
    
        | TYPE_PAYMENT | Список объектов (элемент Payment) | Да | Способ оплаты | 
 | 
    
        | CONTACT_DETAILS | Список объектов (элемент Contact) | Да | Контактные данные | 
 | 
    
        | DELIVERY_PARTS | Булевое значение | Да | Доставка по частям | true/false | 
    
        | PARTS | Список объектов (элемент Part) | Да | Список товаров | 
 | 
Элемент Delivery:
    
        | Имя | Тип | Обязательный | Описание | Примечание | 
    
        | DeliveryID | Число | Да | Уникальный идентификатор способа доставки | 
 | 
    
        | DeliveryAddress | Список объекта (элемент Address) | Нет | Адрес доставки | 
 | 
Элемент Address:
    
        | Имя | Тип | Обязательный | Описание | Примечание | 
    
        | City | Строка | Да | Город | 
 | 
    
        | Street | Строка | Да | Улица | 
 | 
    
        | Dom | Строка | Нет | Дом | 
 | 
    
        | Office | Строка | Нет | Офис | 
 | 
Элемент Payment:
    
        | Имя | Тип | Обязательный | Описание | Примечание | 
    
        | PaymentID | Число | Да | Уникальный идентификатор способа оплаты | 
 | 
    
        | CompanyName | Строка | Нет | Наименование организации | 
 | 
    
        | CompanyRekvizity | Строка | Нет | Реквизиты организации | 
 | 
Элемент Contact:
    
        | Имя | Тип | Обязательный | Описание | Примечание | 
    
        | Name | Строка | Да | Контактное лицо | 
 | 
    
        | Phone | Строка | Да | Телефон | 
 | 
    
        | Office | Строка | Нет | Офис | 
 | 
Элемент Part:
    
        | Имя | Тип | Обязательный | Описание | Примечание | 
    
        | PART_NUMBER | Число | Да | Код товара (присвоенный производителем) | 
 | 
    
        | BRAND | Строка | Да | Наименование производителя товара | 
 | 
    
        | COUNT | Строка | Да | Нужное количество товара | 
 | 
Выходные параметры (элемент SearchResult):
    
        | Имя | Тип | Описание | Примечание | 
    
        | Success | Булевое значение | Результат запроса | true/false | 
    
        | Message | Строка | Сообщение об ошибке | Выводится, когда возникает ошибка. Пример значения: Вы не ввели логин и/или пароль!
 | 
    
        | OrderID | Число | Уникальный идентификатор заказа | 
 | 
    
        | ItemsList | Список объектов (элемент Item) | Список заказанных товаров | 
 | 
    
        | ItemsErrorList | Список объектов (элемент ItemError) | Список не l;заказанных товаров | 
 | 
Элемент Item:
    
        | Имя | Тип | Описание | Примечание | 
    
        | PART_NUMBER | Строка | Код товара (присвоенный производителем) | Если на складе нет нужного количества товара, то будет заказ остаток. | 
    
        | BRAND | Строка | Наименование производителя товара | 
 | 
    
        | COUNT | Число | Количество товара | 
 | 
    
        | DELIVERY_TIME | Число | Время доставки со склада в днях. | 
 | 
Элемент ItemError:
    
        | Имя | Тип | Описание | 
    
        | PART_NUMBER | Строка | Код товара (присвоенный производителем) | 
    
        | BRAND | Строка | Наименование производителя товара | 
    
        | COUNT | Число | Количество товара | 
    
        | MESSAGE | Строка | Сообщение по какой причине этот товар не был заказан. | 
4. Сервис «GetOrders»
http://kuban.rossko.ru/service/v1/GetOrders?wsdl
Список заказов и статус по ним.
Входные параметры:
    
        | Имя | Тип | Обязательный | Описание | Примечание | 
    
        | KEY1 | Строка | Да | Первый секретный ключ | 
 | 
    
        | KEY2 | Строка | Да | Второй секретный ключ | 
 | 
    
        | ORDER_IDS | Список объектов (элемент OrderId) | Нет | Список идентификаторов заказов | 
 | 
    
        | OFFSET | Число | Нет | Смещение | 
 | 
Выходные параметры (элемент SearchResult):
    
        | Имя | Тип | Описание | Примечание | 
    
        | Success | Булевое значение | Результат запроса | true/false | 
    
        | Message | Строка | Сообщение об ошибке. | Выводится, когда возникает ошибка. Пример значения: Вы не ввели логин и/или пароль!
 | 
    
        | OrdersList | Список объектов (элемент Order) | Список заказов | 
 | 
    
        | Total | Число | Количество всего заказов | 
 | 
Элемент Order:
    
        | Имя | Тип | Описание | 
    
        | ID | Число | Уникальный идентификатор заказа | 
    
        | DateCreated | Строка | Дата заказа | 
    
        | DateDelivery | Строка | Дата доставки | 
    
        | Details | Список объектов (элемент Detail) | Детали заказа (способ оплаты и доставки, адрес доставки, реквизиты, комментарий) | 
    
        | Sum | Строка | Сумма заказа | 
    
        | StatusPayment | Строка | Статус заказа | 
    
        | Parts | Список объектов (элемент Part) | Список товаров в заказе | 
Элемент Detail:
    
        | Имя | Тип | Описание | 
    
        | TypeDelivery | Строка | Способ доставки | 
    
        | DeliveryAddress | Строка | Адрес доставки | 
    
        | TypePayment | Строка | Тип оплаты | 
    
        | CompanyName | Строка | Наименование организации | 
    
        | CompanyRekvizity | Строка | Реквизиты организации | 
    
        | Comment | Строка | Комментарий | 
Элемент Part:
    
        | Имя | Тип | Описание | 
    
        | GUID | Строка | Уникальный идентификатор товара | 
    
        | PartNumber | Строка | Код товара (присвоенный производителем) | 
    
        | Name | Строка | Наименование товара | 
    
        | Brand | Строка | Наименование производителя товара | 
    
        | Price | Строка | Цена | 
    
        | Count | Число | Количество | 
    
        | DeliveryTime | Число | Время доставки со склада в днях | 
    
        | Processing1C | Список объектов (элемент DetailProcessing) | Статус товара | 
Элемент DetailProcessing:
    
        | Имя | Тип | Описание | 
    
        | Confirmed | Строка | Подтвеждено товаров | 
    
        | DeliveryTime | Строка | Время доставки со склада в днях | 
    
        | Supplied | Строка | Отгружено | 
    
        | Collected | Строка | Отменено | 
    
        | Shipped | Строка | Отправлено | 
    
        | Sum | Строка | Сумма |