Общая информация

Инструкция по настройке ABCP Agent

ABCP Agent — десктопное приложение для печати документов и стикеров напрямую из Панели управления, а также для приёма оплат через POS-терминалы.

Возможности приложения:

• Быстрая печать документов и стикеров без промежуточного сохранения PDF на компьютере сотрудника;
• Печать с любого компьютера, даже если он не находится в одной локальной сети с принтером;
• Приём оплат через POS-терминал прямо на кассе

Видеоинструкция по настройке ABCP Agent YouTube и VK.

Установка ABCP Agent

Установка ABCP Agent возможна для операционных систем:

• Windows
• MacOs
• Linux

Скачать приложение можно по ссылке

Печать через ABCP Agent

Принтер

XPrinter XP-370B - На данном принтере производится тестирование разработчиками. При этом возможна работа системы и с другим оборудованием.

Настройки в ПУ и ABCP Agent

1. В Панели Управления создайте новый принтер

   • Заполните его название
   • Сгенерируйте ключ
   • Выберите формат печати. При отправке на печать стикеров и ценников из ПУ, система будет предлагать только приложения, у которых в настройке "Формат печати" задано "Печать стикеров".
   • Сохраните настройки.

   

2. Рядом с созданным принтером нажмите на кнопку "Копировать настройки".

   

3. Запустите на компьютере приложение ABCP Agent

4. Откройте пункт меню "Принтеры" и нажмите на кнопку добавления нового принтера.

   

5. Чтобы не переносить настройки приложения вручную, нажмите на кнопку "Импорт из буфера"

   

6. Выберите какой принтер будет использоваться при печати через данное приложение. Дополнительно также можно изменить параметры ориентации и размера бумаги, а также разрешения печати. По умолчанию применяются настройки заданные в драйвере принтера, но для каждого приложения их можно переопределить.

7. Сохраните настройки принтера в приложении ABCP Agent. Если все прошло успешно, то рядом с только что добавленным принтером вы увидите статус "Подключен".

   

8. Приложение готово к печати.

Отправка команды на печать стикера

Отправить документ на печать можно из разных разделов ПУ. Например, вы можете отправить на печать стикеры для позиций приемки:

Запросы на печать можно отправлять даже если приложение не подключено. В этом случае документ попадет в очередь и будет распечатан после подключения приложения к ПУ.

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

POS-терминалы

POS‑терминал — это специализированное устройство на кассе, предназначенное для обработки безналичных платежей. Позволяет принимать оплату за товары и услуги банковскими картами, телефонами, часами и другими средствами бесконтактной оплаты. Для покупателя это простой и удобный способ оплаты, а для бизнеса — инструмент для быстрого обслуживания, контроля продаж и работы с безналичными расчётами.

Условия приема оплат через POS-терминал

Чтобы магазин мог принимать оплаты через POS-терминал, нужно выполнить несколько базовых условий:

• Для зачисления средств от безналичной оплаты нужен расчетный счет
• Магазин должен заключить договор с банком или эквайринг‑провайдером на подключение POS-терминала и обработку платежей
• Необходимо иметь платежный терминал, который поддерживает нужные способы оплаты (контактный, бесконтактный, мобильные платежи). Его можно получить у банка или арендовать у провайдера.

Настройка POS-терминала

POS-терминал обычно настраивает банк, платежный провайдер или технический специалист компании, которая предоставляет оборудование и услуги эквайринга. В зависимости от схемы работы настройка может выполняться при выдаче терминала, во время его установки в торговой точке или удаленно.

Примечание

ABCP поддерживает не все POS-терминалы. Перед настройкой убедитесь, что ваш терминал работает по одному из поддерживаемых протоколов.

Поддерживаемые на платформе протоколы POS-терминалов

Перед началом настройки POS-терминала необходимо убедиться, что ваше устройство соответствует протоколам, поддерживаемым ABCP:

• Inpas:
  • DualConnector 2.0 (доступно для Windows и Linux)
• Sber:
  • TTK2 UPOS Extension (доступно для любой ОС, рекомендуемый вариант для Mac и Linux)
  • sb_pilot (доступно для Windows и Linux)

Уточнить, по какому именно протоколу работает ваш терминал, можно в клиентской поддержке вашего банка.

Настройки для подключения терминала в ПУ

1. Проверьте версию приложения ABCP Agent. Поддержка POS-терминалов доступна с версии 3.1.0.x

2. В Панели управления на странице "POS-терминалы и принтеры" добавьте новый POS-терминал

   

   • Заполните его название
   • Сгенерируйте ключ
   • Сохраните настройки.

3. Рядом с созданным приложением нажмите на кнопку "Копировать настройки"

   

4. Запустите на компьютере приложение ABCP Agent.

5. Откройте пункт меню "POS-терминалы" и нажмите на кнопку добавления нового устройства.

6. Чтобы не переносить настройки приложения вручную, нажмите на кнопку "Импорт из буфера"

7. Выберите тип протокола вашего терминала

   • для протоколов SB_Pilot укажите путь к файлу SB_Pilot на вашем компьютере.
   • для протоколов Inpas и SberTTK параметры подключения необходимо уточнить у банковского специалиста, выполнявшего установку терминала.

Настройка и работа в модуле заказов 1.0

Настройка способа оплаты

Для приёма оплат через POS-терминал в заказах 1.0 необходимо выполнить два шага:

1.Создать конфигурацию платёжной системы Перейдите в раздел: Настройки - Финансы - Настройка платёжных систем

Добавьте новую платёжную систему с типом "Pos-терминал"

В поле "POS-терминал" выберите нужный терминал из числа настроенных на странице POS-терминалы и принтеры.

Сохраните конфигурацию.

2. Создать тип платежа "POS-терминал"

Перейдите в раздел: Настройки - Финансы - Типы платежей

Создайте новый тип оплаты: Указать:

Тип оплаты - указать POS-terminal

Конфигурацию терминала - выберите в нём созданную ранее конфигурацию платёжной системы. Одна конфигурация может быть привязана только к одному типу платежа.

При необходимости включите отправку чека в Комтет (чекбокс "Требуется чек") и заполните остальные поля. На этом настройка терминала завершена.

Проведение оплаты и возврата в заказах 1.0

Добавление оплаты

Добавить новую оплату можно в разделе "Платежи", в списке заказов или в окне создания отгрузки. Нужно указать сумму оплаты и выбрать способ, настроенный на предыдущем шаге. После этого в ПУ будет отображен процесс проведения оплаты, а на терминал будет отправлен запрос. В зависимости от терминала пользователь сможет внести оплату картой, сканированием QR-кода, улыбкой.

Ожидание и завершение оплаты

Пока идёт взаимодействие с банком и терминалом, закрыть окно ожидания нельзя. Возможны три сценария ответа от платежной системы, если включена отправка чека:

1.Успех с отправкой чека - Платёж создаётся, чек уходит в Комтет.

2.Успех без отправки чека - При ошибке отправки чека платёж всё равно сохраняется, появляется предупреждение "Оплата прошла успешно. Возникла ошибка при отправке чека в Комтет." В списке платежей такой платёж будет отмечен специальной иконкой с подсказкой "Чек не отправлен".

3.Ошибка оплаты - Платёж не создаётся.

Возврат

Возврат средств на карту клиента выполняется аналогично, через кнопку "Возврат" у подтверждённого платежа. При нажатии "Вернуть" вызывается операция возврата на терминале, формируется чек возврата (если включена отправка чеков). Все ошибки обрабатываются так же, как и при оплате.

Отображение на сайте

В корзине интернет-магазина способ оплаты "POS-терминал" отображается наравне с другими, но без кнопки "Оплатить" (так же, как и у способа оплаты "Наличные"). Оплатить заказ через сайт этим способом нельзя. Если покупатель выбрал его при оформлении, в уведомлении о заказе будет указано "POS-терминал", а в Панели управления при добавлении оплаты этот тип будет автоматически предвыбран.

Настройка и работа в модуле заказов 2.0

Настройка способа оплаты

1. На странице "Настройки" - "Способы оплаты" добавьте новый способ оплаты с типом “Платежный терминал”

   

2. На вкладке "Настройки" выберите, для какого именно терминала доступен данный способ оплаты

   

Проведение оплаты и возврата

Добавить новую оплату можно в разделе "Платежи 2.0", в списке заказов или в окне создания отгрузки. Нужно указать сумму оплаты и выбрать способ, настроенный на предыдущем шаге. После этого в ПУ будет отображен процесс проведения оплаты, а на терминал будет отправлен запрос. В зависимости от терминала пользователь сможет внести оплату картой, сканированием QR-кода, улыбкой.

В случае успешного проведения оплаты Платеж 2.0 будет создан в статусе "Подтвержден" и можно будет сформировать чек в Комтет при необходимости.

При возникновении какой-либо ошибки система отобразит вам код и описание ошибки, а также предложит повторить платеж. Неуспешная попытка оплаты будет записана как Платеж 2.0 со статусом "Отклонено". При клике на “Повторить” в ПУ откроется окно добавления нового платежа, его данные автоматически будут предзаполнены системой на основе предыдущей оплаты.

Для проведения возврата выберите подтвержденный платеж и нажмите на кнопку "Создать возврат". При клике на "Добавить" в ПУ будет отображен процесс проведения возврата, идентичный процессу проведения оплаты.

Дополнительные настройки

В приложении ABCP Agent предусмотрены дополнительные настройки в отдельном пункте меню. Они позволяют указать, какие события должны отображаться в журнале (все или, например, только ошибки). Также вы можете настроить автоматический запуск приложения при загрузке системы, сворачивание в системный трей при запуске или закрытии, показ заметок о версии после обновления приложения, векторную печать PDF, а также при необходимости указать настройки прокси-сервера.

Логирование событий

Приложение ABCP Agent ведёт журнал всех событий. При обращении в техническую поддержку логи помогут быстрее разобраться в ситуации и устранить проблему.

Сохранения файла с логами:

1. Откройте раздел "Настройки"

2. В пункте "Журнал" выберите значение "Полный" (этот режим записывает все технические детали работы приложения):

   

3. Перейдите в раздел "Журнал"

4. Нажмите на кнопку:

   

5. Сохраните открывшийся файл с логами за текущий день

6. Прикрепите файл к заявке в техническую поддержку

Логи за предыдущие дни находятся в папке:
C:\Users\Public\printapp2\settings\logs

Дополнительные логи платёжных протоколов

Для диагностики работы платёжных терминалов могут потребоваться логи протоколов:

• Sber (sb_pilot)
  Расположение: <SB_PILOT_DIR>\uposXXXX.log
  Обычно находятся в: C:\upos\uposXXXX.log

• inpas
  Расположение: C:\Program Files (x86)\INPAS\DualConnector\Service\log\ConnectorYYYYmmDD.log

• Sber (TTK)
  Отдельных логов нет, достаточно логов из приложения.