FrontpadApi

Интеграция minishop2 с frontpad.ru
Версия 1.0.2-beta
Дата выпуска 07.12.2018
Загрузки 113
Просмотры 5 639
Внимание, этот компонент требует версию PHP 5.4 или выше! Если ваш сайт использует PHP ниже требуемого, установка этого дополнения может его сломать.
Внимание, этот компонент требует версию MODX не ниже 2.4 !
Приложение для интеграции с CRM frontpad.ru через API

FrontPad — это сервис для учета заказов в доставке, кафе, рознице и интернет-магазине.

Возможности API


  • Создание нового заказа — метод new_order
  • Получение статуса заказа по номеру заказа — get_status
  • Получение статуса заказа по номеру телефона — get_status_phone
  • Получение информации о клиенте — get_client
  • Получение статуса сертификата — get_certificate
  • Получение списка продукции — get_products

Возможности приложения


  • Отправка заказов из minishop2 в сервис сразу после создания заказа
  • При добавлении товара и вводе артикула происходит проверка существования артикула в CRM
  • Уведомление менеджера в случае если заказ не смог по каким то причинам синхронизироваться с CRM
  • Учет артикулов из приложения msOptionsPrice2
  • Настройки и сопоставления данных
    • Сопоставление платежных методов
    • Сопоставление статусов

    • Сопоставление способов оплаты
    • Сопоставление точек продаж
    • Сопоставление филлиалов
    • Настройка полей для улицы

В приложение добавлено 2 формы для проверки данных:

Проверка статус заказа по номеру телефона/по номеру заказа
[[$FrontpadApi.Form.status]]

Проверка информации о сертификате
[[$FrontpadApi.Form.certificate]]

Проверка статуса заказа


Для проверки статуса заказа необходимо добавить cron задание
*/1 * * * * /usr/bin/php ~/www/core/components/frontpadapi/cron/checkstatus.php

Ошибки статусов заказов


Для того чтобы работа интернет-магазина не нарушалась в систему автоматически создается статус заказа с название «Ошибка API» он нужен для того чтобы если по какой то причине произошла ошибка то менеджеру интернет-магазина поступило сообщение на emal.
Сообщение об ошибке можно будет посмотреть в комментарии для менеджера в списке заказов minishop2.


Дополнительная информация


Документация по API — содержит информацию по методам синхронизации с интернет-магазином.

frontpadapi_additional_fields — Дополнительные поля
Вы можете добавить свои поля для добавлених их в заказ с сопоставление (Пример datetime:extfld_deliverydate где первое значение это поле в CRM а второе это поле в minishop2)
По умолчанию: pod,certificate,et,card,score,sale,sale_amount,person,datetime:extfld_deliverydate

frontpadapi_default_affiliate — Филлиал по умолчанию
Филлиал по умолчанию выставляется в случае если они подключены в CMR
По умолчанию: пусто

frontpadapi_error_status — Статус заказа с ошибкой
Статус из minishop2 в случае если произошла ошибка
По умолчанию: автоматически назначается во время установки приложения

frontpadapi_affiliate — Филлиалы
Филлиалы вы можете посмотреть в CRM — «Настройки -> Филлиалы» и указать «Код API». Сопостовление филлиалов требуется если они подключены
По умочланию: пусто

frontpadapi_affiliate_enable — Включить филлиалы
Влючайте филлиалы если они у вас подключены в CRM

frontpadapi_default_channel — Канал продаж по умолчанию
Канал продаж вы можете посмотреть в CRM — «Настройки -> Каналы продаж» и указать «Код API»
По умочланию: пусто

frontpadapi_channel — Канал продаж
Сопостовление каналов продаж
По умочланию: пусто

frontpadapi_default_point — Точка продажи по умолчанию
Способ оплаты вы можете посмотреть в CRM — «Настройки -> Точки продаж» и указать «Код API». Если они подключены
По умочланию: пусто
frontpadapi_point — Точки продаж
Сопостовление точек продаж
По умочланию: пусто

frontpadapi_default_pay — Способ оплаты по умолчанию
Способ оплаты вы можете посмотреть в CRM — «Справочники -> Варианты оплаты» и указать «Код API»
По умочланию: пусто

frontpadapi_payments — Способы оплаты
Сопостовление способов оплаты
По умочланию: пусто

frontpadapi_matched_statuses — Сопоставление статусов
Сопостовление статусов заказов. Существующие статусы оплаты вы можете посмотреть в CRM — «Справочники -> Статусы» и указать название статуса. Внимание указывать нужно именно имя статусу, так как API возвращает именно его.
Пример «Новый:1, В пути:2, Отменен:3» где значение после ":" является ID статуса в minishop2
По умочланию: пусто
frontpadapi_secret — Секретный ключ
Секретный ключ вы можете получить зайдя в «Настройки -> Общие -> API (подключение интернет-магазина)»
По умолчанию: пусто

frontpadapi_check_statuses — Проверять статусы
После установки cron задания необходимо установить на каких статусах должен проверяется заказа в CRM.
То есть если статус заказа отменен, то на этом статусе заказ уже больше не будет проверяется.

frontpadapi_check_days — Дней для проверки заказов
Если у вас будут заказы которые не синхронизировались или находятся на одном и том же статусе. То вы можете выставить количество дней сколько должны проверяется эти статусы.
По умолчанию: 7 (дней)

1.0.2-beta

  • Добавлена настройка отправка на статус, которая позволяет отправлять заказа во frontpad только по наступления этого статуса у заказа
  • Воврмения отправки заказа или проверки статуса заказа, если возникает ошибка то статус заказа автоматически переводиться на статус с ошибкой.
  • Проверка существования артикула во время сохранения товара

Последние обсуждения в сообществе MODX.pro