Настроить конфигурационный файл для онлайн-кассы АТОЛ Онлайн
Для фискализации с помощью сервиса АТОЛ Онлайн необходимо настроить систему.
Обратите внимание: вам нужно предварительно зарегистрироваться в АТОЛ Онлайн.
Далее выполните следующие шаги.
- Указать в конфигурационном файле данные для тестовой среды
- Провести тестовый платёж и проверить, фискализировался ли чек
- После успешной проверки — указать в конфигурационном файле данные для промышленной эксплуатации
Указать данные для тестовой среды
Откройте файл atol_fiscalization.cfg
:
nano /usr/local/billing/pymodules/atol_fiscalization.cfg
Укажите данные для подключения к тестовой среде АТОЛ Онлайн.
ФФД 1.05 |
ФФД 1.2 |
Этот формат фискальных данных подходит поставщикам услуг и продавцам немаркированных товаров.
|
Этот формат фискальных данных предназначен для организаций, которые продают маркированные товары. Подробнее — на сайте АТОЛ.
|
Остальные данные на этом этапе можно не заполнять.
Пример для ФФД 1.05
Пример заполненного файла конфигурации для ФФД 1.05
[cashbox:connect]
#реквизиты доступа к АТОЛ Онлайн
login = v4-online-atol-ru
password = iGFFuihss
host = https://testonline.atol.ru/possystem/v4/
#код компании в ККТ
group_code = v4-online-atol-ru_4179
#время ожидания ответа сервера в секундах
timeout = 5
[cashbox:company]
#Система налогообложения: osn | usn_income | usn_income_outcome | envd | esn | patent
sno = osn
#Email компании
email = test@test.ru
#Место расчётов
payment_address = https://v4.online.atol.ru
#ИНН компании
inn = 5544332219
#Ставка налога: none | vat0 | vat10 | vat18 | vat110 | vat118 | vat20 | vat120
nds = vat20
#Email для приема чеков, если абонентский email не задан
default_email = my-company@example.ru
# Наименование услуги в чеке
service_name =
# Список идентификаторов менеджеров, платежи которых не требуется фискализировать (перечисление через разделитель ;)
managers_exclude =
# Список типов платежей, которые не требуется фискализировать (перечисление через разделитель ;)
payclass_exclude =
# Список операторов договоров, которые не требуется фискализировать (перечисление через разделитель ;)
oper_exclude =
# Список идентификаторов менеджеров, платежи которых требуется фискализировать (перечисление через разделитель ;)
managers_include =
# Список типов платежей, которые требуется фискализировать (перечисление через разделитель ;)
payclass_include =
# Список операторов договоров, которые требуется фискализировать (перечисление через разделитель ;)
oper_include =
# Список типов пользователей, которые требуется фискализировать (перечисление через ;) (1 - Юр. лицо, 2 - Физ. лицо, 3 - ИП)
acc_type_include =
# Список типов пользователей, которые не требуется фискализировать (см. описание acc_type_include)
acc_type_exclude =
# Признак способа расчёта: full_prepayment | prepayment | advance | full_payment | partial_payment | credit | credit_payment
payment_method = full_payment
# Вид оплаты: 1 - безналичный | 2 - предварительная оплата (аванс) | 3 - постоплата (кредит) | 4 - иная форма оплаты (встречное предоставление) | 5-9 >
type = 1
# Предмет расчета (применяется только при фискализации платежей): commodity | excise| job| service | gambling_bet | gambling_prize | lottery | lottery_prize | intellectual_activity | payment | agent_commission | composite | another | property_right | non-operating_gain | insurance_premium | sales_tax | resort_fee
payment_object =
# Очередность отправки идентификаторов абонента
# 0 - отправляются и почта, и телефон. Если нет ни того, ни другого, то отправляется почта по умолчанию
# 1 - отправляется только телефон. Если его нет, то заданная почта, либо почта по-умолчанию
# 2 - отправляется только почта. Если ее нет, то заданный телефон, либо почта по-умолчанию
send_order_type = 0
# Отправлять атрибуты агента в чеке
# 0 - не отправлять
# 1 - отправлять
use_agent_info = 0
# Признак агента по предмету расчета
# bank_paying_agent - банковский платежный агент
# bank_paying_subagent – банковский платежный субагент
# paying_agent – платежный агент
# paying_subagent – платежный субагент
# attorney – поверенный
# commission_agent – комиссионер
# another – другой тип агента
agent_info_type = bank_paying_agent
Пример для ФФД 1.2
Пример заполненного файла конфигурации для ФФД 1.2
[cashbox:connect]
#реквизиты доступа к АТОЛ Онлайн
login = v5-online-atol-ru
password = zUr0OxfI
host = https://testonline.atol.ru/possystem/v5/
#код компании в ККТ
group_code = v5-online-atol-ru_5179
#время ожидания ответа сервера в секундах
timeout = 5
[cashbox:company]
# Система налогообложения: osn | usn_income | usn_income_outcome | envd | esn | patent
sno = osn
#Email компании
email = test@test.ru
#Место расчётов
payment_address = https://v5.online.atol.ru
#ИНН компании
inn = 5544332219
#Ставка налога: none | vat0 | vat10 | vat18 | vat110 | vat118 | vat20 | vat120
nds = vat20
#Email для приема чеков, если абонентский email не задан
default_email = my-company@example.ru
# Наименование услуги в чеке
service_name =
# Список идентификаторов менеджеров, платежи которых не требуется фискализировать (перечисление через разделитель ;)
managers_exclude =
# Список типов платежей, которые не требуется фискализировать (перечисление через разделитель ;)
payclass_exclude =
# Список операторов договоров, которые не требуется фискализировать (перечисление через разделитель ;)
oper_exclude =
# Список идентификаторов менеджеров, платежи которых требуется фискализировать (перечисление через разделитель ;)
managers_include =
# Список типов платежей, которые требуется фискализировать (перечисление через разделитель ;)
payclass_include =
# Список операторов договоров, которые требуется фискализировать (перечисление через разделитель ;)
oper_include =
# Список типов пользователей, которые требуется фискализировать (перечисление через ;) (1 - Юр. лицо, 2 - Физ. лицо, 3 - ИП)
acc_type_include =
# Список типов пользователей, которые не требуется фискализировать (см. описание acc_type_include)
acc_type_exclude =
# Признак способа расчёта: full_prepayment | prepayment | advance | full_payment | partial_payment | credit | credit_payment
payment_method = full_payment
# Вид оплаты: 1 - безналичный | 2 - предварительная оплата (аванс) | 3 - постоплата (кредит) | 4 - иная форма оплаты (встречное предоставление) | 5-9 >
type = 1
# Предмет расчета (применяется только при фискализации платежей): commodity | excise| job| service | gambling_bet | gambling_prize | lottery | lottery_prize | intellectual_activity | payment | agent_commission | composite | another | property_right | non-operating_gain | insurance_premium | sales_tax | resort_fee
payment_object =
# Очередность отправки идентификаторов абонента
# 0 - отправляются и почта, и телефон. Если нет ни того, ни другого, то отправляется почта по умолчанию
# 1 - отправляется только телефон. Если его нет, то заданная почта, либо почта по-умолчанию
# 2 - отправляется только почта. Если ее нет, то заданный телефон, либо почта по-умолчанию
send_order_type = 0
# Отправлять атрибуты агента в чеке
# 0 - не отправлять
# 1 - отправлять
use_agent_info = 0
# Признак агента по предмету расчета
# bank_paying_agent - банковский платежный агент
# bank_paying_subagent – банковский платежный субагент
# paying_agent – платежный агент
# paying_subagent – платежный субагент
# attorney – поверенный
# commission_agent – комиссионер
# another – другой тип агента
agent_info_type = bank_paying_agent
Когда заполните тестовые данные, сохраните файл.
Перезапустите модуль LBcore. Команды различаются в разных ОС.
-
Для Debian, CentOS, RHEL, РЕД ОС, Astra Linux:
-
Для FreeBSD:
Провести тестовый платёж и проверить, фискализировался ли чек
Проведите тестовую оплату. Рекомендуем выбрать абонента, у которого не заполнен email — так чек придёт на электронную почту, указанную в параметре default_email
.
Проверьте, фискализировался ли чек. Для этого перейдите в сервис проверки «Первый ОФД» и укажите данные из чека:
- Фискальный накопитель
- Фискальный документ
- Фискальный признак документа
Убедитесь, что данные чека корректны.
Указать данные для промышленной эксплуатации
Если проверка прошла успешно, укажите в файле конфигурации данные для промышленной эксплуатации.
Откройте файл 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
— место расчётов. Должен быть получен после регистрации в АТОЛ Онлайн.
-
inn
— ИНН вашей компании.
-
nds
— ставка налога. Возможные значения:
- none — без НДС,
- vat0 — НДС 0%,
- vat10 — НДС 10%
- vat18 — НДС 18%
- vat110 — НДС 10/110
- vat118 — НДС 18/118
- vat20 — НДС 20%
- vat120 — НДС 20/120
-
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
— предмет расчёта:
- commodity — товар
- excise — подакцизный товар
- job — работа
- service — услуга
- gambling_bet — ставка азартной игры
- gambling_prize — выигрыш азартной игры
- lottery — лотерейный билет
- lottery_prize — выигрыш лотереи
- intellectual_activity — предоставление результатов интеллектуальной деятельности
- payment — платёж
- agent_commission — агентское вознаграждение
- composite — составной предмет расчёта
- another — иной предмет расчёта
- property_right — имущественное право
- non-operating_gain — внереализационный доход
- insurance_premium — страховые взносы
- sales_tax — торговый сбор
- resort_fee — курортный сбор
-
send_order_type
— очередность отправки идентификаторов:
- 0 — отправляется и номер телефона абонента, и адрес его электронной почты. Если у абонента не указан ни телефон, ни электронный адрес, то отправляется почта по умолчанию.
- 1 — если у абонента указан телефонный номер, то LANBilling отправляет только его. Если телефона нет, то отправляется почта — та, что указана у абонента, либо та, что задана по умолчанию.
- 2 — если у абонента указан адрес электронной почты, то LANBilling отправляет только его. Если почты нет, но есть номер телефона — LANBilling отправляет его. Если телефон тоже не указан, то отправляется почта по умолчанию.
-
use_agent_info
— отправлять ли атрибуты агента в чеке:
- 0 — не отправлять,
- 1 — отправлять.
-
agent_info_type
— признак агента по предмету расчёта:
- bank_paying_agent — банковский платежный агент
- bank_paying_subagent — банковский платежный субагент
- paying_agent — платежный агент
- paying_subagent — платежный субагент
- attorney — поверенный
- commission_agent — комиссионер
- another — другой тип агента
Когда заполните данные, сохраните файл. Перезапустите модуль LBcore.
Что делать дальше?
-
Определите, должна ли система отправлять в онлайн-кассу данные о списаниях. Если да — включите опцию fiscalization_services_payments
.
-
Настройте шаблон для отчёта по фискализации. Сформированный отчёт позволяет увидеть, какие операции были фискализированы.