Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
sideservice [2017/09/26 10:43]
annasemukhina [Оповещение о покупке]
sideservice [2019/03/04 14:52] (текущий)
annasemukhina
Строка 1: Строка 1:
 =====Автоматическое оповещение сторонних скриптов и сервисов===== =====Автоматическое оповещение сторонних скриптов и сервисов=====
-====Оповещение о покупке==== 
-АвтоВебОфис позволяет автоматически отправлять оповещение о продаже товаров и услуг на указанные %%URL%% сторонних скриптов и сервисов. 
  
-%%URL%% для оповещений указывается в настройках товарав блоке Настройки автоматических оповещений сторонних скриптов и сервисов о продаже данного товара.+АвтоВебОфис позволяет автоматически отправлять ​оповещения о счетах,​ заявках,​ контактах,​ подписках на указанные %%URL%% сторонних скриптов и сервисов. 
 + 
 +Если %%API%% работает ​по системе запроса пользователя, т.е. инициатором выступаете Вы, то, когда Вы заполняете "​%%URL%% оповещения",​ инициатором запроса уже ​выступаем мы, и как только наступает выбранное событие, например,​ счет оплачен, шлем POST-запрос, внутри которого содержится сериализованный массив с данными о счете по указанному %%URL%% ​на Вашу страницу со скриптом (который напишет Ваш тех ​специалист), который будет обрабатывать полученный массив ​данных. 
 + 
 +%%URL%% для ​оповещений указывается в разделе Настройки-Оповещение скриптов
  
 Для настройки данного функционала:​ Для настройки данного функционала:​
  
-  - Войдите в раздел ​«Товары» зарегистрированного в сервисе АвтоВебОфис магазина +  - Войдите в раздел ​Настройки ​зарегистрированного в сервисе АвтоВебОфис магазина 
-  - Зайдите на страницу изменения информации по товару и найдите на ней блок «Настройки автоматического оповещения сторонних ​скриптов ​и сервисов о продаже данного товара» +  - В левом боковом меню выберите ​пункт Оповещение скриптов 
-  - В поле «%%URL%% для отправки оповещений» ​данного блока укажите адрес, на который должны будут отправляться оповещения о продаже данного товара или услуги +  - В поле «%%URL%% для отправки оповещений» нужного блока укажите адрес, на который должны будут отправляться оповещение 
-  - В поле «Используется» данного блока поставьте галочку +  - Напротив ​указанной ссылки поставьте галочку 
-{{ ::sideservice.png |}}+{{ ::86a2b71e27.png |}}
 \\ \\ \\ \\
-После этого, в случае ​продажи данного товара или ​услуги (смены ​статуса счета с данным товаров на «Оплачен»), на указанный Вами «URL для отправки оповещений» будут отправлены методом $_POST следующие данные:​+После этого, в случае наступления выбранного события, на указанный Вами «URL для отправки оповещений» будут отправлены методом $_POST следующие данные:​ 
 +====Контакты==== 
 +По контактам есть 3 типа действий,​ по которым можно задать отправку уведомлений:​ создание контакта,​ изменения в карточке контакта,​ удаление контакта
 ^Параметр^Описание^ ^Параметр^Описание^
-|**Информация по счету**|| 
-|id_account|Код счета| 
-|account_number|Номер счета| 
-|date_of_order|Дата создания счета| 
-|date_of_payment|Дата оплаты счета| 
-|id_payment_system|Код платежной системы| 
-|id_account_status|Код статуса счета (1 - создан,​ 2 - отказ, 3 - в обработке,​ 4 - ошибка,​ 5 - оплачен)| 
-|**Информация по контакту**|| 
 |id_contact|Код контакта| |id_contact|Код контакта|
-|email|Email,​ указанный при заказе| 
-|phone_number|Телефон,​ указанный при заказе| 
 |last_name|Фамилия| |last_name|Фамилия|
 |name|Имя| |name|Имя|
 |middle_name|Отчество| |middle_name|Отчество|
-|skype|Skype|+|email|Ящик| 
 +|password|Пароль от личного кабинета| 
 +|id_partner|Код партнера| 
 +|not_to_write|Стоит галочка "Не писать"​| 
 +|spam_clicked|Стоит галочка "​Жалоба на СПАМ"​| 
 +|spam_clicked_date|Дата жалобы на СПАМ| 
 +|unsubscribe_date|Дата отписки| 
 +|email_not_exist|Ящик не существует| 
 +|phone_number|Номер телефона| 
 +|do_not_call|Стоит галочка "Не звонить"​|
 |id_country|Код страны| |id_country|Код страны|
-|area|Область/Край|+|zip_code|Индекс| 
 +|area|Область|
 |city|Город| |city|Город|
 |delivery_address|Адрес доставки| |delivery_address|Адрес доставки|
-|zip_code|Почтовый индекс+|skype|Скайп
-|**Информация по товару или услуге**|+|ban|Стоит ​голчка "​Бан"​
-|id_account_line|Код строки счета+|ban_reason|Причина попадания ​в бан
-|id_goods|Код товара+|sex|Пол| 
-|vendor_code|Артикул товара+|date_of_birth|Дата рождения
-|price|Цена+|brief_description|Описание| 
-|quantity|Количество+|date_registration|Дата регистрации
-|sum_price|Сумма стоки счета (цена*количество)+|id_employee_responsible|Код ответственного сотрудника| 
-|**Дополнительная информация**|+|id_employee_created|Код сотрудника, зарегистрировавшего контакт
-|hash|Контрольная сумма MD5 для формирования подписи удостоверяющей подлинность полученных данных+|id_advertising_channel_page|API ​код канала рекламы
-Скрипт или сервис,​ принимающий ​данные, в случае успеха обработки полученных данных, должен вернуть «200 OK». То есть скрипт, ​обрабатывающий оповещение от магазина, зарегистрированного в АвтоВебОфис, в случае успешной обработки полученных данных, ​должен вывести на страницу ​текст: 200 OK и только этот ​текст. +|advertising_channel_keyword|ключевое слово| 
 +|advertising_channel_location|место размещения| 
 +|advertising_channel_type_traffic|тип трафика
 +|deleted|Карточка контакта ​была удалена
 +|deleted_date|Дата удаления контакта| 
 +|vk_user|Идентификатор вКонтакте| 
 +|fb_user|Идентификатор Facebook| 
 +|datetime_notify|Дата отправки уведомления|
  
-Пример запроса, передаваемого после оплаты товара: +**Пример запроса ​на изменение контакта** 
-<​code>​Array +    Array 
-+    
-[id_account] => 21276 +    [id_contact] => 204 
-[account_number] => 21214 +    [last_name] =>  
-[date_of_order] => 2017-05-13 11:01:48 +    [name] =>  
-[date_of_payment] => 2017-06-01 18:40:35 +    [middle_name] =>  
-[id_payment_system] =>  +    [email] => f1351@yandex.ru 
-[id_account_status] => 5 +    [password] => 1acf6 
-[id_contact] => 67426 +    [id_partner] => 0 
-[email] => anr45e1i@yaa.ru +    [not_to_write] => 0 
-[phone_number] => 79261234567 +    [spam_clicked] => 0 
-[last_name] =>  +    [spam_clicked_date] => 0000-00-00 00:00:00 
-[name] => Андерей +    [unsubscribe_date] => 0000-00-00 00:00:00 
-[middle_name] =>  +    [email_not_exist] => 0 
-[id_country] => 0 +    [phone_number] =>  
-[area] =>  +    [do_not_call] => 0 
-[city] =>  +    [id_country] => 0 
-[delivery_address] =>  +    [zip_code] =>  
-[skype] => 544848376711111111111 +    [area] =>  
-[zip_code] =>  +    [city] =>  
-[id_account_line] => 20524 +    [delivery_address] =>  
-[id_goods] => 1252 +    [skype] =>  
-[price] => 0.01 +    [ban] => 0 
-[quantity] => 1 +    [ban_reason] =>  
-[sum_price] => 0.01 +    [sex] => 0 
-[vendor_code] => wwweerrr +    [date_of_birth] => 0000-00-00 
-[hash] => a5cbcd800b94f570a0319d675a1c0293 +    [brief_description] =>  
-)</code+    [date_registration] => 2019-02-13 14:51:49 
-В данном случае //​id_account_status ​5// означает, что счет успешно оплачен.+    [id_employee_responsible] => 0 
 +    [id_employee_created] => 0 
 +    [id_advertising_channel_page] => 0 
 +    [advertising_channel_keyword] =>  
 +    [advertising_channel_location] =>  
 +    [advertising_channel_type_traffic] =>  
 +    [deleted] => 0 
 +    [deleted_date] => 0000-00-00 00:00:00 
 +    [vk_user] =>  
 +    ​[fb_user] =>  
 +    ​[datetime_notify] ​=> 2019-02-21 10:50:06 
 +    ) 
 + ​\\ ​ \\   
 +====Счета====
  
 +По счетам есть 2 типа действий,​ по которым можно задать отправку уведомлений:​ создание счета, изменения в счете (например,​ смена статуса счета на оплачен)
  
-===Формирование контрольного ​HASH удостоверяющего подлинность полученных данных:===+^Параметр^Описание^ 
 +|id_account|Код счета| 
 +|account_number|Номер счета| 
 +|account_sum|Общая сумма счета | 
 +|id_account_status|код статуса счета (1 - создан,​ 2 - отказ, 3 - в обработке, 4 - ошибка,​ 5 - оплачен)| 
 +|close_account|признак закрытия счета| 
 +|id_partner|Код партнера| 
 +|id_payment_system|Код платежной системы| 
 +|close_date|дата закрытия счета| 
 +|date_of_order|дата создания счета| 
 +|goods_return|признак возврата товара| 
 +|date_of_payment|Дата оплаты счета| 
 +|goods_return_date|Дата возврата товара| 
 +|last_name|фамилия| 
 +|name|имя| 
 +|middle_name|отчество| 
 +|email|ящик| 
 +|phone_number|телефон
 +|skype|скайп| 
 +|account_comment|комментарий к счету| 
 +|id_organization|код организации| 
 +|id_delivery_region|код региона ​доставки| 
 +|area|область|  
 +|city|город| 
 +|delivery_address|адрес доставки | 
 +|zip_code|почтовый индекс| 
 +|barcode|почтовый идентификатор
 +|id_delivery_region_method|код способа доставки для региона| 
 +|id_advertising_channel_page|API код канала рекламы| 
 +|advertising_channel_keyword|ключевое слово| 
 +|advertising_channel_location|место размещения| 
 +|advertising_channel_type_traffic|тип трафика| 
 +|deleted|счет удален| 
 +|vk_user|идентификатор вКонтакте| 
 +|fb_user|идентификатор Facebook| 
 +|id_account_line|код строки счета| 
 +|id_goods|код товара| 
 +|goods|название товара на момент заказа| 
 +|price|цена| 
 +|quantity|количество| 
 +|sum_price|сумма строки счета| 
 +|vendor_code|код ​поставщика| 
 +|add_fields|дополнительные поля к заказу| 
 +|name|название дополнительного ​поля к товару
 +|value|комментарий,​ оставленный покупателем в дополнительном поле| 
 +|link_for_pay|ссылка на выбор способа оплаты| 
 +|datetime_notify|дата отправки уведомления|
  
-Контрольная сумма MD5 - строкапредставляющая ​собой 32-разрядное число в 16-ричной форме и любом регистре (всего 32 символа ​0-9, A-F)Формируется по строке, содержащей следующие параметры,​ разделенные ':',​ с добавлением %%API%% KEY GET (данный параметр вы можете получить, перейдя в раздел Настройки->​%%API%%,​ вашего магазина):+**Пример запроса о создании счета** 
 +    Array 
 +    ​( 
 +    [id_account] => 370211 
 +    [account_number] => 289 
 +    [account_sum] => 500 
 +    [id_account_status] => 1 
 +    [close_account] => 0 
 +    [id_partner] => 1 
 +    [id_payment_system] => 0 
 +    [close_date] => 0000-00-00 00:00:00 
 +    [date_of_order] => 2019-02-21 15:29:46 
 +    [goods_return] => 0 
 +    [date_of_payment] => 0000-00-00 00:00:00 
 +    [goods_return_date] => 0000-00-00 00:00:00 
 +    [last_name] =>  
 +    [name] =>  
 +    [middle_name] =>  
 +    [email] => a@gmail.com 
 +    [phone_number] =>  
 +    [skype] =>  
 +    [account_comment] =>  
 +    [id_organization] => 0 
 +    [id_delivery_region] => 0 
 +    [area] =>  
 +    [city] =>  
 +    [delivery_address] =>  
 +    [zip_code] =>  
 +    [barcode] =>  
 +    [id_delivery_region_method] => 0 
 +    [id_advertising_channel_page] => 0 
 +    [advertising_channel_keyword] =>  
 +    [advertising_channel_location] =>  
 +    [advertising_channel_type_traffic] =>  
 +    [id_contact] => 3 
 +    [deleted] => 0 
 +    [vk_user] =>  
 +    [fb_user] =>  
 +    [lines] => Array 
 +        ( 
 +            [321] => Array 
 +                ( 
 +                    [id_account_line] => 321 
 +                    [id_goods] => 1 
 +                    [goods] => Вязаная ​игрушка "Котейка" 
 +                    [price] => 500.00 
 +                    [quantity] => 1 
 +                    [sum_price] => 500.00 
 +                    [vendor_code] =>  
 +                    [add_fields] => Array 
 +                        ( 
 +                            [0] => Array 
 +                                ( 
 +                                    [name] => пожелание 
 +                                    [value] => хочу желтую котейку 
 +                                ) 
 +                        ) 
 +                ) 
 +        ) 
 +    [link_for_pay] => https://​mila.autoweboffice.ru/?​r=ordering/​cart/​s2&​id=370211&​vc=1533628675&​lg=ru 
 +    [datetime_notify] => 2019-02-21 15:29:46 
 +    ​)
  
-//​id_account.':'​.date_of_payment.':'​.id_account_line.':'​.id_goods.':'​.api_key_get//​+ ​\\ ​ \\   
 +====Заявки====
  
-===Пример формирования контрольной суммы MD5 на PHP:=== +По заявкам есть 3 типа действий, по которым можно задать отправку уведомленийсоздание заявки, изменение ​заявки,​ удаление заявки 
-<​code>​ + 
-<?php +^Параметр^Описание^ 
-$hash = MD5($id_account.':'​.$date_of_payment.':'​.$id_account_line.':'​.$id_goods.':'​.$api_key_get);​ +|id_callcenter_request|код запроса| 
-?> +|id_contact|код контакта| 
-</​code>​ +|callcenter_request_comment|комментарий к запросу| 
-====Оповещение ​о подписке==== +|id_callcenter_request_result|код результата ​обработки запроса| 
-При открытии страницы после подтверждения подписки, можно передать с АвтоВебОфиса данные ​подписчика  (например, email). Для этого ​в редактировании группы подписчиков "Настройки автоматических оповещений ​сторонних скриптов и сервисов о действиях с подписчиками" необходимо заполнить строку "​%%URL%% оповещения об успешной подписке" ​и в момент успешной активации подписки ​POST-запрос будет отправляться на данный %%url%%. \\ +|id_callcenter_request_lists|код списка ​запросов| 
-{{::​sideservice2.png?​direct|}} \\ +|id_employee|код ответственного ​сотрудника| 
-Пример запроса: +|processed|признак «Обработан»| 
-<​code>​Array +|id_employee_processed|код обработавшего сотрудника| 
-+|id_training_lessons|код обучающего курса| 
-[id_contact=> 67457 +|date_next_call|дата следующего звонка
-[email] => anreiw23wqhnj@ya.ru +|creation_date|дата создания| 
-[id_newsletter=> 3 +|id_account|код счета| 
-[newsletter] => Бесплатный email-курс +|id_callcenter_purpose_call|код цели звонка| 
-[id_partner=> 0 +|id_advertising_channel_page|API код канала рекламы| 
-[subscribed_date=> 2017-08-29 11:08:18 +|advertising_channel_keyword|ключевое слово| 
-[confirmed=> 1 +|advertising_channel_location|место размещения|  
-[confirmed_date] ​=> 2017-08-29 11:08:53 +|advertising_channel_type_traffic|тип трафика| 
-[unsubscribed] ​=> 0 +|deleted|заявка удалена| 
-[unsubscribed_date] ​=> 0000-00-00 00:00:00 +|datetime_notify|дата ​отправки уведомления| 
-)</​code>​ + 
-\\ \\ + ​\\ ​ \\   
-Если у Вас еще ​остались какие-либо вопросы, пожалуйста, обращайтесь в нашу Службу поддержки через кнопку ​[[https://​autoweboffice.com/​support/​open.php|Обратиться в поддержку]], ​по email <​zakaz@autoweboffice.com>​ или ​в окне консультанта на сайте http://​autoweboffice.com+**Пример запроса о создании заявки** 
 + 
 +    Array 
 +    ( 
 +    [id_callcenter_request] => 22 
 +    [id_contact] => 203 
 +    [callcenter_request_comment] =>  
 +    [id_callcenter_request_result] => 0 
 +    [id_callcenter_request_lists] => 1 
 +    [id_employee] => 0 
 +    [processed] => 0 
 +    [id_employee_processed] => 0 
 +    [id_training_lessons] => 0 
 +    [date_next_call] => 2019-02-27 12:24:28 
 +    [creation_date] => 2019-02-27 12:24:28 
 +    [id_account] => 0 
 +    [id_callcenter_purpose_call] => 0 
 +    [id_advertising_channel_page] => 0 
 +    [advertising_channel_keyword] =>  
 +    [advertising_channel_location] =>  
 +    [advertising_channel_type_traffic] =>  
 +    [deleted] => 0 
 +    [datetime_notify] => 2019-02-27 12:24:28 
 +    ) 
 + 
 + ​\\ ​ \\   
 +====Подписка==== 
 + 
 +По подписке есть 2 типа действий,​ по которым можно задать отправку уведомлений: создание подписки, подтверждение подписки ​ 
 + 
 +^Параметр^Описание^ 
 +|id_contact|код контакта
 +|id_newsletter|код группы подписчиков| 
 +|subscribed_date|дата ​подписки
 +|confirmed|подтверждена подписка (0-нет, 1-да) 
 +|unsubscribed|отписался (0-нет, 1-да)| 
 +|email|ящик| 
 +|newsletter|название группы подписчиков| 
 +|datetime_notify|дата отправки уведомления| 
 + 
 + \\  ​\\ ​  
 + 
 +**Пример запроса ​о подписке** 
 + 
 +   Array 
 +   ​
 +   |id_contact|| => 211 
 +   |id_newsletter|| => 10 
 +   |id_partner|| => 0 
 +   |subscribed_date|| => 2019-03-04 16:58:28 
 +   |confirmed|| => 0 
 +   |unsubscribed|| ​=> 0 
 +   |email|| ​=> test23@gmail.com 
 +   |newsletter|| ​=> тестовая группа 
 +   ​|datetime_notify|| => 2019-03-04 16:58:28 
 +   ​
 +====Проверка запросов==== 
 + 
 +Внизу на странице настройки оповещений ​сторонних скриптов раздел "Список последних запросов". Там Вы можете посмотреть все запросыкоторые ​были отправлены на Ваш сервер. {{ ::​67fa74a494.png |}} 
 + 
 +Вы можете зайти в каждый запрос и посмотреть весь ​отправленный массив, статус отправки (успешно или ошибка) и приема его Вашим сервером и ответ от Вашего сервера 
 + 
 +[[sideservice_old|Автоматическое оповещение сторонних ​скриптов и сервисов (устаревшая версия)]]
  
 \\  //​Успехов Вам и до новых встреч!//​ \\  //​Служба заботы о клиентах сервиса АвтоВебОфис//​ \\  //​Успехов Вам и до новых встреч!//​ \\  //​Служба заботы о клиентах сервиса АвтоВебОфис//​