Phpshop cms: GitHub — phpshopsoftware/phpshopcms: Сайт на PHP и MySQL

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

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

Введение

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

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

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

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

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

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

Расширение “Ferma OFD.ru” распространяется в виде архива, который требуется разархивировать в корневую директорию с
сайтом, и после этого перейти на страницу «Модули» -> «Управление модулями» (см. рисунок 1).

Рисунок 1. Установка модуля

На странице с модулями, перейти на вкладку «Платежные системы», найти наш модуль «Ferma OFD.ru» и включить его
(см. рисунок 2). Должна выполнится установка нашего модуля.

Рисунок 2. Страница с активацией модуля «Ferma OFD.ru»

Для настройки плагина выберем его в списке модулей (см. рисунок 3).

Рисунок 3. Страница настроек плагина «Ferma OFD.ru»

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

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

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

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

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

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

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

Рисунок 4. Журнал операций

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

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

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

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

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

Чек можно создать и в ручном режиме для каждого заказа. Нажав в реестре чеков на номер заказа нужного чека, либо
выбрав заказ из списка заказов магазина и перейти к редактирование его (см. рисунок 6). Здесь можно «Сформировать чек
прихода» или «Сформировать чек возврата» в ручном режиме.

Рисунок 6. Страница создания чеков в ручном режиме

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

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

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

В таблице реестра чеков, «Модули» -> «Ferma OFD.ru» -> «Журнал операций» (см. рисунок 8) идентификаторы чеков
представляют собой ссылки, по которым расположены изображения чеков; нажатие на ссылку приводит к загрузке страницы с
изображением чека (см. рисунок 9) в виде, как бы он при печати был изображен на бумаге. Обычно страница открывается в
новой вкладке браузера.

Рисунок 8. Страница «Журнал операций»Рисунок 9. Чек

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

Версия 1.0

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

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

Динамика числа установок CMS «phpshop free» за период: Август 2013 — Апрель 2014

Период:
август 2013
— апрель 2014

Приведенные данные позволяют оценить динамику изменения количества установок CMS «PHPShop Free» за выбранный период.
Приток характеризует источник перехода на «PHPShop Free», а отток — системы, на которые сайты перешли, отказавшись от
использования «PHPShop Free».

Рейтинг систем управления сайтами (CMS) существует с 2009 года, он составлен по информации
о реальных установках на сайтах, признан самым достоверным большинством разработчиков CMS
и проверен компанией Microsoft.

Приток
Новая установка 1200
WordPress0
PHPShop0
MODx0
WebAsyst Shop-Script0
DataLife Engine0
Прочие0
+200
Отток
CMS удалена 2700
WordPress10
Joomla10
DataLife Engine0
1C-Bitrix0
MODx0
Прочие0
−700

итого:

−500

Данные по количеству установок округлены до десятков или сотен (в зависимости от количества),
суммы и проценты рассчитаны по исходным значениям.

1 Под новой установкой понимаются случаи, когда в начале периода CMS на домене была не определена,
домен не существовал, или сервер ответил ошибкой.

2 Под удалением понимаются случаи, когда в окончании периода домен перестал существовать,
CMS на домене была не определена, или сервер ответил ошибкой.

PHPShop — Какая CMS?

Ошибка управления

Русская платформа интернет-магазина. Умный морфологический поиск, инструменты SEO, мощный маркетинговый функционал, адаптивные шаблоны, удобная обработка запросов с сайта, 18 лет разработки, полноценная база знаний и более 100 бесплатных модулей и интеграций.

    • Технологии Категория Веб-сайты Сравнить
    PHP Язык программирования 331 PHPShop и PHP
    Nginx Веб-сервер 283 PHPShop против Nginx
    Апач Веб-сервер 39 PHPShop и Apache
    ОпенРести Веб-сервер 34 PHPShop и OpenResty
    Облачная вспышка CDN 29 PHPShop против Cloudflare
    cdnjs CDN 22 PHPShop и cdnjs
    Убунту Операционная система 19 PHPShop и Ubuntu
    Библиотеки, размещенные в Google CDN 13 Сравнение PHPShop и размещенных на Google библиотек
    CDN jQuery CDN 8 PHPShop и jQuery CDN
    Распаковка CDN 5 PHPShop и Unpkg
    ЦенОС Операционная система 5 PHPShop и CentOS