Инструкция к модулю Номинальные счета Точка Банк

Что делает модуль

Модуль связывает маркетплейс CS-Cart Multi-Vendor с расчётами через номинальные счета Точка Банк. Он помогает зарегистрировать продавцов как бенефициаров, получить виртуальные счета, распределять входящие оплаты по заказам, создавать сделки на выплаты и контролировать доступность средств к выводу.

Документы для договора бенефициара и приложения к сделке формируются через стандартный механизм документов CS-Cart. Для работы нужен активный модуль PDF-документы.

Где находится модуль

• Модули → Управление модулями → Номинальные счета Точка Банк — подключение, ключи, настройки бенефициаров, распределения и удержания средств.
• Заказы → Оплаты Точка Банк — нераспределённые заказы, входящие платежи, исходящие платежи и сделки.
• Продавцы → Продавцы → карточка продавца → Точка Банк — данные бенефициара, документы и виртуальный счёт продавца.
• Продавцы → Бухгалтерия — запросы на вывод средств и сделки выплат.
• Администрирование → Способы оплаты — способы оплаты, которые участвуют в распределении через Точка Банк.
• Администрирование → Статусы → Статусы заказов — признаки статусов для распределения и завершения заказов.

Подготовьте доступ к Точка Банк

1. Запросите у Точка Банк тестовый или рабочий доступ и передайте банку IP-адрес сервера магазина.
2. Откройте настройки модуля, вкладку Общее, блок Ключи.
3. Нажмите Генерировать ключи. Модуль заполнит публичный и приватный ключ и подготовит сертификат.
4. Передайте в Точка Банк сертификат var/ms_data/ms_tochka_bank/keys/rsaacert.pem.
5. После подтверждения банка заполните Идентификатор площадки, Отпечаток ключа, Номинальный счёт площадки и БИК площадки.
6. Нажмите Тест подключения. При корректных данных модуль покажет успешный результат.

Приватные ключи скрыты по умолчанию. Для просмотра или ручного редактирования используйте настройки Показывать приватные ключи и Разрешить редактирование ключей.

Настройте общие параметры

1. В блоке Тестовые данные включите или выключите Режим теста.
2. Заполните Номинальный счёт площадки и БИК площадки.
3. Если для тестового пополнения нужны отдельные реквизиты плательщика, заполните Счёт отправителя и БИК отправителя.
4. В поле Статус отменённого заказа выберите статус, при котором всю сумму заказа можно перевести как комиссию маркетплейса.
5. В настройке Кто оплачивает эквайринг выберите маркетплейс или продавец. Если платит продавец, комиссия уменьшает сумму выплаты продавцу; если платит маркетплейс, комиссия остаётся в доле площадки.
6. В блоке Удержание средств задайте количество дней удержания. Значение 0 отключает удержание по сроку.
7. В Возвратных статусах заказов отметьте статусы, при которых средства остаются заблокированными независимо от срока удержания.
8. При необходимости включите логирование и задайте максимальный размер файла логов.

Настройте данные продавцов

1. Откройте Администрирование → Поля профиля → Информация о продавце.
2. Создайте или проверьте поля для юридического типа, ИНН, названия компании, КПП, ФИО, даты и места рождения, паспортных данных, кода подразделения, адреса регистрации, кода страны регистрации, признака резидентства, БИК и расчётного счёта.
3. Для поля юридического типа используйте значения J для юридического лица, I для ИП, F для физлица или самозанятого.
4. В настройках модуля на вкладке Информация бенефициара сопоставьте каждое поле продавца с соответствующей настройкой модуля.
5. Если включена настройка Поля профиля в отдельной вкладке, сопоставленные поля появятся в карточке продавца на вкладке Точка Банк. Если настройка выключена, поля останутся в общей форме профиля.
6. Настройте автоматическую активацию и деактивацию бенефициара, а также статус продавца, который используется при деактивации, если у продавца есть заблокированные средства.
7. При необходимости задайте значение по умолчанию и блокировку поля ТБ: создать сделку в бухгалтерии.

Настройте способы оплаты и статусы заказов

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

Зарегистрируйте бенефициара продавца

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

Распределяйте платежи

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

Команда для регулярного запуска распределения показана на вкладке Дополнительная информация в настройках модуля: php admin.php --dispatch=ms_tochka_bank.identity_payments. Запускайте её не реже чем раз в 96 часов, иначе неидентифицированные платежи могут быть возвращены эквайрингу.

Работайте с выплатами и сделками

1. Переведите заказ в статус с признаком ТБ: считать заказ выполненным.
2. Откройте бухгалтерию продавца и создайте запрос на вывод средств.
3. Убедитесь, что для выплаты включено поле ТБ: создать сделку.
4. Главный администратор подтверждает выплату в бухгалтерии. При подтверждении модуль создаёт сделку, прикрепляет документ и пытается выполнить сделку.
5. Если банк вернул ошибку, выплата отклоняется с текстом причины. Исправьте данные продавца, заказа или сделки и повторите действие.
6. На вкладке Сделки можно открыть сделку, обновить данные, выполнить её или отклонить, если текущий статус позволяет действие.
7. Доступность средств учитывает удержание: пока сделка не выполнена, заказ находится в возвратном статусе или срок удержания не истёк, сумма остаётся недоступной.

Деактивируйте бенефициара

1. Если автоматическая деактивация включена, при отключении продавца модуль проверяет виртуальный счёт бенефициара.
2. Если доступных средств нет, модуль деактивирует бенефициара.
3. Если доступный остаток есть, модуль пытается вывести средства на расчётный счёт продавца.
4. Если есть заблокированные средства, продавец переводится в выбранный в настройках статус, а администратор получает уведомление.

Как проверить работу

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

Если что-то не работает

• Тест подключения не проходит. Проверьте ключи, отпечаток ключа, идентификатор площадки, номинальные счета, БИК и IP-адрес, согласованный с банком.
• Бенефициар не создаётся. Проверьте юридический тип продавца, обязательные поля и сопоставление полей профиля в настройках модуля.
• Виртуальный счёт не появляется. Проверьте, что бенефициар создан, документ бенефициара загружен, а в профиле продавца указан ИНН.
• Заказ не попадает в распределение. Проверьте способ оплаты, флажок Использовать с Точкой Банком и статус заказа с признаком ТБ: распределить средства.
• Сделка на выплату не создаётся. Проверьте виртуальный счёт продавца, ID бенефициара, БИК, расчётный счёт и поле ТБ: создать сделку в выплате.
• Средства недоступны к выводу. Проверьте статус сделки, возвратный статус заказа и срок удержания в настройках модуля.
• Документы не формируются. Проверьте, что модуль PDF-документы активен, а шаблоны документов доступны в админке.