Коннектор Ferma к 1С

Версия 2.0 от 20.12.2021 Открыть pdf-файл Модуль Ferma к 1С

Введение

В инструкции представлено описание пользовательского интерфейса внешней обработки для конфигурации «1С: Предприятие Управление торговлей». Внешняя обработка «Коннектор 1C Ferma» (далее - модуль) предназначен для автоматизации процесса фискализации транзакций отраженных в пользовательской учетной системе, на облачной кассе Ferma. Внимание! Модуль не работает в облачной версии «1С Предприятие»

1. Основные функции и системные требования

Модуль позволяет сформировать чеки и отправить для фискализации в Сервис Ferma. Модуль может отправлять сформированные чеки в автоматическом или ручном режиме.
С помощью инструментов «1С:Предприятие» модуль формирует следующие документы:

  1. Чек ККМ;
  2. Чек ККМ Возврат;
  3. Чек ККМ Коррекции.

Модуль работает на платформе «1С:Предприятие 8.3.15» и выше, в следующих конфигурациях:

  • «Управление торговлей 11.4»;
  • «Управление торговлей базовая 11.4»;
  • «1С: Бухгалтерия предприятия 3.0»;
  • «1С: Бухгалтерия предприятия базовая 3.0».

Модуль разработан на встроенном языке «1С:Предприятия» без использования недокументированных компонентов и функций языка. Модуль не вносит изменений в конфигурацию баз данных «1С:Предприятия» и не изменяет ее структуру.

Внимание! Модуль работает только с настроенными в «1С:Предприятие» складами реализации товаров.

2. Установка и авторизация

В разделе представлено описание установки и настройки модуля.

2.1. Установка

Чтобы установить модуль, необходимо выполнить следующие действия:

  1. Открыть «1С Предприятие».
  2. Запустить модуль.
    • Модуль запускаем в «1С Предприятие», через панель инструментов в разделе «Файл» нажимаем на кнопку «Открыть». Откроется окно проводника.
    • В окне проводника найдите скаченный файл с названием ferma.epf.
  3. Необходимо открыть файл. Модуль будет запущен и откроется главная страница.

2.2. Авторизация

Чтобы авторизоваться в модуле, необходимо выполнить следующие действия:

  1. Выберите склад или подключите новый, в разделе "4. Подключение нового склада" представлено описание подключение нового склада.
  2. Нажмите кнопку «Авторизация». В окне выбора склада должен появиться знак , если появился вам необходимо проверить настройки склада.
  3. На главной странице модуля появиться вкладка «Чеки ККТ».
  4. Перейдите на вкладку «Чеки ККТ».

В окне вкладки «Чеки ККТ» выводятся все чеки, как показано на рисунке ниже, если не было ни одно реализации товара, список чеков будет пуст

После настройки модуля переходите к работе с модулем. Описание работы с модулем представлено в разделе "3. Описание работы модуля".

3. Описание работы модуля

Данные для модуля передаются инструментами «1С Предприятие». Модуль формирует запрос в формате JSON и отправляет в сервис Ferma для пробития чека.

3.1. Формирование чека

Чтобы сформировать чек для отправки в сервис Ferma вам необходимо выполнить следующие действия:

  1. Перейдите в раздел «Продажи», в блоке «Розничные продажи» нажмите «Розничные продажи и чеки».
  2. Откроется окно «Розничные продажи (Чеки)». В окне выведена таблица со всеми сформированными чеками для отправки в сервис Ferma, если не было ни одной реализации, список будет пуст
  3. Чтобы сформировать чек, нажмите кнопку «Продажи». Откроется форма для формирования чека.
  4. Заполните данные для формирования чека:
    • склад
    • организация
    • товар или услуга.
  5. После заполнения данных нажмите кнопку «Принять оплату». Откроется окно выбора оплаты.
  6. Выберете тип оплаты нажмите кнопку «Принять оплату».

Сформируется чек с данными для отправки в сервис Ferma.
Описание отправки чека представлено в разделе "3.2. Отправка чека в сервис Ferma".

3.2. Отправка чека в сервис Ferma

Чтобы отправить чек для пробития в сервисе Ferma необходимо выполнить следующие действия:

  1. Перейдите на главную страницу модуля.
  2. Выберите склад, нажмите на кнопку «Авторизация».
  3. Нажмите на вкладку «Чеки ККТ», вкладка появится на главной странице если авторизация склада прошла успешно.

  4. Укажите период для поиска чека, нажмите на кнопку «Обновить статусы».

  5. Найдите сформированный чек для отправки в сервиса Ferma.
  6. Нажмите на кнопку
  7. Нажмите на кнопку «Обновить статусы». Отправленный чек в сервис Ferma будет выделен зелёным цветом.

Описание статусов представлено в таблице 1.

Таблица 1. Описание статуса чека

Цвет текста Статус чека Описание
Зелёный Сформирован и отправлен Чек сформирован и отправлен в сервис Ferma для пробития
Черный Сформирован Чек сформированы для отправки в сервис Ferma
Красный Сформирован и отправлен Чек сформирован и отправлен в сервис Ferma в процессе пробития возникла ошибка

4. Подключение нового склада

Внимание! В «1С Предприятие» склад реализации товаров должен быть настроен.

Модуль может работать в двух режимах «Демонстрационный» и «Рабочий».

Для режима «Демонстрационный» необходимо ввести следующие данные:

  • Домен - ferma-test.ofd.ru;
  • Логин - fermatest1;
  • Пароль - Hjsf3321klsadfAA.

Для режима «Рабочий» необходимо ввести следующие данные:

  • Домен - ferma.ofd.ru;
  • Логин - от кассы Ferma, логин от кассы Ferma вы можете узнать ЛКК в разделе «Сервис Ferma» реквизиты доступа;
  • Пароль - от кассы Ferma, пароль от кассы Ferma вы можете узнать ЛКК в разделе «Сервис Ferma» реквизиты доступа.

Последовательность действий:

  1. После запуска модуля в окне нажмите на кнопку «+».
  2. Откроется форма для настройки склада.
  3. Заполните форму:
    • выберите склад;
    • выберите домен сервиса Ferma;
    • введите логин от сервиса Ferma;
    • введите пароль от сервиса Ferma;
    • Укажите места расчетов;
    • При необходимости заполните блок «Дополнительный реквизит»
    • После ввода всех данных нажмите на кнопку «Сохранить и закрыть»


Склад будет добавлен в список.


Что бы проверить правильности введенных данных, выберите склад, нажмите кнопку «Авторизация». В окне выбора склад должен появиться знак .

В главном окне модуля добавится раздел «Чеки ККТ».

Настройка склада завершена.

В следующих запусках модуля, склад будет сохранен в общем списке.

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

Версия 1.0
Выпущена 30 декабря 2020 г.
Первая регистрируемая версия документа.

Версия 1.1
Выпущена 31 декабря 2020 г.
Исправлены опечатки, рисунки

Версия 1.2
Выпущена 11 января 2021 г.

  • Незначительные изменения в форматировании документа
  • Добавлены конфигурации «1С: Бухгалтерия предприятия 3.0», «1С: Бухгалтерия предприятия базовая 3.0»

Версия 2.0
Выпущена 20 декабря 2021 г.

  • Изменена структура
  • Обновлены рисунки