Различия

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

--- менеджер_оплат:настройка:модули:seredinas1c [2013/09/12 10:17]
fukalov [Списание баллов.]
+++ менеджер_оплат:настройка:модули:seredinas1c [2013/10/22 04:42] (текущий)
@@ Строка 13: / Строка 13: @@
 ===== Порядок установки и настройки =====
-При установке терминала требуется включить флажок "Устанавливать OLE-компоненты для интеграции".
+Установка модуля оплаты seredinas1c.dll производится программой установки Менеджера оплат. Файл seredinas1c.dll помещается в соответствующую папку Менеджера оплат и на него указывается ссылка в файле ShtrihPayMan.ini.
-Сам файл seredinas1c.dll помещается в соответствующую папку менеджера оплат и на него указывается ссылка в файле ShtrihPayMan.ini.
-Для работы OLE-компонентов требуется наличие файла настроек wscardterm.ini либо в той же папке, что и модуль seredinas1c.dll, либо в папке "Общие документы\Seredina". В папку "Общие документы\Seredina" файл настроек попадает при установке терминала для работы с картами "Золотая середина".
-===== Порядок использования. =====
-Ниже перечислены основные операции, реализуемые модулем, а также значения полей, которые модуль ожидает при вызове.
+==== Установка софт терминала и компонентов интеграции компании “Золотая Середина” ====
-==== Запрос баланса. ====
+  - 	Запустите файл установки setup.exe
+  - 	Софт терминал и компоненты по умолчанию устанавливается в папку  "C:\Program Files\Seredina\wscardterm\"
+  - 	Файл настроек лежит в папке "Общие документы\Seredina".
+  -   Логи лежат в папке "Общие документы\Seredina\Logs\".
+  -   В дополнительных параметрах установите флажки “Установить COM объекты для интеграции”, “Сохранять чеки в любом случае”.
+  -   В появившемся окне укажите номер магазина (бизнес единица) и номер кассы (POS терминал) в котором проходит установка. Магазины нумеруются по порядку. Номер кассы в пределах каждого магазина тоже нумеруется по порядку, начиная с единицы. Эти магазины и кассы должны быть предварительно загружены в CRM компании "Золотая середина" и согласованы с компанией “Золотая Середина”. Также укажите название организации и город, в котором находиться магазин. Адрес указывать необязательно.
+  -   Сохраните настройки, выбрав пункт меню "Файл/Сохранить".
+  -   Завершите установку.
-Осуществляется вызовом функции GetDiscountCardInfo(DiscountCardInfo *info).
-*Входные поля*
-* CardNumber - номер карты.
-*Выходные поля*
+**Все номера магазинов, которые Вы прописали при установки софт терминала должны быть отправлены в компанию Золотая Середина для синхронизации.
-* Balance - баланс, в сотых долях баллов.
+**
-* ErrorCode - код ошибки, равно 0, если все хорошо.
-* ErrorMessage - текст ошибки, не заполняется, если все хорошо.
-* StringForPrint - слип-чек для печати.
-==== Начисление баллов. ====
+=== Удаление или переустановка. ===
+Если Вы хотите удалить софт терминал – то запустите setup.exe и выберите опцию удалить.
+Если вы хотите поменять номер магазина, кассы или изменить адрес - необходимо переустановить софт-терминал и компоненты интеграции. Для этого запустите setup.exe и выберите опцию "Удалить".
-Осуществляется вызовом функции CorrectDiscountCard(PayInfo *info).
-*Входные поля*
-* CardNumber - номер карты.
-* CheckNumber - номер чека, если 0, генерируется автоматически из параметров магазина и даты/времени.
-* Amount - сумма чека в рублях.
-*Выходные поля*
-* BonusAmount - начисленные баллы, в сотых долях.
-* Error - код ошибки, равно 0, если все хорошо.
-* ErrorMsg - текст ошибки, не заполняется, если все хорошо.
-* StringForPrint - слип-чек для печати.
-==== Списание баллов. ====
-Осуществляется вызовом функции Pay(PayInfo *info).
-**Входные поля**
-  * CardNumber - номер карты.
-  * CheckNumber - номер чека, если 0, генерируется автоматически из параметров магазина и даты/времени.
-  * Amount - количество баллов для списания.
-  * Pays - массив видов платежей, имеет C-тип PayItem**.
-  * Каждый элемент содержит поля:
-  *   * articul - код вида оплаты.
-  *   * name - наименование вида оплаты.
-  *   * amount - сумма, оплачиваемая данным видом оплаты, в сотых долях валюты.
-  *   * articul - код ККМ, модулем не учитывается.
-  *   *
-  * PaysCount - размер массива Pays.
-Сумма чека считается как сумма полей amount по всем видам оплаты.
-Сумма баллов для списания берется из поля info->Amount.
-**Выходные поля**
-  *  BonusAmount - количество списанных баллов, в сотых долях.
-  *  Error - код ошибки, равно 0, если все хорошо.
-  *  ErrorMsg - текст ошибки, не заполняется, если все хорошо.
-  *  StringForPrint - слип-чек для печати.
-  *
 ===== Настройка слип - чека =====
@@ Строка 107: / Строка 66: @@
   * Ошибки бизнес-логики. Возникают в процессе обработки запросов. Например, сумма баллов для списания превысила лимит списания.
+====   Лог-файлы  ====
 Для помощи в решении проблем можно использовать лог-файлы. Они расположены в папке "Общие документы\Seredina\Logs".
 Каждый файл имеет имя в формате YYYYMMDDКАТЕГОРИЯ.log. Здесь:
-* YYYY - год записи в журнал,
+  *  YYYY - год записи в журнал,
-*   MM - месяц записи в журнал,
+  *    MM - месяц записи в журнал,
-*   DD - день записи в журнал,
+  *    DD - день записи в журнал,
-*   КАТЕГОРИЯ - строка, идентифицирующая категорию информации.
+  *    КАТЕГОРИЯ - строка, идентифицирующая категорию информации. Принимает значения:
-                   Принимает значения:
+    *     _s1c - лог модуля seredinas1c.dll
-** _s1c - лог модуля seredinas1c.dll
+    *     (пусто) - лог OLE-компонента
-** (пусто) - лог OLE-компонента
+    *     _trm - лог терминала
-** _trm - лог терминала
+====   Тестовая утилита testcmdl.exe  ====
 Кроме того, можно воспользоваться утилитой командной строки для тестирования **testcmdl.exe**, которая обеспечивает вызовы функций модуля. Эта утилита расположена там же, где и модуль.
 Схема запуска утилиты:
@@ Строка 127: / Строка 89: @@
   *  [/s сумма]    - сумма чека, в целых рублях
   *  [/b баллы_для_списания] - сумма баллов для списания, в целых баллах.
-  *
 Вывод утилиты обычно похож на следующий:
-<pre>
+<code>
+> testcmdl.exe [номер карты [/s сумма] [/b баллы_для_списания]]
-> *testcmdl.exe [номер карты [/s сумма] [/b баллы_для_списания]]*
 Информация о модуле.
@@ Строка 145: / Строка 108: @@
 Информация о карте:
 	Номер: 0040019414
-	Баланс: 1020.25
+	Баланс: 70
 	Скидка: 0
 Продажа с начислением бонусов...
 	Карта: 0040019414
-	Сумма чека: 100
+	Сумма чека: 10
 ...Успешно.
 	Начислено баллов: 10
 	Сообщение: Продажа выполнена успешно, начислено 10.00 бонусов.
 	Строка продажи:
-	Строка для печати: Продажа выполнена успешно, начислено 10.00 бонусов.
+	Строка для печати:
+****************************************
+*    Добро пожаловать в программу      *
+*           <Золотая середина>         *
+****************************************
+* № чека                               *
+* Дата чека:                           *
+* К оплате:           10.00 руб.       *
+* К оплате с учетом бонусов:           *
+*                     10.00 руб.       *
+****************************************
+* № Вашей карты:       0040019414      *
+* Начислено бонусов за покупку         *
+*                              +10.00  *
+* Списано бонусов в счет покупки       *
+*                                0.00  *
+* Баланс бонусов по карте (до покупки) *
+*                               70.00  *
+****************************************
+* При предъявлении карты,              *
+* Вам начисляется 5% бонусов           *
+* от суммы Вашей покупки.              *
+* 1 бонус=1 рубль                      *
+* Оплачивайте бонусами                 *
+* до 50% от суммы покупки.             *
+****************************************
+* БЛАГОДАРИМ ЗА ПОКУПКУ!               *
+* Узнать подробнее об условиях         *
+* программы и текущих акциях           *
+* www.seredina.ru                      *
+****************************************
 Возврат начисленых бонусов...
 	Карта: 0040019414
-	Сумма чека: -100
+	Сумма чека: -10
 ...Успешно.
 	Начислено баллов: -10
 	Сообщение: Возврат выполнен успешно
 	Строка продажи:
-	Строка для печати: Возврат выполнен успешно
+	Строка для печати:
+****************************************
+*    Добро пожаловать в программу      *
+*           <Золотая середина>         *
+****************************************
+* № чека                               *
+* Дата чека:                           *
+* К оплате:          -10.00 руб.       *
+* К оплате с учетом бонусов:           *
+*                    -10.00 руб.       *
+****************************************
+* № Вашей карты:       0040019414      *
+* Начислено бонусов за покупку         *
+*                              -10.00  *
+* Списано бонусов в счет покупки       *
+*                                0.00  *
+* Баланс бонусов по карте (до покупки) *
+*                               70.00  *
+****************************************
+* При предъявлении карты,              *
+* Вам начисляется 5% бонусов           *
+* от суммы Вашей покупки.              *
+* 1 бонус=1 рубль                      *
+* Оплачивайте бонусами                 *
+* до 50% от суммы покупки.             *
+****************************************
+* БЛАГОДАРИМ ЗА ПОКУПКУ!               *
+* Узнать подробнее об условиях         *
+* программы и текущих акциях           *
+* www.seredina.ru                      *
+****************************************
 Продажа со списанием бонусов...
 	Карта: 0040019414
-	Сумма чека: 100
+	Сумма чека: 10
-	Баллов для списания: 1
+	Баллов для списания: 5
 ...Успешно.
-	Списано баллов: 1
+	Списано баллов: 5
-	Сообщение: Продажа выполнена успешно. Списано баллов: 1,00.
+	Сообщение: Продажа выполнена успешно. Списано баллов: 5,00.
 	Строка продажи:
-	Строка для печати: Продажа выполнена успешно. Списано баллов: 1,00.
+	Строка для печати:
-</pre>
+****************************************
+*    Добро пожаловать в программу      *
+*           <Золотая середина>         *
+****************************************
+* № чека                               *
+* Дата чека:                           *
+* К оплате:           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] - некий адрес в памяти.
+Кроме того, может иметь место проблема, связанная с включённой защитой от выполнения данных (DEP) для 1С. Она проявляется как ошибка доступа к памяти вида: "access vioaltion at [ADDR]. Write memory at [ADDR]", где [ADDR] - некий адрес в памяти.
 Эту защиту нужно отключать для процесса 1с. Как это сделать, подробнее можно узнать здесь: http://support.microsoft.com/kb/875352.

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

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

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

Различия

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