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

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

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

Авторизуемся в панели управления сайта.
Закачайте архив с исходными кодами модуля на сайт: 'Контент → Структура сайта → Файлы и папки → /bitrix/modules'
Распакуйте архив. После распаковки, можете удалить архив с сайта.
Установите модуль: Marketplace → Установленные решения
Настроить модуль Настройки → Настройки продукта → Настройки модулей
1. Выбираем и заполняем нужные параметры:
  1. Выбираем Тестовый или Рабочий (боевой) режим работы расширения(*).
  2. Выбираем активацию параметра "Без дублей", для исключения дублирования отправки данных заказа в фискальный процессинг, при некорректных настройках сторонних модулей интернет-магазина (в разделе изменения статусов заказа, сразу несколько модулей могут устанавливать один и тот же статус заказа, то есть вызывать активацию модуля "БИФИТ Касса" несколько раз подряд). Конечно в случае существования подобной проблемы, правильней выставить корректные настройки сторонних модулей (отключить лишние изменения статуса), но и при активации данного параметра, дубли будут исключены.
  3. Заполняем полученный токен доступа необходимый для рабочего (боевого) режима работы.
  4. Вводим фамилию и инициалы кассира, например Иванов И.И.
  5. Вводим ИНН кассира (12-ть цифр для РФ).
  6. Вводим место расчёта, например домен сайта, строго по форме (с http или https): https://site.ru
  7. Выбираем, что выводить в адресе клиента: телефон или e-mail.
  8. Выбираем выводить или нет ФИО клиента.
  9. Выбираем признак способа расчёта.
  10. Выбираем тип оплаты.
  11. Выбираем режим назначения НДС.
  12. Выбираем ставку НДС.
2. Сохраняем изменённые параметры.
Настройки для каждого типа документа вынесены в отдельный таб.
1. Выбираем и заполняем нужные параметры для каждого типа документа.
  1. Активируем использование данного типа документа.
  2. Выбираем учитывать или нет параметр "Заказ оплачен".
  3. Выбираем систему налогообложения.
  4. Выбираем один или несколько статусов заказа, при выборе которых будет активирована работа расширения по данной вкладке.
  5. Выбираем один или несколько способов оплаты, при выборе которых будет активирована работа расширения по данной вкладке.
2. Сохраняем изменённые параметры.
Вкладка "Связь" предназначена для передачи данных заказа в личный кабинет "БИФИТ Касса" и может работать совершенно независимо от фискального процессинга, то есть от настроек модуля в других вкладках. Используются всего три параметра из первой вкладки "Настройки" - это "Признак способа расчёта", "Единый НДС" и "Ставка НДС".
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. Сохраняем изменённые параметры.
Всю историю транзакций можно просмотреть в меню Сервисы → БИФИТ Касса → Транзакции

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

Название:	Плагин для CMS Bitrix
Версия:	1.4.21
CMS:	Bitrix

Ссылка на плагин:	скачать

Доработки модуля CMS 1C Bitrix

Доработки по настройкам связанным с Фискальным процессингом

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

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

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

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

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

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

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

Видеоуроки

Настройка модуля CMS на примере 1С-Битрикс

@@ Строка 1: / Строка 1: @@
 {{CMS
 |cms_name = Плагин для CMS Bitrix
-|cms_version = 1.0
+|cms_version = 1.4.21
-|cms_platform = CMS Drupal 7
+|cms_platform = Bitrix
 |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 = &nbsp;
+__NOTOC__
+== <big>Инструкция установки модуля "БИФИТ Касса" для CMS "1С-Битрикс"</big> ==
-===Инструкция установки плагина "БИФИТ Касса" для "CMS Drupal 7"===
+# Авторизуемся в панели управления сайта.
-----
+# Закачайте архив с исходными кодами модуля на сайт: ''''Контент → Структура сайта → Файлы и папки → /bitrix/modules''''
-# Авторизуемся на сайте.
+# Распакуйте архив. После распаковки, можете удалить архив с сайта.
-# В верхнем меню выбираем: Настройки сайта → Модули
+# Установите модуль: '''Marketplace → Установленные решения'''
-# На странице модулей нажимаем кнопку "Установить новый модуль"
+# Настроить модуль Настройки → Настройки продукта → Настройки модулей
-# На странице установки выбираем файл "commerce_bifitkassa.zip" и нажимаем кнопку "Установить".
-# После установки модуля возвращаемся на страницу модулей и:
-## В левой колонке нажимаем на пункт "Commerce (BIFIT Kassa)".
-## Нажимаем на кнопку включения слева от названия модуля, чтобы она стала зеленой. В зависимости от шаблона, вместо кнопки может быть обычный чекбокс, который нужно отметить.
-## Жмём на кнопку "Сохранить конфигурацию".
-# В меню справа от названия модуля, выбираем и нажимаем на ссылку "Конфигурация".
-# На странице настроек конфигурации:
 ## Выбираем и заполняем нужные параметры:
-### Тестовый(*) или Боевой режим работы расширения.
+### Выбираем Тестовый или Рабочий (боевой) режим работы расширения(*).
-### Заполняем полученный токен доступа необходимый для боевого режима работы.
+### Выбираем активацию параметра "Без дублей", для исключения дублирования отправки данных заказа в фискальный процессинг, при некорректных настройках сторонних модулей интернет-магазина (в разделе изменения статусов заказа, сразу несколько модулей могут устанавливать один и тот же статус заказа, то есть вызывать активацию модуля "БИФИТ Касса" несколько раз подряд). Конечно в случае существования подобной проблемы, правильней выставить корректные настройки сторонних модулей (отключить лишние изменения статуса), но и при активации данного параметра, дубли будут исключены.
+### Заполняем полученный токен доступа необходимый для рабочего (боевого) режима работы.
 ### Вводим фамилию и инициалы кассира, например Иванов И.И.
 ### Вводим ИНН кассира (12-ть цифр для РФ).
-### Вводим место расчёта → домен сайта, строго по форме (с http или https): https://site.ru
+### Вводим место расчёта, например домен сайта, строго по форме (с http или https): https://site.ru
 ### Выбираем, что выводить в адресе клиента: телефон или e-mail.
+### Выбираем выводить или нет ФИО клиента.
 ### Выбираем признак способа расчёта.
 ### Выбираем тип оплаты.
 ### Выбираем режим назначения НДС.
 ### Выбираем ставку НДС.
-### Далее идут четыре одинаковых набора параметров для разных типов документов: "Приход", "Возврат прихода", "Расход", "Возврат расхода".
+## Сохраняем изменённые параметры.
-#### Выбираем использовать или нет данный тип документа.
+# Настройки для каждого типа документа вынесены в отдельный таб.
-#### Выбираем учитывать или нет параметр "Заказ оплачен".
+## Выбираем и заполняем нужные параметры для каждого типа документа.
-#### Выбираем систему налогообложения.
+### Активируем использование данного типа документа.
-#### Выбираем один или несколько статусов заказа, при выборе которых будет активирована работа расширения по данной вкладке.
+### Выбираем учитывать или нет параметр "Заказ оплачен".
-#### Выбираем один или несколько способов оплаты, при выборе которых будет активирована работа расширения по данной вкладке.
+### Выбираем систему налогообложения.
-## Сохраняем изменённые параметры нажатием на кнопку "Сохранить конфигурацию" внизу страницы.
+### Выбираем один или несколько статусов заказа, при выборе которых будет активирована работа расширения по данной вкладке.
-# Справа вверху две вкладки: первая "Настройки", с текущими настройками, вторая "Отчёты", где будут отображаться все проведённые транзакции.
+### Выбираем один или несколько способов оплаты, при выборе которых будет активирована работа расширения по данной вкладке.
+## Сохраняем изменённые параметры.
+# Вкладка "Связь" предназначена для передачи данных заказа в личный кабинет "БИФИТ Касса" и может работать совершенно независимо от фискального процессинга, то есть от настроек модуля в других вкладках. Используются всего три параметра из первой вкладки "Настройки" - это "Признак способа расчёта", "Единый НДС" и "Ставка НДС".
+## Выбираем и заполняем нужные параметры для связи.
+### Активируем использование связи с кабинетом или нет.
+### Активация подробного логирования всех шагов процесса передачи данных заказа в кабинет "БИФИТ Касса". Включен по-умолчанию. Для каждого заказа создаётся свой лог-файл с именем "log_XXX.txt", где "ХХХ" - это номер самого заказа. Файлы сохраняются в папку "/bitrix/modules/bifit.kassa/classes/general/logs/". В зависимости от настроек сайта и сервера, внешний доступ к лог-файлам может быть закрыт. В таком случае файлы будут доступны через встроенный компонент админ-панели "Контент → Структура сайта → Файлы и папки".
+### Выбираем учитывать или нет параметр "Заказ оплачен".
+### Выбираем систему налогообложения.
+### Выбираем один или несколько статусов заказа, при выборе которых будет активирована работа расширения по данной вкладке.
+### Выбираем один или несколько способов оплаты, при выборе которых будет активирована работа расширения по данной вкладке.
+### Вводим логин (номер телефона: +7(XXX)XXX-XX-XX). Допускаются "+", "(", ")", "-", " ".
+### Вводим пароль.
+### Выбираем организацию (параметр будет доступен при наличии логина и пароля).
+### Выбираем торговый объект (параметр будет доступен при наличии логина и пароля).
+### При необходимости, обновляем данные по организациям и объектам(**).
+### Выбираем доставки сайта подходящие под доставку "Курьером" в кабинете "БИФИТ Касса".
+### Выбираем доставки сайта подходящие под доставку "Самовывоз" в кабинете "БИФИТ Касса".
+### Выбираем статус для нового заказа "Курьером" в кабинете "БИФИТ Касса".
+### Выбираем нужно ли удалять заказ в кабинете "БИФИТ Касса".
+### Выбираем статус заказа при котором будет произведено удаление заказа в кабинете "БИФИТ Касса".
+### Добавляем названия дополнительных кодов свойств заказа для адреса доставки заказа(***).
+## Сохраняем изменённые параметры.
+# Всю историю транзакций можно просмотреть в меню Сервисы → БИФИТ Касса → Транзакции
+--------
+(*)   При выборе тестового режима работы, данные будут отправлены с тестовым токеном, даже если в настройках модуля указан рабочий (боевой) токен подключения.
+(**)  Для ускорения работы, данные по организациям и объектам заданным в кабинете "БИФИТ Касса", загружаются сразу в базу данных сайта и затем выводятся именно из базы сайта, а не из кабинета "БИФИТ Касса". Для обновления этой информации, то есть повторного запроса и загрузки данных по организациям и объектам из кабинета "БИФИТ Касса", необходимо нажать на кнопку "Обновить организации и объекты".
+(***) Перечисление кодов через запятую (например: CITY, STREET, HOUSE, APARTMENT). Названия кодов новых добавленных полей, находятся на странице "Магазин → Настройки → Свойства заказа → Список свойств". Коды по-умолчанию добавлять не нужно.
+|}}
-===ТЕЛЕФОН===
-В CMS "Drupal 7" по-умолчанию нет параметра для ввода телефона. Поэтому для полноценной работы функционала синхронизации сайта с кабинетом "БИФИТ Касса", потребуется создать поле для ввода номера телефона. Для этого необходимо:
+{{ProductTable-1|
-# Открыть страницу настроек аккаунта по пути: Конфигурация → Настройки → Конфигурация → Пользователи → Настройки учётной записи. Открыть вкладку "Управление полями" и добавить новое поле с названием "Телефон", обязательным(!) машинным именем "field_phone" и типом поля "Текст".
+|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С-Битрикс]