Перейти к основному контенту

AtolCloud Подключение облачной фискализации

https://atol.online/

Сервис АТОЛ Онлайн фискализирует запросы, которые поступают из внешней системы пользователя ККТ.

image.png

Платеж через Абонемент Онлайн или мобильное приложение проводится в два этапа:

1. Мобильное приложение/Абонемент Онлайн перенаправляет клиента в процессинг, где он производит платёж. Информация о платеже возвращается в модуль.

2. Модуль отправляет запрос на регистрацию платежа в Абонемент через API (Connecter). Для завершения регистрации платежа, API запросит формирование чека для данной операции у облачного ФР. Только после успешной фискализации платёж (чек) будет зарегистрирован в Абонемент.


ФФД 1.2   API V5

Лицензия - Проект 5 Модуль 1. Абонемент модуль Интерфейс Атол-онлайн (CloudKassir) ПО

Добавили возможность работать с  новыми ставками НДС (5% и 7%) для соответствия актуальным требованиям законодательства.
Описание протокола: API V5 ФФД 1.2

  • 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/ — Адрес API
API_GROUP _ _ _ _ _ _ — Группа
API_Login _ _ _ _ _ _ — Логин доступа к API
Company_PaymentAddress — _ _ _ _ _ _ — Платежный адрес вашей компании
API_Password _ _ _ _ _ _ — Пароль доступа к API

DurationWaitProcessed -  максимальное время ожидания фискализации чека, сек.

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

При первом запуске пароль зашифруется, а параметр "NewPassword" удалится.

Пример для подключения к тестовой среде API V5 Атол Онлайн:

<xmlConfig ProtocolVersion="46">
	<Parameters>
		<Company_INN>5544332219</Company_INN>
		<API_URL>https://testonline.atol.ru/possystem/v5/</API_URL>
		<API_GROUP>v5-online-atol-ru_5179</API_GROUP>
		<API_Login>v5-online-atol-ru</API_Login>
		<DurationWaitProcessed>360</DurationWaitProcessed>
		<Company_PaymentAddress>https://v5.online.atol.ru</Company_PaymentAddress>
		<API_Password>Oqc4SLOy8E8=</API_Password>
	</Parameters>
</xmlConfig>

Проверить корректность подключения можно в testConnecter.exe. Пример запроса для внесение аванса:

<?xml version="1.0" encoding="windows-1251"?>
<REQUEST TRANSFORMSCHEMA="">
    <FUNCNAME>FOLIO_PAYMENT</FUNCNAME>
    <PARAMETERS>
        <GUEST>1003</GUEST>
        <COST>100</COST>
        <INFO>test connecter</INFO>
        <ADVANCENAME>Advance</ADVANCENAME>
        <PAYCODE>901</PAYCODE>
        <PHONE1>+7_______</PHONE1>           - введите корректный номер
        <EMAIL>__________</EMAIL>            - введите корректный email
        </PARAMETERS>
</REQUEST>



ФФД 1.05 (без новых налоговых ставок НДС) API V4

Описание протокола:  API V4 ФФД 1.05

  • 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/ — Адрес API
API_GROUP _ _ _ _ _ _ — Группа
API_Login _ _ _ _ _ _ — Логин доступа к API
Company_PaymentAddress — _ _ _ _ _ _ — Платежный адрес вашей компании
API_Password _ _ _ _ _ _ — Пароль доступа к API

DurationWaitProcessed -  максимальное время ожидания фискализации чека, сек.

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

При первом запуске пароль зашифруется, а параметр "NewPassword" удалится.

Пример для подключения к тестовой среде API V4 Атол Онлайн:

<xmlConfig ProtocolVersion="46">
	<Parameters>
		<Company_INN>5544332219</Company_INN>
		<API_URL>https://testonline.atol.ru/possystem/v4/</API_URL>
        <API_GROUP>v4-online-atol-ru_4179</API_GROUP>
		<API_Login>v4-online-atol-ru</API_Login>
		<API_Password>sbwby37V1DjS8oPeOLklKw==</API_Password>
		<DurationWaitProcessed>300</DurationWaitProcessed>
		<NPassword>iGFFuihss</NPassword>
	</Parameters>
</xmlConfig>


Ошибки

1. В случае ошибки токена с кодом "11", происходит повторный запрос токена и повторно отправляется команда
2. В случае ошибки с кодом "34"("Состояние чека не найдено. Попробуйте позднее."), отправляется повторный запрос через таймаут

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
Наверх