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

Расширение “Ferma OFD.ru” для CMS “CS-Cart”

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

Введение

В документе приводятся технические сведения о плагине “Ferma OFD.ru”, предназначенном для CMS “CS-Cart”. Модуль тестировался на версии 4.9.2. Модуль предназначен для взаимодействия информационной системы, использующей CMS “CS-Cart” с информационными системами оператора фискальных данных “OFD.ru” для генерации фискальных документов с помощью интернет-касс и получения информации о сгенерированных фискальных документах.

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

Плагин “Ferma OFD.ru” для CMS “CS-Cart” распространяется в виде файла, содержащего программное расширение, позволяющее CMS “CS-Cart” взаимодействовать с информационными системами оператора фискальных данных “OFD.ru” с целью генерации чеков, загрузки чеков, а также просмотра реестра чеков и управления ими.

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

При смене статуса заказа клиента на статус, заданный в настройках формирования приходного чека (например, «Оплачено»), компонент «Ferma OFD.ru» автоматически создает в облачной кассе ОФД чек на получение денежных средств от покупателя.

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

Расширение “Ferma OFD.ru” распространяется в виде архива, который требуется загрузить в CMS “CS-Cart” через «Управление модулями».

Установка состоит из нескольких этапов:

1. Открыть раздел «управления модулями» (см. рисунок 1).
Рисунок 1. «Управления модулями»
2 В появившемся окне выбрать ранее скачанный архив с модулем «cscart.ofd_ferma.zip» и нажать кнопку «Загрузить и установить» (см. рисунок 2).
Рисунок 2. Страница загрузки модуля
3. После того как наш модуль установился, обновим текущую страницу нажав на клавиатуре клавишу «F5»

Для настройки плагина перейдем на страницу модулей, через меню «Модули» - «Управления модулями» и в появившемся списке модулей найдем «Ferma OFD.ru» (см. рисунок 3)

Рисунок 3. Модуль «Ferma OFD.ru»

После клика по названию модуля, у нас откроется окно настроек модуля (см. рисунок 4)

Рисунок 4. Окно настройки модуля

С помощью пользовательского интерфейса в окне настроек, введите актуальные значения настроек плагина; назначение параметров описано в таблице 1.

После ввода значений в соответствующие поля нажмите кнопку «Сохранить»

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

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

Для автоматического обновления статуса, необходимо добавить задачу на проверку в Cron. Строка для cron'a:

GET <ваш домен>/index.php?dispatch=ofd_ferma.cron

или так:

/30 * * * * wget -q -O - <ваш домен>/index.php?dispatch=ofd_ferma.cron /dev/null 2>&1

Параметры уточните у вашего хостинг провайдера. Периодичность: 1 раз в 20 - 30 мин.

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

В общем случае для создания товарного чека в облачной кассе ОФД не требуется никаких дополнительных действий: модуль в автоматическом режиме при смене статуса заказа, созданного клиентом в ИС интернет-магазина, на указанный в настройках создает чек на получение денежных средств от покупателя. Также чеки можно сформировать вручную из административной панели, в том числе чек на возврат сумм производится исключительно вручную, процедура описана в разделе 4.1.

В случае, если чек не сформирован по причине неправильного заполнения полей, то необходимо изменить их значения в заказе клиента или настройках и повторить попытку. Список уже сформированных чеков можно вызвать с помощью пунктов меню: «Модули» - «Ferma OFD.ru» (см. рисунок 5).

Рисунок 5. Страница списка чеков

В списке чеков отображаются идентификаторы чеков в информационных системах “OFD.ru”, дата создания чека, сумма по чеку, тип чека (чек прихода или чек возврата), номер заказа (со ссылкой на страницу заказа), с которым связан чек и статус чека (например, «Чек передан в ОФД»).

Если текущее значение статуса не конечное, то его можно уточнить вручную: необходимо нажать кнопку «Обновить Чек» (см. рисунок 6).

Рисунок 6. Обновление статуса чека

Также имеется возможность фильтрации существующих чеков по периоду, типу или номеру заказа.

4.1. Создание чеков в ручном режиме

Чек можно создать и в ручном режиме для каждого заказа. Нажав в реестре чеков на номер заказа нужного чека, либо выбрав заказ из списка заказов магазина и перейти к редактирование (см. рисунок 7). Далее необходимо, перейти на вкладку «Ferma OFD.ru» (см. рисунок 8).

Рисунок 7. Страница заказов
Рисунок 8. Вкладка «Ferma OFD.ru»

Из данного окна, можно «Сформировать чек прихода» или «Сформировать чек возврата» в ручном режиме (см. рисунок 9).

Рисунок 9. «Сформировать чек прихода» и «Сформировать чек возврата»

Чек возврата формируется только в ручном режиме, то есть, только с помощью данного интерфейса. Если формирование чека невозможно или в процессе формирования чека возникли ошибки, сообщения в всплывающем окне (см. рисунок 10) или в логе, который формируется в директории сайта /var/ofd_ferma.log.

Рисунок 10. Ошибка формирования чека

4.2. Просмотр чеков

В таблице реестра чеков (см. рисунок 11) идентификаторы чеков представляют собой ссылки, по которым расположены изображения чеков; нажатие на ссылку приводит к загрузке страницы с изображением чека (см. рисунок 12) в виде, как бы он при печати был изображен на бумаге. Обычно страница открывается в новой вкладке браузера.

Рисунок 11. Реестр чеков
Рисунок 12. Чек

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

Версия 1.0

Выпущена 7 марта 2019 г.

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