CMS 1C Bitrix: различия между версиями

Материал из Касса
Перейти к навигации Перейти к поиску
 
(не показана 41 промежуточная версия 4 участников)
Строка 1: Строка 1:
{{CMS
{{CMS
|cms_name = Плагин для CMS Bitrix
|cms_name = Плагин для CMS Bitrix
|cms_version = 1.3.9
|cms_version = 1.4.21
|cms_platform = Bitrix
|cms_platform = Bitrix
|cms_img = 1c_bitrix_logo.svg.png
|cms_img = 1c_bitrix_logo.svg.png
|cms_url = https://kassa.bifit.com/_files/bifit.kassa_drupal.zip
|cms_url = https://kassa.bifit.com/_files/bifit.kassa_bitrix_1.4.21.zip
|cms_description =
|cms_description =  
 
__NOTOC__
==Инструкция установки модуля "БИФИТ Касса" для CMS "1С-Битрикс"==
== <big>Инструкция установки модуля "БИФИТ Касса" для CMS "1С-Битрикс"</big> ==


# Авторизуемся в панели управления сайта.
# Авторизуемся в панели управления сайта.
# Закачайте архив с исходными кодами модуля на сайт: ''''Контент -> Структура сайта -> Файлы и папки -> /bitrix/modules''''
# Закачайте архив с исходными кодами модуля на сайт: ''''Контент → Структура сайта → Файлы и папки → /bitrix/modules''''
# Распакуйте архив. После распаковки, можете удалить архив с сайта.
# Распакуйте архив. После распаковки, можете удалить архив с сайта.
# Установите модуль: ''''Marketplace -> Установленные решения''''
# Установите модуль: '''Marketplace → Установленные решения'''
# Настроить модуль Настройки -> Настройки продукта -> Настройки модулей
# Настроить модуль Настройки → Настройки продукта → Настройки модулей
## Выбираем и заполняем нужные параметры:
## Выбираем и заполняем нужные параметры:
### Выбираем Тестовый или Рабочий (боевой) режим работы расширения(*).
### Выбираем Тестовый или Рабочий (боевой) режим работы расширения(*).
Строка 39: Строка 39:
## Выбираем и заполняем нужные параметры для связи.
## Выбираем и заполняем нужные параметры для связи.
### Активируем использование связи с кабинетом или нет.
### Активируем использование связи с кабинетом или нет.
### Активация подробного логирования всех шагов процесса передачи данных заказа в кабинет "БИФИТ Касса". Включен по-умолчанию. Для каждого заказа создаётся свой лог-файл с именем "log_XXX.txt", где "ХХХ" - это номер самого заказа. Файлы сохраняются в папку "/bitrix/modules/bifit.kassa/classes/general/logs/". В зависимости от настроек сайта и сервера, внешний доступ к лог-файлам может быть закрыт. В таком случае файлы будут доступны через встроенный компонент админ-панели "Контент -> Структура сайта -> Файлы и папки".
### Активация подробного логирования всех шагов процесса передачи данных заказа в кабинет "БИФИТ Касса". Включен по-умолчанию. Для каждого заказа создаётся свой лог-файл с именем "log_XXX.txt", где "ХХХ" - это номер самого заказа. Файлы сохраняются в папку "/bitrix/modules/bifit.kassa/classes/general/logs/". В зависимости от настроек сайта и сервера, внешний доступ к лог-файлам может быть закрыт. В таком случае файлы будут доступны через встроенный компонент админ-панели "Контент → Структура сайта → Файлы и папки".
### Выбираем учитывать или нет параметр "Заказ оплачен".
### Выбираем учитывать или нет параметр "Заказ оплачен".
### Выбираем систему налогообложения.
### Выбираем систему налогообложения.
Строка 56: Строка 56:
### Добавляем названия дополнительных кодов свойств заказа для адреса доставки заказа(***).
### Добавляем названия дополнительных кодов свойств заказа для адреса доставки заказа(***).
## Сохраняем изменённые параметры.
## Сохраняем изменённые параметры.
# Всю историю транзакций можно просмотреть в меню Сервисы -> БИФИТ Касса -> Транзакции
# Всю историю транзакций можно просмотреть в меню Сервисы → БИФИТ Касса → Транзакции
==============================================================
--------
(*)  При выборе тестового режима работы, данные будут отправлены с тестовым токеном, даже если в настройках модуля указан рабочий (боевой) токен подключения.
(*)  При выборе тестового режима работы, данные будут отправлены с тестовым токеном, даже если в настройках модуля указан рабочий (боевой) токен подключения.
(**)  Для ускорения работы, данные по организациям и объектам заданным в кабинете "БИФИТ Касса", загружаются сразу в базу данных сайта и затем выводятся именно из базы сайта, а не из кабинета "БИФИТ Касса". Для обновления этой информации, то есть повторного запроса и загрузки данных по организациям и объектам из кабинета "БИФИТ Касса", необходимо нажать на кнопку "Обновить организации и объекты".
(**)  Для ускорения работы, данные по организациям и объектам заданным в кабинете "БИФИТ Касса", загружаются сразу в базу данных сайта и затем выводятся именно из базы сайта, а не из кабинета "БИФИТ Касса". Для обновления этой информации, то есть повторного запроса и загрузки данных по организациям и объектам из кабинета "БИФИТ Касса", необходимо нажать на кнопку "Обновить организации и объекты".
(***) Перечисление кодов через запятую (например: CITY, STREET, HOUSE, APARTMENT). Названия кодов новых добавленных полей, находятся на странице "Магазин -> Настройки -> Свойства заказа -> Список свойств". Коды по-умолчанию добавлять не нужно.
(***) Перечисление кодов через запятую (например: CITY, STREET, HOUSE, APARTMENT). Названия кодов новых добавленных полей, находятся на странице "Магазин → Настройки → Свойства заказа → Список свойств". Коды по-умолчанию добавлять не нужно.
|}}
 
 
 
{{ProductTable-1|
|title-left=<big><big>'''Доработки модуля CMS 1C Bitrix'''</big></big>
|content-left=
 
<big>'''Доработки по настройкам связанным с Фискальным процессингом'''</big>
 
Путь к настройкам связанным с Фискальным процессингом '''Настройки→ БИФИТ Касса → Настройки параметров модуля''':
 
# В настройках модуля добавлен параметр [[Файл:Без дублей.png]] для исключения дублирования данных заказа на Фискальный процессинг.
# Добавлен функционал применения ставки НДС, при сохранении заказа в модуле. Для этого добавлены два поля подразделе '''Настройки→ БИФИТ Касса → Настройки параметров модуля'''.
#*  Поле [[Файл:Единый НДС.png]] предназначено для установки параметров применения ставки НДС для всех товаров на сайте. У поля есть два варианта работы "Да" и "НЕТ". При первом варианте необходимо в поле '''Ставка НДС''' указать НДС который будет применяться ко всем товарам на сайте и в дальнейшем выгружаться в Личный Кабинет БИФИТ Бизнес. При втором варианте НДС будет использоваться та, которая указана в карточке товара на сайте и которую можно указать при создании товарной позиции в модуле.
#* Поле [[Файл:Ставка НДС.png]] предназначен для совместной работы с полем '''Единый НДС''' и позволяет использовать одинаковую ставку НДС для всех позиций на сайте.
 
=== Доработки по настройкам связанным с передачей Онлайн-заказа в ЛК БИФИТ  ===
 
Путь к настройкам связанным с Фискальным процессингом '''Настройки→ БИФИТ Касса → Связь между сайтом и личным кабинетом "БИФИТ Касса"''':


# Создание товара и клиента в Личном Кабинете БИФИТ Бизнес при формировании Онлайн-заказа. То есть если в Личном кабинете не существует позиции товара, которая есть на сайте, при передаче онлайн заказа, в Личном кабинете БИФИТ Бизнес будет создана новая номенклатурная позиция и добавлена в онлайн-заказ.
# Добавлены поля [[Файл:Поле Организация.png]] и [[Файл:Поле Торговый Объект.png]] для привязки Онлайн-заказа к организации и торговому объекту в Личном Кабинете БИФИТ Бизнес.
# Добавлена функция изменения статуса заказа в CMS с последующим автоматическим изменением в ЛК БИФИТ. Изменение статуса заказа совершается при помощи поля [[Файл:Статусы заказа.png]]. В данном поле устанавливается статус при достижении которого, заказ будет отправлен в Личный Кабинет БИФИТ Бизнес.
# Добавлена возможность передачи типа доставки (курьер, самовызов). В настройки модуля добавлены следующие поля: [[Файл:Доставка Курьером.png]] и [[Файл:Доставка Самовывоз.png]]<br>
# Добавлена возможность удалять заказ в Личном Кабинете БИФИТ Бизнес из CMS модуля. За удаление заказа отвечает настройка [[Файл:Удаление заказа в кабинете.png]]. Данная настройка позволяет установить условие для удаления заказа из Личного кабинета БИФИТ Бизнес. При включенной настройке Онлайн-заказ из Личного кабинета БИФИТ Бизнес будет удален автоматически, при выключенной настройке заказ будет удален только в модуле.
# Добавлена передача стоимости доставки в Онлайн-заказе в Личном Кабинете БИФИТ Бизнес.
# Добавлена передача данных об оплате заказа в Личный Кабинет БИФИТ Бизнес.
     
=== Логирование в модуле ===
# Добавлена дополнительная проверка почтового ящика покупателя.
# Добавлена проверка и сохранение идентификатора транзакции заказа в базе данных "БИФИТ Касса"
# Добавлена проверка и форматирование номера телефона заказчика перед передачей заказа в Личный кабинет БИФИТ Бизнес
# Добавлена проверка/подмена значения параметра '''Адрес Клиента'''. Если в настройках, в параметре [[Файл:Адрес клиента.png]] выбран "e-mail", но адрес почтового ящика покупателя в заказе отсутствует, то при наличии указанного номера телефона, выводится телефон покупателя (работает в обратную сторону). В случае отсутствия e-mail и  номера телефона - выводится сообщение об отсутствии параметров.
|}}
|}}
== Видеоуроки ==
* [https://vk.com/video/@bifit.kassa?z=video-143616203_456239178%2Fclub143616203%2Fpl_-143616203_-2 Настройка модуля CMS на примере 1С-Битрикс]

Текущая версия на 12:56, 11 сентября 2024

 

Инструкция установки модуля "БИФИТ Касса" для CMS "1С-Битрикс"

  1. Авторизуемся в панели управления сайта.
  2. Закачайте архив с исходными кодами модуля на сайт: 'Контент → Структура сайта → Файлы и папки → /bitrix/modules'
  3. Распакуйте архив. После распаковки, можете удалить архив с сайта.
  4. Установите модуль: Marketplace → Установленные решения
  5. Настроить модуль Настройки → Настройки продукта → Настройки модулей
    1. Выбираем и заполняем нужные параметры:
      1. Выбираем Тестовый или Рабочий (боевой) режим работы расширения(*).
      2. Выбираем активацию параметра "Без дублей", для исключения дублирования отправки данных заказа в фискальный процессинг, при некорректных настройках сторонних модулей интернет-магазина (в разделе изменения статусов заказа, сразу несколько модулей могут устанавливать один и тот же статус заказа, то есть вызывать активацию модуля "БИФИТ Касса" несколько раз подряд). Конечно в случае существования подобной проблемы, правильней выставить корректные настройки сторонних модулей (отключить лишние изменения статуса), но и при активации данного параметра, дубли будут исключены.
      3. Заполняем полученный токен доступа необходимый для рабочего (боевого) режима работы.
      4. Вводим фамилию и инициалы кассира, например Иванов И.И.
      5. Вводим ИНН кассира (12-ть цифр для РФ).
      6. Вводим место расчёта, например домен сайта, строго по форме (с http или https): https://site.ru
      7. Выбираем, что выводить в адресе клиента: телефон или e-mail.
      8. Выбираем выводить или нет ФИО клиента.
      9. Выбираем признак способа расчёта.
      10. Выбираем тип оплаты.
      11. Выбираем режим назначения НДС.
      12. Выбираем ставку НДС.
    2. Сохраняем изменённые параметры.
  6. Настройки для каждого типа документа вынесены в отдельный таб.
    1. Выбираем и заполняем нужные параметры для каждого типа документа.
      1. Активируем использование данного типа документа.
      2. Выбираем учитывать или нет параметр "Заказ оплачен".
      3. Выбираем систему налогообложения.
      4. Выбираем один или несколько статусов заказа, при выборе которых будет активирована работа расширения по данной вкладке.
      5. Выбираем один или несколько способов оплаты, при выборе которых будет активирована работа расширения по данной вкладке.
    2. Сохраняем изменённые параметры.
  7. Вкладка "Связь" предназначена для передачи данных заказа в личный кабинет "БИФИТ Касса" и может работать совершенно независимо от фискального процессинга, то есть от настроек модуля в других вкладках. Используются всего три параметра из первой вкладки "Настройки" - это "Признак способа расчёта", "Единый НДС" и "Ставка НДС".
    1. Выбираем и заполняем нужные параметры для связи.
      1. Активируем использование связи с кабинетом или нет.
      2. Активация подробного логирования всех шагов процесса передачи данных заказа в кабинет "БИФИТ Касса". Включен по-умолчанию. Для каждого заказа создаётся свой лог-файл с именем "log_XXX.txt", где "ХХХ" - это номер самого заказа. Файлы сохраняются в папку "/bitrix/modules/bifit.kassa/classes/general/logs/". В зависимости от настроек сайта и сервера, внешний доступ к лог-файлам может быть закрыт. В таком случае файлы будут доступны через встроенный компонент админ-панели "Контент → Структура сайта → Файлы и папки".
      3. Выбираем учитывать или нет параметр "Заказ оплачен".
      4. Выбираем систему налогообложения.
      5. Выбираем один или несколько статусов заказа, при выборе которых будет активирована работа расширения по данной вкладке.
      6. Выбираем один или несколько способов оплаты, при выборе которых будет активирована работа расширения по данной вкладке.
      7. Вводим логин (номер телефона: +7(XXX)XXX-XX-XX). Допускаются "+", "(", ")", "-", " ".
      8. Вводим пароль.
      9. Выбираем организацию (параметр будет доступен при наличии логина и пароля).
      10. Выбираем торговый объект (параметр будет доступен при наличии логина и пароля).
      11. При необходимости, обновляем данные по организациям и объектам(**).
      12. Выбираем доставки сайта подходящие под доставку "Курьером" в кабинете "БИФИТ Касса".
      13. Выбираем доставки сайта подходящие под доставку "Самовывоз" в кабинете "БИФИТ Касса".
      14. Выбираем статус для нового заказа "Курьером" в кабинете "БИФИТ Касса".
      15. Выбираем нужно ли удалять заказ в кабинете "БИФИТ Касса".
      16. Выбираем статус заказа при котором будет произведено удаление заказа в кабинете "БИФИТ Касса".
      17. Добавляем названия дополнительных кодов свойств заказа для адреса доставки заказа(***).
    2. Сохраняем изменённые параметры.
  8. Всю историю транзакций можно просмотреть в меню Сервисы → БИФИТ Касса → Транзакции

(*) При выборе тестового режима работы, данные будут отправлены с тестовым токеном, даже если в настройках модуля указан рабочий (боевой) токен подключения. (**) Для ускорения работы, данные по организациям и объектам заданным в кабинете "БИФИТ Касса", загружаются сразу в базу данных сайта и затем выводятся именно из базы сайта, а не из кабинета "БИФИТ Касса". Для обновления этой информации, то есть повторного запроса и загрузки данных по организациям и объектам из кабинета "БИФИТ Касса", необходимо нажать на кнопку "Обновить организации и объекты". (***) Перечисление кодов через запятую (например: CITY, STREET, HOUSE, APARTMENT). Названия кодов новых добавленных полей, находятся на странице "Магазин → Настройки → Свойства заказа → Список свойств". Коды по-умолчанию добавлять не нужно.

Название: Плагин для CMS Bitrix
Версия: 1.4.21
CMS: Bitrix
1c bitrix logo.svg.png
Ссылка на плагин: скачать


Доработки модуля CMS 1C Bitrix
Доработки по настройкам связанным с Фискальным процессингом

Путь к настройкам связанным с Фискальным процессингом Настройки→ БИФИТ Касса → Настройки параметров модуля:

  1. В настройках модуля добавлен параметр Без дублей.png для исключения дублирования данных заказа на Фискальный процессинг.
  2. Добавлен функционал применения ставки НДС, при сохранении заказа в модуле. Для этого добавлены два поля подразделе Настройки→ БИФИТ Касса → Настройки параметров модуля.
    • Поле Единый НДС.png предназначено для установки параметров применения ставки НДС для всех товаров на сайте. У поля есть два варианта работы "Да" и "НЕТ". При первом варианте необходимо в поле Ставка НДС указать НДС который будет применяться ко всем товарам на сайте и в дальнейшем выгружаться в Личный Кабинет БИФИТ Бизнес. При втором варианте НДС будет использоваться та, которая указана в карточке товара на сайте и которую можно указать при создании товарной позиции в модуле.
    • Поле Ставка НДС.png предназначен для совместной работы с полем Единый НДС и позволяет использовать одинаковую ставку НДС для всех позиций на сайте.

Доработки по настройкам связанным с передачей Онлайн-заказа в ЛК БИФИТ

Путь к настройкам связанным с Фискальным процессингом Настройки→ БИФИТ Касса → Связь между сайтом и личным кабинетом "БИФИТ Касса":

  1. Создание товара и клиента в Личном Кабинете БИФИТ Бизнес при формировании Онлайн-заказа. То есть если в Личном кабинете не существует позиции товара, которая есть на сайте, при передаче онлайн заказа, в Личном кабинете БИФИТ Бизнес будет создана новая номенклатурная позиция и добавлена в онлайн-заказ.
  2. Добавлены поля Поле Организация.png и Поле Торговый Объект.png для привязки Онлайн-заказа к организации и торговому объекту в Личном Кабинете БИФИТ Бизнес.
  3. Добавлена функция изменения статуса заказа в CMS с последующим автоматическим изменением в ЛК БИФИТ. Изменение статуса заказа совершается при помощи поля Статусы заказа.png. В данном поле устанавливается статус при достижении которого, заказ будет отправлен в Личный Кабинет БИФИТ Бизнес.
  4. Добавлена возможность передачи типа доставки (курьер, самовызов). В настройки модуля добавлены следующие поля: Доставка Курьером.png и Доставка Самовывоз.png
  5. Добавлена возможность удалять заказ в Личном Кабинете БИФИТ Бизнес из CMS модуля. За удаление заказа отвечает настройка Удаление заказа в кабинете.png. Данная настройка позволяет установить условие для удаления заказа из Личного кабинета БИФИТ Бизнес. При включенной настройке Онлайн-заказ из Личного кабинета БИФИТ Бизнес будет удален автоматически, при выключенной настройке заказ будет удален только в модуле.
  6. Добавлена передача стоимости доставки в Онлайн-заказе в Личном Кабинете БИФИТ Бизнес.
  7. Добавлена передача данных об оплате заказа в Личный Кабинет БИФИТ Бизнес.


Логирование в модуле

  1. Добавлена дополнительная проверка почтового ящика покупателя.
  2. Добавлена проверка и сохранение идентификатора транзакции заказа в базе данных "БИФИТ Касса"
  3. Добавлена проверка и форматирование номера телефона заказчика перед передачей заказа в Личный кабинет БИФИТ Бизнес
  4. Добавлена проверка/подмена значения параметра Адрес Клиента. Если в настройках, в параметре Адрес клиента.png выбран "e-mail", но адрес почтового ящика покупателя в заказе отсутствует, то при наличии указанного номера телефона, выводится телефон покупателя (работает в обратную сторону). В случае отсутствия e-mail и номера телефона - выводится сообщение об отсутствии параметров.

Видеоуроки

Источник — http://kassa.bifit.com/wiki/index.php?title=CMS_1C_Bitrix&oldid=55115