Модуль «Золотая середина» менеджера оплат Штрих-М служит для интеграции менеджера оплат Штрих-М с бонусными и дисконтными картами компании «Золотая середина».

Сам модуль представляет собой динамически подключаемую библиотеку seredinas1c.dll, разработанную в соответствии с требованиями компании Штрих-М.

Для работы модуля требуется, чтобы был установлен «Терминал для работы с картами «Золотая середина».

Установка модуля оплаты seredinas1c.dll производится программой установки Менеджера оплат. Файл seredinas1c.dll помещается в соответствующую папку Менеджера оплат и на него указывается ссылка в файле ShtrihPayMan.ini.

1. Запустите файл установки setup.exe
2. Софт терминал и компоненты по умолчанию устанавливается в папку «C:\Program Files\Seredina\wscardterm\»
3. Файл настроек лежит в папке «Общие документы\Seredina».
4. Логи лежат в папке «Общие документы\Seredina\Logs\».
5. В дополнительных параметрах установите флажки “Установить COM объекты для интеграции”, “Сохранять чеки в любом случае”.
6. В появившемся окне укажите номер магазина (бизнес единица) и номер кассы (POS терминал) в котором проходит установка. Магазины нумеруются по порядку. Номер кассы в пределах каждого магазина тоже нумеруется по порядку, начиная с единицы. Эти магазины и кассы должны быть предварительно загружены в CRM компании «Золотая середина» и согласованы с компанией “Золотая Середина”. Также укажите название организации и город, в котором находиться магазин. Адрес указывать необязательно.
7. Сохраните настройки, выбрав пункт меню «Файл/Сохранить».
8. Завершите установку.

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

Если Вы хотите удалить софт терминал – то запустите 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 [номер карты [/s сумма] [/b баллы_для_списания]].

Здесь:

• [номер карты] - номер бонусной карты для тестирования, по умолчанию 0040019414
• [/s сумма] - сумма чека, в целых рублях
• [/b баллы_для_списания] - сумма баллов для списания, в целых баллах.

Вывод утилиты обычно похож на следующий:

> 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                      *
****************************************

Кроме того, может иметь место проблема, связанная с включённой защитой от выполнения данных (DEP) для 1С. Она проявляется как ошибка доступа к памяти вида: «access vioaltion at [ADDR]. Write memory at [ADDR]», где [ADDR] - некий адрес в памяти. Эту защиту нужно отключать для процесса 1с. Как это сделать, подробнее можно узнать здесь: http://support.microsoft.com/kb/875352.