Сервер обмена

Описание

Сервер обмена заказами на одном такси, позволяет давать доступ к заказам одного такси, другим такси на этом сервере. Так же через сервер обмена могут быть получены данные или передаваемые данные на другие сервера обмена/партнеров.

Данные

Пользователи внешнего доступа - такси

Каждое такси получает уникальный API ключ - ключ будет использоваться во всех командах доступа.

Таблица доступа

Матрица доступа между такси. Для такси А указывается в какие такси B,C,D... будет попадать заказ расшаренный в системе. Различаются 2 матрицы:

• наличные заказы (наличные, VISA заказы)
• безналичные заказы

API

Для внутреннего обмена

Внутренний сервер обмена предназначен для работы с заказами, уже созданными какимито пользователями в системе ТвоеТакси. Поэтому используются команды:

Расшарить заказ

Заказ попадает в обработку не только службы, которая создала заказ, но и тем службам, которые соотносятся с данной службой в соответствии с "Таблица доступа". Заказ попадает к ним в тот порядок обработки, который задан согласно Окно Настройки.

Скрыть заказ

Заказ изымается из обработки других такси, остается виден только для provider и executeprovider.

Назначение водителем на заказ

Назначение так еже как и для своего собственного заказа, исключающее работу не со своими заказами - executeprovider не мое такси.

Для внешнего обмена

Внешнее API позволяет выполнять команды в системе внешним приложениям от имени того такси, которое открыло для себя автоматизацию клиентом.

Добавить заказ

Добавление внешнего заказа - помещение в систему такси от имени такси. Отправка в сервер обмена - "шаринг заказа" будет выполняться автоматически.

Закрытие заказа

Удаление заказа в архив с указанным статусом.

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

Возврат информации о текущем состоянии текущего заказа.

Стоимость заказа

Возврат по данным заказа для данного такси

• стоимости
• километража
• времени

История заказов по клиенту

История заказов для клиента достается по всем такси в системе (на сервере).

Получение справочника типов машин

Отдача справочника

Получение справочника услуг

Отдача справочника

Получение справочника списка объектов

Отдача справочника

Получение справочника улиц

Отдача справочника

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

Отдача справочника

Получение справочника статусов заказов

Отдача справочника

Для работы на уровне клиентского приложения

Регистрация нового клиента

При регистрации нового клиента в сервере, мы обращаемся к таблице rst_consumers. Если по данному нам номеру телефона, там нет клиента - мы ее создаем. Опционально заполняем данные клиента в таблице. Если там запись есть - мы используем ее.

Для получения GUID пользователя, мы генерируем СМС сообщение на указанный номер телефона с кодом (4-6 цифр). Этот код используется в следующей команде "Подтверждение регистрации".

Подтверждение регистрации клиента

Команда вызывается после команды регистрации с параметром отосланным в СМС пользователя. При успешном выполнении (нахождении клиента и совпадении его сгенерированного кода), мы отдаем GUID пользователя для того, чтобы данное устройство в дальнейшем использовало его.