Техническое задание на интеграцию кассового программного обеспечения с виртуальной кассой Regos: VCR.

Общие сведения

Для выполнения базовой интеграции Вашего кассового программного обеспечения (далее КПО) с виртуальной кассой Regos: VCR (далее ВК) предлагаются к реализации следующие задачи:

  1. Открытие / закрытие кассой смены;
  2. Проведение платежей через ЭПС (ClickPass, PaymeGo и др.);
  3. Осуществление регистрации продажи / возврата.

С порядком взаимодействия с API интерфейсом виртуальной кассы можно ознакомиться по ссылке.

Перед началом взаимодействия с ВК рекомендуется проверить ее готовность к работе, вызвав метод Sys.Initialize.

1. Открытие / закрытие кассовой смены

Для открытия и закрытия кассовой смены используются методы ZReport.Open и ZReport.Close соответственно.

Если КПО поддерживает работу с кассовыми сменами, рекомендуется реализовать запись id смены ВК в базу данных КПО.

2. Проведение платежей через ЭПС

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

  1. Провести платеж через ЭПС с помощью метода Payment.Create;
  2. В случае успешного выполнения записать id платежа в базу данных КПО;
  3. Произвести регистрацию продажи, указав значение payment_id из предыдущего пункта.

Важно! Для проведения платежей через ЭПС требуется предварительная настройка ВК специалистом ЦОТУ.

3. Осуществление регистрации продажи / возврата

Для выполнения регистрации продажи необходимо вызвать метод Receipt.Sale.

Для выполнения регистрации возврата рекомендуется выполнить следующие действия:

  1. Считать ссылку на чеке продажи и вызвать метод Receipt.CheckQRCodeUrl;
  2. В случае положительного ответа вызвать метод Receipt.Refund. В объект refund_info, в поле QRCodeURL передать значение ссылки из предыдущего пункта.