Настроить конфигурационный файл для онлайн-кассы АТОЛ Онлайн

Для фискализации с помощью сервиса АТОЛ Онлайн необходимо настроить систему.

Обратите внимание: вам нужно предварительно зарегистрироваться в АТОЛ Онлайн.

Далее выполните следующие шаги.

  1. Указать данные для тестовой среды
  2. Провести тестовый платёж и проверить, фискализировался ли чек
  3. После успешной проверки — указать в конфигурационном файле данные для промышленной эксплуатации

Указать данные для тестовой среды

Откройте файл atol_fiscalization.cfg:

nano /usr/local/billing/pymodules/atol_fiscalization.cfg

Укажите данные для подключения к тестовой среде АТОЛ Онлайн. Остальные данные на этом этапе можно не редактировать.

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

Для ФФД 1.05 Для ФФД 1.2
  • Компания: АТОЛ
  • fdf_version: 1.05
  • login: v4-online-atol-ru
  • password: iGFFuihss
  • host: https://testonline.atol.ru/possystem/v4/
  • group_code: v4-online-atol-ru_4179
  • payment_address: https://v4.online.atol.ru
  • inn: 5544332219
  • Компания: АТОЛ
  • fdf_version: 1.2
  • login: v5-online-atol-ru
  • password: zUr0OxfI
  • host: https://testonline.atol.ru/possystem/v5/
  • group_code: v5-online-atol-ru_5179
  • payment_address: https://v5.online.atol.ru
  • inn: 5544332219
Пример тестовой конфигурации для ФФД 1.05
Пример тестовой конфигурации для ФФД 1.2

Когда заполните тестовые данные, сохраните файл.

Проверить, фискализируется ли чек

Проведите тестовую оплату. Чтобы проверить, что всё корректно работает в тестовом режиме, проверьте лог LBcore.

В логе должны присутствовать строки вида:

20.11.2025 01:57:03.999040 DEBUG   LWP410044 [db_proxy_connection.cpp:226:LogQuery]     SqlQuery : [120214] INSERT  INTO `fiscal_payments` (`payment_id`, `fiscal_state`, `amount`, `agrm_id`, `processed_date`, `payment_type`, `detail`, `pay_detail`) VALUES ('417646', '1', '1350.000000', '8535', '2025-11-20 01:57:03', '0', '[ { "agent_info": null, "amount": 1350.000000, "descr": "Пополнение договора", "payment_method": "full_payment" } ]', '[ { "amount": 1350.000000, "type": 1 } ]')
20.11.2025 02:01:30.980049 DEBUG   LWP409463 [connection.cpp:143:Debug] Atol: json_param: {"external_id": "150-20251120T020130-sell", "receipt": {"client": {"name": "\u0421\u043e\u043a\u043e\u043b\u043e\u0432\u0430 \u0413\u0430\u043b\u0438\u043d\u0430 \u0413\u0435\u043e\u0440\u0433\u0438\u0435\u0432\u043d\u0430", "email": "", "phone": ""}, "company": {"email": "", "sno": "osn", "inn": "5544332219", "payment_address": "https://v5.online.atol.ru"}, "items": [{"name": "\u041f\u043e\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0435 \u0434\u043e\u0433\u043e\u0432\u043e\u0440\u0430: \u0424\u041b-2024/034", "price": 1350.0, "quantity": 1, "sum": 1350.0, "payment_method": "full_payment", "payment_object": "payment", "vat": {"type": "vat0"}}], "payments": [{"sum": 1350.0, "type": 1}], "total": 1350.0, "internet": true}, "timestamp": "20.11.2025 01:57:03"}

Указать данные для промышленной эксплуатации

Если проверка прошла успешно, укажите в файле конфигурации данные для промышленной эксплуатации.

Откройте файл atol_fiscalization.cfg:

nano /usr/local/billing/pymodules/atol_fiscalization.cfg

Укажите в нём данные для промышленной эксплуатации.

У вас может быть несколько онлайн-касс. В этом случае в каждой секции укажите префикс кассы, например:

  • [cashbox_1:connect] и [cashbox_1:company],
  • [cashbox_2:connect] и [cashbox_2:company].

Значения параметров для промышленной эксплуатации:

[cashbox:connect]

  • login и password — реквизиты доступа, полученные при регистрации в АТОЛ Онлайн.

  • host:

    • для ФФД 1.05 — https://online.atol.ru/possystem/v4/
    • для ФФД 1.2 — https://online.atol.ru/possystem/v5/

  • group_code — код вашей компании в ККТ. Также должен быть получен при регистрации в АТОЛ Онлайн.

  • timeout — время ожидания ответа сервера. Указывается в секундах.

[cashbox:company]

  • sno — система налогообложения вашей компании. Возможные значения:

    • osn
    • usn_income
    • usn_income_outcome
    • envd
    • esn
    • patent

  • email — адрес электронной почты вашей компании.

  • payment_address — место расчётов. Должен быть получен после регистрации в АТОЛ Онлайн.

  • fdf_version — версия ФФД. Возможные значения:

    • 1.05
    • 1.2

  • inn — ИНН вашей компании.

  • default_email — email, на который система будет отправлять чеки в тех случаях, когда у абонента не указан электронный адрес.

  • service_name — наименование услуги в чеке.

  • managers_exclude — если задать этот параметр, система будет фискализировать платежи от всех менеджеров кроме тех, которые указаны в этой строке. Допустимое значение: ID менеджера. Если таких менеджеров должно быть несколько, перечислите их ID через точку с запятой (;).

  • payclass_exclude — если задать этот параметр, система будет фискализировать платежи для всех категорий, кроме тех, которые указаны в этой строке. Допустимое значение: ID категории платежа. Если таких категорий должно быть несколько, перечислите их ID через точку с запятой (;).

  • oper_exclude — если задать этот параметр, система будет фискализировать платежи по всем договорам, кроме тех, в которых назначен этот оператор. Допустимое значение: ID оператора. Если таких операторов должно быть несколько, перечислите их ID через точку с запятой (;).

  • managers_include — если задать этот параметр, система будет фискализировать только платежи, которые провёл этот менеджер. Допустимое значение: ID менеджера. Если таких менеджеров должно быть несколько, укажите их ID через точку с запятой (;).

  • payclass_include — если задать этот параметр, система будет фискализировать только платежи, в которых указана эта категория. Допустимое значение: ID категории платежа. Если таких категорий должно быть несколько, укажите их ID через точку с запятой (;).

  • oper_include — если задать этот параметр, система будет фискализировать только платежи по договорам, в которых указан этот оператор. Допустимое значение: ID оператора. Если таких операторов должно быть несколько, укажите их ID через точку с запятой (;).

  • acc_type_include — если задать этот параметр, система будет фискализировать платежи только для указанных типов пользователей. Если таких типов пользователей должно быть несколько, укажите их через точку с запятой (;). Допустимые значения:

    • 1 — юрлица
    • 2 — физлица
    • 3 — ИП

  • acc_type_exclude — если задать этот параметр, система будет фискализировать платежи для всех типов пользователей, кроме указанных в этой строке. Если таких типов пользователей должно быть несколько, укажите их через точку с запятой (;). Допустимые значения:

    • 1 — юрлица
    • 2 — физлица
    • 3 — ИП

  • payment_method — признак способа расчёта:

    • full_prepayment — полная предоплата,
    • prepayment — частичная предоплата,
    • advance — аванс,
    • full_payment — полный расчёт,
    • partial_payment — частичный расчёт и кредит,
    • credit — кредит,
    • credit_payment — выплата по кредиту.

    Обратите внимание: отправляемая ставка НДС будет зависеть от настройки в карточке оператора и от признака способа расчета. Подробнее.

  • type — вид оплаты:

    • 1 — безналичный,
    • 2 — предварительная оплата (аванс),
    • 3 — постоплата (кредит),
    • 4 — иная форма оплаты (встречное предоставление),
    • 5-9 — расширенные виды оплаты.

  • payment_object — предмет расчёта. Формат значения зависит от выбранной версии ФФД.

    • для ФФД 1.05:
      • commodity — товар, может указываться на услуге в тарифе в предмете расчёта,
      • job — работа, может указываться на услуге в тарифе в предмете расчёта,
      • service — при фискализации услуги или трафика; может также указываться на услуге в тарифе в предмете расчёта,
      • payment — при проведении платежа.
    • для ФФД 1.2:
      • 1 — соответствует значению commodity (товар),
      • 3 — соответствует значению job (работа),
      • 4 — соответствует значению service (услуга),
      • 10 — соответствует значению payment (платёж).

  • send_order_type — очередность отправки идентификаторов:

    • 0 — отправляется и номер телефона абонента, и адрес его электронной почты. Если у абонента не указан ни телефон, ни электронный адрес, то отправляется почта по умолчанию.
    • 1 — если у абонента указан телефонный номер, то LANBilling отправляет только его. Если телефона нет, то отправляется почта — та, что указана у абонента, либо та, что задана по умолчанию.
    • 2 — если у абонента указан адрес электронной почты, то LANBilling отправляет только его. Если почты нет, но есть номер телефона — LANBilling отправляет его. Если телефон тоже не указан, то отправляется почта по умолчанию.

  • use_agent_info — отправлять ли в чеке информацию о том, что ваша организация выступает в роли агента:

  • agent_info_type — если вы работаете по агентской схеме, нужно указать признак агента по предмету расчёта:

    • bank_paying_agent — банковский платежный агент
    • bank_paying_subagent — банковский платежный субагент
    • paying_agent — платежный агент
    • paying_subagent — платежный субагент
    • attorney — поверенный
    • commission_agent — комиссионер
    • another — другой тип агента

Определение ставки НДС

Отправляемая ставка НДС зависит от двух факторов:

Модуль соотносит эти параметры и автоматически выбирает ставку по следующей логике:

  • full_prepayment — расчётная ставка (vat105, vat107, vat122),
  • prepayment — расчётная ставка (vat105, vat107, vat122),
  • advance — расчётная ставка (vat105, vat107, vat122),
  • full_payment — обычная ставка (vat5, vat7, vat22),
  • partial_payment — обычная ставка (vat5, vat7, vat22),
  • credit — обычная ставка (vat5, vat7, vat22),
  • credit_payment — обычная ставка (vat5, vat7, vat22),
  • если у оператора установлена настройка «Без НДС», во всех операция отправляется none.
Соответствие ставок НДС передаваемым значениям

Пример.

В карточке оператора указана ставка НДС 7%.

  • Если payment_method — full_payment, partial_payment, credit или credit_payment, то отправляемая ставка будет 7%.

  • Если payment_method — full_prepayment, prepayment или advance, то отправляемая ставка будет 7/107%.

Когда заполните данные, сохраните файл.

Что делать дальше?

  • Определите, должна ли система отправлять в онлайн-кассу данные о списаниях. Если да — включите опцию fiscalization_services_payments.

  • Настройте шаблон для отчёта по фискализации. Сформированный отчёт позволяет увидеть, какие операции были фискализированы.