Помогаем продавать
Войти в ЛК

Расширение “Ferma OFD.ru” для CMS “1С-Битрикс”

Версия 1.0 от 30.10.2018 Открыть pdf-файл Модуль для CMS

Введение

В документе приводятся сведения об установке и эксплуатации модуля “Ferma OFD.ru”, для CMS «1С-Битрикс» версии не менее 15.5, редакция «Малый бизнес». Модуль обеспечивает взаимодействие информационной системы (ИС) интернет-магазина, использующего CMS «1С-Битрикс», с информационной системой “Ferma OFD.ru”.

1. Назначение расширения “Ferma OFD.ru”

Модуль “Ferma OFD.ru”, для CMS «1С-Битрикс» версии не менее 15.5, редакция «Малый бизнес», реализует взаимодействие CMS «1С-Битрикс» с ИС оператора фискальных данных “OFD.ru” с целью генерации фискальных документов с помощью арендованных интернет-касс, их загрузки и просмотра их реестра.

2. Основные принципы работы расширения

При смене статуса заказа клиента на статус, соответствующий факту успешной оплаты заказа, модуль автоматически создает в облачной кассе “OFD.ru” фискальный документ (чек, БСО) на получение денежных средств от покупателя. Также имеется возможность вручную сформировать документ на возврат средств покупателю.

3. Установка и настройка расширения

Модуль распространяется в виде архивного файла с расширением “.zip” (тестовая версия) либо посредством платформы «Маркетплейс». В случае распространения модуля в виде архивного файла, чтобы установить модуль, необходимо сначала скопировать архивный файл в каталог веб-сервера “bitrix/modules” с помощью системных инструментов сервера или подключенного компьютера администратора. Далее необходимо включить нужный модуль с помощью веб-интерфейса: загрузить начальную страницу CMS «1С-Битрикс» (см. рисунок 1), ввести имя и пароль администратора, а затем, выбрав на панели в левой части рабочего поля окна браузера пиктограмму «Настройки», затем пункты иерархического меню (располагается в левой части рабочего поля справа от панели) «Настройки продукта» и «Модули», перейти на страницу «Модули» (см. рисунок 2). В таблице необходимо найти строку “OFD.ru Ferma” и левой кнопкой мыши нажать зеленую кнопку «Установить» в правой части строки с названием модуля. Таким образом, модуль будет установлен и включен.

Рисунок 1. Начальная страница CMS "1С-Битрикс" версии ____
Рисунок 2. Страница установки модулей

Для настройки плагина перейдите на страницу его параметров, выбрав в иерархическом меню пункты «Настройки продукта», «Настройки модулей» и «OFD.ru Ferma», справа от меню отобразится страница параметров модуля (см. рисунок 3). С помощью пользовательского интерфейса на загруженной странице введите необходимые значения настроек плагина; назначение параметров описано в таблице 1.

Таблица 1. Настроечные параметры, необходимые для работы расширения “Ferma OFD.ru”

Параметр Описание
URL api Значение интернет-адреса для направления запросов со стороны ИС интернет-магазина
Логин для фермы Данные идентификации (имя пользователя) для синхронизации данных через API с облачной кассой ОФД
Пароль для фермы Данные аутентификации (пароль) для синхронизации данных через API с облачной кассой ОФД
ИНН компании ИНН лица, от имени которого генерируется кассовый документ (чек)
Система налогообложения Система налогообложения
Адрес электронной почты для отправки уведомлений об ошибках сервиса Адрес электронной почты управляющего. На этот адрес будут отправляться сообщения об ошибках в работе модуля

Нажатие на кнопку «Сохранить» приводит к сохранению введенных параметров; нажатие на кнопку «Применить» приводит к сохранению введенных параметров и началу работы с ними модуля. Кнопка «По умолчанию» изменяет настройки модуля на заводские (без сохранения и применения).

Рисунок 3. Интерфейс настройки модуля и пункты меню для его вызова

4. Использование расширения

В общем случае для создания фискального документа в облачной кассе “OFD.ru” не требуется никаких дополнительных действий: модуль в автоматическом режиме при смене на странице заказа статуса заказа на «Оплачен, формируется к отправке» создает документ (чек или БСО) на получение денежных средств от покупателя. Формирование кассовых документов на возврат суммы описывается в п. 4.1.

Для отображения списка сформированных фискальных документов необходимо выбрать пиктограмму «Магазин» на вертикальной панели в левой части рабочего поля, затем в иерархическом меню выбрать пункты «OFD.ru Ferma», далее «Реестр чеков». Примерный вид страницы реестра чеков показан на рисунке 5. В списке кассовых документов отображаются следующие их параметры: идентификатор документа, номер заказа, сумма по документу (сумма чека), номер фискального документа (номер, хранящийся в фискальном накопителе), статус передачи в ОФД, номер чека (идентификатор фискального документа в информационных системах OFD.ru) дата создания фискального документа (см. рисунок 5). По ссылкам в столбцах таблицы “ID” и «Номер чека» производится переход на страницу просмотра фискального документа, документ отображается в виде, как бы он был напечатан на бумаге (см. рисунок 5).

Рисунок 4. Примерный вид реестра (списка) чеков
Рисунок 5. Чек при просмотре

4.1. Создание фискальных документов на возврат денежных средств

Фискальный документ на возврат денежных средств генерируется по команде оператора со страницы реестра кассовых чеков (см. рисунок 6); слева от строки записи о фискальном документе присутствует кнопка локального меню действий с чеком , в котором для генерации фискального документа на возврат денежных средств следует выбрать пункт «», после чего документ будет сгенерирован и через некоторое время появится в реестре чеков, при этом с помощью интернет-кассы будет произведена операция возврата денежных средств.

Рисунок 6. Возврат денежных средств

История изменений

Версия 1.0

Выпущена 30 октября 2018 г.

Первая версия документа.