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

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

===== Общие положения =====
Модуль **"Золотая середина"** менеджера оплат Штрих-М  служит для интеграции менеджера оплат Штрих-М с бонусными и дисконтными картами компании **"Золотая середина"**. 

Сам модуль представляет собой динамически подключаемую библиотеку 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.
Штрих-М: Документация

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

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

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