Необходимо написать 4 скрипта.

Консольные скрипты

Все консольные скрипты что описаны ниже вызывается с параметрами командами вида php scriptname.php -param1=value1 -param2=value2

1. Скрипт подписки на события хорошопа

Консольный скрипт

Принимаемые параметры

• login - логин пользователя

• password - пароль пользователя

• event - название события, принимаемые значения:

  • order_created - событие срабатывающее при оформлении пользователем заказа либо при создании заказа в админ. панели

  • user_signup - событие срабатывающее при регистрации пользователя

• target_url - ссылка по которой необходимо отправить данные при срабатывании события

Функционал

1. Получает авторизационный токен https://horoshop.atlassian.net/wiki/spaces/DOCS/pages/25296931
   В случае неудачи выводит сообщение ошибки и завершает выполнение

2. Выполняет запрос подписки на событие https://horoshop.atlassian.net/wiki/spaces/DOCS/pages/25296989
   Выводит сообщение ошибки или уведомление об успешном выполнении задачи и (!) идентификатор подписки.

2. Скрипт отписки от события хорошопа

Консольный скрипт

Принимаемые параметры

• login - логин пользователя

• password - пароль пользователя

• id - идентификатор подписки полученный в функции hooks/subscribe (который должен выводить скрипт подписки после выполнения)

• target_url - ссылка на которую отправлялись данные по подписке

Функционал

1. Получает авторизационный токен https://horoshop.atlassian.net/wiki/spaces/DOCS/pages/25296931
   В случае неудачи выводит сообщение ошибки и завершает выполнение

2. Выполняет запрос отписки от события https://horoshop.atlassian.net/wiki/spaces/DOCS/pages/25296991
   Выводит сообщение ошибки или уведомление об успешном выполнении задачи

Веб-скрипты

Логирование веб-скриптов

Логи работы веб-скриптов необходимо сохранять в отдельных текстовых файлах в директорию logs размещенную рядом со скриптами.

Путь сохранения ./logs/НазваниеСкрипта_КлючОбращения.log

Значения “название скрипта” и “ключ обращение” указаны в спецификации отдельных скриптов

Необходимо сохранять:

1. Получаемые данные от вебхука Хорошопа,

2. Адрес обращения к API RetailCRM и передаваемые ей данные

3. Ответ API RetailCRM

3. Скрипт обработки регистрации пользователя

Веб-скрипт

URL этого скрипта будет указан как target_url для подписки на событие регистрации пользователя (user_signup)

Функционал

1. Получает данные согласно документации https://horoshop.atlassian.net/wiki/spaces/DOCS/pages/25297008

2. Создать пользователя в CRM согласно документации - https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-customers-create (метод /api/v5/customers/create)
   Как customer[externalId] (Внешний ID клиента) нужно использовать идентификатор пользователя (параметр "id") полученный от хорошопа с текстовым префиксом “hs” (например, для пользователя 1 идентификатор будет равен “hs1”)

Логирование

• Название скрипта - user_signup

• Ключ обращения - значение параметра параметра "id” полученного от хорошопа

4. Скрипт обработки оформления заказа

Веб-скрипт

URL этого скрипта будет указан как target_url для подписки на событие оформления заказа (order_created)

Функционал

1. Получает данные согласно документации https://horoshop.atlassian.net/wiki/spaces/DOCS/pages/25296999

2. Делает запрос по url https://docs.google.com/spreadsheets/d/e/2PACX-1vQySVXD5PxDoAQCvWs-WIOOgBFTHyWb-6txJDV56wo1VG_AccQTSzPv2p9dVXLXvKjdky0g0emapA8h/pub?output=csv и сохраняет полученные данные как конфиг для замены товаров (описана ниже) в заявке. По указаному выше url можно получить содержимое гугл таблицы https://docs.google.com/spreadsheets/d/1q4xuPRMMr5pY_fFEYKX1QNYE7rjKBu56ouz9iBruQtc/edit#gid=0 в формате СSV.

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

• Формат: “артикул1:кол-во1:цена1,артикул2:кол-во2:цена2”

• К примеру в документе есть следующая запись:

• Тогда если в заказе поступит товар с артикулом 1210, он будет заменен на: 10 штук товара с артикулом 120 по цене 28, плюс 10 штук товара с артикулом 1940 по цене 28. Товаров в замене может быть любое кол-во больше нуля.

4. Передает полученные и обработанные данные к CRM согласно документации https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-orders-create

• Запрос должен обязательно содержать поле order[customer][externalId] созданное как идентификатор пользователя (параметр "id") полученный от хорошопа с текстовым префиксом “hs” (например, для пользователя 1 значение будет равно “hs1”)

• При обращении к CRM цены для товаров передаются как initialPrice.