Бесплатные шаблоны тут: Шаблоны Joomla. Объективы для Sony Alpha - Объективы Minolta и Sony.

Интеграция программы "Автопрокат" с другими программными системами

Данное руководство предназначено для разработчиков программ и онлайн-сервисов в сфере автопроката.

Программа "Автопрокат" предназначена для полной автоматизации компании проката автомобилей. В ней содержится информация о Клиентах, Автомобилях, Договорах проката, предварительных Заявках и многое другое.

В настоящее время имеется возможность (API) для передачи в программу "Автопрокат" информации о заявках на бронирование автомобилей: добавление новых и изменение имеющихся заявок.

Взаимодействие с программой "Автопрокат" производится при помощи "Модуля приема заявок от партнеров" (http://pisoft.ru/aprok/partnersite), который должен быть установлен на сайте компании проката.

Информация о работе с API

Обращение к API производится по протоколу http по адресу http://<domen>/partner/add_zakaz.php
Здесь <domen> - это адрес сайта компании проката (например, urentcar.ru).

Параметры запроса передаются http-методом POST.

Параметры должны передаваться в кодировке windows-1251. (Если очень нужно, то можно будет добавить кодировку utf-8).

Предварительной авторизации не требуется. В каждом запросе должен передаваться логин и пароль партнера, предварительно зарегистрированного в базе данных системы. Поступающие заявки будут связаны с данным партнером.

Список POST-параметров запроса:

u_login - Логин партнера (обязательный параметр)
u_passw - Пароль партнера (обязательный параметр)

model - Название модели автомобиля. Должно в точности совпадать с названием одной из моделей в справочнике "Модели" программы "Автопрокат". (Обязательный параметр)

day_beg - День месяца даты начала аренды (число от 1 до 31)
month_beg - Номер месяца даты начала аренды (число от 1 до 12)
year_beg - Год даты начала аренды
hour_beg - Часы времени начала аренды
min_beg - Минуты времени начала аренды

day_end - День месяца даты конца аренды (число от 1 до 31)
month_end - Номер месяца даты конца аренды (число от 1 до 12)
year_end - Год даты конца аренды
hour_end - Часы времени конца аренды
min_end - Минуты времени конца аренды

store_b - Место выдачи (в соответствии со справочником мест программы "Автопрокат")
store_e - Место возврата (в соответствии со справочником мест программы "Автопрокат")
addr_b - Адрес выдачи
addr_e - Адрес возврата

cli_name - Имя клиента (обязательный параметр)
cli_lname - Фамилия клиента (обязательный параметр)
cli_sname - Отчество клиента
cli_phone - Номер телефона клиента (обязательный параметр)
cli_email - Email клиента
cli_card - Номер карточки клиента
cli_bday - День месяца даты рождения клиента (число от 1 до 31)
cli_bmonth - Номер месяца даты рождения клиента (число от 1 до 12)
cli_byear - Год даты рождения клиента

pasp_num - Серия и номер паспорта клиента
pasp_vyd - Кто выдал паспорт клиента
pasp_country - Страна паспорта клиента
pasp_city - Город адреса клиента
pasp_street - Адрес клиента (улица, дом и пр.)
pasp_day - День месяца даты выдачи паспорта (число от 1 до 31)
pasp_month - Номер месяца даты выдачи паспорта (число от 1 до 12)
pasp_year - Год даты рождения выдачи паспорта

vod_num - Номер водительского удостоверения клиента
vod_vyd - Кто выдал водительского удостоверения
vod_day - День месяца даты выдачи водительского удостоверения (число от 1 до 31)
vod_month - Номер месяца даты выдачи водительского удостоверения (число от 1 до 12)
vod_year - Год даты рождения выдачи водительского удостоверения

days - Число дней аренды автомобиля (обязательный параметр)
price - Тариф за день аренды
day_sum - Сумма за все дни аренды автомобиля
tot_sum - Общая сумма заявки (включая стоимости дополнительных услуг и оборудования)

dop1 - Название первого дополнительного оборудования
dop2 - Название второго дополнительного оборудования
. . .
dop7 - Название седьмого дополнительного оборудования (всего не более 7-и)

dsum1 - Стоимость первого дополнительного оборудования
dsum2 - Стоимость второго дополнительного оборудования
. . .
dsum7 - Стоимость седьмого дополнительного оборудования (всего не более 7-и)

bag_type - Название вида багажника

usl1 - Название первой дополнительной услуги
usl2 - Название второй дополнительной услуги
. . .
usl4 - Название четвертой дополнительной услуги (всего не более 4-х доп услуг)

usum1 - Стоимость первой дополнительной услуги
usum2 - Стоимость второй дополнительной услуги
. . .
usum4 - Стоимость четвертой дополнительной услуги (всего не более 4-х доп услуг)

Ответ сервера на запрос

Если в запросе не указан правильный логин партнера (u_login), то сервер вернет ответ:
"Ошибка выполнения запроса к таблице partner"

Если не задан хотя бы один из обязательных параметров (model, cli_name, cli_lname, cli_phone или days), то ответ будет: "Вы ввели не всю информацию, поэтому заявка не принята."

Если параметр model не совпадает ни с одной моделью в справочнике "Модели" программы, то получим ответ: "Ошибка. Нет модели: <model>"

При поступлении запроса сервер проверяет нет ли уже в базе данных заявки с таким номером телефона клиента (cli_phone) и таким же временем начала аренды. Если такой заявки в базе данных еще нет, то новая заявка ДОБАВЛЯЕТСЯ в базу.
При успешном добавлении заявки в базу данных получим ответ: "Ваша заявка отправлена"
В случае ошибки добавления, ответ сервера будет: "Заявка не добавлена! Заказ через API. Создание: <time>"

Если в базе данных уже есть заявка с таким номером телефона и временем начала аренды, то делается ИЗМЕНЕНИЕ этой заявки.
При успешном изменении заявки в базе данных получим ответ: "Ваша заявка успешно изменена"
В случае ошибки добавления, ответ сервера будет: "Заявка не изменена! Заказ через API. Изменение: <time>"

Адрес формы заявки для тестирования http://<domen>/partner/zakaz-test.php
Предварительно нужно войти в "Личный кабинет" партнера по адресу http://<domen>/partner/

 

Версия API 1.0 от 27.05.2016 г.

Вопросы, пожелания, поддержка: Этот адрес электронной почты защищён от спам-ботов. У вас должен быть включен JavaScript для просмотра.

×
Скачать "Прокат-Эксперт"

Чтобы скачать программу "Прокат-Эксперт" нужно зарегистрироваться: