# AtolCloud Подключение облачной фискализации ### [https://atol.online/](https://atol.online/) #### Сервис АТОЛ Онлайн фискализирует запросы, которые поступают из внешней системы пользователя ККТ. [![image.png](https://docs.shelter.ru/uploads/images/gallery/2025-03/scaled-1680-/image.png)](https://docs.shelter.ru/uploads/images/gallery/2025-03/image.png) Платеж через Абонемент Онлайн или мобильное приложение проводится в два этапа: 1\. Мобильное приложение/Абонемент Онлайн перенаправляет клиента в процессинг, где он производит платёж. Информация о платеже возвращается в модуль. 2\. Модуль отправляет запрос на регистрацию платежа в Абонемент через API (Connecter). Для завершения регистрации платежа, API запросит формирование чека для данной операции у облачного ФР. Только после успешной фискализации платёж (чек) будет зарегистрирован в Абонемент. #### ### **ФФД 1.2** API V5

**ВСЕ ДОРАБОТКИ БУДУТ ВЕСТИСЬ ТОЛЬКО НА ЭТОМ ПРОТОКОЛЕ. API v4 более не дорабатывается.**

**Изменения для соответствия новым требованиям к формату фискальных документов с 1 сентября 2025 года. [https://docs.shelter.ru/books/podklyucenie-kkt-k-abonement/page/novye-tegi-v-cekax-s-1-sentyabrya-2025-goda](https://docs.shelter.ru/books/podklyucenie-kkt-k-abonement/page/novye-tegi-v-cekax-s-1-sentyabrya-2025-goda)**

**Лицензия - Проект 5 Модуль 1**. Абонемент модуль Интерфейс Атол-онлайн (CloudKassir) ПО Добавили возможность работать с новыми ставками НДС (5% и 7%) для соответствия актуальным требованиям законодательства. Описание протокола: **[API V5 ФФД 1.2](https://atol.online/upload/iblock/b59/qrr2rme0h9hdechigiikpduilvps768w/API%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%B0%20%D0%90%D0%A2%D0%9E%D0%9B%20%D0%9E%D0%BD%D0%BB%D0%B0%D0%B9%D0%BD_v5.pdf)** - Connecter - 1.76 и выше - URunPos.dll - 2.14.0.3 - fpCloudAtol.dll - 1.5.0.5 ...\\FullVersion\\\_INTERFACE\\POS\\fpCloudAtol Все dll должны быть размещены в папке Connecter. #### Настройки

В настройках ПО Абонемент должен быть включен "Контроль ФФД" и Отправка чеков по телефону/email. В карточках услуг должны быть проставлены коды налогов и СНО, Признак предмета расчета. У клиентов должны быть указаны телефон/email.

##### **connecter.ini** Секция **\[pos\]** ``` RunPosDllName=Urunpos.dll ``` Секция **\[defaults\]**

Тип платежа и киоск, которые будут использоваться для онлайн продаж. Смена в киоске должна быть всегда открыта пользователем с полными правами и закрываться только если необходимо снять отчет.

``` DefaultPayCode=901 STDKIOSKCODE=1 ``` ##### **UrunPos.ini** ``` [Main] ;Драйвер ФР R_keeper DriverName = fpCloudAtol.dll ;ХМL настроек драйвера ФР R_keeper ParamXMLFile = urunpos_frxml_CloudAtol.xml [TranslateTaxRateIndexToVat] ;Код налога в карточке услуги = Код налога в системе CloudAtol 0=none 1=vat0 2=vat10 3=vat18 4=vat20 5=vat110 6=vat118 7=vat120 8=vat5 9=vat105 10=vat7 11=vat107 [TranslateTaxTypeToSno] ;Код СНО в карточке услуги = sno в системе cloudAtol 0=osn 1=usn_income 2=usn_income_outcome 3=envd 4=esn 5=patent ``` ##### **fpCloudAtol.ini** Секция \[BILL\] заполняется автоматически при продажах. Секции налогов и СНО те же, что в UrunPos.ini ``` [BILL] LastDocNumber= LastReceipt= LastReceiptNumber= [TranslateTaxRateIndexToVat] ;Код налога в карточке услуги = Код налога в системе CloudAtol 0=none 1=vat0 2=vat10 3=vat18 4=vat20 5=vat110 6=vat118 7=vat120 8=vat5 9=vat105 10=vat7 11=vat107 [TranslateTaxTypeToSno] ;Код СНО в карточке услуги = sno в системе cloudAtol 0=osn 1=usn_income 2=usn_income_outcome 3=envd 4=esn 5=patent ``` ##### **urunpos\_frxml\_CloudAtol.xml** Ваши регистрационные данные Атол Онлайн. Company\_INN \_ \_ \_ \_ \_ \_ \_ \_ — ИНН API\_URL [https://online.atol.ru/possystem/v5/](https://online.atol.ru/possystem/v4/) — Адрес API API\_GROUP \_ \_ \_ \_ \_ \_ — Группа API\_Login \_ \_ \_ \_ \_ \_ — Логин доступа к API Company\_PaymentAddress — \_ \_ \_ \_ \_ \_ — Платежный адрес вашей компании API\_Password \_ \_ \_ \_ \_ \_ — Пароль доступа к API DurationWaitProcessed - максимальное время ожидания фискализации чека, сек.

Пароль в xml файле хранится в зашифрованном виде. Что бы его зашифровать необходимо при первом запуске вместо **<API\_Password>Ваш пароль</API\_Password>** добавить параметр **<NewPassword>Ваш пароль</NewPassword>**

При первом запуске пароль зашифруется, а параметр "NewPassword" удалится. Пример для подключения к тестовой среде API V5 Атол Онлайн: ``` 5544332219 https://testonline.atol.ru/possystem/v5/ v5-online-atol-ru_5179 v5-online-atol-ru 360 https://v5.online.atol.ru Oqc4SLOy8E8= ``` Проверить корректность подключения можно в testConnecter.exe. Пример запроса для внесение аванса: ``` FOLIO_PAYMENT 1003 100 test connecter Advance 901 +7_______ - введите корректный номер __________ - введите корректный email ``` ### **ФФД 1.05** (без новых налоговых ставок НДС) API V4 Описание протокола: **[API V4 ФФД 1.05](https://atol.online/upload/iblock/ce2/7o1zlsgey3wi3befhac0dr5mga961hig/API_atol_online_v4.pdf)** - Connecter - 1.76 - URunPos.dll - 2.9.0.9 - fpCloudAtol.dll - 1.4.0.4 **connecter.ini** Секция **\[pos\]** ``` RunPosDllName=Urunpos.dll ``` Секция **\[defaults\]**

Тип платежа (фискальный) и киоск, которые будут использоваться для онлайн продаж. Смена в киоске должна быть всегда открыта пользователем с полными правами и закрываться только если необходимо снять отчет.

``` DefaultPayCode=901 STDKIOSKCODE=1 ``` **UrunPos.ini** ``` [Main] ;Драйвер ФР R_keeper DriverName = fpCloudAtol.dll ;ХМL настроек драйвера ФР R_keeper ParamXMLFile = urunpos_frxml_CloudAtol.xml ;Код налога по умолчанию TaxIndexDef=6 ;Налоги передаваемые в чек ;Налог с кодом 1 RateValue1 =0 ;Налог с кодом 2 RateValue2 =1000 ;Налог с кодом 3 RateValue3 =2000 ;Налог с кодом 4 RateValue4 =11000 ;Налог с кодом 5 RateValue5 =12000 ;Налог с кодом 6 RateValue6 =-1 DocNumber = -1 ``` **fpCloudAtol.ini** Секция \[BILL\] заполняется автоматически при продажах. ``` [BILL] LastDocNumber= LastReceipt= LastReceiptNumber= ``` **urunpos\_frxml\_CloudAtol.xml** Ваши регистрационные данные Атол Онлайн. Company\_INN \_ \_ \_ \_ \_ \_ \_ \_ — ИНН API\_URL [https://online.atol.ru/possystem/v4/](https://online.atol.ru/possystem/v4/) — Адрес API API\_GROUP \_ \_ \_ \_ \_ \_ — Группа API\_Login \_ \_ \_ \_ \_ \_ — Логин доступа к API Company\_PaymentAddress — \_ \_ \_ \_ \_ \_ — Платежный адрес вашей компании API\_Password \_ \_ \_ \_ \_ \_ — Пароль доступа к API DurationWaitProcessed - максимальное время ожидания фискализации чека, сек.

Пароль в xml файле хранится в зашифрованном виде. Что бы его зашифровать необходимо при первом запуске вместо **<API\_Password>Ваш пароль</API\_Password>** добавить параметр **<NewPassword>Ваш пароль</NewPassword>**

При первом запуске пароль зашифруется, а параметр "NewPassword" удалится. Пример для подключения к тестовой среде API V4 Атол Онлайн: ``` 5544332219 https://testonline.atol.ru/possystem/v4/ v4-online-atol-ru_4179 v4-online-atol-ru sbwby37V1DjS8oPeOLklKw== 300 iGFFuihss ``` #### #### Ошибки 1\. В случае ошибки токена с кодом "11", происходит повторный запрос токена и повторно отправляется команда 2\. В случае ошибки с кодом "34"("Состояние чека не найдено. Попробуйте позднее."), отправляется повторный запрос через таймаут [https://online.atol.ru/files/ffd/test\_sreda.txt](https://online.atol.ru/files/ffd/test_sreda.txt) ``` Адрес тестовой среды (ФФД 1.05): https://testonline.atol.ru/possystem/v4/ Тестовые данные: ∙ Компания: АТОЛ ∙ ИНН: 5544332219 ∙ Адрес расчетов: https://v4.online.atol.ru ∙ Код группы: v4-online-atol-ru_4179 ∙ Логин: v4-online-atol-ru ∙ Пароль: iGFFuihss Проверка чека в Первый ОФД https://consumer.1-ofd-test.ru/v1?fn=9999078902010421&fp=2680485228&i=1545 где fn=Номер ФН - "fn_number" fp=ФПД - "fiscal_document_attribute" i=Номер ФД - "fiscal_document_number" ------------------------------------------------------------------------------------------- Адрес тестовой среды (ФФД 1.2): https://testonline.atol.ru/possystem/v5/ Тестовые данные: ∙ Компания: АТОЛ ∙ ИНН: 5544332219 ∙ Адрес расчетов: https://v5.online.atol.ru ∙ Код группы: v5-online-atol-ru_5179 ∙ Логин: v5-online-atol-ru ∙ Пароль: zUr0OxfI ```