Документация BILLmanager 5
Документация — ваш лучший друг?
Поделитесь мнением и пройдите небольшой опрос
Пройти опрос

Как перейти на ФФД 1.05

Согласно федеральному закону 54, c 1-го января 2019 года чеки на приобретённые услуги должны соответствовать установленному формату фискальных данных (ФФД) версии 1.05.

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

Если для отправки чеков вы используете интеграцию с онлайн-кассой, то для перехода к новому формату: 

  1. Измените версию API в личном кабинете АТОЛ.
  2. В BILLmanager смените модуль для интеграции с онлайн-кассой.
  3. Отправьте чеки с ошибкой через новую интеграцию. 

Шаг 1. Изменение версии API

Чтобы изменить версию API в личном кабинете АТОЛ, воспользуйтесь официальной инструкцией

Шаг 2. Смена модуля для интеграции

Чтобы перейти на API v4, создайте новую интеграцию с АТОЛ:

  1. Перейдите в Финансы → Онлайн-кассы → Создать и выберите модуль "АТОЛ Онлайн v4". 
  2. Укажите Наименование кассы
  3. Если создаёте интеграцию для тестирования, то в поле API URL введите "https://testonline.atol.ru/possystem/v4/". Для действующей интеграции оставьте поле пустым. 
  4. Укажите Логин и Пароль для авторизации в АТОЛ Онлайн. 
  5. Введите Код группы ККТ, полученный в личном кабинете АТОЛ. 
  6. Укажите Email отправителя чека. 
  7. Укажите ИНН организации, на которую зарегистрирована ККТ. 
  8. Введите Адрес расчётов, указанный при регистрации ККТ в ФНС. 
  9. Введите Наименование услуги, которое будет использоваться при авансовых платежах. 
  10. Включите опцию Регистрация чеков по оказанным услугам, чтобы формировать вторые чеки (чеки реализации) на основе расходов. Если опция отключена, то второй чек формироваться не будет. 
  11. Если требуется формировать чеки возврата по платежам, для которых отсутствует чек прихода, то активируйте опцию Регистрация чеков возврата для платежей без чеков прихода
  12. Нажмите Ok и отключите модуль, работающий по API v3: Финансы → Онлайн-кассы → Выкл

Шаг 3. Переотправка чеков с ошибкой

После смены модуля интеграции новые чеки не будут отправлены из-за ошибки "8 (system): Ошибка валидации входящего чека с GUID <GUID чека>: Кассы, относящиеся к группе, не поддерживают ФФД 1.00 и версию сервиса v3. Необходимо отправить запрос на версию сервиса v4 с поддержкой ФФД 1.05". Такие чеки необходимо подключить к новой интеграции с онлайн-кассой и повторить отправку вручную:

  1. Подключитесь по SSH к серверу с BILLmanager, используя учётную запись суперпользователя. 
  2. Войдите в систему управления базами данных и подключитесь к базе billmgr:

    mysql billmgr
  3. Выполните SQL-запрос на обновление записей в таблице payment_receipt: 
  4. update payment_receipt set payment_cash_register=<moduleID> where error_message like '8%';
    Пояснения к запросу
  5. Запустите повторную отправку чеков с ошибкой: Финансы → Чеки → Отправить