Дисклэймер
Данная публикация основана на //infostart.ru/public/828931/
В свою очередь, та публикация основана на //infostart.ru/public/304373/
Также, в публикации использована инструкция с сайта 1c-e.ru
Выражаю огромную благодарность авторам этих публикаций и посвящаю им эту обновлённую версию :)
Также, в подсистеме участвует консоль заданий //infostart.ru/public/617615/
Работоспособность проверена на платформе 8.3.13.1690
Описание
Данная подсистема представляет из себя лёгкий и упрощённый вариант интеграции 1С и Яндекс.Деньги
Что умеет:
- работать с несколькими кошельками
- загружать историю операций
- принимать HTTP-уведомления о вх.поступлениях, выполненных через веб-формы (но это не точно)
- вести внутренний учёт
- автоматически загружать актуальную историю и баланс
Инструкция
1. Регистрируете приложение на сайте яндекс.деньги
На странице регистрации приложения указываем
- Название приложения (по вашему усмотрению)
- Адрес вашего сайта (URL или IP веб-сервера, где будет опубликована БД 1С)
- Редирект URI
- Использовать проверку подлиности приложения (для большей безопасности наша БД использует client_secret)
Шаблон Редирект URI (для совместимости с нашей системой на 1С) – http://mysite.ru/pay/hs/ym/НомерКошелька/ , где
- mysite.ru – адрес сервера
- pay – имя публикации
- hs – служебная часть адреса, указывающая на работу hs 1c
- ym – имя http-сервиса в 1С (необходима публикация базы на веб-сервере)
- НомерКошелька – номер счета Яндекс.Денег
При настройке своих приложений вам потребуется указать адрес используемого веб-сервера и номер счета. Если публикуете базу под другим названием, то замените имя публикации pay на выбранное вами. Остальные части Редирект URI оставляйте как есть.
Нажимаем "Подтвердить". Оказываемся на форме ввода СМС, снова нажимаем "Подтвердить", на указанный при регистрации в Яндекс мобильный телефон приходит СМС, указываем код СМС и заканчиваем регистрацию.
По окончании процедуры регистрации нам выдаются
- Идентификатор приложения (он же client id)
- OAuth2 (он же client_secret)
Сохраняем Номер кошелька, значения Редирект URI, Идентификатор приложения, client_secret . Они потребуются для получения постоянного токена в дальнейшем, который понадобиться для доступа к API
2. Настраиваем 1С
Чтобы получить access_token мы должны предварительно настроить веб-сервер и опубликовать на нем http-сервис ЯндексДеньги
Публикуем базу на веб-сервере.
Вводим новый элемент в справочник "Кошельки". Заполняем наименование (можно любое), номер кошелька (обязательно), email (обязательно), на вкладке "Настройки" заполняем соотв.поля (они также обязательны), записываем элемент.
Для запуска процедуры получения access_token возвращаемся в список кошельков и жмём на жёлтую кнопку вверху "Авторизация". Откроется новое окно и жмем кнопку "Отправить запрос на авторизацию". При этом на клиенте откроется веб-страница с запросом доступа приложения. После подтверждения доступа происходит редирект на адрес нашего http-сервиса, и при успехе в соответствующий элемент справочника Кошельки записывается реквизит access_token, а на экране появляется сообщение о получении токена.
Срок действия токена на текущий момент составляет 3 года. По истечении этого срока необходимо будет повторно пройти процедуру его получения.
Получив access_token, можно обращаться к методам API.
Примечание. Переход на Redirect-URI после подтверждения доступа приложения происходит редиректом, а токен передается в заголовке запроса. Это означает, что веб-сервер не обязан быть виден извне. Он может быть внутренним и даже локальным.
3. Загружаем историю в 1С
3.1 Ручной режим
Для этого переходим в Сервис->Загрузка операций ЯД. Выбираем там нужный кошелёк, период (если нужно) и нажимаем "Обновить".
В таблице должны отразиться операции по кошельку, если они были за указанный период. Если период не указывать, то вернётся абсолютно вся история кошелька с самого начала. Далее, нажимаете "Загрузить историю операций" (если операций в этом списке нет, то ничего не загрузится).
3.2 Автоматический режим
Для работы в автоматическом режиме в справочнике "Кошельки" у элемента нужно поставить галочку "Автоматическая синхронизация". После этого, каждый час информация за текущие сутки будет автоматически загружаться и обновляться информация о балансе. Вы можете настроить расписание с помощью Сервис -> Консоль заданий -> Синхронизация Яндекс.Деньги.
4. Настройка оперативных уведомлений о пополнений о пополнении (необязательно).
Открываете на сайте яндекс.деньги раздел "Настройки кошелька", далее переходите на вкладку "Пакеты / другие сервисы", раздел "Сбор денег" и пункт "Уведомления" и жмёте "Настроить".
В поле сверху указываете адрес нашего Redirect URI http://mysite.ru/pay/hs/ym/НомерКошелька/
Секретное слово записываете в соотв. реквизит справочника "Кошельки".
Примечание: при приёме HTTP-уведомлений происходит проверка на хэш, согласно документации API Яндекс.Деньги. По тестовой проверке совпадений у меня не было, но техподдержка ответила, что в боевом режиме всё должно быть нормально. Я это не проверял, т.к. данный функционал по сути лишний, и просто дублирует автоматическую загрузку. Использовать не рекомендуется.
Примечание 2: если в базе у вас будет заведён пользователь, то нужно указывать перед адресом имя пользователя БД и пароль, иначе HTTP-запрос не пройдёт авторизацию в 1С.
5. Детальный анализ.
Конечной точкой является отчёт "Движения денежных средств Яндекс.Деньги". У этого отчёта два режима работы - остатки и диаграмма. По остаткам вы увидите детальные операции, а также актуальный остаток на тот или иной период.
В режиме диаграммы, вы сможете наглядно оценить ваши поступления и затраты.
Как это работает
Технически, данная подсистема ничего сложного не представляет и её можно безболезненно интегрировать с любой вундервафлей. Основой всего служит регистр сведений "История операций". Туда загружается абсолютно вся инфа, которую представляет API. Далее, создаётся документ "Операция", его можно найти в списке документов "Журнал операций". Данный документ делает движения по регистру накопления "Баланс" и вы видите эту информацию в отчёте.
P.S. Платёжный функционал не делал, т.к. мне это не нужно. Если кто-то докрутит по такому же образцу, с минимумом наворотов - будет круто.
