Приложение для интеграции с 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 (дней)