Различия

Показаны различия между двумя версиями страницы.

--- public:doc:cashdesk:arcus2 [14:58 30/07/2019] – создано ili
+++ public:doc:cashdesk:arcus2 [07:57 29/05/2025] (текущий) – [Пути] t1meow
@@ Строка 1: / Строка 1: @@
-====== Arcus2 ======
+====== Кассовый эквайринг Arcus2 ======
+[[http://ingenico.ru/solu-3-reshenie_ARCUS2.html|Arcus2]] - протокол эквайринга компании [[http://ingenico.ru/|Ingenico]], поддерживается подавляющим числом Банков.
+===== Установка =====
 <WRAP center round important 60%>
@@ Строка 5: / Строка 10: @@
 В ином случае интеграция работать не будет!
+Версия Arcus2 не ниже **2.1.0.16**
 </WRAP>
@@ Строка 20: / Строка 27: @@
 Используемый код валюты: ''643''
 </WRAP>
+==== Порядок приема работ от поставщика пинпада\эквайринга ====
+В ходе подключения пинпада, со стороны его поставщика должны быть выполнены следующие работы:
+  - Установка драйверов пинпада на ПК заказчика
+  - Установка Arcus2 на ПК заказчика
+  - Подключение пинпада к ПК заказчика
+  - Выполнение тестовых операций при помощи утилиты ''CommandLineTool.exe'' входящей к комплект ПО заказчика:
+    - Выполнение операции оплаты
+    - Выполнение операции отмены оплаты
+    - Проверка наличия следующих файлов после проведения каждой операции (в папке ''c:\Arcus2''):
+      * ''output.dat''
+      * ''output_ex.dat'' - текстовый файл с информацией об операции, должен содержать строку ''RC=000'' или ''RC=0''
+      * ''output_ex.txt'' - текстовый файл с информацией об операции
+      * ''cheq.out'' - в файле должен быть текст банковского слипа, с информацией об успешно проведенной оплате или отмене
 ===== Пути =====
@@ Строка 29: / Строка 52: @@
   * ''C:\Arcus2\CommandLineTool\bin\CommandLineTool.exe''
   * ''C:\Arcus2\ini\ops.ini''
+  * ''C:\Arcus2\ini\cashreg.ini''
-Файлы ответа (''chek.out'', ''output_ex.dat'' и ''output_ex.txt'') должны формироваться в ''C:\Arcus2''
+Файлы ответа (''chek.out'', ''output_ex.dat'' и ''output_ex.txt'') должны формироваться в ''C:\Arcus2'' (не всегда). Также файлы ответа могут лежать в папке :
+{{ :public:doc:cashdesk:logsarcus2.png?600 |}}
+===== Настройка =====
+<WRAP center round important 60%>
+При подключении по USB: [[public:doc:deny_usb_power_off|]]
+</WRAP>
+==== cashreg.ini ====
+Файл должен быть расположен в ''C:\Arcus2\ini\'', содержит основные настройки соединения с пин-падом:
+  * PORT - имя COM порта, по которому подключен пин-пад. Обычно физически пин-пад подключен к компьютеру через USB, при этом устройство встает как виртуальный ком порт. Данная настройка должна совпадать с номером порта в системе. Если вы не можете определить какой из виртуальных портов пин-пад - выключите его, один из портов должен пропасть, потом включите, он снова должен появиться, используйте его номер для настройки.
+==== Заголовок ====
+<WRAP center round important 60%>
+Номер порта должен быть **меньше** 9! Если он больше, смените в настройках системы его номер на другой!
+</WRAP>
+Смена настройки порта:
+  - В диспетчере устройств находим нужное устройство в разделе "Порты COM и LPT"\\ {{:public:doc:cashdesk:arcus_com_1.png|}}
+  - Выбрать устройство, открыть его свойство и на вкладке "Параметры порта" нажать "Дополнительно"\\ {{:public:doc:cashdesk:arcus_com_2.png|}}
+  - В открывшемся окне выбрать новый порт\\ {{:public:doc:cashdesk:arcus_com_3.png|}}
 ===== Реализуемые операции =====
@@ Строка 42: / Строка 89: @@
   * Закрытие дня (сверка итогов): ''10=2,1''
-Фактически это означает, что касса "подстроится" под текущие настройки Arcus2. В случае если в ''C:\Arcus2\ini\ops.ini'' определено несколько кодов операции для одной пары класс+идентификатор операции будет использован первый определенный код.
+Фактически это означает, что касса "подстроится" под текущие настройки Arcus2. В случае если, в ''C:\Arcus2\ini\ops.ini'' определено несколько кодов операции для одной пары класс+идентификатор операции будет, использован первый определенный код.
 ===== Определение RRN =====
@@ Строка 48: / Строка 95: @@
 В ходе тестирования выявлено, что в файлах ответа не всегда появляется идентификатор операции (RRN), т.е. он банально не заполнен. Данный идентификатор **обязателен** для корректной отмены операции (и/или возврата в течение текущего дня).
-В случае если в файлах ответа не содержится RRN, программа будет искать в чеке строку вида **RRN   123456789012** и цифровое значение следующее после "RRN", длиной не менее 6 символов будет считаться как RRN операции.
+В случае если в файлах ответа не содержится RRN, программа будет искать в чеке **первую** строку вида "RRN   123456789012" и цифровое значение следующее после "RRN", длиной не менее 6 символов будет считаться как RRN операции.
 ===== Журнал операций =====
@@ Строка 55: / Строка 102: @@
 Arcus2 не поддерживает возможности просмотра журнала операций пин-пада.
 </WRAP>
+===== Проблемы =====
+==== Деньги с карты списались, но программа сочла это ошибкой ====
+После списания денег с карты программа выдала ошибку, с текстом ''992: УСПЕШНО'' (цифра может быть другой, текст тоже, но семантически мы понимаем что якобы списание прошло успешно, или же клиент нам показывает, что деньги  списались). Это значит, что пинпад вернул программе статус ''992'', который он по каким-то причинам считает успехом, а программа - **нет**.
+В протоколе Arcus2 успешным считается **только** статус операции ''000'', все остальные - **ошибка**. Поэтому все операции со статусом отличным от ''000'' программа считает ошибочными, т.е. списания средств по ним быть не должно. Номер ошибки, это статус который возвращает нам Arcus2
+<WRAP center round info 60%>
+В этом случае следует обратиться в банк эквайер для разъяснения ситуации по спорной транзакции. В случае если деньги всё же списаны вернуть их через личный кабинет юридического лица банка эквайера или через его службу поддержки!
+</WRAP>
+=== Для справки ===
+<WRAP center round important 60%>
+Информация ниже приведена для справки, **не настраивайте эквайринг самостоятельно**!
+</WRAP>
+В настройках Arcus2 (которые **должен делать банк**) есть два файла:
+  * ''rc_res.ini'' - в нем содержится текстовое описание статусов (т.е. там должна быть запись ''992=УСПЕШНО'')
+  * ''rc_conv.ini'' - этот файл отвечает за преобразование статусов (т.е. он позволяет сказать что тот или иной статус является по сути успехом), так вот в этом файле в таком случае должна быть запись ''992=000''.
+<WRAP center round important 60%>
+В эти файлы лезть категорически нельзя! Нужно что бы банк разобрался с настройками Arcus2 в соответствии со своими правилами.
+</WRAP>
 {{tag>public doc cashdesk_doc}}