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

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

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

Вы посетили:
менеджер_оплат:настройка:модули:seredinas1c

Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия 		Предыдущая версия
менеджер_оплат:настройка:модули:seredinas1c [2013/09/12 10:18]
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".  Для помощи в решении проблем можно использовать лог-файлы. Они расположены в папке "Общие документы\Seredina\Logs". 
 Каждый файл имеет имя в формате YYYYMMDDКАТЕГОРИЯ.log. Здесь:  Каждый файл имеет имя в формате YYYYMMDDКАТЕГОРИЯ.log. Здесь: 
-* YYYY - год записи в журнал,  +  *  YYYY - год записи в журнал,  
-*   MM - месяц записи в журнал, +  *    MM - месяц записи в журнал, 
-*   DD - день записи в журнал, +  *    DD - день записи в журнал, 
-*   КАТЕГОРИЯ - строка, идентифицирующая категорию информации.  +  *    КАТЕГОРИЯ - строка, идентифицирующая категорию информации. Принимает значения: 
-                   Принимает значения: +    *     _s1c - лог модуля seredinas1c.dll 
-** _s1c - лог модуля seredinas1c.dll +    *     (пусто) - лог OLE-компонента 
-** (пусто) - лог OLE-компонента +    *     _trm - лог терминала 
-** _trm - лог терминала +    
 +====   Тестовая утилита testcmdl.exe  ==== 
 +   
 Кроме того, можно воспользоваться утилитой командной строки для тестирования **testcmdl.exe**, которая обеспечивает вызовы функций модуля. Эта утилита расположена там же, где и модуль.  Кроме того, можно воспользоваться утилитой командной строки для тестирования **testcmdl.exe**, которая обеспечивает вызовы функций модуля. Эта утилита расположена там же, где и модуль. 
 Схема запуска утилиты:  Схема запуска утилиты: 
Строка 127: Строка 89:
   *  [/s сумма]    - сумма чека, в целых рублях   *  [/s сумма]    - сумма чека, в целых рублях
   *  [/b баллы_для_списания] - сумма баллов для списания, в целых баллах.   *  [/b баллы_для_списания] - сумма баллов для списания, в целых баллах.
-  * +   
 Вывод утилиты обычно похож на следующий: Вывод утилиты обычно похож на следующий:
-<pre>+<code> 
 + 
 +> testcmdl.exe [номер карты [/s сумма] [/b баллы_для_списания]]
  
-> *testcmdl.exe [номер карты [/s сумма] [/b баллы_для_списания]]* 
  
 Информация о модуле. Информация о модуле.
Строка 145: Строка 108:
 Информация о карте: Информация о карте:
  Номер: 0040019414  Номер: 0040019414
- Баланс: 1020.25+ Баланс: 70
  Скидка: 0  Скидка: 0
 Продажа с начислением бонусов... Продажа с начислением бонусов...
  Карта: 0040019414  Карта: 0040019414
- Сумма чека: 100+ Сумма чека: 10
 ...Успешно. ...Успешно.
  Начислено баллов: 10  Начислено баллов: 10
  Сообщение: Продажа выполнена успешно, начислено 10.00 бонусов.  Сообщение: Продажа выполнена успешно, начислено 10.00 бонусов.
  Строка продажи:   Строка продажи: 
- Строка для печати: Продажа выполнена успешно, начислено 10.00 бонусов.+ Строка для печати:  
 +**************************************** 
 +*    Добро пожаловать в программу      * 
 +*           <Золотая середина>         * 
 +**************************************** 
 +* № чека                               * 
 +* Дата чека:                           * 
 +* К оплате:           10.00 руб.       * 
 +* К оплате с учетом бонусов:           * 
 +*                     10.00 руб.       * 
 +**************************************** 
 +* № Вашей карты:       0040019414      * 
 +* Начислено бонусов за покупку         * 
 +*                              +10.00  * 
 +* Списано бонусов в счет покупки       * 
 +*                                0.00  * 
 +* Баланс бонусов по карте (до покупки) * 
 +*                               70.00  * 
 +**************************************** 
 +* При предъявлении карты,              * 
 +* Вам начисляется 5% бонусов           * 
 +* от суммы Вашей покупки.              * 
 +* 1 бонус=1 рубль                      * 
 +* Оплачивайте бонусами                 * 
 +* до 50% от суммы покупки.             * 
 +**************************************** 
 +* БЛАГОДАРИМ ЗА ПОКУПКУ!               * 
 +* Узнать подробнее об условиях         * 
 +* программы и текущих акциях           * 
 +* www.seredina.ru                      * 
 +****************************************
 Возврат начисленых бонусов... Возврат начисленых бонусов...
  Карта: 0040019414  Карта: 0040019414
- Сумма чека: -100+ Сумма чека: -10
 ...Успешно. ...Успешно.
  Начислено баллов: -10  Начислено баллов: -10
  Сообщение: Возврат выполнен успешно  Сообщение: Возврат выполнен успешно
  Строка продажи:   Строка продажи: 
- Строка для печати: Возврат выполнен успешно+ Строка для печати:  
 +**************************************** 
 +*    Добро пожаловать в программу      * 
 +*           <Золотая середина>         * 
 +**************************************** 
 +* № чека                               * 
 +* Дата чека:                           * 
 +* К оплате:          -10.00 руб.       * 
 +* К оплате с учетом бонусов:           * 
 +*                    -10.00 руб.       * 
 +**************************************** 
 +* № Вашей карты:       0040019414      * 
 +* Начислено бонусов за покупку         * 
 +*                              -10.00  * 
 +* Списано бонусов в счет покупки       * 
 +*                                0.00  * 
 +* Баланс бонусов по карте (до покупки) * 
 +*                               70.00  * 
 +**************************************** 
 +* При предъявлении карты,              * 
 +* Вам начисляется 5% бонусов           * 
 +* от суммы Вашей покупки.              * 
 +* 1 бонус=1 рубль                      * 
 +* Оплачивайте бонусами                 * 
 +* до 50% от суммы покупки.             * 
 +**************************************** 
 +* БЛАГОДАРИМ ЗА ПОКУПКУ!               * 
 +* Узнать подробнее об условиях         * 
 +* программы и текущих акциях           * 
 +* www.seredina.ru                      * 
 +****************************************
 Продажа со списанием бонусов... Продажа со списанием бонусов...
  Карта: 0040019414  Карта: 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. Эту защиту нужно отключать для процесса 1с. Как это сделать, подробнее можно узнать здесь: http://support.microsoft.com/kb/875352.
  
менеджер_оплат/настройка/модули/seredinas1c.1378981101.txt.gz · Последнее изменение: 2013/09/12 10:18 (внешнее изменение)

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

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki