Инструкция по модулю MS: Точка Банк

Установка

1. Установите и включите модуль MS: Точка Банк.
2. Убедитесь, что в магазине установлен модуль pdf_documents, так как он используется для шаблонов документов по бенефициару и сделкам.
3. После установки откройте Администрирование → Модули → MS: Точка Банк.

Подготовка доступа к API

1. Подайте заявку в Точка Банк с запросом доступа к test/preprod API и укажите IP-адрес сервера магазина.
2. В настройках модуля на вкладке «Общее» нажмите «Генерировать ключи».
3. Передайте сотрудникам Точка Банк файл var/ms_data/ms_tochka_bank/keys/rsaacert.pem.
4. После подтверждения со стороны банка заполните в настройках модуля параметры sign-system, thumbprint, номинальный счёт и БИК.

Настройка модуля

Модуль содержит три основные вкладки настроек.

• Общее — тестовый режим, реквизиты номинального счёта, управление ключами, логирование и тестовое пополнение.
• Информация бенефициара — сопоставление полей профиля продавца с полями Точка Банк, включая ИНН, ФИО, паспортные данные, адрес регистрации, код страны регистрации и признак налогового резидентства.
• Дополнительная информация — служебная вкладка с дополнительными сведениями по модулю.

Если вы храните данные продавца в отдельных полях профиля, сначала создайте их в Администрирование → Поля профиля → Информация о продавце, а затем сопоставьте в настройках модуля.

Использование

1. Регистрация бенефициара

1. Откройте карточку продавца и заполните поля для Точка Банк.
2. Для юрлица заполните ИНН, название организации и КПП.
3. Для ИП, самозанятых и физлиц заполните ФИО, дату и место рождения, паспортные данные, адрес регистрации, код страны регистрации и признак налогового резидентства, если эти поля сопоставлены в модуле.
4. Нажмите кнопку получения бенефициара или сохраните карточку продавца, чтобы модуль создал либо обновил бенефициара.
5. После успешной обработки проверьте, что у продавца появились идентификатор бенефициара, документ бенефициара и виртуальный счёт.

2. Работа с документами

1. Модуль может загрузить документ бенефициара из файла или сформировать его автоматически по шаблону.
2. Для сделок используется отдельный PDF-документ, который формируется через тип документа deal_invoice.
3. На странице продавца модуль показывает сведения о документах бенефициара и статусы их проверки, если они уже возвращаются API Точка Банк.

3. Платежи и выплаты

1. В способе оплаты включите использование с Точка Банк.
2. Перейдите в Заказы → Оплаты Точка Банк, чтобы просматривать входящие платежи, внутренние платежи и сделки.
3. На странице платежей используйте автоматическое распределение, чтобы связать входящие поступления с заказами и виртуальными счетами продавцов.
4. Для вывода средств продавец создаёт заявку в бухгалтерском учёте, а администратор подтверждает выплату и формирует сделку.

Проверка работы

1. Включите тестовый режим и выполните тестовое пополнение из настроек модуля.
2. Проверьте тест подключения к API после ввода ключей и реквизитов.
3. Создайте тестового продавца и убедитесь, что после сохранения появляются идентификатор бенефициара и виртуальный счёт.
4. Проверьте, что данные документов бенефициара и статусы проверки отображаются на карточке продавца.
5. Создайте тестовый заказ с оплатой через Точка Банк и убедитесь, что платёж появляется на странице «Оплаты Точка Банк».
6. Создайте тестовую выплату продавцу и убедитесь, что модуль формирует сделку и документ по сделке.

Типовые проблемы

• Нет доступа к API. Проверьте, что банк открыл доступ для IP-адреса магазина, а в настройках заполнены корректные ключи и реквизиты.
• Не создаётся бенефициар. Проверьте заполнение и сопоставление обязательных полей профиля продавца.
• Не появляется виртуальный счёт. Убедитесь, что бенефициар создан успешно и по нему загружен либо сгенерирован документ.
• Паспортные данные или адрес становятся равны 0. Исправьте значения в полях продавца и повторно сохраните карточку.
• Не формируются PDF-документы. Проверьте наличие и настройку модуля pdf_documents и шаблонов документов модуля.

Ключевые файлы модуля

• app/addons/ms_tochka_bank/addon.xml — схема модуля и настройки
• app/addons/ms_tochka_bank/controllers/backend/ms_tochka_bank.php — backend-страницы платежей, сделок и тестовых действий
• app/addons/ms_tochka_bank/controllers/backend/companies.post.php — интеграция с карточкой продавца
• app/addons/ms_tochka_bank/Tygh/Addons/MsTochkaBank/MsTochkaBank.php — основной клиент API Точка Банк
• app/addons/ms_tochka_bank/Tygh/Addons/MsTochkaBank/Entities/Beneficiary.php — логика работы с бенефициарами
• app/addons/ms_tochka_bank/resources/document_templates.xml — шаблоны документов по бенефициару и сделке
• app/addons/ms_tochka_bank/info/*.html — описание, инструкция и changelog модуля