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

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

Этот раздел представляет интерес для оптовиков, но будет полезен и для других пользователей системы.

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

Преимущества :

• Данные сервисов можно получать в любой программе, а не только в IE;
• Данные сервисов можно отображать и обрабатывать автоматически (без участия оператора);
• Сервисы работают значительно быстрее, чем страницы IE, так как по сети пересылаются только данные( но не элементы оформления);
• За счет использования протоколов SOAP соединение по сервисам обладает большой надежностью. При использовании WDDX / XML соединение происходит максимально быстро.

Недостатки :

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

# Метод XML - TestConnect

Описание

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

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<TestConnect>
    <TestString>TEST-String</TestString>
</TestConnect>

# Метод XML - GetPrice

Описание

Метод для проценки деталей по номеру (без кроcса)

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GetPrice>
    <Detail>
        <Brand>DENSO</Brand>
        <Number>IK16</Number>
        <Name>Свеча зажигания</Name>
        <Price>10.37</Price>
        <Currency>USD</Currency>
        <Quantity>80</Quantity>
        <SupplierCode>KILO</SupplierCode>
        <Weight>0.461</Weight>
        <DeliveryType>LOCAL</DeliveryType>
        <DeliveryTime>1</DeliveryTime>
        <DamagedFlag>N</DamagedFlag>
        <UsedFlag>N</UsedFlag>
        <RestoredFlag>N</RestoredFlag>
    </Detail>
    <Detail>
    ...
    </Detail>
</GetPrice>

# Метод XML - GetPriceWithCrosses

Описание

Метод проценки деталей с кроссами
Этот метод работает в два шага:

1. По заданному номеру уточняется производитель
2. Когда номер и производитель известен – производится поиск кроссов и прайсов.
Обычно метод вызывается для первого шага, а потом для второго. Однако в некоторых случаях первый шаг пропускается, и сразу выдается результат второго шага. Например, при поиске номера ААА обнаруживается, что его производит один производитель, тогда нет смысла уточнять производителя на 1-м шаге и можно сразу перейти на второй.

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

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

Возвращает

XML ответ следующего вида :

Шаг 1 - Выбор производителя

<?xml version="1.0" encoding="utf-8"?>
<PriceResult>
    <QueryStatus>
        <QueryStatusCode>1</QueryStatusCode>
        <QueryStatusDescription>Номер найден. Необходимо уточнить бренд</QueryStatusDescription>
    </QueryStatus>
    <InputData>
        <PartNumber>9091901235</PartNumber>
        <BrandId>0</BrandId>
        <GroupBrands>0</GroupBrands>
        <Currency>0</Currency>
    </InputData>
    <Producers>
        <Producer>
            <BrandId>579</BrandId>
            <Brand>TOYOTA</Brand>
            <PartDescriptionRus>Свеча зажигания</PartDescriptionRus>
        </Producer>
        <Producer>
            <BrandId>874</BrandId>
            <Brand>LEXUS</Brand>
            <PartDescriptionRus>Свеча зажигания</PartDescriptionRus>
        </Producer>
    </Producers>
    <Prices/>
</PriceResult>

Шаг 2 - Получение результатов по производителю и номеру

<?xml version="1.0" encoding="utf-8"?>
<PriceResult>
    <QueryStatus>
        <QueryStatusCode>0</QueryStatusCode>
        <QueryStatusDescription>Результат с ценами выдан (может быть пуст)</QueryStatusDescription>
    </QueryStatus>
    <InputData>
        <PartNumber>9091901235</PartNumber>
        <BrandId>579</BrandId>
        <GroupBrands>0</GroupBrands>
        <Currency>0</Currency>
    </InputData>
    <Producers/>
    <Prices>
        <Price>
            <PartId>12370318864</PartId>
            <BrandId>579</BrandId>
            <Brand>TOYOTA</Brand>
            <PartNumber>90919-01235</PartNumber>
            <PartNumberShort>9091901235</PartNumberShort>
            <PartDescriptionRus>Свеча зажигания</PartDescriptionRus>
            <Price>2.91</Price>
            <Currency>USD</Currency>
            <Quantity>108</Quantity>
            <QuantityType>EQUAL</QuantityType>
            <PriceLogo>STOK</PriceLogo>
            <Weight>0.054</Weight>
            <PriceDescrShort>Наличие Техномир</PriceDescrShort>
            <PriceDescrLong>Наличие Техномир</PriceDescrLong>
            <DeliveryType>LOCAL</DeliveryType>
            <DeliveryDays>0</DeliveryDays>
            <DeliveryPercent>96.9</DeliveryPercent>
            <PriceChangeDate>2014-10-09 17:54:02</PriceChangeDate>
            <DamagedFlag>N</DamagedFlag>
            <UsedFlag>N</UsedFlag>
            <OriginalFlag>Y</OriginalFlag>
            <OldPartNumberFlag>N</OldPartNumberFlag>
            <ReturnFlag>Y</ReturnFlag>
            <PriceFinalFlag>Y</PriceFinalFlag>
            <Group>0</Group><GroupDescr/>
        </Price>
        <Price></Price>
    </Prices>
</PriceResult>

# Метод XML - GetDetailInfo_ByDetailNum

Описание

Метод для получения движения деталей

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GetDetailInfo_ByDetailNum>
    <Detail>
        <GlobalId>2794173</GlobalId>
        <ClientsId>0</ClientsId>
        <Brand>MITSUBISHI</Brand>
        <Number>3815A323</Number>
        <NumberPrinted>3815A323</NumberPrinted>
        <NewNumber/>
        <Name>Пыльник вала передней полуоси</Name>
        <Quantity>1</Quantity>
        <Price>36.27</Price>
        <Currency>USD</Currency>
        <StateId>12</StateId>
        <StateName>Выдано</StateName>
        <SupplierCode>PRS</SupplierCode>
        <SupplierDeliveryType>STOK</SupplierDeliveryType>
        <StateChangedDate>2014-06-12T22:17:47+03:00</StateChangedDate>
        <ClientComment></ClientComment>
        <AdminComment/>
        <OrderNum>878159</OrderNum>
        <ClientsOrderNum>0</ClientsOrderNum>
    </Detail>
</GetDetailInfo_ByDetailNum>

Возможные состояния позиций :

# Метод XML - GetCurrencies

Описание

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

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GetCurrencies>
    <Currencies>
        <Currency>
            <Code>USD</Code>
            <Coef>20.00</Coef>
        </Currency>
        <Currency>
            <Code>EUR</Code>
            <Coef>30.00</Coef>
        </Currency>
    </Currencies>
</GetCurrencies>

# Метод XML - GetProducers

Описание

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

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GetProducers>
    <Producers>
        <Producer>
            <Id>1</Id>
            <Name>SPIDAN</Name>
        </Producer>
        <Producer>
            <Id>2</Id>
            <Name>HELLA</Name>
        </Producer>
        <Producer>
            <Id>3</Id>
            <Name>ATE</Name>
        </Producer>
    </Producers>
</GetProducers>

# Метод XML - GetSuppliers

Описание

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

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GetSuppliers>
    <Suppliers>
        <Supplier>
            <Code>GLIR</Code>
            <DeliveryType>LOCAL</DeliveryType>
            <DeliveryTime>17</DeliveryTime>
            <Region>Германия</Region>
            <Description>Европейский поставщик запчастей</Description>
            <ReturnFlag>Y</ReturnFlag>
            <PriceFinalFlag>Y</PriceFinalFlag>
        </Supplier>
        <Supplier>
            <Code>STOK</Code>
            <DeliveryType>LOCAL</DeliveryType>
            <DeliveryTime>0</DeliveryTime>
            <Region>Одесса</Region>
            <Description>Наличие Техномир</Description>
            <ReturnFlag>Y</ReturnFlag>
            <PriceFinalFlag>N</PriceFinalFlag>
        </Supplier>
        <Supplier>
            <Code>AERF</Code>
            <DeliveryType>AIR</DeliveryType>
            <DeliveryTime>12</DeliveryTime>
            <Region>Эмираты</Region>
            <Description>Эмираты авиа</Description>
            <ReturnFlag>N</ReturnFlag>
            <PriceFinalFlag>Y</PriceFinalFlag>
        </Supplier>
    </Suppliers>
</GetSuppliers>

# Метод XML - GetBoxesReadyToSend

Описание

Метод для получения коробок, готовых к отгрузке

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GetBoxesReadyToSend>
    <QueryStatus>
        <QueryStatusCode>0</QueryStatusCode>
        <QueryStatusDescription></QueryStatusDescription>
    </QueryStatus>
    <Boxes>
        <Box>
            <BoxId>489667</BoxId>
            <BoxDate>2014-09-16 19:47:05</BoxDate>
            <BoxPartsSum>135.41</BoxPartsSum>
            <BoxWorksSum>6.37</BoxWorksSum>
            <BoxWeight>0.980</BoxWeight>
            <BoxLength>0</BoxLength>
            <BoxWidth>0</BoxWidth>
            <BoxHeight>0</BoxHeight>
        </Box>
        <Box>
            <BoxId>487233</BoxId>
            <BoxDate>2014-09-10 20:54:38</BoxDate>
            <BoxPartsSum>37.28</BoxPartsSum>
            <BoxWorksSum>1.30</BoxWorksSum>
            <BoxWeight>0.200</BoxWeight>
            <BoxLength>0</BoxLength>
            <BoxWidth>0</BoxWidth>
            <BoxHeight>0</BoxHeight>
        </Box>
        <Box>
            <BoxId>480348</BoxId>
            <BoxDate>2014-08-27 21:28:56</BoxDate>
            <BoxPartsSum>2.45</BoxPartsSum>
            <BoxWorksSum>0.78</BoxWorksSum>
            <BoxWeight>0.120</BoxWeight>
            <BoxLength>0</BoxLength>
            <BoxWidth>0</BoxWidth>
            <BoxHeight>0</BoxHeight>
        </Box>
    </Boxes>
</GetBoxesReadyToSend>

# Метод XML - GetBoxDetails

Описание

Метод для просмотра содержимого коробки

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GetBoxDetails>
    <BoxId>489667</BoxId>
    <BoxDate>2014-09-16 19:47:05</BoxDate>
    <BoxPartsSum>135.41</BoxPartsSum>
    <BoxWorksSum>6.37</BoxWorksSum>
    <BoxWeight>0.980</BoxWeight>
    <BoxLength>0</BoxLength>
    <BoxWidth>0</BoxWidth>
    <BoxHeight>0</BoxHeight>
    <Positions>
        <Position>
            <BrandId>1142</BrandId>
            <Brand>KAWASAKI</Brand>
            <Number>39058000818R</Number>
            <Quantity>1</Quantity>
            <Name></Name>
            <Reference>Yarik</Reference>
            <StickerReference></StickerReference>
            <Sticker>+00012977494/1</Sticker>
        </Position>
        <Position>
            <BrandId>1142</BrandId>
            <Brand>KAWASAKI</Brand>
            <Number>35063038618R</Number>
            <Quantity>1</Quantity>
            <Name></Name>
            <Reference>Yarik</Reference>
            <StickerReference></StickerReference>
            <Sticker>+00012977493/1</Sticker>
        </Position>
    </Positions>
</GetBoxDetails>

# Метод XML - BasketList

Описание

Метод для просмотра содержимого корзины

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<BasketList>
    <PositionsCount>2</PositionsCount>
    <PositionsSum>2.48</PositionsSum>
    <Positions>
        <Position>
            <BasId>2544074</BasId>
            <SupCode>STOK</SupCode>
            <ProdId>579</ProdId>
            <ProdName>TOYOTA</ProdName>
            <Code>90915YZZD2</Code>
            <Qty>5</Qty>
            <Price>0.00</Price>
            <Currency>USD</Currency>
            <Comment>Комментарий</Comment>
            <Reference>12333211</Reference>
        </Position>
        <Position>
            <BasId>2544076</BasId>
            <SupCode>AERF</SupCode>
            <ProdId>579</ProdId>
            <ProdName>TOYOTA</ProdName>
            <Code>9091901235</Code>
            <Qty>1</Qty>
            <Price>2.48</Price>
            <Currency>USD</Currency>
            <Comment>Комментарий</Comment>
            <Reference>100022341</Reference>
        </Position>
    </Positions>
</BasketList>

# Метод XML - BasketClear

Описание

Метод для очистки корзины

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<BasketClear/>

# Метод XML - BasketDeletePos

Описание

Метод для удаления позиции с корзины

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<BasketDeletePos>
    <BasId>2544074</BasId>
</BasketDeletePos>

# Метод XML - BasketAddPos

Описание

Метод для добавления позиции в корзину

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<BasketAddPos>
    <Status>
        <Code>100</Code>
        <Msg>Позиция добавлена</Msg>
    </Status>
</BasketAddPos>

Коды статусов :

100 - Позиция добавлена
200 - Не передано производителя
201 - Невозможно найти производителя. Плохой параметр ProdId
202 - Невозможно найти производителя. Плохой параметр ProdStr
203 - Не передано поставщика
204 - Невозможно найти пост. Плохой параметр SupCode
205 - Не передано Qty или неверное значение (мин = 1, макс = 200)
206 - Не передан код детали (> 1 сим, только из 0-9 и A-Z)

# Метод XML - BasketMakeOrder

Описание

Метод для оформления заказа с корзины

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<BasketMakeOrder>
    <Status>
        <Code>100</Code>
        <Msg>Заказ принят</Msg>
    </Status>
    <OrderId>932850</OrderId>
    <OrderStatus>ACTIVE</OrderStatus>
</BasketMakeOrder>

Коды состояния :

100 - Заказ принят
200 - Нет позиций в корзине


Статус заказа :

ACTIVE - активный
HOLD - отложенный

# Метод XML - GetStokPrice

Описание

Метод для оформления заказа с корзины

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GetStokPrice>
    <Status>
        <Code>200</Code>
        <Msg>Прайс получен</Msg>
    </Status>
    <Positions>
        <Position>
            <Producer>SPIDAN</Producer>
            <Code>20347</Code>
            <Description>Пыльник шруса</Description>
            <Qty>4</Qty>
            <Price>7.02</Price>
            <Currency>USD</Currency>
            <CodePrinted>20347</CodePrinted>
            <PriceForRemote>7.89</PriceForRemote>
        </Position>
    </Positions>
    <OrderStatus> </OrderStatus>
</GetStokPrice>

Коды состояния :

100 - Вам запрещено скачивание прайс листа
200 - Прайс получен

# Метод XML - GetOrders

Описание

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

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GerOrders>
    <QtyHold>0</QtyHold>
    <QtyActive>2</QtyActive>
    <OrdersList>
        <Order>
            <OrderId>1342200</OrderId>
            <CustomerOrderId>20124</CustomerOrderId>
            <PriceSum>120.11</PriceSum>
            <Status>ACTIVE</Status>
            <Date>2016-01-02 23:33:45</Date>
        </Order>
        <Order>
            <OrderId>1342200</OrderId>
            <CustomerOrderId>20347</CustomerOrderId>
            <PriceSum>155.31</PriceSum>
            <Status>ACTIVE</Status>
            <Date>2016-02-03 12:23:34</Date>
        </Order>
    </OrdersList>
</GetOrders>

Статусы заказа :

ACTIVE - активный (в работе)
HOLD - отложенный

# Метод XML - GetOrderPositions

Описание

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

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

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

Возвращает

XML ответ следующего вида :

<?xml version="1.0" encoding="utf-8"?>
<GerOrderPositions>
    <PositionsList>
        <Position>
            <GlobalId>5100200</GlobalId>
            <Producer>MITSUBISHI</Producer>
            <PartNumber>MN100250</PartNumber>
            <PartNumberNew></PartNumberNew>
            <Quantity>10</Quantity>
            <Description>BUSH</Description>
            <Price>2.54</Price>
            <Currency>USD</Currency>
            <StateId>12</StateId>
            <StateName>Выдано</StateName>
            <StateChangedDate>2016-01-02 03:04:05</StateChangedDate>
            <SupplierCode>STOK</SupplierCode>
            <Reference>12345</Reference>
            <CommentCustomer>warehouse</CommentCustomer>
            <CommentAdmin></CommentAdmin>
        </Position>
        <Position>
            <GlobalId>5200300</GlobalId>
            <Producer>MITSUBISHI</Producer>
            <PartNumber>MN100110</PartNumber>
            <PartNumberNew></PartNumberNew>
            <Quantity>2</Quantity>
            <Description>PART</Description>
            <Price>10.23</Price>
            <Currency>USD</Currency>
            <StateId>8</StateId>
            <StateName>На складе</StateName>
            <StateChangedDate>2016-01-02 03:04:05</StateChangedDate>
            <SupplierCode>STOK</SupplierCode>
            <Reference>54321</Reference>
            <CommentCustomer>warehouse</CommentCustomer>
            <CommentAdmin></CommentAdmin>
        </Position>
    </PositionsList>
</GetOrderPositions>

Возможные состояния позиций :