Различия

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

--- менеджер_оплат:настройка:модули:seredinas1c [2013/09/12 07:15]
versus создано
+++ менеджер_оплат:настройка:модули:seredinas1c [2013/10/22 04:42] (текущий)
@@ Строка 1: / Строка 1: @@
 ====== Золотая середина ======
+===== Общие положения =====
+Модуль **"Золотая середина"** менеджера оплат Штрих-М  служит для интеграции менеджера оплат Штрих-М с бонусными и дисконтными картами компании **"Золотая середина"**.
+Сам модуль представляет собой динамически подключаемую библиотеку seredinas1c.dll, разработанную в соответствии с требованиями компании Штрих-М.
+===== Требования к системе =====
+Для работы модуля требуется, чтобы был установлен "Терминал для работы с картами "Золотая середина".
+===== Порядок установки и настройки =====
+Установка модуля оплаты seredinas1c.dll производится программой установки Менеджера оплат. Файл seredinas1c.dll помещается в соответствующую папку Менеджера оплат и на него указывается ссылка в файле ShtrihPayMan.ini.
+==== Установка софт терминала и компонентов интеграции компании “Золотая Середина” ====
+  - 	Запустите файл установки setup.exe
+  - 	Софт терминал и компоненты по умолчанию устанавливается в папку  "C:\Program Files\Seredina\wscardterm\"
+  - 	Файл настроек лежит в папке "Общие документы\Seredina".
+  -   Логи лежат в папке "Общие документы\Seredina\Logs\".
+  -   В дополнительных параметрах установите флажки “Установить COM объекты для интеграции”, “Сохранять чеки в любом случае”.
+  -   В появившемся окне укажите номер магазина (бизнес единица) и номер кассы (POS терминал) в котором проходит установка. Магазины нумеруются по порядку. Номер кассы в пределах каждого магазина тоже нумеруется по порядку, начиная с единицы. Эти магазины и кассы должны быть предварительно загружены в CRM компании "Золотая середина" и согласованы с компанией “Золотая Середина”. Также укажите название организации и город, в котором находиться магазин. Адрес указывать необязательно.
+  -   Сохраните настройки, выбрав пункт меню "Файл/Сохранить".
+  -   Завершите установку.
+**Все номера магазинов, которые Вы прописали при установки софт терминала должны быть отправлены в компанию Золотая Середина для синхронизации.
+**
+=== Удаление или переустановка. ===
+Если Вы хотите удалить софт терминал – то запустите setup.exe и выберите опцию удалить.
+Если вы хотите поменять номер магазина, кассы или изменить адрес - необходимо переустановить софт-терминал и компоненты интеграции. Для этого запустите setup.exe и выберите опцию "Удалить".
+===== Настройка слип - чека =====
+Шаблон слип-чека, выдаваемого модулем можно настраивать. Для этого существует закладка "Слип-чек" в окне настроек модуля.
+Шаблон представляет собой произвольный текст со специальными полями, которые будут вычислены и подставлены в чек.
+Каждое подставляемое поле ограничено символом '&' в начале и в конце. Затем идет двухбуквенное регистрочувствительное наименование поля, а затем спецификатор формата. Спецификатор формата должен быть такой же, как для C-функции printf.
+Например, *&SU%8.2f  &* означает поле SU (сумма чека), отформатированное как число с десятичной точкой, с точностью 2 знака после запятой и шириной 8 символов.
+Выравнивание полей осуществляется по правой границе. Если ширина получившегося отформатированного значения получилась меньше, чем ширина строки между начальным и конечным символами '&', производится дополнение пробелами слева (выравнивание по правой границе).
+Ниже представлены поля, которые поддерживаются:
+  * **SU** - сумма чека
+  * **SB** - сумма к оплате за вычетом суммы, оплачиваемой баллами
+  * **CN** - номер карты
+  * **BC** - количество начисленных при операции бонусов
+  * **BD** - количество списанных при операции бонусов
+  * **BB** - баланс карты да операции
+Настройки модуля, включая шаблон слип-чека сохраняются в файле "Общие документы\Seredina\seredinas1c.xml".
+===== Разрешение проблем при работе модуля =====
+Возникающие проблемы можно условно разделить на несколько видов.
+  * Ошибки настройки. Этот класс проблем возникает из-за неправильной установки или настройки модуля.
+  * Ошибки связи. Возникают из-за проблем с сетью.
+  * Ошибки бизнес-логики. Возникают в процессе обработки запросов. Например, сумма баллов для списания превысила лимит списания.
+====   Лог-файлы  ====
+Для помощи в решении проблем можно использовать лог-файлы. Они расположены в папке "Общие документы\Seredina\Logs".
+Каждый файл имеет имя в формате YYYYMMDDКАТЕГОРИЯ.log. Здесь:
+  *  YYYY - год записи в журнал,
+  *    MM - месяц записи в журнал,
+  *    DD - день записи в журнал,
+  *    КАТЕГОРИЯ - строка, идентифицирующая категорию информации. Принимает значения:
+    *     _s1c - лог модуля seredinas1c.dll
+    *     (пусто) - лог OLE-компонента
+    *     _trm - лог терминала
+====   Тестовая утилита testcmdl.exe  ====
+Кроме того, можно воспользоваться утилитой командной строки для тестирования **testcmdl.exe**, которая обеспечивает вызовы функций модуля. Эта утилита расположена там же, где и модуль.
+Схема запуска утилиты:
+**testcmdl.exe [номер карты [/s сумма] [/b баллы_для_списания]]**.
+Здесь:
+  *  [номер карты] - номер бонусной карты для тестирования, по умолчанию 0040019414
+  *  [/s сумма]    - сумма чека, в целых рублях
+  *  [/b баллы_для_списания] - сумма баллов для списания, в целых баллах.
+Вывод утилиты обычно похож на следующий:
+<code>
+> testcmdl.exe [номер карты [/s сумма] [/b баллы_для_списания]]
+Информация о модуле.
+	Версия протокола: 7
+	Имя: "Золотая середина"
+	Дополнтельная информация:
+		ReadCardOnCash: 1
+		MultiAuth: 0
+		ReadPhoneNumberOnCash: 0
+		ReadServiceProviderOnCash: 0
+		MultiCloseDay: 0
+Запрос информации о карте...Успешно.
+Информация о карте:
+	Номер: 0040019414
+	Баланс: 70
+	Скидка: 0
+Продажа с начислением бонусов...
+	Карта: 0040019414
+	Сумма чека: 10
+...Успешно.
+	Начислено баллов: 10
+	Сообщение: Продажа выполнена успешно, начислено 10.00 бонусов.
+	Строка продажи:
+	Строка для печати:
+****************************************
+*    Добро пожаловать в программу      *
+*           <Золотая середина>         *
+****************************************
+* № чека                               *
+* Дата чека:                           *
+* К оплате:           10.00 руб.       *
+* К оплате с учетом бонусов:           *
+*                     10.00 руб.       *
+****************************************
+* № Вашей карты:       0040019414      *
+* Начислено бонусов за покупку         *
+*                              +10.00  *
+* Списано бонусов в счет покупки       *
+*                                0.00  *
+* Баланс бонусов по карте (до покупки) *
+*                               70.00  *
+****************************************
+* При предъявлении карты,              *
+* Вам начисляется 5% бонусов           *
+* от суммы Вашей покупки.              *
+* 1 бонус=1 рубль                      *
+* Оплачивайте бонусами                 *
+* до 50% от суммы покупки.             *
+****************************************
+* БЛАГОДАРИМ ЗА ПОКУПКУ!               *
+* Узнать подробнее об условиях         *
+* программы и текущих акциях           *
+* www.seredina.ru                      *
+****************************************
+Возврат начисленых бонусов...
+	Карта: 0040019414
+	Сумма чека: -10
+...Успешно.
+	Начислено баллов: -10
+	Сообщение: Возврат выполнен успешно
+	Строка продажи:
+	Строка для печати:
+****************************************
+*    Добро пожаловать в программу      *
+*           <Золотая середина>         *
+****************************************
+* № чека                               *
+* Дата чека:                           *
+* К оплате:          -10.00 руб.       *
+* К оплате с учетом бонусов:           *
+*                    -10.00 руб.       *
+****************************************
+* № Вашей карты:       0040019414      *
+* Начислено бонусов за покупку         *
+*                              -10.00  *
+* Списано бонусов в счет покупки       *
+*                                0.00  *
+* Баланс бонусов по карте (до покупки) *
+*                               70.00  *
+****************************************
+* При предъявлении карты,              *
+* Вам начисляется 5% бонусов           *
+* от суммы Вашей покупки.              *
+* 1 бонус=1 рубль                      *
+* Оплачивайте бонусами                 *
+* до 50% от суммы покупки.             *
+****************************************
+* БЛАГОДАРИМ ЗА ПОКУПКУ!               *
+* Узнать подробнее об условиях         *
+* программы и текущих акциях           *
+* www.seredina.ru                      *
+****************************************
+Продажа со списанием бонусов...
+	Карта: 0040019414
+	Сумма чека: 10
+	Баллов для списания: 5
+...Успешно.
+	Списано баллов: 5
+	Сообщение: Продажа выполнена успешно. Списано баллов: 5,00.
+	Строка продажи:
+	Строка для печати:
+****************************************
+*    Добро пожаловать в программу      *
+*           <Золотая середина>         *
+****************************************
+* № чека                               *
+* Дата чека:                           *
+* К оплате:           10.00 руб.       *
+* К оплате с учетом бонусов:           *
+*                      5.00 руб.       *
+****************************************
+* № Вашей карты:       0040019414      *
+* Начислено бонусов за покупку         *
+*                               +0.00  *
+* Списано бонусов в счет покупки       *
+*                                5.00  *
+* Баланс бонусов по карте (до покупки) *
+*                               70.00  *
+****************************************
+* При предъявлении карты,              *
+* Вам начисляется 5% бонусов           *
+* от суммы Вашей покупки.              *
+* 1 бонус=1 рубль                      *
+* Оплачивайте бонусами                 *
+* до 50% от суммы покупки.             *
+****************************************
+* БЛАГОДАРИМ ЗА ПОКУПКУ!               *
+* Узнать подробнее об условиях         *
+* программы и текущих акциях           *
+* www.seredina.ru                      *
+****************************************
+</code>
+====   Проблема с DEP ====
+Кроме того, может иметь место проблема, связанная с включённой защитой от выполнения данных (DEP) для 1С. Она проявляется как ошибка доступа к памяти вида: "access vioaltion at [ADDR]. Write memory at [ADDR]", где [ADDR] - некий адрес в памяти.
+Эту защиту нужно отключать для процесса 1с. Как это сделать, подробнее можно узнать здесь: http://support.microsoft.com/kb/875352.

Штрих-М: Документация

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы