| | API сервис инструкции
Поиск запчастейНапример, G 7203

API сервис инструкции

Инструкция подключения api сервиса для наших клиентов:

 
Какие возможности
 
Сервер http://poisk.autoxit.ru
Оглавление
1.1 Поиск по каталогу и номеру
1.2 Поиск по номеру
2.1 Список заказов
2.2 Информация о заказе
3.1 Просмотр корзины
3.2 Добавление детали в корзину и изменение количества
3.3 Удаление детали из корзины
4 Отправка заказа

Поиск по каталогу и номеру
Запрос отправляется методом GET, авторизация (логин и пароль клиента) по методу HTTP
Basic Authentication, т.е. в запросе содержится дополнительный заголовок с логином и
паролем.
Параметры запроса:
do=api обязательный параметр, код действия;
article_and_vendor=GATES_5310XS каталог и номер без спецсимволов, записанные через
нижнее подчёркивание _.
Должны быть url-encoded, на случай, если название
каталога содержит пробелы, как Ford Europa;
full_price=1 1 или 0, признак поиска в полном прайсе;
all_stores=1 1 или 0, искать по всем складам, или не включая
партнёрские;
even_number=1 1 или 0, признак точного номера или части номера;
with_analogs=1 1 или 0, возвращать в ответе аналоги или нет.
Пример запроса, отправленный с помощью CURL:
curl -u KU0001:password -X GET 'http://poisk.autoxit.ru/?
do=api&full_price=1&all_stores=1&even_number=1&with_analogs=1&article_and_vendor
=GATES_5310XS'
Пример ответа:
<dataroot generated="2012-12-07T17:38:32+04:00">
<price>
<price_item>
<man_name>BOSCH</man_name>
<art>1004336599</art>
<part_name>Узел щеточный для стартера</part_name>
<price_rur>831</price_rur>
<price_rur_cash>831</price_rur_cash>
<price_ue>20.26</price_ue>
<min_qty>1</min_qty>
<qty>&gt; 10</qty>
<date_update>28.11.2012</date_update>
<comment></comment>
<dlv_day>В наличии</dlv_day>
<dir_name>BO01</dir_name>
<dealer></dealer>
<type_cross>1</type_cross>
<id_price>BOSCH##1004336599##1004336599##Узел щеточный для стартера##18.4185##В
наличии####BO01</id_price>
</price_item>
</price>


Описание полей ответа:
man_name – производитель, каталог;
art – артикул, номер;
part_name – название;
price_rur – цена, р., безналичный расчёт;
price_rur_cash – цена, р., наличный расчёт;
price_ue – цена, у.е.;
min_qty – минимальная упаковка, шт.;
qty – количество;
date_update – дата обновления: дд.мм.гггг;
comment – комментарий;
dlv_day – срок поставки: "в наличии”, "есть”, "N дней”;
dir_name – строка наценки;
dealer – поставщик, двухбуквенный код;
type_cross – признак кроссировки: 0 – оригинал, 1 – аналог;
id_price – уникальный код детали, используется для помещения детали в корзину.
Перейти в Оглавление
Редакция от 14 декабря 2012
Поиск по номеру
Запрос отправляется методом GET, авторизация (логин и пароль клиента) по методу HTTP
Basic Authentication, т.е. в запросе содержится дополнительный заголовок с логином и
паролем.
Параметры запроса:
do=api обязательный параметр, код действия;
article=5310XS номер без спецсимволов;
full_price=1 1 или 0, признак поиска в полном прайсе;
all_stores=1 1 или 0, искать по всем складам, или не включая
партнёрские;
even_number=1 1 или 0, признак точного номера или части номера;
with_analogs=1 1 или 0, возвращать в ответе аналоги или нет.
Пример запроса, отправленный с помощью CURL:
curl -u KU0001: password -X GET 'http://poisk.autoxit.ru/?
do=api&full_price=1&all_stores=1&even_number=1&with_analogs=1&article=50161'
Пример ответа:
Если найдено одно соответствие с таким номером – ответ будет как в поиске по номеру и
каталогу. См. Поиск по каталогу и номеру:
 
Пример ответа.
Если найдено несколько номеров из разных каталогов, ответ выглядит так:
<man>
<item>
<man_name>AC-DELCO</man_name>
<art>501-61</art>
</item>
<item>
<man_name>FEBI</man_name>
<art>50161</art>
</item>
</man>
Описание полей ответа:
man_name – производитель, каталог;
art – артикул, номер.
Перейти в Оглавление
Редакция от 14 декабря 2012
Список заказов
Запрос отправляется методом GET, авторизация (логин и пароль клиента) по методу HTTP
Basic Authentication, т.е. в запросе содержится дополнительный заголовок с логином и
паролем.
Параметры запроса:
do=api обязательный параметр, код действия;
order_list=1 обязательный параметр, режим показа: все заказы;
date_from=01.10.2012 дата начала списка, дд.мм.гггг., необязательно.
По умолчанию – первое число текущего месяца;
date_till=22.10.2012 дата конца списка, дд.мм.гггг., необязательно.
По умолчанию – текущая дата.
Пример запроса, отправленный с помощью CURL:
curl -u KU0001: password -X GET 'http://poisk.autoxit.ru/?
do=api&order_list=1&date_from=01.10.2012&date_till=22.10.2012'
Пример ответа:
<error>
<text>Не найдено ни одного заказа.</text>
</error>
Или:
<dataroot generated="2012-12-14T20:11:26+04:00">
<orders count="2">
<order>
<order_number>12-000024-0023</order_number>
<order_date>11.10.2012</order_date>
<order_time>15:36:30</order_time>
<order_status>Не выполнен</order_status>
<order_total>3824 руб. безнал</order_total>
<order_item_number>2</order_item_number>
<order_delivery>доставка</order_delivery>
<order_payment>безнал.</order_payment>
<items>
<item>
<number>10</number>
<man_name>ELITA</man_name>
<art>3C1Q6019AB</art>
<part_name>Крышка передняя ДВС</part_name>
<price>1912.00</price>
<qty>2</qty>
<total>3824.00</total>
<status></status>
</item>


</items>
</order>
<order>
<order_number>12-000023-0022</order_number>
<order_date>11.10.2012</order_date>
<order_time>17:03:28</order_time>
<order_status>Не выполнен</order_status>
<order_total>3824 руб. безнал</order_total>
<order_item_number>2</order_item_number>
<order_delivery>доставка</order_delivery>
<order_payment>безнал.</order_payment>
<items>
<item>
<number>10</number>
<man_name>ELITA</man_name>
<art>3C1Q6019AB</art>
<part_name>Крышка передняя ДВС</part_name>
<price>1912.00</price>
<qty>2</qty>
<total>3824.00</total>
<status></status>
</item>
</items>
</order>
</orderlist>
Описание полей ответа
Поля заказа order:
order_number – номер заказа;
order_date – дата заказа, дд.мм.гггг (время GMT+4, московское);
order_time – время заказа (время GMT+4, московское);
order_status – статус заказа;
order_total – стоимость заказа (в валюте, выбранной при отправке заказа);
order_item_number – количество позиций в заказе;
order_delivery – тип доставки (доставка/самовывоз);
order_payment – вид оплаты (нал/безнал);
Поля позиций заказа item:
number – номер позиции в заказе, нумерация 10, 20, 30..., как в файлах dbf;
man_name – каталог;
art – номер;
part_name – название;
price – цена за 1 шт.;
qty – количество;
total – цена, всего;
status – статус детали.

Информация о заказе
Запрос отправляется методом GET, авторизация (логин и пароль клиента) по методу HTTP
Basic Authentication, т.е. в запросе содержится дополнительный заголовок с логином и
паролем.
Параметры запроса:
do=api обязательный параметр, код действия;
order_number=12-000023-0022 обязательный параметр, номер заказа.
Пример запроса, отправленный с помощью CURL:
curl -u KU0001:password -X GET 'http://poisk.autoxit.ru/?do=api&order_number=11-
000600-0011'
Пример ответа:
См. Список заказов: Пример ответа. Список из одного заказа.
Описание полей ответа:
См. Список заказов: Поля заказа order.

Просмотр корзины
Запрос отправляется методом GET, авторизация (логин и пароль клиента) по методу HTTP
Basic Authentication, т.е. в запросе содержится дополнительный заголовок с логином и
паролем.
Параметры запроса:
do=api обязательный параметр, код действия;
cart_list=1 обязательный параметр, режим показа: корзина.
Пример запроса, отправленный с помощью CURL:
curl -u KU0001:password -X GET 'http://poisk.autoxit.ru/?do=api&cart_list=1'
Пример ответа:
<message>
<text>Корзина пуста.</text>
</message>
Или:
<dataroot generated="2012-12-14T20:33:11+04:00">
<items number="33" price="896.7" currency="р. (безнал.)">
<item>
<man_name>CHAMP</man_name>
<art>PH8A</art>
<part_name>Фильтр масляный</part_name>
<price>113.10 р.</price>
<qty>3</qty>
<total>339.3</total>
</item>
<item>
<man_name>CHEVROLET</man_name>
<art>05973823</art>
<part_name>Пистон</part_name>
<price>18.58 р.</price>
<qty>30</qty>
<total>557.4</total>
</item>
</items>
Описание полей ответа:
См. Список заказов: Поля позиций заказа item.

Добавление детали в корзину и изменение количества
Запрос отправляется методом POST, авторизация (логин и пароль клиента) по методу HTTP
Basic Authentication, т.е. в запросе содержится дополнительный заголовок с логином и
паролем.
Параметры запроса:
do=api обязательный параметр, код действия;
cart_change= FORD... обязательный параметр, код детали;
cart_qty=3 обязательный параметр. Количество.
Если будет указано 0, деталь будет удалена.
Если деталь уже в корзине – количество будет изменено.
Если детали нет в корзине – она будет добавлена
с указанным количеством.
Пример запроса, отправленный с помощью CURL:
curl -u KU0001:password -X POST -F do=api -F cart_change=FORD
%20Europa##1709189##1709189####395.6####5Q##MC01 -F cart_qty=3
'http://poisk.autoxit.ru/'
Пример ответа:
Запрос возвращает обновлённое содержание корзины. См. Просмотр корзины.
Описание полей ответа:
Запрос возвращает обновлённое содержание корзины. См. Просмотр корзины.

Удаление детали из корзины
Запрос отправляется методом POST, авторизация (логин и пароль клиента) по методу HTTP
Basic Authentication, т.е. в запросе содержится дополнительный заголовок с логином и
паролем.
Параметры запроса:
do=api обязательный параметр, код действия;
cart_remove= FORD... обязательный параметр, код детали.
Пример запроса, отправленный с помощью CURL:
curl -u KU0001:password -X POST -F do=api -F cart_remove=FORD
%20Europa##1709189##1709189####395.6####5Q##MC01 'http://poisk.autoxit.ru/'
Пример ответа:
Запрос возвращает обновлённое содержание корзины. См. Просмотр корзины.
Описание полей ответа:
Запрос возвращает обновлённое содержание корзины. См. Просмотр корзины.
Перейти в Оглавление
Редакция от 14 декабря 2012
Отправка заказа
Запрос отправляется методом POST, авторизация (логин и пароль клиента) по методу HTTP
Basic Authentication, т.е. в запросе содержится дополнительный заголовок с логином и
паролем.
Параметры запроса:
do=api обязательный параметр, код действия;
cart_order=1 обязательный параметр, сформировать заказ;
delivery=1 тип доставки: 1 – самовывоз, 0 – доставка компании;
payment_type=1 оплата: 1 – наличная, 0 - безналичная;
delivery_date=22.11.2012 необязательно, дата доставки дд.мм.гггг;
comment=комментарий необязательно, комментарий.
Пример запроса, отправленный с помощью CURL:
curl -u KU0001:password -X POST -F do=api -F cart_order=1 -F
comment='Комментарий' -F delivery_date='22.11.2012' -F delivery=1 -F
payment_type=0 'http://poisk.autoxit.ru/'
Пример ответа:
Возвращает данные о готовом заказе. См. Список заказов: Пример ответа.
Описание полей ответа:
Возвращает данные о готовом заказе. См. Список заказов: Поля заказа order.

Оставить комментарий: