Результат - Автотрейд
advertisement
1
Документация API 2.0
Оглавление
Общие сведения .......................................................................................................................................... 4
Пользовательские методы ......................................................................................................................... 5
GetStoragesList() ....................................................................................................................................... 5
GetPhoto($id, $type)................................................................................................................................. 7
GetOrderList ($fromDate, $toDate[, $page][, $limit]) .............................................................................. 8
GetDocList($fromDate, $toDate[, $Page][, $Limit])................................................................................11
GetOrderDetails($order_id) ....................................................................................................................14
GetDocDetails($doc_id) ..........................................................................................................................16
logout() ....................................................................................................................................................19
Методы получения информации по товару............................................................................................19
GetStocksAndPrices($storageIDs, $items) ..............................................................................................19
GetAmountInTransit($items, $storages) ................................................................................................24
GetTechInfo($article) ..............................................................................................................................25
GetReplacesAndCrosses ($article) ..........................................................................................................28
GetProperties($article) ...........................................................................................................................32
GetApplicability($article) ........................................................................................................................33
Методы манипулирования корзиной......................................................................................................36
GetBasket() ..............................................................................................................................................36
UpdateBasket($Items) ............................................................................................................................41
AddToBasket($items) ..............................................................................................................................43
RemoveFromBasket($items) ...................................................................................................................45
ClearBasket() ...........................................................................................................................................46
SendOrder($comment) ...........................................................................................................................47
Методы, используемые в поиске по артикулу или наименованию. ....................................................49
GetItemsByQuery ($q, $Exact, $Page, $Limit) ........................................................................................49
Методы, используемые в поиске по списку артикулов ........................................................................51
GetItemsByList($Items, $Page, $Limit) ...................................................................................................51
Методы, используемые в поиске по каталогам. ....................................................................................60
GetCatalogsList($Filter) ...........................................................................................................................60
GetSectionsList($CatalogId, $Filter) ........................................................................................................61
GetSubSectionsList($CatalogId, $SectionId, $Filter) ...............................................................................63
GetItemsByCatalog ($CatalogId, $SectionId, $SubSectionIds, $Brand [, $Page][, $Limit]) ....................65
2
Методы, используемые в поиске по техническим параметрам. ..........................................................70
GetPartsTypesList($Filter) .......................................................................................................................70
GetShablonByPartsType($PartsTypeID) ..................................................................................................71
GetItemsByPartsType($PartsTypeID, $TechInfoStr[, $Page][, $Limit]) ...................................................74
Методы, используемые в поиске по кросс-номерам. ...........................................................................76
GetCrossTypesList($Filter) ......................................................................................................................76
GetCrossValues($PropertyID, $Filter) .....................................................................................................78
GetItemsByCrossValue($Value, $PropertyID, $Page, $Limit) .................................................................79
Коды и сообщения об ошибках................................................................................................................81
Код ошибки ................................................................................................................................................81
Сообщение .................................................................................................................................................81
0 ...................................................................................................................................................................82
ok .................................................................................................................................................................82
1 ...................................................................................................................................................................82
Неверный формат данных в запросе.......................................................................................................82
2 ...................................................................................................................................................................82
Вы не авторизованы. .................................................................................................................................82
3 ...................................................................................................................................................................82
Неправильный логин или пароль. ...........................................................................................................82
4 ...................................................................................................................................................................82
Неуникальная пара логин\пароль. ..........................................................................................................82
5 ...................................................................................................................................................................82
Ошибка определения списка доступных складов. .................................................................................82
6 ...................................................................................................................................................................82
Ошибка обновления корзины. .................................................................................................................82
7 ...................................................................................................................................................................82
Ошибка блокировки корзины. .................................................................................................................82
8 ...................................................................................................................................................................82
Корзина пуста.............................................................................................................................................82
9-16 .............................................................................................................................................................82
Отправка заявок в настоящее время недоступна в связи с проведением технических работ. .........82
17.................................................................................................................................................................82
Для одной или нескольких позиций в запросе не указано требуемое количество. ...........................82
18.................................................................................................................................................................82
Количество позиций в запросе превышает максимально допустимое значение. ..............................82
3
19.................................................................................................................................................................82
Информация по наличию товара на складах и цене в данный момент не актуальна в связи с
проведением технических работ. ............................................................................................................82
20.................................................................................................................................................................82
Запрашиваемые позиции не найдены. Проверьте правильность указания артикулов. ....................82
21.................................................................................................................................................................82
Документ(ы) не найден(ы). ......................................................................................................................82
4
Общие сведения
Документ содержит сведения о программном интерфейсе интернет-магазина компании «Автотрейд»
sklad.autotrade.su (далее - «API»). Через API внешние приложения получают доступ к системе поиска
интернет-магазина (в различных вариантах), оформлению заказов и информации о заказах.
WSDL (англ. Web Services Description Language) — это язык описания веб-сервисов, основанный на XML. На
этом языке описывается модель сервиса: методы, входные и результирующие структуры данных, типы
данных, сетевые адреса для обращения к сервису и т.п.
JSON (англ. JavaScriptObjectNotation) — текстовый формат обмена данными, основанный на JavaScript и
обычно используемый именно с этим языком. Как и многие другие текстовые форматы, JSON легко читается
людьми.
Взаимодействие с сервисом может осуществляться через SOAP протокол или посредством JSON путем
отправки запроса на соответствующий адрес сервиса:
SOAP: https://api2.autotrade.su/?soap
JSON: https://api2.autotrade.su/?json
Внимание! При отправке запросов по протоколу HTTPS на данный момент могут
возникать ошибки, в этом случае используйте протокол HTTP.
В случае использования SOAP способ отправки запросов зависит от SOAP-библиотеки. Если библиотека
поддерживает WSDL, достаточно указать адрес WSDL-файла:
https://api2.autotrade.su/api.wsdl
Из него библиотека получает адрес API и выполняет необходимые действия для отправки запроса. Если
библиотека не поддерживает WSDL, необходимо явно указывать адрес API - https://api2.autotrade.su/?soap.
Все методы вида getItemsByxxx возвращают путь к фотографии в поле photo, если фото нет, то возвращается
пустая строка.
Все методы getItemsByxxx возвращают признаки:
наличия технической информации: techinfo_exists =>'Y'’ / ’N’;
наличия аналогов: cross_exists => 'Y' / ’N’;
наличия замен: subs_exists => 'Y' / ’N’, где «Y» - yes, «N» - нет
Механизм авторизации
При каждом вызове метода API производится проверка авторизации пользователя, с этой целью запрос
должен содержать хэш, сформированный из пары логин-пароль пользователя по следующему алгоритму:
$hash = MD5(login.MD5(password).SALT),где
login – логин для авторизации на sklad.autotrade.su;
password – пароль для авторизации на sklad.autotrade.su;
SALT – строка длиной 10 символов, состоящая из букв латинского алфавита, цифр и знаков пунктуации, эта
строка равна “1>6)/MI~{J”.
5
Для примера рассмотрим вызов метода GetStoragesList для получения списка разрешенных складов.
При использовании формата SOAP хэш передается в заголовке SOAP-запроса
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENC=http://schemas.xmlsoap.org/soap/encoding/ SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>910c29400ebfed8c3baab935f3456f49</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetStoragesList />
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
При использовании формата JSON хэш передается в элементе auth_key JSON-массива:
data = {
"auth_key": "910c29400ebfed8c3baab935f3456f49",
"method": "getStoragesList"
}
Внимание! При отправке запроса в формате JSON перед {} необходимо добавить
“data=”. Названия и значения параметров должны быть заключены в двойные кавычки,
как в примере выше.
Пользовательские методы
GetStoragesList()
Возвращает массив разрешенных к просмотру складов для авторизованного пользователя, хранящийся в
элементе storages массива сессии пользователя.
Входные параметры:
нет
Результат:
массив вида:
{
{
'id'=>'1',
‘legend’=> ‘C1’
'name'=>'склад №1'
‘address’ => ‘адрес’
‘geo’ => ‘ширина. долгота’
‘widget’ => ‘код для генерации карты 2ГИС’
},
{
'id'=>'2',
‘legend’=> ‘C2’
'name'=>'склад №2'
‘address’ => ‘адрес’
‘geo’ => ‘ширина. долгота’
‘widget’ => ‘код для генерации карты 2ГИС’
6
}
,
...
}
Пример:
SOAP
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>910c29400ebfed8c3baab935f3456f49</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetStoragesList />
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetStoragesListResponse>
<return SOAP-ENC:arrayType="ns1:StoragesInfo[2]" xsi:type="ns1:ArrayOfStoragesInfo">
<item xsi:type="ns1:StoragesInfo">
<id xsi:type="xsd:int">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<address xsi:type="xsd:string"/>
<geo xsi:type="xsd:string"/>
<widget xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:StoragesInfo">
<id xsi:type="xsd:int">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<address xsi:type="xsd:string"/>
<geo xsi:type="xsd:string"/>
<widget xsi:type="xsd:string"/>
</item>
</return>
</ns1:GetStoragesListResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
7
JSON
Запрос
{
"auth_key": "910c29400ebfed8c3baab935f3456f49",
"method": "getStoragesList"
}
Ответ
[
"1": {
"id": "1",
"legend": "И(Р)",
"name": "Иркутск (Ракитная)",
"address": "",
"geo": "",
"widget": ""
},
"9": {
"id": "9",
"legend": "И(А)",
"name": "Иркутск (Автоград)",
"address": "",
"geo": "",
"widget": ""
}
]
GetPhoto($id, $type)
Получение ссылки на фотографию модели или запчасти и ссылки на уменьшенное изображение
фотографии.
Входные параметры:
$id–внутренний id запчасти (см. описание одного из методов GetItemsByXXX) или id модели автомобиля;
$type– тип фотографии: “model” – фотография модели, ”item” – фотография запчасти.
Результат:
Массив вида:
{
'error'=>'0' – ошибок нет или ‘1’ – ошибка
‘message’ => ‘код ошибки если url фотографии не удалось получить’
'url'=>’http://autotrade.su/pic.php?code={id}&state={код_страны}'
‘url_prewiew’: "http://autotrade.su/files/photo/models/preview/{название фотографии}‘
}
Пример:
SOAP
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
8
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>29a4729eef37cebdd4413eb4cf55c64b</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetPhoto>
<id xsi:type="xsd:string">##1FB2###</id>
<type xsi:type="xsd:string">item</type>
</ns1:GetPhoto>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetPhotoResponse>
<error xsi:type="xsd:int">0</error>
<message xsi:type="xsd:string">Ok</message>
<url xsi:type="xsd:string">http://autotrade.su/pic.php?code=%23%231FB2%23%23%23&amp;state=1&amp;size=800.625</url>
<url_prewiew xsi:type="xsd:string">http://autotrade.su/files/photo/models/preview/ty-rv2-r-cp lfw_x.jpg</url_prewiew>
</ns1:GetPhotoResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "29a4729eef37cebdd4413eb4cf55c64b",
"method": "getPhoto",
"params": {
"id": "##1FB2###",
"type": "item"
}
}
Ответ
{
"error": "0",
"message": "Ok",
"url": "http://autotrade.su/pic.php?code=%23%231FB2%23%23%23&state=1&size=800.625",
"url_prewiew": "http://autotrade.su/files/photo/models/preview/ty-rv2-r-cp lfw_x.jpg"
}
GetOrderList ($fromDate, $toDate[, $page][, $limit])
Возвращает список необработанных заявок пользователя (таблица atr_shop_orders) за определенный
период и с постраничной разбивкой.
Входные параметры:
$fromDate – начало периода, дата в формате 'YYYY-MM-DD';
$toDate – конец периода, дата в формате 'YYYY-MM-DD';
$page – страница, по умолчанию 1;
$limit - количество строк на странице, по умолчанию 20.
Результат:
Массив вида
9
{
total => ‘общее число заявок’,
page => ‘номер страницы’
limit => ‘по сколько выводить на странице’,
items => {
{
order_id => ‘id заявки’,
order_date => ‘дата-время создания заявки’,
type_doc => ‘вид документа’,
quantity => ‘общее кол-во товаров в заявке’,
amount => ‘итоговая сумма’
},
...
}
}
Пример:
Получить список необработанных заявок за период с 12.10.2012 по 19.10.2012, страница 1, по5 элементов
на странице.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getOrderList"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>910c29400ebfed8c3baab935f3456f49</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetOrderList>
<fromDate xsi:type="xsd:string">2012-10-12</fromDate>
<toDate xsi:type="xsd:string">2012-10-19</toDate>
<page xsi:type="xsd:int">1</page>
<limit xsi:type="xsd:int">5</limit>
</ns1:GetOrderList>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetOrderListResponse>
<total xsi:type="xsd:int">33</total>
<page xsi:type="xsd:int">1</page>
<limit xsi:type="xsd:int">5</limit>
<items SOAP-ENC:arrayType="ns1:OrdersInfo[5]" xsi:type="ns1:ArrayOfOrders">
<item xsi:type="ns1:OrdersInfo">
<order_id xsi:type="xsd:string">205210</order_id>
<order_date xsi:type="xsd:string">18.10.2012</order_date>
<type_doc xsi:type="xsd:string">Неподтвержденнаязаявка</type_doc>
10
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
<item xsi:type="ns1:OrdersInfo">
<order_id xsi:type="xsd:string">205208</order_id>
<order_date xsi:type="xsd:string">18.10.2012</order_date>
<type_doc xsi:type="xsd:string">Неподтвержденнаязаявка</type_doc>
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
<item xsi:type="ns1:OrdersInfo">
<order_id xsi:type="xsd:string">205206</order_id>
<order_date xsi:type="xsd:string">18.10.2012</order_date>
<type_doc xsi:type="xsd:string">Неподтвержденнаязаявка</type_doc>
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
<item xsi:type="ns1:OrdersInfo">
<order_id xsi:type="xsd:string">205184</order_id>
<order_date xsi:type="xsd:string">18.10.2012</order_date>
<type_doc xsi:type="xsd:string">Неподтвержденнаязаявка</type_doc>
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
<item xsi:type="ns1:OrdersInfo">
<order_id xsi:type="xsd:string">205176</order_id>
<order_date xsi:type="xsd:string">17.10.2012</order_date>
<type_doc xsi:type="xsd:string">Неподтвержденнаязаявка</type_doc>
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">8440.00</amount>
</item>
</items>
</ns1:GetOrderListResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "910c29400ebfed8c3baab935f3456f49",
"method": "getOrderList",
"params": {
"fromDate": "2012-10-12",
"toDate": "2012-10-19",
"page": 1,
"limit": 5
}
}
Ответ
{
"total": "33",
"page": 1,
"limit": 5,
"items": [
{
"order_id": "205210",
"order_date": "18.10.2012",
"type_doc": "Неподтвержденная заявка",
"quantity": "7",
"amount": "0.00"
},
{
"order_id": "205208",
"order_date": "18.10.2012",
"type_doc": "Неподтвержденная заявка",
"quantity": "7",
"amount": "0.00"
},
{
"order_id": "205206",
11
"order_date": "18.10.2012",
"type_doc": "Неподтвержденная заявка",
"quantity": "7",
"amount": "0.00"
},
{
"order_id": "205184",
"order_date": "18.10.2012",
"type_doc": "Неподтвержденная заявка",
"quantity": "7",
"amount": "0.00"
},
{
"order_id": "205176",
"order_date": "17.10.2012",
"type_doc": "Неподтвержденная заявка",
"quantity": "7",
"amount": "8440.00"
}
]
}
GetDocList($fromDate, $toDate[, $Page][, $Limit])
Возвращает список документов пользователя (таблица atr_documents) за диапазон дат.
Входные параметры:
$fromDate - начало диапазона дат, строка в формате 'YYYY-MM-DD';
$toDate - окончание диапазона дат, строка в формате 'YYYY-MM-DD';
$Page – страница, по умолчанию 1;
$Limit - количество строк на странице, по умолчанию 20.
Результат:
Массив вида
{
total => ‘общее число документов’,
page => ‘номер страницы’
limit => ‘по сколько выводить на странице’,
items => {
{
parent_id => ‘id родительского документа’ или 0,
id => ‘id документа’,
number => ‘номер документа’,
doc_date => ‘дата-время создания документа’,
type_doc => ‘вид документа’,
quantity => ‘общее кол-во товаров в документе заявки’,
amount => ‘итоговая сумма’,
pay =>1 или 0
real => 1 или 0,
child => ‘массив дочерних документов’
},
...
}
}
Пример:
Получить список документов за период с 12.10.2012 по 19.10.2012, вывести первых 5 элементов.
12
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getDocList"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>910c29400ebfed8c3baab935f3456f49</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetDocList>
<fromDate xsi:type="xsd:string">2012-10-12</fromDate>
<toDate xsi:type="xsd:string">2012-10-19</toDate>
<page xsi:type="xsd:int">1</page>
<limit xsi:type="xsd:int">5</limit>
</ns1:GetDocList>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetDocListResponse>
<total xsi:type="xsd:int">23</total>
<page xsi:type="xsd:int">1</page>
<limit xsi:type="xsd:int">5</limit>
<items SOAP-ENC:arrayType="ns1:DocsInfo[5]" xsi:type="ns1:ArrayOfDocs">
<item xsi:type="ns1:DocsInfo">
<parent_id xsi:nil="true"/>
<id xsi:type="xsd:string">8595319101</id>
<number xsi:type="xsd:string">АА00008318</number>
<date_doc xsi:type="xsd:string">18.10.2012</date_doc>
<type_doc xsi:type="xsd:string">Документ.ЗаявкаПокупателя</type_doc>
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">0.00</amount>
<pay xsi:type="xsd:string"/>
<real xsi:type="xsd:string"/>
<child SOAP-ENC:arrayType="ns1:DocsInfo[0]" xsi:type="ns1:ArrayOfDocs"/>
</item>
<item xsi:type="ns1:DocsInfo">
<parent_id xsi:nil="true"/>
<id xsi:type="xsd:string">8595322101</id>
<number xsi:type="xsd:string">АА00008321</number>
<date_doc xsi:type="xsd:string">18.10.2012</date_doc>
<type_doc xsi:type="xsd:string">Документ.ЗаявкаПокупателя</type_doc>
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">0.00</amount>
<pay xsi:type="xsd:string"/>
<real xsi:type="xsd:string"/>
<child SOAP-ENC:arrayType="ns1:DocsInfo[0]" xsi:type="ns1:ArrayOfDocs"/>
</item>
<item xsi:type="ns1:DocsInfo">
<parent_id xsi:nil="true"/>
<id xsi:type="xsd:string">8595321101</id>
<number xsi:type="xsd:string">АА00008320</number>
13
<date_doc xsi:type="xsd:string">18.10.2012</date_doc>
<type_doc xsi:type="xsd:string">Документ.ЗаявкаПокупателя</type_doc>
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">0.00</amount>
<pay xsi:type="xsd:string"/>
<real xsi:type="xsd:string"/>
<child SOAP-ENC:arrayType="ns1:DocsInfo[0]" xsi:type="ns1:ArrayOfDocs"/>
</item>
<item xsi:type="ns1:DocsInfo">
<parent_id xsi:nil="true"/>
<id xsi:type="xsd:string">8595320101</id>
<number xsi:type="xsd:string">АА00008319</number>
<date_doc xsi:type="xsd:string">18.10.2012</date_doc>
<type_doc xsi:type="xsd:string">Документ.ЗаявкаПокупателя</type_doc>
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">0.00</amount>
<pay xsi:type="xsd:string"/>
<real xsi:type="xsd:string"/>
<child SOAP-ENC:arrayType="ns1:DocsInfo[0]" xsi:type="ns1:ArrayOfDocs"/>
</item>
<item xsi:type="ns1:DocsInfo">
<parent_id xsi:nil="true"/>
<id xsi:type="xsd:string">8595318101</id>
<number xsi:type="xsd:string">АА00008317</number>
<date_doc xsi:type="xsd:string">18.10.2012</date_doc>
<type_doc xsi:type="xsd:string">Документ.ЗаявкаПокупателя</type_doc>
<quantity xsi:type="xsd:int">7</quantity>
<amount xsi:type="xsd:string">0.00</amount>
<pay xsi:type="xsd:string"/>
<real xsi:type="xsd:string"/>
<child SOAP-ENC:arrayType="ns1:DocsInfo[0]" xsi:type="ns1:ArrayOfDocs"/>
</item>
</items>
</ns1:GetDocListResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "910c29400ebfed8c3baab935f3456f49",
"method": "getDocList",
"params": {
"fromDate": "2012-10-12",
"toDate": "2012-10-19",
"page": 1,
"limit": 5
}
}
Ответ
{
"total": "23",
"page": 1,
"limit": 5,
"items": [
{
"parent_id": null,
"id": "8595319101",
"number": "АА00008318",
"date_doc": "18.10.2012",
"type_doc": "Документ.ЗаявкаПокупателя",
"quantity": "7.00",
"amount": "0.00",
"pay": "",
"real": "",
"child": []
},
{
"parent_id": null,
"id": "8595322101",
14
"number": "АА00008321",
"date_doc": "18.10.2012",
"type_doc": "Документ.ЗаявкаПокупателя",
"quantity": "7.00",
"amount": "0.00",
"pay": "",
"real": "",
"child": []
},
{
"parent_id": null,
"id": "8595321101",
"number": "АА00008320",
"date_doc": "18.10.2012",
"type_doc": "Документ.ЗаявкаПокупателя",
"quantity": "7.00",
"amount": "0.00",
"pay": "",
"real": "",
"child": []
},
{
"parent_id": null,
"id": "8595320101",
"number": "АА00008319",
"date_doc": "18.10.2012",
"type_doc": "Документ.ЗаявкаПокупателя",
"quantity": "7.00",
"amount": "0.00",
"pay": "",
"real": "",
"child": []
},
{
"parent_id": null,
"id": "8595318101",
"number": "АА00008317",
"date_doc": "18.10.2012",
"type_doc": "Документ.ЗаявкаПокупателя",
"quantity": "7.00",
"amount": "0.00",
"pay": "",
"real": "",
"child": []
}
]
}
GetOrderDetails($order_id)
Получение детальной информации о заказе.
Входные параметры:
$order_id–номер заказа;
Результат:
Массив вида
{
order_id => ‘id заказа’,
order_date => ‘дата отправки заказа’,
amount => ‘общее число товаров в заказе’,
comment => ‘комментарий к заказу’,
items =>
{
{article, name, price, quantity, amount},
15
{article1, name1, price1, quantity1, amount1},
...
}
}
Пример:
Получить детальную информацию о заказе #205184.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getOrderDetails"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>910c29400ebfed8c3baab935f3456f49</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetOrderDetails>
<order_id xsi:type="xsd:string">205184</order_id>
</ns1:GetOrderDetails>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetOrderDetailsResponse>
<order_id xsi:type="xsd:string">205184</order_id>
<order_date xsi:type="xsd:string">18.10.2012</order_date>
<amount xsi:type="xsd:int">0</amount>
<comment xsi:type="xsd:string">Тестовая заявка, не обрабатывать! (Чернухо)</comment>
<items SOAP-ENC:arrayType="ns1:OrderDetailsInfo[4]" xsi:type="ns1:ArrayOfOrderDetails">
<item xsi:type="ns1:OrderDetailsInfo">
<article xsi:type="xsd:string">217-2019L-UE</article>
<name xsi:type="xsd:string">Туманка HONDA STREAM 00-04, RN#</name>
<price xsi:type="xsd:string">0.00</price>
<quantity xsi:type="xsd:int">1</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
<item xsi:type="ns1:OrderDetailsInfo">
<article xsi:type="xsd:string">4PK860</article>
<name xsi:type="xsd:string">99364-00860-83, 99364-30860 Ременькондиционера 1G-FE 96- 99364-00860-8S 4PK860, TOYOTA</name>
<price xsi:type="xsd:string">0.00</price>
<quantity xsi:type="xsd:int">1</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
<item xsi:type="ns1:OrderDetailsInfo">
<article xsi:type="xsd:string">HD00015</article>
<name xsi:type="xsd:string">Радиатор HONDA STREAM RN1 1.7 00-, RN#</name>
<price xsi:type="xsd:string">0.00</price>
<quantity xsi:type="xsd:int">1</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
16
<item xsi:type="ns1:OrderDetailsInfo">
<article xsi:type="xsd:string">ST-HDP5-394-0</article>
<name xsi:type="xsd:string">Радиаторкондиционера HONDA STREAM 00-, RN1-5</name>
<price xsi:type="xsd:string">0.00</price>
<quantity xsi:type="xsd:int">4</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
</items>
</ns1:GetOrderDetailsResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "910c29400ebfed8c3baab935f3456f49",
"method": "getOrderDetails",
"params": 205184
}
Ответ
{
"order_id": "205184",
"order_date": "18.10.2012",
"amount": "0.00",
"comment": "Тестовая заявка, не обрабатывать! (Чернухо)",
"items": [
{
"article": "217-2019L-UE",
"name": "Туманка HONDA STREAM 00-04, RN#",
"price": "0.00",
"quantity": "1",
"amount": "0.00"
},
{
"article": "4PK860",
"name": "99364-00860-83, 99364-30860 Ремень кондиционера 1G-FE 96- 99364-00860-8S 4PK860, TOYOTA",
"price": "0.00",
"quantity": "1",
"amount": "0.00"
},
{
"article": "HD00015",
"name": "Радиатор HONDA STREAM RN1 1.7 00-, RN#",
"price": "0.00",
"quantity": "1",
"amount": "0.00"
},
{
"article": "ST-HDP5-394-0",
"name": "Радиаторкондиционера HONDA STREAM 00-, RN1-5",
"price": "0.00",
"quantity": "4",
"amount": "0.00"
}
]
}
GetDocDetails($doc_id)
Получение детальной информации о документе.
Входные параметры:
$doc_id – номер документа;
17
Результат:
Массив вида
{ number, date_doc, type_doc, summa_doc
items => {
{article, name, price, quantity, amount},
{article1, name1, price1, quantity1, amount1},
...
}
}
Пример:
Получить детальную информацию о документе №8595315101.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getDocDetails"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>910c29400ebfed8c3baab935f3456f49</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetDocDetails>
<doc_id xsi:type="xsd:string">8595315101</doc_id>
</ns1:GetDocDetails>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetDocDetailsResponse>
<number xsi:type="xsd:string">АА00008314</number>
<date_doc xsi:type="xsd:string">17.10.2012</date_doc>
<type_doc xsi:type="xsd:string">Документ.ЗаявкаПокупателя</type_doc>
<summa_doc xsi:type="xsd:string">0.00</summa_doc>
<items SOAP-ENC:arrayType="ns1:DocDetailsInfo[4]" xsi:type="ns1:ArrayOfDocDetails">
<item xsi:type="ns1:DocDetailsInfo">
<article xsi:type="xsd:string">217-2019L-UE</article>
<name xsi:type="xsd:string">Туманка HONDA STREAM 00-04</name>
<price xsi:type="xsd:string">0.00</price>
<quantity xsi:type="xsd:int">1</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
18
<item xsi:type="ns1:DocDetailsInfo">
<article xsi:type="xsd:string">4PK860</article>
<name xsi:type="xsd:string">Ременьполиклин TY 1G-FE 96- (AC), NS KA24DE U30 (AC)</name>
<price xsi:type="xsd:string">0.00</price>
<quantity xsi:type="xsd:int">1</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
<item xsi:type="ns1:DocDetailsInfo">
<article xsi:type="xsd:string">HD00015</article>
<name xsi:type="xsd:string">Радиатор HONDA STREAM RN1 1.7 00-</name>
<price xsi:type="xsd:string">0.00</price>
<quantity xsi:type="xsd:int">1</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
<item xsi:type="ns1:DocDetailsInfo">
<article xsi:type="xsd:string">ST-HDP5-394-0</article>
<name xsi:type="xsd:string">Радиаторкондиционера HONDA STREAM 00-</name>
<price xsi:type="xsd:string">0.00</price>
<quantity xsi:type="xsd:int">4</quantity>
<amount xsi:type="xsd:string">0.00</amount>
</item>
</items>
</ns1:GetDocDetailsResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "910c29400ebfed8c3baab935f3456f49",
"method": "getDocDetails",
"params": 8595315101
}
Ответ
{
"number": "АА00008314",
"date_doc": "17.10.2012",
"type_doc": "Документ.ЗаявкаПокупателя",
"summa_doc": "0.00",
"items": [
{
"article": "217-2019L-UE",
"name": "Туманка HONDA STREAM 00-04",
"price": "0.00",
"quantity": "1.00",
"amount": "0.00"
},
{
"article": "4PK860",
"name": "Ременьполиклин TY 1G-FE 96- (AC), NS KA24DE U30 (AC)",
"price": "0.00",
"quantity": "1.00",
"amount": "0.00"
},
{
"article": "HD00015",
"name": "Радиатор HONDA STREAM RN1 1.7 00-",
"price": "0.00",
"quantity": "1.00",
"amount": "0.00"
},
{
"article": "ST-HDP5-394-0",
"name": "РадиаторкондиционераHONDASTREAM 00-",
"price": "0.00",
"quantity": "4.00",
19
"amount": "0.00"
}
]
}
logout()
Завершение сессии.
Входные параметры: нет
Результат:
массив вида:
[
"0",
"Ok"
]
Методы получения информации по товару.
GetStocksAndPrices($storageIDs, $items)
Получение остатков на складах и цен по заданным артикулам.
Входные параметры:
$storageIDs – список идентификаторов складов полученных с помощью метода GetStoragesList, по которым
нужно получить наличие и цену. Если $storageIDs = 0 – выведет наличие и цену по всем доступным клиенту
складам.
$items – ассоциативный массив следующего вида:
{‘Артикул 1’ => ‘количество’, ‘Артикул 2’ => ‘количество’, …}
Результат:
Массив, подобный следующему:
{
Items =>
{
{
article => ‘KE120 RQ/LH’,
name => ‘Стекло форточки (уголок) задней левой двери TOYOTA COROLLA
AE110/KE110 4D SEDAN 1995-...’,
brand => ‘XYG’,
price => 290,
currency => ‘руб.’,
stocks =>
{
id => 1, name => ‘Иркутск (Ракитная)’, legend=>’И(А)’, quantity_unpacked => ‘+’, quantity_packed => ‘-‘ }
id => 9, name => ‘Иркутск (Автоград)’, legend=>’И(А)’, quantity_unpacked => ‘-’, quantity_packed => ‘-‘ }
}
},
…
}
price_ust => 'цена за установку стекла',
20
}
Запрос производится из 1С. Возвращаются цена товара и признак наличия «+» или отсутствия «-» товара на
каждом из запрошенных складов.
Пример:
получить цены и остатки по складам Иркутск-Автоград и Иркутск-Ракитная для артикула ST-HDP5-394-0.
SOAP
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns2="http://xml.apache.org/xml-soap" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>29a4729eef37cebdd4413eb4cf55c64b</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetStocksAndPrices>
<storages SOAP-ENC:arrayType="xsd:int[2]" xsi:type="SOAP-ENC:Array">
<item xsi:type="xsd:int">1</item>
<item xsi:type="xsd:int">9</item>
</storages>
<items xsi:type="ns2:Map">
<item>
<key xsi:type="xsd:string">217-2019L-UE</key>
<value xsi:type="xsd:int">1</value>
</item>
<item>
<key xsi:type="xsd:string">HD00015</key>
<value xsi:type="xsd:int">1</value>
</item>
<item>
<key xsi:type="xsd:string">4PK860</key>
<value xsi:type="xsd:int">1</value>
</item>
<item>
<key xsi:type="xsd:string">ST-HDP5-394-0</key>
<value xsi:type="xsd:int">4</value>
</item>
</items>
</ns1:GetStocksAndPrices>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetStocksAndPricesResponse>
<items SOAP-ENC:arrayType="ns1:ArticlesInfo[4]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">HD00015</article>
<name xsi:type="xsd:string">Радиатор HONDA STREAM RN1 1.7 00-</name>
<id xsi:type="xsd:string">15956</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">###CB8###</inside_id_in>
<price xsi:type="xsd:string">2140</price>
<price_ust xsi:type="xsd:string">0</price_ust>
<currency xsi:type="xsd:string">руб.</currency>
21
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">+</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">+</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">+</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">217-2019L-UE</article>
<name xsi:type="xsd:string">Туманка HONDA STREAM 00-04</name>
<id xsi:type="xsd:string">23941</id>
<brand xsi:type="xsd:string">DEPO</brand>
<inside_id_in xsi:type="xsd:string">###IH1###</inside_id_in>
<price xsi:type="xsd:string">1120</price>
<price_ust xsi:type="xsd:string">0</price_ust>
<currency xsi:type="xsd:string">руб.</currency>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">ST-HDP5-394-0</article>
<name xsi:type="xsd:string">Радиатор кондиционера HONDA STREAM 00-</name>
<id xsi:type="xsd:string">31388</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">###O7W###</inside_id_in>
<price xsi:type="xsd:string">1800</price>
<price_ust xsi:type="xsd:string">0</price_ust>
<currency xsi:type="xsd:string">руб.</currency>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">1</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">4PK860</article>
<name xsi:type="xsd:string">Ремень поликлин TY 1G-FE 96- (AC), NS KA24DE U30 (AC)</name>
<id xsi:type="xsd:string">35470</id>
<brand xsi:type="xsd:string">MITSUBOSHI</brand>
22
<inside_id_in xsi:type="xsd:string">###RDA###</inside_id_in>
<price xsi:type="xsd:string">110</price>
<price_ust xsi:type="xsd:string">0</price_ust>
<currency xsi:type="xsd:string">руб.</currency>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
</items>
<code xsi:type="xsd:string">0</code>
<message xsi:type="xsd:string">Ok</message>
</ns1:GetStocksAndPricesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "29a4729eef37cebdd4413eb4cf55c64b",
"method": "getStocksAndPrices",
"params": {
"storages": [
1,
9
],
"items": {
"217-2019L-UE": 1,
"HD00015": 1,
"4PK860": 1,
"ST-HDP5-394-0": 4
}
}
} Ответ
{
"items": {
"HD00015": {
"article": "HD00015",
"name": "Радиатор HONDA STREAM RN1 1.7 00-",
"id": "15956",
"brand": "SAT",
"itemtype": "original",
"inside_id_in": "###CB8###",
"price": "2140",
"currency": "руб.",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "+",
"quantity_packed": "+"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "+",
23
"quantity_packed": "-"
}
},
"price_ust": "0"
},
"217-2019L-UE": {
"article": "217-2019L-UE",
"name": "Туманка HONDA STREAM 00-04",
"id": "23941",
"brand": "DEPO",
"itemtype": "original",
"inside_id_in": "###IH1###",
"price": "1120",
"currency": "руб.",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "-",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
},
"price_ust": "0"
},
"ST-HDP5-394-0": {
"article": "ST-HDP5-394-0",
"name": "Радиатор кондиционера HONDA STREAM 00-",
"id": "31388",
"brand": "SAT",
"itemtype": "original",
"inside_id_in": "###O7W###",
"price": "1800",
"currency": "руб.",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "1",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
},
"price_ust": "0"
},
"4PK860": {
"article": "4PK860",
"name": "Ремень поликлин TY 1G-FE 96- (AC), NS KA24DE U30 (AC)",
"id": "35470",
"brand": "MITSUBOSHI",
"itemtype": "original",
"inside_id_in": "###RDA###",
"price": "110",
"currency": "руб.",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "-",
24
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
},
"price_ust": "0"
}
},
"code": "0",
"message": "Ok"
}
GetAmountInTransit($items, $storages)
Получение информации о приходе товара на склад.
Входные параметры:
$items – ассоциативный массив следующего вида:
{‘Артикул 1’ => ‘количество’, ‘Артикул 2’ => ‘количество’, …}
$storages – список ИДов складов, по которым необходимо получить информацию, если не указан – метод
вернет информацию по всем доступным пользователю складам.
Результат:
массив вида:
{
"48510-39795": {
"article": "48510-39795", /* артикул */
"inside_id_in": " LI7 ", /* внутрений ИД */
"name": "Амортизатор FR TOYOTA DYNA 99-02", /* наименование */
"stocks": {
"2": { /* ИД склада */
"id": "2", /* ИД склада */
"name": "Владивосток", /* Название склада */
"delivery": [
{
"id_1c": " 4X ", /* внутренний ИД товара */
"date": "24.06.2014", /* примерная дата поступления */
"quantity": 6 /* кол-во товара в поступлении */
}
]
},
...
}
}
}
Пример:
Получить информацию о приходе товара 48510-39795 на склад Иркутск (Ракитная).
SOAP
Временно недоступно.
JSON
Запрос
{
"auth_key": "29a4729eef37cebdd4413eb4cf55c64b",
"method": "getAmountInTransit",
25
"params": {
"items": {
"48510-39795": 1,
"storages": [1]
}
}
}
Ответ
{
"48510-39795": {
"article": "48510-39795",
"inside_id_in": " LI7 ",
"name": "Амортизатор FR TOYOTA DYNA 99-02",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"delivery": [
{
"id_1c": " 1K ",
"date": "04.07.2014",
"quantity": 4
}
]
}
}
}
}
GetTechInfo($article)
Получение технической информации по конкретному артикулу номенклатуры.
Входные параметры:
$article – артикул требуемой позиции.
Результат:
массив вида:
{
article => ‘56101-05380’,
name => ‘СтеклолобовоеTOYOTAAVENSIS 09- д.д., вин, зел. Полоса’,
items => {
{key => название свойства,value =>значение свойства , alt=>альтернативное название свойства, val_alt=>альтернативное
название значения свойства},
{key => название свойства,value =>значение свойства , alt=>альтернативное название свойства, val_alt=>альтернативное
название значения свойства},
…
}
}
Пример:
Получить техн. Информаци для артикула IS200 LFW/X.
SOAP
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>29a4729eef37cebdd4413eb4cf55c64b</auth_key>
26
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetTechInfo>
<article xsi:type="xsd:string">IS200 LFW/X</article>
</ns1:GetTechInfo>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetTechInfoResponse>
<article xsi:type="xsd:string">IS200 LFW/X</article>
<name xsi:type="xsd:string">Стекло лобовое в клей TOYOTA ALTEZZA 98-05 4/5D</name>
<items SOAP-ENC:arrayType="ns1:PropertyInfo[16]" xsi:type="ns1:ArrayOfProperties">
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Цвет стекла</key>
<value xsi:type="xsd:string">GN</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Цвет полосы</key>
<value xsi:type="xsd:string">BL</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Молдинг</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">VIN</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Козырек</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Обогрев щеток</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Полный обогрев</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Антенна</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Датчик света</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Д.Д. (фото)</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Место под пятак (фото)</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Руль</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Ширина</key>
<value xsi:type="xsd:string">1378</value>
</item>
27
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Высота</key>
<value xsi:type="xsd:string">825</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Диагональ</key>
<value xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Камера</key>
<value xsi:type="xsd:string"/>
</item>
</items>
</ns1:GetTechInfoResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "29a4729eef37cebdd4413eb4cf55c64b",
"method": "getTechInfo",
"params": "IS200 LFW/X"
}
Ответ
{
"article": "IS200 LFW/X",
"name": "Стекло лобовое в клей TOYOTA ALTEZZA 98-05 4/5D",
"items": [
{
"key": "Цвет стекла",
"value": "GN",
"alt": "",
"val_alt": "зеленый"
},
{
"key": "Цвет полосы",
"value": "BL",
"alt": "",
"val_alt": "синий"
},
{
"key": "Молдинг",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "VIN",
"value": "",
"alt": "Окно под VIN номер",
"val_alt": ""
},
{
"key": "Козырек",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Обогрев щеток",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Полный обогрев",
28
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Антенна",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Датчик света",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Д.Д. (фото)",
"value": "",
"alt": "Датчик дождя",
"val_alt": ""
},
{
"key": "Место под пятак (фото)",
"value": "",
"alt": "Место под пятак",
"val_alt": ""
},
{
"key": "Руль",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Ширина",
"value": "1378",
"alt": "",
"val_alt": "1378"
},
{
"key": "Высота",
"value": "825",
"alt": "",
"val_alt": "825"
},
{
"key": "Диагональ",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Камера",
"value": "",
"alt": "Место под камеру",
"val_alt": ""
}
]
}
GetReplacesAndCrosses ($article)
Возвращает информацию по аналогам и заменам для указанного артикула.
Входные параметры:
$article – параметр вида: ‘артикул’
29
Результат:
Массив вида:
{
id => ‘id товара’,
article=> 'артикул’
name=>'Наименование артикула',
brand => 'бренд',
inside_id_in=>'Внутренний код номенклатуры',
itemsReplace =>
{
{
id =>id аналога,
article =>артикул,
name =>наименование,
brand =>бренд,
inside_id_in =>внутреннийкод,
tehinform => строка значений тех. параметров,
basket => наличие данной позиции в корзине,
photo => путь к изображению позиции,
},
…
},
itemsCross =>
{
{
id =>id аналога,
article =>артикул,
name =>наименование,
brand =>бренд,
inside_id_in =>внутренний код номенклатуры,
tehinform => строка значений тех. параметров,
basket => наличие данной позиции в корзине,
photo => путь к изображению позиции,
},
...
},
totalReplaces => количество замен,
totalCrosses => количество аналогов,
totalAll => общее количество замен и аналогов,
code => код ошибки,
message => сообщение об ошибке
}
Пример:
Получить номенклатуру аналогов и замен для артикула 48510-29176.
SOAP
Запрос
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:ns2="http://xml.apache.org/xml-soap"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>29a4729eef37cebdd4413eb4cf55c64b</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:getReplacesAndCrosses>
30
<article>48510-29176</article>
</ns1:getReplacesAndCrosses>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetReplacesAndCrossesResponse>
<article xsi:type="xsd:string">48510-29176</article>
<name xsi:type="xsd:string">Стойка амортизационная FR TOYOTA MARKII 92-</name>
<id xsi:type="xsd:int">12173</id>
<inside_id_in xsi:type="xsd:string">###9E5###</inside_id_in>
<itemsReplace SOAP-ENC:arrayType="ns1:ReplacesAndCrossesInfo[2]" xsi:type="ns1:ArrayOfReplacesAndCrossesInfo">
<item xsi:type="ns1:ReplacesAndCrossesInfo">
<article xsi:type="xsd:string">48510-29165</article>
<name xsi:type="xsd:string">Стойка амортизационная, передняя CHASER CRESTA MARK 2</name>
<id xsi:type="xsd:string">89552</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">##1X3K###</inside_id_in>
<tehinform xsi:type="xsd:string"/>
<basket xsi:type="xsd:bool">false</basket>
<photo xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:ReplacesAndCrossesInfo">
<article xsi:type="xsd:string">48510-29175</article>
<name xsi:type="xsd:string">Стойка амортизационная, передняя CHASER CRESTA MARK 2</name>
<id xsi:type="xsd:string">86501</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">##1UQT###</inside_id_in>
<tehinform xsi:type="xsd:string"/>
<basket xsi:type="xsd:bool">false</basket>
<photo xsi:type="xsd:string"/>
</item>
</itemsReplace>
<itemsCross SOAP-ENC:arrayType="ns1:ReplacesAndCrossesInfo[2]" xsi:type="ns1:ArrayOfReplacesAndCrossesInfo">
<item xsi:type="ns1:ReplacesAndCrossesInfo">
<article xsi:type="xsd:string">ST-48510-29176</article>
<name xsi:type="xsd:string">Стойка FR TOYOTA ALTEZZA/CHASER/CRESTA/MARK2/BLIT/PROGRES/VEROSSA 92-07 LH=RH</name>
<id xsi:type="xsd:string">47243</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">##10GB###</inside_id_in>
<tehinform xsi:type="xsd:string">,,12,Шток,Ухо,,,,,,,550,418</tehinform>
<basket xsi:type="xsd:bool">false</basket>
<photo
xsi:type="xsd:string">http://www.autotrade.su/pic.php?code=%23%2310GB%23%23%23&amp;state=1&amp;size=910.615</photo>
</item>
<item xsi:type="ns1:ReplacesAndCrossesInfo">
<article xsi:type="xsd:string">ST-48510-29175-SE</article>
<name xsi:type="xsd:string">Стойка FR TOYOTA ALTEZZA/CHASER/CRESTA/MARK2/BLIT/PROGRES/VEROSSA 92-07 Special Edition
LH=RH</name>
<id xsi:type="xsd:string">127489101</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">##2QDD101</inside_id_in>
<tehinform xsi:type="xsd:string">,,12,Шток,Ухо,,,,,,,550,418</tehinform>
<basket xsi:type="xsd:bool">false</basket>
<photo xsi:type="xsd:string">http://www.autotrade.su/pic.php?code=%23%232QDD101&amp;state=1&amp;size=860.593</photo>
</item>
</itemsCross>
<totalReplace xsi:type="xsd:int">2</totalReplace>
<totalCross xsi:type="xsd:int">2</totalCross>
<totalAll xsi:type="xsd:int">4</totalAll>
<code xsi:type="xsd:string">0</code>
<message xsi:type="xsd:string">Ok</message>
</ns1:GetReplacesAndCrossesResponse>
</SOAP-ENV:Body>
31
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "29a4729eef37cebdd4413eb4cf55c64b",
"method": "getReplacesAndCrosses",
"params": {
"article": "48510-29176"
}
}
Ответ
{
"article": "48510-29176",
"name": "Стойка амортизационная FR TOYOTA MARKII 92-",
"id": "12173",
"inside_id_in": "###9E5###",
"itemsReplace": {
"48510-29165": {
"article": "48510-29165",
"name": "Стойка амортизационная, передняя CHASER CRESTA MARK 2",
"id": "89552",
"brand": "TOYOTA",
"inside_id_in": "##1X3K###",
"tehinform": "",
"basket": false,
"photo": ""
},
"48510-29175": {
"article": "48510-29175",
"name": "Стойка амортизационная, передняя CHASER CRESTA MARK 2",
"id": "86501",
"brand": "TOYOTA",
"inside_id_in": "##1UQT###",
"tehinform": "",
"basket": false,
"photo": ""
}
},
"itemsCross": {
"ST-48510-29176": {
"article": "ST-48510-29176",
"name": "Стойка FR TOYOTA ALTEZZA/CHASER/CRESTA/MARK2/BLIT/PROGRES/VEROSSA 92-07 LH=RH",
"id": "47243",
"brand": "SAT",
"inside_id_in": "##10GB###",
"tehinform": ",,12,Шток,Ухо,,,,,,,550,418",
"basket": false,
"photo": "http://www.autotrade.su/pic.php?code=%23%2310GB%23%23%23&state=1&size=910.615"
},
"ST-48510-29175-SE": {
"article": "ST-48510-29175-SE",
"name": "Стойка FR TOYOTA ALTEZZA/CHASER/CRESTA/MARK2/BLIT/PROGRES/VEROSSA 92-07 Special Edition LH=RH",
"id": "127489101",
"brand": "SAT",
"inside_id_in": "##2QDD101",
"tehinform": ",,12,Шток,Ухо,,,,,,,550,418",
"basket": false,
"photo": "http://www.autotrade.su/pic.php?code=%23%232QDD101&state=1&size=860.593"
}
},
"totalReplace": 2,
"totalCross": 2,
"totalAll": 4,
"code": "0",
"message": "Ok"
}
32
GetProperties($article)
Получение свойств (кросс-номеров) по артикулу основной позиции.
Входные параметры:
$article – артикул требуемой позиции.
Результат:
массив подобного вида:
{
article => ‘56101-05380’,
name => ‘СтеклолобовоеTOYOTAAVENSIS 09- д.д., вин, зел. Полоса’
items =>
{
key => названиекросс-номера,
value =>значение кросс-номера
},
…
}
Пример:
Получить свойства (кросс-номера) для артикула C3-5DHBK FD/LH.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getProperties"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>019223ef495bd594e97dfd8508958839</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetProperties>
<article xsi:type="xsd:string">C3-5DHBK FD/LH</article>
</ns1:GetProperties>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetPropertiesResponse>
<article xsi:type="xsd:string">C3-5DHBK FD/LH</article>
<name xsi:type="xsd:string">Стеклопереднеелевоеопускное CITROEN C3 5D HATCHBACK 2002-</name>
<items SOAP-ENC:arrayType="ns1:PropertyInfo[3]" xsi:type="ns1:ArrayOfProperties">
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Видзапчасти</key>
33
<value xsi:type="xsd:string">Стеклобоковоеопускное</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Еврокод</key>
<value xsi:type="xsd:string">2726LGSH5FD</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">Еврокодкороткий</key>
<value xsi:type="xsd:string">2726L</value>
</item>
</items>
</ns1:GetPropertiesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "019223ef495bd594e97dfd8508958839",
"method": "getProperties",
"params": "C3-5DHBK FD/LH"
}
Ответ
{
"article": "C3-5DHBK FD/LH",
"name": "Стекло переднее левое опускное CITROEN C3 5D HATCHBACK 2002-",
"items": [
{
"key": "Вид запчасти",
"value": "Стекло боковое опускное"
},
{
"key": "Еврокод",
"value": "2726LGSH5FD"
},
{
"key": "Евро код короткий",
"value": "2726L"
}
]
}
GetApplicability($article)
Получение применяемости для моделей по артикулу позиции.
Входные параметры:
$article – артикул требуемой позиции.
Результат:
массив вида:
{
article => ‘56101-05380’,
items =>
34
{
id =>idмодели,
name=>название модели,
code=>код модели,
manufacturer =>производитель,
photo =>имя файла фотографии
},
…
}
Пример:
Получить применяемость для артикула ST-52395-SH3-004.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getApplicability"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>019223ef495bd594e97dfd8508958839</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetApplicability>
<article xsi:type="xsd:string">ST-52395-SH3-004</article>
</ns1:GetApplicability>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetApplicabilityResponse>
<article xsi:type="xsd:string">ST-52395-SH3-004</article>
<items SOAP-ENC:arrayType="ns1:ModelsInfo[7]" xsi:type="ns1:ArrayOfModels">
<item xsi:type="ns1:ModelsInfo">
<id xsi:type="xsd:string">1964</id>
<name xsi:type="xsd:string">HONDA INTEGRA DB# 93-00</name>
<code xsi:type="xsd:string">56</code>
<manufacturer xsi:type="xsd:string">HONDA</manufacturer>
<photo xsi:type="xsd:string">/var/www/autotrade.su/www/files/photo/models/56.jpg</photo>
</item>
<item xsi:type="ns1:ModelsInfo">
<id xsi:type="xsd:string">1988</id>
<name xsi:type="xsd:string">HONDA CIVIC EF# 88-92</name>
<code xsi:type="xsd:string">39</code>
<manufacturer xsi:type="xsd:string">HONDA</manufacturer>
<photo xsi:type="xsd:string">/var/www/autotrade.su/www/files/photo/models/39.jpg</photo>
</item>
<item xsi:type="ns1:ModelsInfo">
<id xsi:type="xsd:string">1992</id>
<name xsi:type="xsd:string">HONDA INTEGRA DA# 89-93</name>
<code xsi:type="xsd:string">55</code>
<manufacturer xsi:type="xsd:string">HONDA</manufacturer>
35
<photo xsi:type="xsd:string">/var/www/autotrade.su/www/files/photo/models/55.jpg</photo>
</item>
<item xsi:type="ns1:ModelsInfo">
<id xsi:type="xsd:string">210</id>
<name xsi:type="xsd:string">HONDA CIVIC EK# 95-01 3/4D</name>
<code xsi:type="xsd:string">42</code>
<manufacturer xsi:type="xsd:string">HONDA</manufacturer>
<photo xsi:type="xsd:string">/var/www/autotrade.su/www/files/photo/models/42.jpg</photo>
</item>
<item xsi:type="ns1:ModelsInfo">
<id xsi:type="xsd:string">220</id>
<name xsi:type="xsd:string">HONDA CR-V RD1 96-01</name>
<code xsi:type="xsd:string">51</code>
<manufacturer xsi:type="xsd:string">HONDA</manufacturer>
<photo xsi:type="xsd:string">/var/www/autotrade.su/www/files/photo/models/51.jpg</photo>
</item>
<item xsi:type="ns1:ModelsInfo">
<id xsi:type="xsd:string">838</id>
<name xsi:type="xsd:string">HONDA CIVIC EG# 92-95 3/4D</name>
<code xsi:type="xsd:string">40</code>
<manufacturer xsi:type="xsd:string">HONDA</manufacturer>
<photo xsi:type="xsd:string">/var/www/autotrade.su/www/files/photo/models/40.jpg</photo>
</item>
<item xsi:type="ns1:ModelsInfo">
<id xsi:type="xsd:string">1963</id>
<name xsi:type="xsd:string">HONDA DOMANI MA# 92-96</name>
<code xsi:type="xsd:string">41</code>
<manufacturer xsi:type="xsd:string">HONDA</manufacturer>
<photo xsi:type="xsd:string">/var/www/autotrade.su/www/files/photo/models/41.jpg</photo>
</item>
</items>
</ns1:GetApplicabilityResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "019223ef495bd594e97dfd8508958839",
"method": "getApplicability",
"params": "ST-52395-SH3-004"
}
Ответ
{
"article": "ST-52395-SH3-004",
"items": [
{
"id": "1964",
"name": "HONDA INTEGRA DB# 93-00",
"code": "56",
"manufacturer": "HONDA",
"photo": "/var/www/autotrade.su/www/files/photo/models/56.jpg"
},
{
"id": "1988",
"name": "HONDA CIVIC EF# 88-92",
"code": "39",
"manufacturer": "HONDA",
"photo": "/var/www/autotrade.su/www/files/photo/models/39.jpg"
},
{
"id": "1992",
"name": "HONDA INTEGRA DA# 89-93",
"code": "55",
"manufacturer": "HONDA",
"photo": "/var/www/autotrade.su/www/files/photo/models/55.jpg"
},
{
"id": "210",
36
"name": "HONDA CIVIC EK# 95-01 3/4D",
"code": "42",
"manufacturer": "HONDA",
"photo": "/var/www/autotrade.su/www/files/photo/models/42.jpg"
},
{
"id": "220",
"name": "HONDA CR-V RD1 96-01",
"code": "51",
"manufacturer": "HONDA",
"photo": "/var/www/autotrade.su/www/files/photo/models/51.jpg"
},
{
"id": "838",
"name": "HONDA CIVIC EG# 92-95 3/4D",
"code": "40",
"manufacturer": "HONDA",
"photo": "/var/www/autotrade.su/www/files/photo/models/40.jpg"
},
{
"id": "1963",
"name": "HONDA DOMANI MA# 92-96",
"code": "41",
"manufacturer": "HONDA",
"photo": "/var/www/autotrade.su/www/files/photo/models/41.jpg"
}
]
}
Методы манипулирования корзиной.
GetBasket()
Получение корзины клиента: чтение корзины из БД в массив сессии пользователя, получение остатков и цен
по позициям, возврат полученного массива.
Входные параметры:
нет
Результат:
Массив вида:
{
Items :
{
‘артикул’:
{
article: ‘артикул",
name: ‘наименование запчасти’,
brand: ‘название бренда’,
quantity:‘количество единиц товара’,
stocks:
{
"idсклада":
{
"id": “idсклада”,
"name": "названиесклада",
"legend": "краткоеобозначениесклада",
"quantity_unpacked": "-",
"quantity_packed":"-"
37
…
},
"price":‘цена’,
"summa":‘сумма’,
"photo": ‘если для товара есть фотография - ссылка на нее вида
http://autotrade.su/pic.php?code=<внутренний код товара>&state=<код страны>’
},
…
},
code : "код ошибки",
message: "сообщение об ошибке или ok"
}
Пример:
Получить корзину клиента.
SOAP
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns2="http://xml.apache.org/xml-soap" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>29a4729eef37cebdd4413eb4cf55c64b</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetBasket />
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetBasketResponse>
<items SOAP-ENC:arrayType="ns1:ArticlesInfo[4]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">217-2019L-UE</article>
<name xsi:type="xsd:string">Туманка HONDA STREAM 00-04</name>
<id xsi:type="xsd:string">23941</id>
<brand xsi:type="xsd:string">DEPO</brand>
<inside_id_in xsi:type="xsd:string">###IH1###</inside_id_in>
<quantity xsi:type="xsd:string">1</quantity>
<price xsi:type="xsd:string">0</price>
<currency xsi:type="xsd:string">руб.</currency>
<photo xsi:type="xsd:string">code=217-2019L-UE&amp;state=1&amp;size=800.471</photo>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
38
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">4PK860</article>
<name xsi:type="xsd:string">Ремень поликлин TY 1G-FE 96- (AC), NS KA24DE U30 (AC)</name>
<id xsi:type="xsd:string">35470</id>
<brand xsi:type="xsd:string">MITSUBOSHI</brand>
<inside_id_in xsi:type="xsd:string">###RDA###</inside_id_in>
<quantity xsi:type="xsd:string">3</quantity>
<price xsi:type="xsd:string">0</price>
<currency xsi:type="xsd:string">руб.</currency>
<photo xsi:type="xsd:string"/>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">HD00015</article>
<name xsi:type="xsd:string">Радиатор HONDA STREAM RN1 1.7 00-</name>
<id xsi:type="xsd:string">15956</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">###CB8###</inside_id_in>
<quantity xsi:type="xsd:string">3</quantity>
<price xsi:type="xsd:string">2140</price>
<currency xsi:type="xsd:string">руб.</currency>
<photo xsi:type="xsd:string">code=HD00015&amp;state=1&amp;size=789.600</photo>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">+</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">+</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">1</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">ST-HDP5-394-0</article>
<name xsi:type="xsd:string">Радиатор кондиционера HONDA STREAM 00-</name>
<id xsi:type="xsd:string">31388</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">###O7W###</inside_id_in>
<quantity xsi:type="xsd:string">4</quantity>
<price xsi:type="xsd:string">1800</price>
<currency xsi:type="xsd:string">руб.</currency>
<photo xsi:type="xsd:string">code=ST-HDP5-394-0&amp;state=1&amp;size=800.466</photo>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
39
<quantity_unpacked xsi:type="xsd:string">1</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
</items>
<code xsi:type="xsd:string">0</code>
<message xsi:type="xsd:string">Ok</message>
</ns1:GetBasketResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "c60cb0989a4bf98c21e0dcafae7129ef",
"method": "getBasket"
}
Ответ
{
"items": {
"217-2019L-UE": {
"article": "217-2019L-UE",
"name": "Туманка HONDA STREAM 00-04",
"id": "23941",
"brand": "DEPO",
"itemtype": "original",
"inside_id_in": "###IH1###",
"quantity": 1,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "-",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
},
"price": "0",
"currency": "руб.",
"summa": 0,
"photo": "code=217-2019L-UE&state=1&size=800.471"
},
"4PK860": {
"article": "4PK860",
"name": "Ремень поликлин TY 1G-FE 96- (AC), NS KA24DE U30 (AC)",
"id": "35470",
"brand": "MITSUBOSHI",
"itemtype": "original",
"inside_id_in": "###RDA###",
"quantity": 3,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
40
"quantity_unpacked": "-",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
},
"price": "0",
"currency": "руб.",
"summa": 0,
"photo": ""
},
"HD00015": {
"article": "HD00015",
"name": "Радиатор HONDA STREAM RN1 1.7 00-",
"id": "15956",
"brand": "SAT",
"itemtype": "original",
"inside_id_in": "###CB8###",
"quantity": 3,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "+",
"quantity_packed": "+"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "1",
"quantity_packed": "-"
}
},
"price": 2140,
"currency": "руб.",
"summa": 6420,
"photo": "code=HD00015&state=1&size=789.600"
},
"ST-HDP5-394-0": {
"article": "ST-HDP5-394-0",
"name": "Радиатор кондиционера HONDA STREAM 00-",
"id": "31388",
"brand": "SAT",
"itemtype": "original",
"inside_id_in": "###O7W###",
"quantity": 4,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "1",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
},
"price": 1800,
"currency": "руб.",
"summa": 7200,
"photo": "code=ST-HDP5-394-0&state=1&size=800.466"
}
41
},
"code": "0",
"message": "Ok"
}
UpdateBasket($Items)
Изменение количества по указанным позициям в корзине, пересчет цены и остатков.
Входные параметры:
массив вида:
{‘артикул 1’=>количество,‘артикул 2’=>количество,…}
Результат:
См. результат функции GetBasket.
Пример:
Изменить количество товара HD00015 в корзине на 3.
SOAP
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns2="http://xml.apache.org/xml-soap" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>29a4729eef37cebdd4413eb4cf55c64b</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:UpdateBasket>
<articles xsi:type="ns2:Map">
<item>
<key xsi:type="xsd:string">HD00015</key>
<value xsi:type="xsd:int">3</value>
</item>
</articles>
</ns1:UpdateBasket>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:UpdateBasketResponse>
<items SOAP-ENC:arrayType="ns1:ArticlesInfo[1]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">HD00015</article>
<name xsi:type="xsd:string">Радиатор HONDA STREAM RN1 1.7 00-</name>
<id xsi:type="xsd:string">15956</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">###CB8###</inside_id_in>
<quantity xsi:type="xsd:string">3</quantity>
<price xsi:type="xsd:string">2140</price>
<currency xsi:type="xsd:string">руб.</currency>
<photo xsi:type="xsd:string">code=HD00015&amp;state=1&amp;size=789.600</photo>
42
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">+</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">+</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">1</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
</items>
<code xsi:type="xsd:string">0</code>
<message xsi:type="xsd:string">Ok</message>
</ns1:UpdateBasketResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "29a4729eef37cebdd4413eb4cf55c64b ",
"method": "updateBasket",
"params": {
"articles": {
"HD00015 ": 3
}
}
}
Ответ
{
"items": {
"HD00015": {
"article": "HD00015",
"name": "Радиатор HONDA STREAM RN1 1.7 00-",
"id": "15956",
"brand": "SAT",
"itemtype": "original",
"inside_id_in": "###CB8###",
"quantity": 3,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "+",
"quantity_packed": "+"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "1",
"quantity_packed": "-"
}
},
"price": 2140,
"currency": "руб.",
"summa": 6420,
"photo": "code=HD00015&state=1&size=789.600"
}
},
"code": "0",
"message": "Ok"
43
}
AddToBasket($items)
Добавление товаров в корзину. Если определенный артикул уже присутствует в корзине, в корзину
помещается суммарное его количество.
Входные параметры:
массив следующего вида:
{‘артикул 1’=>количество, ‘артикул 2’=>количество,…}
Результат:
См. результат функции GetBasket.
Пример:
Добавить в корзину товар с артикулом 217-2019L-UE в количестве 1шт.
SOAP
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns2="http://xml.apache.org/xml-soap" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>29a4729eef37cebdd4413eb4cf55c64b</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:AddToBasket>
<articles xsi:type="ns2:Map">
<item>
<key xsi:type="xsd:string">217-2019L-UE</key>
<value xsi:type="xsd:int">1</value>
</item>
</articles>
</ns1:AddToBasket>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:AddToBasketResponse>
<items SOAP-ENC:arrayType="ns1:ArticlesInfo[1]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">217-2019L-UE</article>
<name xsi:type="xsd:string">Туманка HONDA STREAM 00-04</name>
<id xsi:type="xsd:string">23941</id>
44
<brand xsi:type="xsd:string">DEPO</brand>
<inside_id_in xsi:type="xsd:string">###IH1###</inside_id_in>
<quantity xsi:type="xsd:string">3</quantity>
<price xsi:type="xsd:string">0</price>
<currency xsi:type="xsd:string">руб.</currency>
<photo
xsi:type="xsd:string">http://autotrade.su/pic.php?code=%23%23%23IH1%23%23%23&amp;state=1&amp;size=800.471</photo>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
</items>
<code xsi:type="xsd:string">0</code>
<message xsi:type="xsd:string">Ok</message>
</ns1:AddToBasketResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "29a4729eef37cebdd4413eb4cf55c64b",
"method": "addToBasket",
"params": {
"articles": {
"217-2019L-UE": 1
}
}
}
Ответ
{
"items": {
"217-2019L-UE": {
"article": "217-2019L-UE",
"name": "Туманка HONDA STREAM 00-04",
"id": "23941",
"brand": "DEPO",
"itemtype": "original",
"inside_id_in": "###IH1###",
"quantity": 4,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "-",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
},
45
"price": "0",
"currency": "руб.",
"summa": 0,
"photo": "http://autotrade.su/pic.php?code=%23%23%23IH1%23%23%23&state=1&size=800.471"
}
},
"code": "0",
"message": "Ok"
}
RemoveFromBasket($items)
Удаление товаров из корзины.
Входные параметры:
массив артикулов, подлежащих удалению из корзины, следующего вида:
{‘артикул 1’,‘артикул 2’,…}
Результат:
массив следующего вида:
{
code => “”,
message”
},
где code - код ошибки, message - сообщение об ошибке.
code=0 - выполнено успешно.
Пример:
Удалить артикул 4PK860из корзины.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#removeFromBasket"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns2="http://xml.apache.org/xml-soap" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>c60cb0989a4bf98c21e0dcafae7129ef</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:RemoveFromBasket>
<articles SOAP-ENC:arrayType="xsd:string[2]" xsi:type="SOAP-ENC:Array">
<item xsi:type="xsd:string">4PK860</item>
</articles>
</ns1:RemoveFromBasket>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
46
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:RemoveFromBasketResponse>
<error xsi:type="xsd:int">0</error>
<message xsi:type="xsd:string">Ok.</message>
</ns1:RemoveFromBasketResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key":"f9ecbe3a8e3201e06d9f2f6693e90700",
"method":"removeFromBasket",
"params":{
"articles":[
"4PK860"
]
}
}
Ответ
[
"0",
"Ok."
]
ClearBasket()
Очистка корзины.
Входныепараметры:
нет
Результат:
Массив вида:
47
{code,message},
где code-код ошибки, message-сообщение об ошибке. code=0 - выполнено успешно.
Пример:
Очистить корзину.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#clearBasket"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns2="http://xml.apache.org/xml-soap" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>2c3d8e3089170f3ce8b262870e9294f8</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:ClearBasket />
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:ClearBasketResponse>
<error xsi:type="xsd:int">0</error>
<message xsi:type="xsd:string">Ok.</message>
</ns1:ClearBasketResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "2c3d8e3089170f3ce8b262870e9294f8",
"method": "clearBasket"
}
Ответ
[
"0",
"Ok."
]
SendOrder($comment)
48
Оформление заказа. Производится отправка заказа в 1С. В заказ включаются данные из корзины
клиента. Если заказ оформлен успешно, корзина очищается.
Входные параметры:
$comment – комментарий к заказу.
Результат:
{code,message},
где code-код ошибки, message-сообщение об ошибке.
code=0 - выполнено успешно.
Пример:
Оформить заказ на товары из корзины клиента.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#sendOrder"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>2c3d8e3089170f3ce8b262870e9294f8</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:SendOrder>
<article xsi:type="xsd:string">Тестовая заявка, не обрабатывать!</article>
</ns1:SendOrder>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:SendOrderResponse>
<error xsi:type="xsd:int">0</error>
<message xsi:type="xsd:string">Ok.</message>
</ns1:SendOrderResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "2c3d8e3089170f3ce8b262870e9294f8",
"method": "sendOrder",
"params": "Тестовая заявка, не обрабатывать!"
}
49
Ответ
[
"0",
"Ok."
]
Методы, используемые в поиске по артикулу или наименованию.
GetItemsByQuery ($q, $Exact, $Page, $Limit)
Получение позиций номенклатуры, соответствующих поисковой фразе, может искать строгое соответствие.
Для поиска используется движок Sphinx.
Входные параметры:
$q – поисковая фраза;
$Exact – точный поиск? (1 - да/0 - нет);
$Page– страница, по умолчанию 1;
$Limit– количество строк на странице, по умолчанию 20.
Результат:
массив вида:
{
total=><найдено строк>,
page=><номер страницы>,
limit=><limit>,
‘items’=> {
{
article=>'артикул',
name=>'Наименование артикула',
id=>‘id артикула’,
brand=>'бренд',
inside_id_in=>'Внутр. код'
},
...
},
‘brands’ =>
{
{Id => ‘id бренда’,
Name => ‘название бренда’
},
…
}
Пример:
Получить позиции, соответствующие поисковому запросу "TOYOTACOROLLA 120/RAV4" с учетом неточного
соответствия. Вывести 3-ю страницу, по 4 позиции на страницу.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getItemsByQuery"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
50
<SOAP-ENV:Header>
<auth_key>a9479c04e46d0049ec8cfc2d32ab5012</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetItemsByQuery>
<q xsi:type="xsd:string">TOYOTA COROLLA 120/RAV4</q>
<exact xsi:type="xsd:int">0</exact>
<page xsi:type="xsd:int">3</page>
<limit xsi:type="xsd:int">4</limit>
</ns1:GetItemsByQuery>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetItemsByQueryResponse>
<total xsi:type="xsd:int">69362</total>
<page xsi:type="xsd:int">3</page>
<limit xsi:type="xsd:int">4</limit>
<items SOAP-ENC:arrayType="ns1:ArticlesInfo[4]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">52119-13900</article>
<name xsi:type="xsd:string">Бампер TOYOTA COROLLA SPACIO 97-99</name>
<id xsi:type="xsd:string">2644</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">###21G###</inside_id_in>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">52159-13904</article>
<name xsi:type="xsd:string">Бамперзадний TOYOTA COROLLA FIELDER 00-04 5D</name>
<id xsi:type="xsd:string">2682</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">###22I###</inside_id_in>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">52159-13907</article>
<name xsi:type="xsd:string">Бамперзадний TOYOTA COROLLA HB/ALLEX/RUNX 02-04</name>
<id xsi:type="xsd:string">2683</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">###22J###</inside_id_in>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">52159-1A920</article>
<name xsi:type="xsd:string">Бампер RR TOYOTA COROLLA 120 SED 00-04</name>
<id xsi:type="xsd:string">2684</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">###22K###</inside_id_in>
</item>
</items>
</ns1:GetItemsByQueryResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "a9479c04e46d0049ec8cfc2d32ab5012",
"method": "getItemsByQuery",
"params": {
"q": "TOYOTA COROLLA 120/RAV4",
"exact": 0,
"page": 3,
"limit": 4
}
51
}
Ответ
{
"total": 69362,
"page": 3,
"limit": 4,
"items": [
{
"article": "52119-13900",
"name": "Бампер TOYOTA COROLLA SPACIO 97-99",
"id": 2644,
"brand": "TOYOTA",
"inside_id_in": "###21G###"
},
{
"article": "52159-13904",
"name": "Бамперзадний TOYOTA COROLLA FIELDER 00-04 5D",
"id": 2682,
"brand": "TOYOTA",
"inside_id_in": "###22I###"
},
{
"article": "52159-13907",
"name": "Бамперзадний TOYOTA COROLLA HB/ALLEX/RUNX 02-04",
"id": 2683,
"brand": "TOYOTA",
"inside_id_in": "###22J###"
},
{
"article": "52159-1A920",
"name": "Бампер RR TOYOTA COROLLA 120 SED 00-04",
"id": 2684,
"brand": "TOYOTA",
"inside_id_in": "###22K###"
}
]
}
Методы, используемые в поиске по списку артикулов
GetItemsByList($Items, $Page, $Limit)
Возвращает информацию о товарах, наличие на складах (исходя из суммы распакованных и
нераспакованных остатков) и цены по ним. Если сумма остатков меньше запрошенного также
возвращается остатки и цены по заменам.
Входные параметры:
$Items – массив артикулов вида [{'артикул 1'=>'количество 1',{'артикул 2'=>'количество 2',...}];
$Page – страница, по умолчанию 1;
$Limit - количество строк на странице, по умолчанию 20.
Результат:
массив вида:
{
52
total=><найдено строк>,
page=><номерстраницы>,
limit=><limit>,
items=>
{
{
id=>‘id артикула’,
article=>'артикул',
name=>'Наименование артикула',
quantity =>‘Запрошенное кол-во’
brand=>'бренд',
inside_id_in=>'Внутр. код',
photo => фото,
techinfo_exists => наличие тех. информации: Y - есть, N - нет
cross_exists => наличие аналогов: Y - есть, N - нет ,
subs_exists => наличие замен: Y - есть, N - нет ,
itemtype => тип,
stocks =>
{
{
id => ‘idсклада’,
name => ‘названиесклада’,
legend => ’Короткоеназвание’,
quantity => ‘-‘
},
...
}
/* еслисумма остатковизstocksменьшезапрошенного пользователем,
добавляем в ответ информацию по заменам */
itemSubs => {
id => ‘idартикулазамены’,
article => 'артикул замены',
name => 'Наименованиеартикула замены',
quantity =>‘рассчитанное количествопо замене’
brand => 'брендзамены',
inside_id_in=>'внутр. кодзамены',
price =>'цена',
stocks =>
{
{
id => ‘idсклада’,
name => ‘названиесклада’,
legend => ’Короткоеназвание’,
quantity => ‘-‘
},
...
}
}
},
…
}
}
Пример:
Получить информацию, остатки и цены по списку артикулов.
53
SOAP
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns2="http://xml.apache.org/xml-soap" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>29a4729eef37cebdd4413eb4cf55c64b</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetItemsByList>
<items xsi:type="ns2:Map">
<item>
<key xsi:type="xsd:string">04111-66035</key>
<value xsi:type="xsd:int">6</value>
</item>
<item>
<key xsi:type="xsd:string">04111-16155</key>
<value xsi:type="xsd:int">2</value>
</item>
<item>
<key xsi:type="xsd:string">04111-21065</key>
<value xsi:type="xsd:int">3</value>
</item>
<item>
<key xsi:type="xsd:string">04111-64285</key>
<value xsi:type="xsd:int">4</value>
</item>
<item>
<key xsi:type="xsd:string">04111-64345</key>
<value xsi:type="xsd:int">5</value>
</item>
</items>
<page xsi:type="xsd:int">1</page>
<limit xsi:type="xsd:int">2</limit>
</ns1:GetItemsByList>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetItemsByListResponse>
<total xsi:type="xsd:int">5</total>
<page xsi:type="xsd:int">1</page>
<limit xsi:type="xsd:int">2</limit>
<items SOAP-ENC:arrayType="ns1:ArticlesInfo[2]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">04111-16155</article>
<name xsi:type="xsd:string">Ремкомплект двигателя TOYOTA CARIB,COROLLA 4AF# 88-92</name>
<id xsi:type="xsd:string">57530</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">##18E2###</inside_id_in>
<quantity xsi:type="xsd:string">2</quantity>
<photo xsi:type="xsd:string"/>
54
<techinfo_exists xsi:type="xsd:string">Y</techinfo_exists>
<cross_exists xsi:type="xsd:string">N</cross_exists>
<subs_exists xsi:type="xsd:string">N</subs_exists>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">04111-21065</article>
<name xsi:type="xsd:string">Ремкомплект двигателя TOYOTA SUCCEED, PROBOX 1-2NZFE 02-</name>
<id xsi:type="xsd:string">69940</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">##1HYS###</inside_id_in>
<quantity xsi:type="xsd:string">3</quantity>
<photo xsi:type="xsd:string"/>
<techinfo_exists xsi:type="xsd:string">Y</techinfo_exists>
<cross_exists xsi:type="xsd:string">N</cross_exists>
<subs_exists xsi:type="xsd:string">Y</subs_exists>
<itemsSubs SOAP-ENC:arrayType="ns1:ArticlesInfo[4]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">04111-21062</article>
<name xsi:type="xsd:string">Комплект прокладок для двигателя</name>
<id xsi:type="xsd:string">121955101</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">##2M3N101</inside_id_in>
<quantity xsi:type="xsd:string">1</quantity>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">04111-21064</article>
<name xsi:type="xsd:string">Ремкомплект двигателя TOYOTA SUCCEED, PROBOX 1-2NZFE 02-</name>
<id xsi:type="xsd:string">37637</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">###T1H###</inside_id_in>
<quantity xsi:type="xsd:string">1</quantity>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
55
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">04111-21069</article>
<name xsi:type="xsd:string">Ремкомплект двигателя TOYOTA SUCCEED, PROBOX 1-2NZFE 02-</name>
<id xsi:type="xsd:string">105639</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">##29IF###</inside_id_in>
<quantity xsi:type="xsd:string">1</quantity>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">04111-21350</article>
<name xsi:type="xsd:string">Ремкомплект двигателя TOYOTA SUCCEED, PROBOX 1-2NZFE 02-</name>
<id xsi:type="xsd:string">119941101</id>
<brand xsi:type="xsd:string">TOYOTA</brand>
<inside_id_in xsi:type="xsd:string">##2KJP101</inside_id_in>
<quantity xsi:type="xsd:string">1</quantity>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">+</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">+</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
</itemsSubs>
<stocks SOAP-ENC:arrayType="ns1:StorageAmount[2]" xsi:type="ns1:ArrayOfStorageAmount">
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">1</id>
<name xsi:type="xsd:string">Иркутск (Ракитная)</name>
<legend xsi:type="xsd:string">И(Р)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
<item xsi:type="ns1:StorageAmount">
<id xsi:type="xsd:string">9</id>
<name xsi:type="xsd:string">Иркутск (Автоград)</name>
<legend xsi:type="xsd:string">И(А)</legend>
<quantity_unpacked xsi:type="xsd:string">-</quantity_unpacked>
<quantity_packed xsi:type="xsd:string">-</quantity_packed>
</item>
</stocks>
</item>
</items>
</ns1:GetItemsByListResponse>
56
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "29a4729eef37cebdd4413eb4cf55c64b",
"method": "getItemsByList",
"params": {
"Items": {
"04111-0C105": 1,
"04111-16155": 2,
"04111-21065": 3,
"04111-64285": 4,
"04111-64345": 5,
"04111-66035": 6
},
"page": 1,
"limit": 20
}
}
Ответ
{
"total": 6,
"page": 1,
"limit": 20,
"items": {
"04111-0C105": {
"article": "04111-0C105",
"name": "Ремкомплект двигателя TOYOTA 2TRFE 05-",
"id": 115722101,
"brand": "TOYOTA",
"inside_id_in": "##2HAI101",
"quantity": "1",
"photo": "",
"techinfo_exists": "Y",
"cross_exists": "N",
"subs_exists": "Y",
"itemtype": "original",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "+",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
}
},
"04111-16155": {
"article": "04111-16155",
"name": "Ремкомплект двигателя TOYOTA CARIB,COROLLA 4AF# 88-92",
"id": 57530,
"brand": "TOYOTA",
"inside_id_in": "##18E2###",
"quantity": "2",
"photo": "",
"techinfo_exists": "Y",
"cross_exists": "N",
"subs_exists": "N",
"itemtype": "original",
"stocks": {
57
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "-",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
}
},
"04111-21065": {
"article": "04111-21065",
"name": "Ремкомплект двигателя TOYOTA SUCCEED, PROBOX 1-2NZFE 02-",
"id": 69940,
"brand": "TOYOTA",
"inside_id_in": "##1HYS###",
"quantity": "3",
"photo": "",
"techinfo_exists": "Y",
"cross_exists": "N",
"subs_exists": "Y",
"itemtype": "replace",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "-",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
},
"itemsSubs": {
"04111-21062": {
"article": "04111-21062",
"name": "Комплект прокладок для двигателя",
"id": "121955101",
"brand": "TOYOTA",
"inside_id_in": "##2M3N101",
"quantity": 1,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "-",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
}
},
"04111-21064": {
"article": "04111-21064",
"name": "Ремкомплект двигателя TOYOTA SUCCEED, PROBOX 1-2NZFE 02-",
"id": "37637",
"brand": "TOYOTA",
58
"inside_id_in": "###T1H###",
"quantity": 1,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "-",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
}
},
"04111-21069": {
"article": "04111-21069",
"name": "Ремкомплект двигателя TOYOTA SUCCEED, PROBOX 1-2NZFE 02-",
"id": "105639",
"brand": "TOYOTA",
"inside_id_in": "##29IF###",
"quantity": 1,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "-",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "-",
"quantity_packed": "-"
}
}
},
"04111-21350": {
"article": "04111-21350",
"name": "Ремкомплект двигателя TOYOTA SUCCEED, PROBOX 1-2NZFE 02-",
"id": "119941101",
"brand": "TOYOTA",
"inside_id_in": "##2KJP101",
"quantity": 1,
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "+",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "+",
"quantity_packed": "-"
}
}
}
}
},
"04111-64285": {
"article": "04111-64285",
"name": "Ремкомплект двигателя TOYOTA CALDINA CT190,21# 2С,3С",
"id": 9984,
"brand": "TOYOTA",
59
"inside_id_in": "###7PC###",
"quantity": "4",
"photo": "",
"techinfo_exists": "Y",
"cross_exists": "N",
"subs_exists": "N",
"itemtype": "original",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "2",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "1",
"quantity_packed": "-"
}
}
},
"04111-64345": {
"article": "04111-64345",
"name": "Ремкомплект двигателя TOYOTA TOWNACE 2C-T",
"id": 8793,
"brand": "TOYOTA",
"inside_id_in": "###6S9###",
"quantity": "5",
"photo": "",
"techinfo_exists": "Y",
"cross_exists": "N",
"subs_exists": "N",
"itemtype": "original",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "1",
"quantity_packed": "-"
},
"9": {
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "1",
"quantity_packed": "-"
}
}
},
"04111-66035": {
"article": "04111-66035",
"name": "Ремкомплект двигателя TOYOTA LAND CRUISER 80 1FZFE 92-98",
"id": 8040,
"brand": "TOYOTA",
"inside_id_in": "###67C###",
"quantity": "6",
"photo": "",
"techinfo_exists": "Y",
"cross_exists": "N",
"subs_exists": "N",
"itemtype": "original",
"stocks": {
"1": {
"id": "1",
"name": "Иркутск (Ракитная)",
"legend": "И(Р)",
"quantity_unpacked": "1",
"quantity_packed": "-"
},
"9": {
60
"id": "9",
"name": "Иркутск (Автоград)",
"legend": "И(А)",
"quantity_unpacked": "2",
"quantity_packed": "-"
}
}
}
}
}
Методы, используемые в поиске по каталогам.
GetCatalogsList($Filter)
Получение списка доступных каталогов, с возможностью задать фильтр.
Входные параметры:
$Filter – строка для поиска по наименованию каталога.
Результат:
массив вида:
{
{id=>‘id каталога’,name=>'Наименование каталога',parent_id=>null,parent_name=>''},
...
}
Пример:
Получить список доступных каталогов, содержащих в наименовании строку “грм”.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getCatalogsList"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>a9479c04e46d0049ec8cfc2d32ab5012</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetCatalogsList>
<filter xsi:type="xsd:string">грм</filter>
</ns1:GetCatalogsList>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
61
<ns1:GetCatalogsListResponse>
<items SOAP-ENC:arrayType="ns1:Catalogs[2]" xsi:type="ns1:ArrayOfCatalogs">
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">32</id>
<name xsi:type="xsd:string">Прайс-каталогцепиГРМ</name>
<parent_id xsi:nil="true"/>
<parent_name xsi:type="xsd:string"/>
</item>
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">26</id>
<name xsi:type="xsd:string">Прайс-каталогГРМ</name>
<parent_id xsi:nil="true"/>
<parent_name xsi:type="xsd:string"/>
</item>
</items>
</ns1:GetCatalogsListResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "a9479c04e46d0049ec8cfc2d32ab5012",
"method": "getCatalogsList",
"params": "грм"
}
Ответ
[
{
"id": "32",
"name": "Прайс-каталогцепиГРМ",
"parent_id": null,
"parent_name": ""
},
{
"id": "26",
"name": "Прайс-каталог ГРМ",
"parent_id": null,
"parent_name": ""
}
]
GetSectionsList($CatalogId, $Filter)
Получение списка разделов по выбранному каталогу, с возможностью задать фильтр.
Входные параметры:
$CatalogId–id каталога;
$Filter – строка для поиска по наименованиюраздела.
Результат:
массив вида:
{
{id=>'id раздела’,name=>'Наименование раздела',parent_id=>'id каталога',parent_name=>'Наименование каталога'},
...
}
Пример:
Получить список разделов каталога с id=36, содержащих в наименовании строку “dai”.
62
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getSectionsList"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>a9479c04e46d0049ec8cfc2d32ab5012</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetSectionsList>
<catalog_id xsi:type="xsd:int">36</catalog_id>
<filter xsi:type="xsd:string">dai</filter>
</ns1:GetSectionsList>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetSectionsListResponse>
<items SOAP-ENC:arrayType="ns1:Catalogs[2]" xsi:type="ns1:ArrayOfCatalogs">
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">33</id>
<name xsi:type="xsd:string">DAIHATSU</name>
<parent_id xsi:type="xsd:int">36</parent_id>
<parent_name xsi:type="xsd:string">Автостекло (лобовые, боковые, задние)</parent_name>
</item>
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">32</id>
<name xsi:type="xsd:string">HYUNDAI</name>
<parent_id xsi:type="xsd:int">36</parent_id>
<parent_name xsi:type="xsd:string">Автостекло (лобовые, боковые, задние)</parent_name>
</item>
</items>
</ns1:GetSectionsListResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "a9479c04e46d0049ec8cfc2d32ab5012",
"method": "getSectionsList",
"params": {
"catalog_id": 36,
"filter": "dai"
}
}
Ответ
[
{
"id": "33",
63
"name": "DAIHATSU",
"parent_id": "36",
"parent_name": "Автостекло (лобовые, боковые, задние)"
},
{
"id": "32",
"name": "HYUNDAI",
"parent_id": "36",
"parent_name": "Автостекло (лобовые, боковые, задние)"
}
]
GetSubSectionsList($CatalogId, $SectionId, $Filter)
Получение списка подразделов по выбранным каталогу и разделу, с возможностью задать фильтр.
Входные параметры:
$CatalogId–id каталога;
$SectionId– id раздела;
$Filter – строка для поиска по наименованию.
Результат:
массив вида:
{
{id=>‘idподраздела’,
name=>'Наименованиеподраздела',
parent_id=>'idраздела',
parent_name=>'Наименованиераздела'},
...
}
Пример:
Получить список подразделов раздела 8 каталога 36 , содержащих в наименовании строку “a6”.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getSubSectionsList"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>a9479c04e46d0049ec8cfc2d32ab5012</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetSubSectionsList>
<catalog_id xsi:type="xsd:int">36</catalog_id>
<section_id xsi:type="xsd:int">8</section_id>
<filter xsi:type="xsd:string">a6</filter>
</ns1:GetSubSectionsList>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
64
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetSubSectionsListResponse>
<items SOAP-ENC:arrayType="ns1:Catalogs[8]" xsi:type="ns1:ArrayOfCatalogs">
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">6163</id>
<name xsi:type="xsd:string">AUDI 100/A6 90-97 4D</name>
<parent_id xsi:type="xsd:int">8</parent_id>
<parent_name xsi:type="xsd:string">AUDI</parent_name>
</item>
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">6164</id>
<name xsi:type="xsd:string">AUDI 100/A6 90-97 5D</name>
<parent_id xsi:type="xsd:int">8</parent_id>
<parent_name xsi:type="xsd:string">AUDI</parent_name>
</item>
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">6180</id>
<name xsi:type="xsd:string">AUDI A6/S6 97-04 4D</name>
<parent_id xsi:type="xsd:int">8</parent_id>
<parent_name xsi:type="xsd:string">AUDI</parent_name>
</item>
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">6181</id>
<name xsi:type="xsd:string">AUDI A6/S6 97-04 5D</name>
<parent_id xsi:type="xsd:int">8</parent_id>
<parent_name xsi:type="xsd:string">AUDI</parent_name>
</item>
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">6182</id>
<name xsi:type="xsd:string">AUDI A6/S6 04-11 4D</name>
<parent_id xsi:type="xsd:int">8</parent_id>
<parent_name xsi:type="xsd:string">AUDI</parent_name>
</item>
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">6183</id>
<name xsi:type="xsd:string">AUDI A6/S6 04-11 5D</name>
<parent_id xsi:type="xsd:int">8</parent_id>
<parent_name xsi:type="xsd:string">AUDI</parent_name>
</item>
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">11896101</id>
<name xsi:type="xsd:string">AUDI A6/S6 11- 4D</name>
<parent_id xsi:type="xsd:int">8</parent_id>
<parent_name xsi:type="xsd:string">AUDI</parent_name>
</item>
<item xsi:type="ns1:Catalogs">
<id xsi:type="xsd:int">11897101</id>
<name xsi:type="xsd:string">AUDI A6/S6 11- 5D</name>
<parent_id xsi:type="xsd:int">8</parent_id>
<parent_name xsi:type="xsd:string">AUDI</parent_name>
</item>
</items>
</ns1:GetSubSectionsListResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "a9479c04e46d0049ec8cfc2d32ab5012",
"method": "getSubSectionsList",
"params": {
"catalog_id": 36,
"section_id": 8,
"filter": "a6"
}
}
65
Ответ
[
{
"id": "6163",
"name": "AUDI 100/A6 90-97 4D",
"parent_id": "8",
"parent_name": "AUDI"
},
{
"id": "6164",
"name": "AUDI 100/A6 90-97 5D",
"parent_id": "8",
"parent_name": "AUDI"
},
{
"id": "6180",
"name": "AUDI A6/S6 97-04 4D",
"parent_id": "8",
"parent_name": "AUDI"
},
{
"id": "6181",
"name": "AUDI A6/S6 97-04 5D",
"parent_id": "8",
"parent_name": "AUDI"
},
{
"id": "6182",
"name": "AUDI A6/S6 04-11 4D",
"parent_id": "8",
"parent_name": "AUDI"
},
{
"id": "6183",
"name": "AUDI A6/S6 04-11 5D",
"parent_id": "8",
"parent_name": "AUDI"
},
{
"id": "11896101",
"name": "AUDI A6/S6 11- 4D",
"parent_id": "8",
"parent_name": "AUDI"
},
{
"id": "11897101",
"name": "AUDI A6/S6 11- 5D",
"parent_id": "8",
"parent_name": "AUDI"
}
]
GetItemsByCatalog ($CatalogId, $SectionId, $SubSectionIds, $Brand [, $Page][,
$Limit])
Получение списка товаров, соответствующего заданному каталогу, разделу и массиву подразделов.
Входные параметры:
$CatalogId– id каталога;
$SectionId– id раздела;
$SubSectionIds– массив id подразделов;
$Brand - фильтровать результат по коду производителя, если пустая строка - то возвращается весь набор;
$Page – страница, по умолчанию 1;
$Limit – количество строк на странице, по умолчанию 20.
66
Результат:
массив вида:
{
total=><найдено строк>,
page=><номерстраницы>,
limit=><limit>,
items=>{
{
article=>'артикул',
name=>'Наименованиеартикула',
id=>‘idартикула’,
brand=>'бренд',
inside_id_in=>'Внутр. код',
cat_id =>id каталога,
cat_name => название каталога,
manufacturer_id =>id производителя,
manufacturer_name => название производителя,
model_id =>id модели,
model_name => название модели
photo => ссылка на фото ,
techinfo_exists => наличие технической информации: Y – есть, N - нет,
part_type : вид запчасти,
techinfo_list => техническая информация вида
{
key => название свойства,
value => значение свойства,
alt => альтернативное название свойства,
val_alt => альтернативное название значения свойства
}
….
},
...
}
}
Пример:
Получение списка товаров, соответствующего каталогу 36, разделу 3, подразделам 366, 817,250, страница 1,
по 20 позиций на странице.
SOAP
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>29a4729eef37cebdd4413eb4cf55c64b</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetItemsByCatalog>
<catalog_id xsi:type="xsd:int">36</catalog_id>
<section_id xsi:type="xsd:int">3</section_id>
<subsection_ids SOAP-ENC:arrayType="xsd:int[2]" xsi:type="ns1:ArrayOfInteger">
<item xsi:type="xsd:int">366</item>
<item xsi:type="xsd:int">817</item>
<item xsi:type="xsd:int">250</item>
</subsection_ids>
<brand xsi:type="xsd:string"></brand>
<page xsi:type="xsd:int">1</page>
67
<limit xsi:type="xsd:int">20</limit>
</ns1:GetItemsByCatalog>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetItemsByCatalogResponse>
<total xsi:type="xsd:int">21</total>
<page xsi:type="xsd:int">1</page>
<limit xsi:type="xsd:int">20</limit>
<brands SOAP-ENC:arrayType="xsd:string[2]" xsi:type="SOAP-ENC:Array">
<item xsi:type="xsd:string">SAT</item>
<item xsi:type="xsd:string">XYG</item>
</brands>
<items SOAP-ENC:arrayType="ns1:ArticlesInfo[19]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">TD-31</article>
<name xsi:nil="true"/>
<id xsi:type="xsd:string">45441</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">###Z29###</inside_id_in>
<cat_id xsi:type="xsd:string">36</cat_id>
<cat_name xsi:type="xsd:string">Автостекло (лобовые, боковые, задние)</cat_name>
<section_id xsi:type="xsd:string">220101</section_id>
<section_name xsi:type="xsd:string">Молдинг</section_name>
<manufacturer_id xsi:type="xsd:string">3</manufacturer_id>
<manufacturer_name xsi:type="xsd:string">TOYOTA</manufacturer_name>
<model_id xsi:type="xsd:string">366</model_id>
<model_name xsi:type="xsd:string">TOYOTA ALLION #ZT24# 01-07</model_name>
<photo xsi:type="xsd:string"/>
<techinfo_exists xsi:type="xsd:string">Y</techinfo_exists>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">NZT260 RQ/RH</article>
<name xsi:nil="true"/>
<id xsi:type="xsd:string">37106</id>
<brand xsi:type="xsd:string">XYG</brand>
<inside_id_in xsi:type="xsd:string">###SMQ###</inside_id_in>
<cat_id xsi:type="xsd:string">36</cat_id>
<cat_name xsi:type="xsd:string">Автостекло (лобовые, боковые, задние)</cat_name>
<section_id xsi:type="xsd:string">3</section_id>
<section_name xsi:type="xsd:string">Стекло форточки</section_name>
<manufacturer_id xsi:type="xsd:string">3</manufacturer_id>
<manufacturer_name xsi:type="xsd:string">TOYOTA</manufacturer_name>
<model_id xsi:type="xsd:string">817</model_id>
<model_name xsi:type="xsd:string">TOYOTA ALLION #ZT26# 07-</model_name>
<photo xsi:type="xsd:string"/>
<techinfo_exists xsi:type="xsd:string">N</techinfo_exists>
</item>
</items>
</ns1:GetItemsByCatalogResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "29a4729eef37cebdd4413eb4cf55c64b",
"method": "getItemsByCatalog",
"params": {
"catalog_id": 36,
"section_id": 3,
"subsection_ids": [
366,
68
817,
250
],
"brand": "",
"page": 1,
"limit": 20
}
Ответ
{
"total": "21",
"page": 1,
"limit": 20,
"brands": [
"SAT",
"XYG"
],
"items": {
"TD-31": {
"article": "TD-31",
"id": "45441",
"brand": "SAT",
"inside_id_in": "###Z29###",
"cat_id": "36",
"cat_name": "Автостекло (лобовые, боковые, задние)",
"section_id": "220101",
"section_name": "Молдинг",
"manufacturer_id": "3",
"manufacturer_name": "TOYOTA",
"model_id": "366",
"model_name": "TOYOTA ALLION #ZT24# 01-07",
"photo": "",
"techinfo_exists": "Y",
"part_type": "Молдинг",
"techinfo_list": ""
},
"ZZT240 LFW/X": {
"article": "ZZT240 LFW/X",
"id": "17380",
"brand": "XYG",
"inside_id_in": "###DES###",
"cat_id": "36",
"cat_name": "Автостекло (лобовые, боковые, задние)",
"section_id": "1",
"section_name": "Стекло лобовое",
"manufacturer_id": "3",
"manufacturer_name": "TOYOTA",
"model_id": "366",
"model_name": "TOYOTA ALLION #ZT24# 01-07",
"photo": "http://autotrade.su/pic.php?code=%23%23%23DES%23%23%23&state=1&size=800.679",
"techinfo_exists": "N",
"part_type": "Стекло лобовое в клей",
"techinfo_list": [
{
"key": "Цвет стекла",
"value": "GN",
"alt": "",
"val_alt": "зеленый"
},
{
"key": "Цвет полосы",
"value": "BL",
"alt": "",
"val_alt": "синий"
},
{
"key": "Молдинг",
"value": "",
"alt": "",
"val_alt": ""
},
{
69
"key": "VIN",
"value": "",
"alt": "Окно под VIN номер",
"val_alt": ""
},
{
"key": "Козырек",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Обогрев щеток",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Полный обогрев",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Антенна",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Датчик света",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Д.Д. (фото)",
"value": "",
"alt": "Датчик дождя",
"val_alt": ""
},
{
"key": "Место под пятак (фото)",
"value": "",
"alt": "Место под пятак",
"val_alt": ""
},
{
"key": "Руль",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Ширина",
"value": "1425",
"alt": "",
"val_alt": "1425"
},
{
"key": "Высота",
"value": "935",
"alt": "",
"val_alt": "935"
},
{
"key": "Диагональ",
"value": "",
"alt": "",
"val_alt": ""
},
{
"key": "Камера",
"value": "",
70
"alt": "Место под камеру",
"val_alt": ""
}
]
}
Методы, используемые в поиске по техническим параметрам.
GetPartsTypesList($Filter)
Получение списка типов запасной части.
Входные параметры:
$Filter – строка для поиска по наименованию свойства.
Результат:
массив вида:
{
{key=>‘id типа’,
value=>'Наименование типа'},
...
}
Пример:
Получить список типов запасной части, в наименовании которых содержится буква “р”.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getPartsTypesList"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>6f87036ad47e5dba20c483d58f351957</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetPartsTypesList>
<filter xsi:type="xsd:string">р</filter>
</ns1:GetPartsTypesList>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetPartsTypesListResponse>
<return SOAP-ENC:arrayType="ns1:PropertyInfo[3]" xsi:type="ns1:ArrayOfProperties">
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">3</key>
71
<value xsi:type="xsd:string">ШРУС</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">4</key>
<value xsi:type="xsd:string">Радиаторы</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">8</key>
<value xsi:type="xsd:string">Крестовины</value>
</item>
</return>
</ns1:GetPartsTypesListResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "6f87036ad47e5dba20c483d58f351957",
"method": "getPartsTypesList",
"params": "р"
}
Ответ
[
{
"key": "3",
"value": "ШРУС"
},
{
"key": "4",
"value": "Радиаторы"
},
{
"key": "8",
"value": "Крестовины"
}
]
GetShablonByPartsType($PartsTypeID)
Получение шаблона технической информации по заданному типу запасной части.
Входные параметры:
$PartsTypeID –код типа запасной части.
Результат:
массив вида:
{
{
},
...
}
Пример:
id=>’id тех. параметра’,
name=>’Наименованиетех. параметра’,
typeti=>’тип значения: число, строка или список’,
valti=>’значение, если тип "число" или "строка"’,
listti=>’значение, если тип "список"’
72
Получение шаблона технической информации для типа запасной части = 4.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getShablonByPartsType"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>6f87036ad47e5dba20c483d58f351957</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetShablonByPartsType>
<parts_type_id xsi:type="xsd:int">4</parts_type_id>
</ns1:GetShablonByPartsType>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetShablonByPartsTypeResponse>
<return SOAP-ENC:arrayType="ns1:Shablon[9]" xsi:type="ns1:ArrayOfShablon">
<item xsi:type="ns1:Shablon">
<id xsi:type="xsd:int">25</id>
<name xsi:type="xsd:string">Материалбачка</name>
<typeti xsi:type="xsd:string">Список</typeti>
<valti xsi:nil="true"/>
<listti xsi:type="xsd:string">"PL","AL","BR"</listti>
</item>
<item xsi:type="ns1:Shablon">
<id xsi:type="xsd:int">26</id>
<name xsi:type="xsd:string">Материалсердцевины</name>
<typeti xsi:type="xsd:string">Список</typeti>
<valti xsi:nil="true"/>
<listti xsi:type="xsd:string">"AL","CP"</listti>
</item>
<item xsi:type="ns1:Shablon">
<id xsi:type="xsd:int">27</id>
<name xsi:type="xsd:string">Трансмиссия</name>
<typeti xsi:type="xsd:string">Список</typeti>
<valti xsi:nil="true"/>
<listti xsi:type="xsd:string">"A/T","M/T","A/M"</listti>
</item>
<item xsi:type="ns1:Shablon">
<id xsi:type="xsd:int">28</id>
<name xsi:type="xsd:string">Ширина</name>
<typeti xsi:type="xsd:string">Число</typeti>
<valti xsi:nil="true"/>
<listti xsi:nil="true"/>
</item>
<item xsi:type="ns1:Shablon">
<id xsi:type="xsd:int">29</id>
<name xsi:type="xsd:string">Высота</name>
<typeti xsi:type="xsd:string">Число</typeti>
<valti xsi:nil="true"/>
<listti xsi:nil="true"/>
73
</item>
<item xsi:type="ns1:Shablon">
<id xsi:type="xsd:int">30</id>
<name xsi:type="xsd:string">Толщина</name>
<typeti xsi:type="xsd:string">Число</typeti>
<valti xsi:nil="true"/>
<listti xsi:nil="true"/>
</item>
<item xsi:type="ns1:Shablon">
<id xsi:type="xsd:int">31</id>
<name xsi:type="xsd:string">Видохл. поверхности</name>
<typeti xsi:type="xsd:string">Список</typeti>
<valti xsi:nil="true"/>
<listti xsi:type="xsd:string">"TR","LR"</listti>
</item>
<item xsi:type="ns1:Shablon">
<id xsi:type="xsd:int">32</id>
<name xsi:type="xsd:string">Дополнительныхпатрубков</name>
<typeti xsi:type="xsd:string">Список</typeti>
<valti xsi:nil="true"/>
<listti xsi:type="xsd:string">"0","1","2"</listti>
</item>
<item xsi:type="ns1:Shablon">
<id xsi:type="xsd:int">38</id>
<name xsi:type="xsd:string">Кондиционер</name>
<typeti xsi:type="xsd:string">Список</typeti>
<valti xsi:nil="true"/>
<listti xsi:type="xsd:string">"W", "WO", "UNI"</listti>
</item>
</return>
</ns1:GetShablonByPartsTypeResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "6f87036ad47e5dba20c483d58f351957",
"method": "getShablonByPartsType",
"params": 4
}
Ответ
[
{
"id": "25",
"name": "Материалбачка",
"typeti": "Список",
"valti": null,
"listti": "\"PL\",\"AL\",\"BR\""
},
{
"id": "26",
"name": "Материалсердцевины",
"typeti": "Список",
"valti": null,
"listti": "\"AL\",\"CP\""
},
{
"id": "27",
"name": "Трансмиссия",
"typeti": "Список",
"valti": null,
"listti": "\"A/T\",\"M/T\",\"A/M\""
},
{
"id": "28",
"name": "Ширина",
"typeti": "Число",
"valti": null,
74
"listti": null
},
{
"id": "29",
"name": "Высота",
"typeti": "Число",
"valti": null,
"listti": null
},
{
"id": "30",
"name": "Толщина",
"typeti": "Число",
"valti": null,
"listti": null
},
{
"id": "31",
"name": "Вид охл. поверхности",
"typeti": "Список",
"valti": null,
"listti": "\"TR\",\"LR\""
},
{
"id": "32",
"name": "Дополнительных патрубков",
"typeti": "Список",
"valti": null,
"listti": "\"0\",\"1\",\"2\""
},
{
"id": "38",
"name": "Кондиционер",
"typeti": "Список",
"valti": null,
"listti": "\"W\", \"WO\", \"UNI\""
}
]
GetItemsByPartsType($PartsTypeID, $TechInfoStr[, $Page][, $Limit])
Получение спискатоваров, соответствующего заданному типу запасной части.
Входные параметры:
$PartsTypeID– код типа запасной части;
$TechInfoStr– строка технической информации, например '%,%,A/M,%,%,%,LR,2,%';
$Page– страница, по умолчанию 1;
$Limit– количество строк на странице,по умолчанию 20.
Результат:
массив вида:
{
total=><найдено строк>,page=><номер страницы>,limit=><limit>,
‘items’=>
{
{
article=>'артикул',
name=>'Наименованиеартикула',
id=>‘idартикула’,
brand=>'бренд',
inside_id_in=>'Внутр. код'
photo => ‘ссылка на фото’,
techinfo_exists => наличие тех. информации: «Y» - есть, «N» - нет,
cross_exists =>наличие аналогов: «Y» - есть, «N» - нет ",
75
subs_exists => наличие замен: «Y» - есть, «N» - нет ",
},
...
}
}
Пример:
Получение списка товаров, соответствующего типу запасной части 3 и строке тех. информации "32,28",
страница 2, по 3 позиции на странице.
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getItemsByPartsType"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>6f87036ad47e5dba20c483d58f351957</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetItemsByPartsType>
<parts_type_id xsi:type="xsd:int">3</parts_type_id>
<tech_info_str xsi:type="xsd:string">32,,28</tech_info_str>
<page xsi:type="xsd:int">2</page>
<limit xsi:type="xsd:int">3</limit>
</ns1:GetItemsByPartsType>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetItemsByPartsTypeResponse>
<total xsi:type="xsd:int">9</total>
<page xsi:type="xsd:int">2</page>
<limit xsi:type="xsd:int">3</limit>
<items SOAP-ENC:arrayType="ns1:ArticlesInfo[3]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">HO-038A</article>
<name xsi:type="xsd:string">Шрус HONDA Inspire/Saber UA1/2/Odyssey RA1-9/Step Wagon RF1/S-MX F22B/H22A/G2#A/B20B 96-03</name>
<id xsi:type="xsd:string">19921</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">###FDD###</inside_id_in>
</item>
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">HO-038</article>
<name xsi:type="xsd:string">Шрус HONDA Inspire/Saber UA1/2/Odyssey RA1-9/Step Wagon RF1/S-MX F22B/H22A/G2#A/B20B 96-03</name>
<id xsi:type="xsd:string">19922</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">###FDE###</inside_id_in>
</item>
<item xsi:type="ns1:ArticlesInfo">
76
<article xsi:type="xsd:string">HO-29</article>
<name xsi:type="xsd:string">Шрус HONDA Inspire/Saber UA1/2/Odyssey RA1/9/Step Wagon RF1/S-MX F22B/H22A/G20A/G25A/B20B 96-03
ABS</name>
<id xsi:type="xsd:string">20077</id>
<brand xsi:type="xsd:string">SAT</brand>
<inside_id_in xsi:type="xsd:string">###FHP###</inside_id_in>
</item>
</items>
</ns1:GetItemsByPartsTypeResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "6f87036ad47e5dba20c483d58f351957",
"method": "getItemsByPartsType",
"params": {
"parts_type_id": 3,
"tech_info_str": "32,,28",
"page": 2,
"limit": 3
}
}
Ответ
{
"total": 9,
"page": 2,
"limit": 3,
"items": [
{
"article": "HO-038A",
"name": "Шрус HONDA Inspire/Saber UA1/2/Odyssey RA1-9/Step Wagon RF1/S-MX F22B/H22A/G2#A/B20B 96-03",
"id": 19921,
"brand": "SAT",
"inside_id_in": "###FDD###",
"photo": "",
"techinfo_exists": "N",
"cross_exists": "N",
"subs_exists": "Y"
},
{
"article": "HO-038",
"name": "Шрус HONDA Inspire/Saber UA1/2/Odyssey RA1-9/Step Wagon RF1/S-MX F22B/H22A/G2#A/B20B 96-03",
"id": 19922,
"brand": "SAT",
"inside_id_in": "###FDE###",
"photo": "",
"techinfo_exists": "N",
"cross_exists": "N",
"subs_exists": "Y"
}
]
}
Методы, используемые в поиске по кросс-номерам.
GetCrossTypesList($Filter)
Получение списка видовсвойств (кросс-номеров).
Входные параметры:
$Filter – строка для поиска по наименованию свойства.
77
Результат:
массив вида:
{
{key=>‘id свойства’,
value=>'Наименование свойства'},
...
}
Пример:
Получить список видов свойств (кросс-номеров), содержащих в наименовании строку "евро".
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getCrossTypesList"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>6f87036ad47e5dba20c483d58f351957</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetCrossTypesList>
<filter xsi:type="xsd:string">евро</filter>
</ns1:GetCrossTypesList>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetCrossTypesListResponse>
<return SOAP-ENC:arrayType="ns1:PropertyInfo[2]" xsi:type="ns1:ArrayOfProperties">
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">13</key>
<value xsi:type="xsd:string">Еврокод</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">48</key>
<value xsi:type="xsd:string">Еврокодкороткий</value>
</item>
</return>
</ns1:GetCrossTypesListResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "6f87036ad47e5dba20c483d58f351957",
"method": "getCrossTypesList",
"params": "евро"
78
}
Ответ
[
{
"key": "13",
"value": "Еврокод"
},
{
"key": "48",
"value": "Евро код короткий"
}
]
GetCrossValues($PropertyID, $Filter)
Получение значений, соответствующих заданному виду свойства (кросс-номера), с возможностью
фильтрации.
Входные параметры:
$PropertyID– idсвойства (кросс-номера);
$Filter – строка для поиска по наименованию свойства.
Результат:
массив вида:
{
{key=>‘id значения свойства’,
value=>'Значение свойства'},
...
}
Пример:
Получить значения, соответствующие виду свойства (кросс-номера) 13, содержащие в наименовании строку
"2726l".
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getCrossValues"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>910c29400ebfed8c3baab935f3456f49</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetCrossValues>
<property_id xsi:type="xsd:int">13</property_id>
<filter xsi:type="xsd:string">2726l</filter>
</ns1:GetCrossValues>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ответ
79
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetCrossValuesResponse>
<return SOAP-ENC:arrayType="ns1:PropertyInfo[4]" xsi:type="ns1:ArrayOfProperties">
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">6863</key>
<value xsi:type="xsd:string">2726LGSH5FD</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">6865</key>
<value xsi:type="xsd:string">2726LGSH5FV</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">6867</key>
<value xsi:type="xsd:string">2726LGSH5RD</value>
</item>
<item xsi:type="ns1:PropertyInfo">
<key xsi:type="xsd:string">6869</key>
<value xsi:type="xsd:string">2726LGSH5RQ</value>
</item>
</return>
</ns1:GetCrossValuesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "910c29400ebfed8c3baab935f3456f49",
"method": "getCrossValues",
"params": {
"property_id": 13,
"filter": "2726l"
}
}
Ответ
[
{
"key": "6863",
"value": "2726LGSH5FD"
},
{
"key": "6865",
"value": "2726LGSH5FV"
},
{
"key": "6867",
"value": "2726LGSH5RD"
},
{
"key": "6869",
"value": "2726LGSH5RQ"
}
]
GetItemsByCrossValue($Value, $PropertyID, $Page, $Limit)
80
Получение списка товаров, соответствующего заданному типу запасной части.
Входные параметры:
$Value– значениекросс-номера;
$PropertyID– idсвойства (кросс-номера);
$Page – страница, по умолчанию 1;
$Limit – лимит выборки, по умолчанию 20.
Результат:
массив вида:
{
total=><найдено строк>,
page=><номерстраницы>,
limit=><limit>,
‘items’=>
{
{
article=>'артикул',
name=>'Наименование артикула',
id=>‘idартикула’,
brand=>'бренд',
inside_id_in=>'Внутр. код'
photo => ‘ссылка на фото’,
techinfo_exists => наличие тех. информации: «Y» - есть, «N» - нет,
cross_exists =>наличие аналогов: «Y» - есть, «N» - нет ",
subs_exists => наличие замен: «Y» - есть, «N» - нет ",
},
...
}
}
Пример:
Получить список товаров для idсвойства (кросс-номера) = 13, значения кросс-номера "1836AGNBL".
SOAP
Запрос
POST /?soapHTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "API#getItemsByCrossValue"
Host: api2.autotrade.su
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<auth_key>910c29400ebfed8c3baab935f3456f49</auth_key>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<ns1:GetItemsByCrossValue>
<value xsi:type="xsd:string">1836AGNBL</value>
<property_id xsi:type="xsd:int">13</property_id>
<page xsi:nil="true"/>
<limit xsi:nil="true"/>
</ns1:GetItemsByCrossValue>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
81
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="API"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetItemsByCrossValueResponse>
<total xsi:type="xsd:int">1</total>
<page xsi:type="xsd:int">1</page>
<limit xsi:type="xsd:int">20</limit>
<items SOAP-ENC:arrayType="ns1:ArticlesInfo[1]" xsi:type="ns1:ArrayOfArticlesInfo">
<item xsi:type="ns1:ArticlesInfo">
<article xsi:type="xsd:string">DA7 LFW/X</article>
<name xsi:type="xsd:string">Стекло лобовое в клей HONDA INTEGRA 89-93 4D</name>
<id xsi:type="xsd:string">16681</id>
<brand xsi:type="xsd:string">XYG</brand>
<inside_id_in xsi:type="xsd:string">###CVD###</inside_id_in>
<photo
xsi:type="xsd:string">http://autotrade.su/pic.php?code=%23%23%23CVD%23%23%23&amp;state=1&amp;size=800.606</photo>
<techinfo_exists xsi:type="xsd:string">N</techinfo_exists>
<cross_exists xsi:type="xsd:string">N</cross_exists>
<subs_exists xsi:type="xsd:string">N</subs_exists>
</item>
</items>
</ns1:GetItemsByCrossValueResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
JSON
Запрос
{
"auth_key": "910c29400ebfed8c3baab935f3456f49",
"method": "getItemsByCrossValue",
"params": {
"value": "1836AGNBL",
"property_id": 13
}
}
Ответ
{
"total": 1,
"page": 1,
"limit": 20,
"items": {
"DA7 LFW/X": {
"article": "DA7 LFW/X",
"name": "Стекло лобовое в клей HONDA INTEGRA 89-93 4D",
"id": 16681,
"brand": "XYG",
"inside_id_in": "###CVD###",
"photo": "http://autotrade.su/pic.php?code=%23%23%23CVD%23%23%23&state=1&size=800.606",
"techinfo_exists": "N",
"cross_exists": "N",
"subs_exists": "N"
}
}
}
Коды и сообщения об ошибках
Код ошибки
Сообщение
82
0
1
2
3
4
5
6
7
8
9-16
17
18
19
20
21
ok
Неверный формат данных в запросе.
Вы не авторизованы.
Неправильный логин или пароль.
Неуникальная пара логин\пароль.
Ошибка определения списка доступных складов.
Ошибка обновления корзины.
Ошибка блокировки корзины.
Корзина пуста.
Отправка заявок в настоящее время недоступна в связи с проведением технических
работ.
Для одной или нескольких позиций в запросе не указано требуемое количество.
Количество позиций в запросе превышает максимально допустимое значение.
Информация по наличию товара на складах и цене в данный момент не актуальна в
связи с проведением технических работ.
Запрашиваемые позиции не найдены. Проверьте правильность указания артикулов.
Документ(ы) не найден(ы).