====== Золотая середина ====== ===== Общие положения ===== Модуль **"Золотая середина"** менеджера оплат Штрих-М служит для интеграции менеджера оплат Штрих-М с бонусными и дисконтными картами компании **"Золотая середина"**. Сам модуль представляет собой динамически подключаемую библиотеку 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 баллы_для_списания] - сумма баллов для списания, в целых баллах. Вывод утилиты обычно похож на следующий: > 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 ==== Кроме того, может иметь место проблема, связанная с включённой защитой от выполнения данных (DEP) для 1С. Она проявляется как ошибка доступа к памяти вида: "access vioaltion at [ADDR]. Write memory at [ADDR]", где [ADDR] - некий адрес в памяти. Эту защиту нужно отключать для процесса 1с. Как это сделать, подробнее можно узнать здесь: http://support.microsoft.com/kb/875352.