====== Экспорт в retailCRM ======

retailCRM — это специализированная CRM-система для интернет-магазинов, позволяет обрабатывать заказы, проводить аналитику, управлять товарами и др.

Для работы с API этой системы можно воспользоваться следующим решением.

  - Переносим {{ :private:koding:hostcms:modules:shop:import_export:retailcrm.zip |файлы решения}} на сервер.
  - Задаем настройки в конфигурационном файле:<code php><?php

return array(
	'url' => 'https://your-shop.retailcrm.ru',
	'api_key' => 'your_api_key',
	'secret_sequence' => 'your_secret_sequence',
	'manager_id' => '1',
	'subscription_order_status' => 'prd',
);</code>
  - Пользуемся.

На данный в решение реализованы выгрузка заказа и подписки (решение [[private:market:programmer:shop_item_subscribe|«Подписка на отсутсвующие товары»]]), а также работа с событиями.

===== Выгрузка заказа =====

Для выгрузки заказа в retalCRM можно использовать следующий наблюдатель:

<code php><?php

defined('HOSTCMS') || exit('HostCMS: access denied.');

/**
 * Наблюдатель для экспорта заказа в retailCRM.
 */
class Shop_Payment_System_Handler_Observer_Retailcrm
{
	/**
	 * Регистрирует наблюдатели.
	 *
	 * @param  array  $aShops
	 * @return void
	 */
	static public function attach()
	{
		Core_Event::attach('Shop_Payment_System_Handler.onAfterProcessOrder', array(__CLASS__, 'exportToRetailCrm'));
	}

	/**
	 * @param  Shop_Payment_System_Handler  $oShopPaymentSystemHandler
	 * @return void
	 */
	static public function exportToRetailCrm(Shop_Payment_System_Handler $oShopPaymentSystemHandler)
	{
		if (CURRENT_SITE != 1)
		{
			return;
		}

		// Создаем заказ
		$oKadRetailcrmClient = Kad_Retailcrm_Client::instance();
		$oKadRetailcrmClient->createOrder($oShopPaymentSystemHandler->getShopOrder());
	}
}</code>

====== Выгрузка подписки =====

Для работы наблюдателя потребуется добавить событие ''Shop_Item_Subscription_Controller.onAfterAddSubscription'' к контроллеру ''Shop_Item_Subscription_Controller'', а также поле ''phone'' для выгрузки номера телефона.

<code php><?php

defined('HOSTCMS') || exit('HostCMS: access denied.');

/**
* Наблюдатель для выгрузки подписки в CRM.
* 
* @author Maxim Zasorin, KAD Systems (©) 2017
* @date 14-12-2017
*/
class Shop_Item_Subscription_Controller_Observer_DispatchToRetailCrm
{
	/**
	 * Регистриует наблюдатель.
	 *
	 * @return void
	 */
	static public function attach()
	{
		Core_Event::attach('Shop_Item_Subscription_Controller.onAfterAddSubscription', array(__CLASS__, 'addPhoneNumber'));
		Core_Event::attach('Shop_Item_Subscription_Controller.onAfterAddSubscription', array(__CLASS__, 'dispatchToRetailCrm'));
	}

	/**
	 * Деактивирует наблюдатель.
	 *
	 * @return void
	 */
	static public function detach()
	{
		Core_Event::detach('Shop_Item_Subscription_Controller.onAfterAddSubscription', array(__CLASS__, 'addPhoneNumber'));
		Core_Event::detach('Shop_Item_Subscription_Controller.onAfterAddSubscription', array(__CLASS__, 'dispatchToRetailCrm'));
	}

	/**
	 * Сохраняем номер телефона.
	 *
	 * @param  Shop_Item_Subscription_Controller  $oShopItemSubscriptionController
	 * @param  array  $aArgs
	 * @return void
	 */
	static public function addPhoneNumber(Shop_Item_Subscription_Controller $oShopItemSubscriptionController, array $aArgs)
	{
		list($oShopItemSubscription) = $aArgs;

		$oShopItemSubscription->phone = trim(strval(Core_Array::getRequest('phone')));
		$oShopItemSubscription->save();
	}

	/**
	 * Выгружаем подписку в CRM.
	 *
	 * @param  Shop_Item_Subscription_Controller  $oShopItemSubscriptionController
	 * @param  array  $aArgs
	 * @return void
	 */
	static public function dispatchToRetailCrm(Shop_Item_Subscription_Controller $oShopItemSubscriptionController, array $aArgs)
	{
		list($oShopItemSubscription) = $aArgs;

		$oKadRetailcrmClient = Kad_Retailcrm_Client::instance();
		$oKadRetailcrmClient->createOrderFromSubscription($oShopItemSubscription);
	}
}</code>

====== Работа с событиями =====

Для работы с событиями (называются триггерами), которые отсылает retailCRM реализован специальный класс, использовать его необходимо следующим образом:

<code php><?php

/**
* Событие изменения заказа в retailCRM.
* 
* @author Maxim Zasorin, KAD Systems (©) 2017	
* @date 07-12-2017	
*/

// Обработка запроса
$oKadRetailcrmWebhook = Kad_Retailcrm_Webhook::create(file_get_contents('php://input'));

if ($oKadRetailcrmWebhook)
{
	$oData = $oKadRetailcrmWebhook->getData();

	// Выполняем какие-то действия с пришедшими данными $oData, здесь уже точно известно, что они пришли от retailCRM
}
else
{
	Core_Page::instance()->error403();
}</code>

<wrap lo>Страницу создал Максим Засорин 28.12.17 в 09:57</wrap>