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

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

Модуль подключает маркетплейс 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. Если в настройках выбран статус отменённого заказа, на странице заказа можно перечислить всю стоимость такого заказа как комиссию маркетплейса.

Команду для регулярного запуска автоматического распределения можно посмотреть во вкладке Дополнительная информация в настройках модуля.

Вывод средств и сделки

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

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

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

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

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

Устранение неполадок

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