Различия

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

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

sideservice_old [2019/02/28 10:43] (текущий)
annasemukhina создано
Строка 1: Строка 1:
 +=====Автоматическое оповещение сторонних скриптов и сервисов=====
 +====Оповещение о покупке====
 +АвтоВебОфис позволяет автоматически отправлять оповещение о продаже товаров и услуг на указанные %%URL%% сторонних скриптов и сервисов.
  
 +%%URL%% для оповещений указывается в настройках товара,​ в блоке Настройки автоматических оповещений сторонних скриптов и сервисов о продаже данного товара.
 +
 +Для настройки данного функционала:​
 +
 +  - Войдите в раздел «Товары» зарегистрированного в сервисе АвтоВебОфис магазина
 +  - Зайдите на страницу изменения информации по товару и найдите на ней блок «Настройки автоматического оповещения сторонних скриптов и сервисов о продаже данного товара»
 +  - В поле «%%URL%% для отправки оповещений» данного блока укажите адрес, на который должны будут отправляться оповещения о продаже данного товара или услуги
 +  - В поле «Используется» данного блока поставьте галочку
 +{{ ::​sideservice.png |}}
 +\\ \\
 +После этого, в случае продажи данного товара или услуги (смены статуса счета с данным товаров на «Оплачен»),​ на указанный Вами «URL для отправки оповещений» будут отправлены методом $_POST следующие данные:​
 +^Параметр^Описание^
 +|**Информация по счету**||
 +|id_account|Код счета|
 +|account_number|Номер счета|
 +|date_of_order|Дата создания счета|
 +|date_of_payment|Дата оплаты счета|
 +|id_payment_system|Код платежной системы|
 +|id_account_status|Код статуса счета (1 - создан,​ 2 - отказ, 3 - в обработке,​ 4 - ошибка,​ 5 - оплачен)|
 +|**Информация по контакту**||
 +|id_contact|Код контакта|
 +|email|Email,​ указанный при заказе|
 +|phone_number|Телефон,​ указанный при заказе|
 +|last_name|Фамилия|
 +|name|Имя|
 +|middle_name|Отчество|
 +|skype|Skype|
 +|id_country|Код страны|
 +|area|Область/​Край|
 +|city|Город|
 +|delivery_address|Адрес доставки|
 +|zip_code|Почтовый индекс|
 +|**Информация по товару или услуге**||
 +|id_account_line|Код строки счета|
 +|id_goods|Код товара|
 +|vendor_code|Артикул товара|
 +|price|Цена|
 +|quantity|Количество|
 +|sum_price|Сумма стоки счета (цена*количество)|
 +|**Дополнительная информация**||
 +|hash|Контрольная сумма MD5 для формирования подписи удостоверяющей подлинность полученных данных|
 +Скрипт или сервис,​ принимающий данные,​ в случае успеха обработки полученных данных,​ должен вернуть «200 OK». То есть скрипт,​ обрабатывающий оповещение от магазина,​ зарегистрированного в АвтоВебОфис,​ в случае успешной обработки полученных данных,​ должен вывести на страницу текст: 200 OK и только этот текст. ​
 +
 +Пример запроса,​ передаваемого после оплаты товара:​
 +<​code>​Array
 +(
 +[id_account] => 21276
 +[account_number] => 21214
 +[date_of_order] => 2017-05-13 11:01:48
 +[date_of_payment] => 2017-06-01 18:40:35
 +[id_payment_system] => 
 +[id_account_status] => 5
 +[id_contact] => 67426
 +[email] => anr45e1i@yaa.ru
 +[phone_number] => 79261234567
 +[last_name] => 
 +[name] => Андерей
 +[middle_name] => 
 +[id_country] => 0
 +[area] => 
 +[city] => 
 +[delivery_address] => 
 +[skype] => 544848376711111111111
 +[zip_code] => 
 +[id_account_line] => 20524
 +[id_goods] => 1252
 +[price] => 0.01
 +[quantity] => 1
 +[sum_price] => 0.01
 +[vendor_code] => wwweerrr
 +[hash] => a5cbcd800b94f570a0319d675a1c0293
 +)</​code>​
 +В данном случае //​id_account_status = 5// означает,​ что счет успешно оплачен.
 +
 +
 +===Формирование контрольного HASH удостоверяющего подлинность полученных данных:​===
 +
 +Контрольная сумма MD5 - строка,​ представляющая собой 32-разрядное число в 16-ричной форме и любом регистре (всего 32 символа 0-9, A-F). Формируется по строке,​ содержащей следующие параметры,​ разделенные ':',​ с добавлением %%API%% KEY GET (данный параметр вы можете получить,​ перейдя в раздел Настройки->​%%API%%,​ вашего магазина):​
 +
 +//​id_account.':'​.date_of_payment.':'​.id_account_line.':'​.id_goods.':'​.api_key_get//​
 +
 +===Пример формирования контрольной суммы MD5 на PHP:===
 +<​code>​
 +<?php
 +$hash = MD5($id_account.':'​.$date_of_payment.':'​.$id_account_line.':'​.$id_goods.':'​.$api_key_get);​
 +?>
 +</​code>​
 +====Оповещение о подписке====
 +При открытии страницы после подтверждения подписки,​ можно передать с АвтоВебОфиса данные подписчика ​ (например,​ email). Для этого в редактировании группы подписчиков "​Настройки автоматических оповещений сторонних скриптов и сервисов о действиях с подписчиками"​ необходимо заполнить строку "​%%URL%% оповещения об успешной подписке"​ и в момент успешной активации подписки POST-запрос будет отправляться на данный %%url%%. \\
 +{{::​sideservice2.png?​direct|}} \\
 +Пример запроса:​
 +<​code>​Array
 +(
 +[id_contact] => 67457
 +[email] => anreiw23wqhnj@ya.ru
 +[id_newsletter] => 3
 +[newsletter] => Бесплатный email-курс
 +[id_partner] => 0
 +[subscribed_date] => 2017-08-29 11:08:18
 +[confirmed] => 1
 +[confirmed_date] => 2017-08-29 11:08:53
 +[unsubscribed] => 0
 +[unsubscribed_date] => 0000-00-00 00:00:00
 +)</​code>​
 +
 +Если у Вас еще остались какие-либо вопросы,​ пожалуйста,​ обращайтесь в нашу Службу поддержки через кнопку [[https://​autoweboffice.com/​support/​open.php|Обратиться в поддержку]],​ по email <​zakaz@autoweboffice.com>​ или в окне консультанта на сайте http://​autoweboffice.com
 +
 +\\  //​Успехов Вам и до новых встреч!//​ \\  //​Служба заботы о клиентах сервиса АвтоВебОфис//​