Выбрать курс
0  /  2

Интеграция 1С-Битрикс с сервисом мобильных приложений imshop.io с помощью модуля scoder.api

Как мы помогли нашим клиентам подружить их мобильное приложение, реализованное с помощью взаимодействия с сервисом imshop.io. Заложена работа со следующими объектами:

I. Профиль пользователя

  1. Авторизация (регистрация) по номеру телефона + SMS
  2. Получение и редактирование данных учётной записи.

II.  Доставки.

III. Оплаты.

IV. Заказ

  1. Оформление заказа
  2. Синхронизация статусов заказов.

V. Проверка наличия товара.

Для реализации задачи используется тиражный модуль Scoder: Rest API для БУС. Бэкенд мобильных приложений и разработали вспомогательный модуль Scoder: Инструменты разработчика [scoder.tools], аккумулирующий доработки по задаче (кодировка вспомогательного модуля может отличаться от кодировки вашего сайта, в этом случае нужно вручную поменять кодировку языковых файлов модуля).

Внимание! Мы не осуществляем техническую поддержку по вспомогательному модулю "Scoder: Инструменты разработчика" [scoder.tools]. Это всего лишь пример реализации, где описаны принципы реализации подобной задачи.

Для внедрение описанного подхода потребуется помощь программистов. Мы также можем в этом помощь, но за отдельное вознаграждение. Обратиться за помощью можно в наш чат в правом нижнем углу нашего сайта. Но оставляем за собой право отказать в доработке без объяснения причин.

На сайте создана страница /apimob/index.php и размещен компонент scoder:api, согласно документации. Настроен ЧПУ для компонента.

В конструкторе запросов модуля scoder.api (Сервисы - Scoder: Rest API для БУС - Профили) созданы необходимые профили:


Поле Метод АПИ соответствует адресу страницы относительно созданной папки /apimob/, куда нужно обращаться для получения требуемой информации.

Следовательно УРЛ сайта, куда необходимо обращаться из приложения:

  • Авторизация (регистрация) по номеру телефона + SMS: /apimob/users.otp 
  • Получение данных учётной записи: /apimob/users.user 
  • Редактирование данных учётной записи: /apimob/users.user.update 
  • Доставки: ваш-сайт/apimob/deliveries Оплаты: /apimob/payments 
  • Оформление заказа: /apimob/order 
  • Синхронизация статусов заказов: /apimob/order.status 
  • Проверка наличия товара: /apimob/availability

Служебный модуль Scoder: Инструменты разработчика [scoder.tools] содержит в себе необходимые функции и обработчики событий, преобразующие данные (ответы), согласно требованиям imshop.io. Имеет следующие настройки (Настройки - Настройки продукта - Настройки модулей - Scoder: Инструменты разработчика):

  • Активировать отправку изменений статусов заказов в сервис imshop.io. При включенной опции, при изменениях статусов заказов на стороне веб-сайта, информация будет передаваться на сервис imshop.io на адрес, указанный в следующей опции. 
  • URL страницы для отправки изменений статусов по заказу - предоставляется менеджером сервиса imshop.io. 
  • Сайт для приложения imshop.io - указывается ид сайта, который будет присвоен заказам при их создании через приложение imshop.io. 
  • Тип плательщика по умолчанию для приложения imshop.io - указывается ид типа плательщика, который будет присвоен заказам при их создании через приложение imshop.io.
  • Длина OTP для imshop.io (по умолчанию 4).
  • Сколько секунд осталось до возможности повторно запросить OTP (по умолчанию 120 секунд).



ПРИМЕЧАНИЯ:

I. Службы доставки, согласно документации, могут быть 2-х типов:

  • type — тип (delivery, pickup — доставка или самовывоз). 

Тот или иной тип определяется по наличию фразы “самовывоз” в названии или описании службы. Перечень служб доставки в админке Битрикс: Магазин - Настройки - Службы доставки.

II. Платежные системы, согласно документации, могут иметь следующие типы (type):

  • cash - оплата наличными, 
  • card_on_delivery - картой курьеру или при получении,
  • card - картой в приложении,
  • iOS - Apple Pay,
  • android - Google Pay (в разработке у сервиса).

Тип платежной системы указывается в поле “Код” в карточке редактирования платежной системы. Перечень доступен по адресу в админке сайт на 1C-Битрикс: Магазин - Настройки - Платежные системы.

Если данное поле "Код" пусто, то платежная система не передается.

III. Авторизация. В качестве модуля для отправки СМС используется модуль коллег - Авторизация по номеру телефона.... У вас, скорее свой модуль или используете родные возможности 1С-Битрикс, следовательно необходимо будет внеси корректировки во фрагмент кода, отвечающий за отправку СМС в вспомогательном модуле scoder.tools.