Интеграция программы "Автопрокат" с другими программными системами
Данное руководство предназначено для разработчиков программ и онлайн-сервисов в сфере автопроката.
Программа "Автопрокат" предназначена для полной автоматизации компании проката автомобилей. В ней содержится информация о Клиентах, Автомобилях, Договорах проката, предварительных Заявках и многое другое.
В настоящее время имеется возможность (API) для передачи в программу "Автопрокат" информации о заявках на бронирование автомобилей: добавление новых и изменение имеющихся заявок.
Взаимодействие с программой "Автопрокат" производится при помощи "Модуля приема заявок от партнеров" (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.2 от 27.05.2016 г.
Вопросы, пожелания, поддержка:
