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

В документе приводятся сведения о расширении «Ferma OFD.ru», предназначенном для взаимодействия интернет-магазина на OpenCart с облачной кассой Ferma OFD.ru. Расширение создаёт и отслеживает чеки, а также ведёт их реестр.

Расширение подключает магазин к Ferma OFD.ru, создаёт чеки по событиям заказа, получает результаты их обработки и ведёт реестр операций. Основная работа выполняется автоматически после первоначальной настройки.

Расширение реагирует на смену статуса заказа. В настройках администратор выбирает отдельные статусы для предоплаты, полного расчёта и возврата; один статус нельзя использовать в двух сценариях.

Все созданные операции и сообщения Ferma остаются в реестре чеков. Расширение также выполняет их периодическую проверку.

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

1. Откройте «Расширения» → «Установщик».
2. Загрузите файл для OpenCart 4.x ferma.ocmod.zip или для OpenCart / ocStore 3.x OFD_OpenCart_ocStore_3_1.1.ocmod.zip.
3. Нажмите «Установить»
   
4. Откройте Расширения → Расширения и выберите тип «Модули».
5. Найдите Ferma OFD.ru в списке и нажмите «Установить».
   
6. Перезагрузите страницу и убедитесь, что в левом меню появился раздел Ferma OFD.ru с настройками и реестром чеков.
   

Страница настроек разделена на четыре блока: «Настройки», «Кассир», «Триггеры чеков» и «Callback и резервная проверка».

Для каждой НДС-настройки доступны: без НДС, 0%, 5%, 7%, 10%, 22%, а также расчётные 5/105, 7/107, 10/110 и 22/122. Расширение не преобразует ставки автоматически: для каждого вида чека используется ровно выбранная ставка.

Если отдельному товару нужна ставка НДС, отличающаяся от общей, настройте её индивидуально:

1. Перейдите в раздел «Каталог» → «Товары».
2. Выберите нужный товар и нажмите «Редактировать».
   
3. Перейдите на вкладку Ferma OFD.ru.
4. Укажите:
   • НДС для чека предоплаты;
   • НДС для чека полного расчёта.
     

Оба поля необязательны. Значение «Использовать ставку из настроек плагина» означает, что для этого товара будет применена соответствующая общая ставка из раздела настроек Ferma OFD.ru. Индивидуальная ставка применяется только к товарной строке и имеет приоритет над общей.

Ставка доставки и поддерживаемых сборов в карточке товара не настраивается: для них всегда используется отдельная общая настройка НДС доставки и сборов. Возврат воспроизводит ставку из исходного чека и не зависит от текущих настроек товара.

Передача кассира необязательна. Если включить параметр «Передавать сведения о кассире в чек», обязательно укажите ФИО кассира. ИНН кассира можно не указывать. Если он указан, допускается значение длинной 10 или 12 цифр.

Расширение создаёт чек автоматически, когда заказ переходит в выбранный статус. Один и тот же статус нельзя выбрать для двух разных сценариев.

Порядок создания полного расчёта зависит от параметра «Создавать чек полного расчёта без подтверждённого чека предоплаты»:

• параметр выключен — полный расчёт ждёт подтверждения предоплаты;
• параметр включён — полный расчёт создаётся по своему статусу даже без чека предоплаты.

Какой статус за какой чек отвечает, настраивается в разделе Ferma OFD.ru:

1. Откройте Ferma OFD.ru → Настройки.
   
2. В блоке «Триггеры чеков» для каждого сценария укажите статус заказа, при переходе в который должен создаваться этот чек.
   
3. Нажмите «Сохранить».
   

Адрес callback формируется расширением автоматически на основе публичного адреса магазина. Выберите подходящий публичный адрес из предложенных — если доступен HTTPS, приоритет отдаётся ему.

Резервная проверка нужна на случай, если callback от Ferma по какой-то причине не дошёл до магазина: расширение самостоятельно и периодически опрашивает статусы отправленных чеков, чтобы реестр оставался актуальным.

Значения периода и лимита по умолчанию подходят большинству магазинов, и менять их не обязательно. Пересмотреть их стоит, если сервер не справляется с нагрузкой (например, из-за высокой посещаемости магазина) или по иным причинам производительности — тогда период можно увеличить, а число чеков за одну проверку уменьшить:

• период проверки: 1, 2, 5, 10 или 20 минут;
• чеков за одну проверку: 20, 50, 100 или без ограничений.

Фактическая частота запуска резервной проверки зависит ещё и от посещаемости сайта: на магазинах с низкой посещаемостью проверка может запускаться реже заданного периода.

Для настройки следуйте инструкции:

1. Откройте Ferma OFD.ru → Настройки.
   
2. В блоке «Callback и резервная проверка» заполните нужные поля.
   
3. Нажмите «Сохранить».
   

После заполнения всех блоков настроек:

1. В поле «Статус» выберите «Включено».
2. Нажмите «Проверить подключение» и убедитесь, что появилось уведомление об успешной проверке.
3. Нажмите «Сохранить».
   

В обычном режиме дополнительное действие менеджера магазина не требуется: смена выбранного статуса заказа создаёт соответствующий чек. В истории заказа добавляется служебный комментарий Ferma, а чек появляется в реестре.

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

Откройте Ferma OFD.ru → Реестр чеков. В реестре отображаются номер и тип чека, статус, заказ, сумма, дата создания, описание ошибки и ссылка на чек.

Кнопка «Обновить статусы» проверяет ожидающие чеки. В каждой строке есть отдельная кнопка обновления. Если сервис прислал технический ответ, используйте заметную кнопку «Показать технический ответ» — она открывает сохранённый ответ Ferma и помогает при диагностике.

В реестре доступен блок «Ручное создание чека». Для его создания:

1. Укажите номер заказа (можно узнать в разделе «Продажи/Заказы»).
2. Выберите тип чека.
3. Нажмите «Зарегистрировать чек».
   

Для ручного полного расчёта действует та же защита, что и для автоматического: если сценарий без предоплаты выключен, потребуется подтверждённый чек предоплаты. Для ручного возврата должен существовать подтверждённый исходный чек соответствующего типа.

Если Ferma вернула ссылку на чек, его идентификатор в реестре открывается в новой вкладке. Если ссылки нет, реестр всё равно содержит идентификатор Ferma, InvoiceId, номер заказа и актуальный статус.

При проблеме выполните следующие действия:

1. Проверьте среду API: тестовая или рабочая.
2. Нажмите «Проверить подключение» в настройках.
   
3. Откройте реестр и обновите статус конкретного чека.
   
4. При наличии ошибки нажмите «Показать технический ответ» и сохраните текст ответа для обращения в поддержку.

Версия 1.0
Выпущена 09 октября 2018 г.
Первая отслеживаемая версия документа.

Версия 1.1
Выпущена 07 сентября 2026 г.
Полностью переработанная инструкция, обновлен плагин. Описан формат работы с версиями OpenCart 3+.