# 1С: Управление торговлей ред. 10.3 и 1С: Управление производственным предприятием 1.3
## Общая информация
В программе реализованы алгоритмы взаимодействия с системой АТОЛ Онлайн посредством стандартного API компании (с информацией можно ознакомиться по ссылке ).
## Настройки
* Все основные настройки вынесены в специальном меню “Атол Online”
* "Форма настроек АТОЛ Онлайн" - открывает форму, в которой необходимо указать данные для подключения к системе.
{% hint style="info" %}
Если отправка чеков происходит от нескольких организаций, то задайте значения для каждой.
{% endhint %}
### **Получение списка ИНН**
{% hint style="info" %}
Получение списка ИНН доступно начиная с версии 1.2.0.0
{% endhint %}
Для получения списка ИНН, от которых доступна отправка чеков в АТОЛ Онлайн для вашей конфигурации:
* Откройте форму настроек АТОЛ Онлайн
* Перейдите на вкладку "Лицензии"
* Введите логин и пароль, полученный в отделе продаж
* Нажмите "Сохранить логин и пароль"
* Нажмите "Обновить информацию по лицензии"
{% hint style="warning" %}
В случае возникновения сложностей при получении лицензии свяжитесь с отделом продаж компании ЗетаСофт.
{% endhint %}
### **Основные настройки**
* **Версия API -** в зависимости от версии ФФД ККТ выберите соответствующую версию API. Для ФФД 1.05 - версия v4, для ФФД 1.2 - версия v5
{% hint style="info" %}
Версию ФФД своей кассы можно уточнить в компании АТОЛ Онлайн
{% endhint %}
* **Логин** - логин пользователя для отправки данных (информация содержится в файле в поле **login**, доступном в личном кабинете АТОЛ Онлайн, подробнее в разделе [Получение настроек в АТОЛ Онлайн](#poluchenie-nastroek-v-atol-onlain))
* **Пароль** - пароль пользователя для отправки данных (информация содержится в файле в поле **password**, доступном в личном кабинете АТОЛ Онлайн, подробнее в разделе [Получение настроек в АТОЛ Онлайн](#poluchenie-nastroek-v-atol-onlain))
* **group code** - идентификатор группы ККТ (информация содержится в файле в поле **group\_code**, доступном в личном кабинете АТОЛ Онлайн, подробнее в разделе [Получение настроек в АТОЛ Онлайн](#poluchenie-nastroek-v-atol-onlain))
* **Платёжный адрес** - место расчетов, при наличии нескольких мест расчетов добавьте каждое в отдельную строку (информация содержится в файле в поле **shop hostname**, доступном в личном кабинете АТОЛ Онлайн, подробнее в разделе [Получение настроек в АТОЛ Онлайн](#poluchenie-nastroek-v-atol-onlain))
* **Вид контактной информации адрес эл. почты** - вид контактной информации в карточке партнера, в которой хранится адрес электронной почты для отправки письма
* **Вид контактной информации телефон** - вид контактной информации в карточке партнера, в которой хранится телефон для отправки смс
* **Вид контактной информации адрес эл. почты организации** - вид контактной информации в карточке организации, в которой хранится адрес электронной почты для добавления в чек (адрес отправителя)
* **Флаг "Отправлять чек на телефон"**
* **Флаг "Отправлять чек на почту"**
* **Формулировка авансового платежа** - автоматически будет подставляться в содержание при отправке чеков на аванс из документов оплаты
* **Cтавка НДС** - ставка НДС для авансового платежа
{% hint style="info" %}
Если включены оба флага отправки чека (и на телефон, и на эл. почту), то сработает следующий алгоритм:
* Если заполнена эл. почта, то чек отправится только на эл. почту
* Если эл. почта не заполнена, то чек отправится телефон
Обращаем внимание, что для отправки чеков на телефон необходимо, чтобы эта опция была доступна у вашего ОФД, а также оплачен необходимый пакет.
Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+» (номер «+371 2 1234567» необходимо передать как «+37121234567»). Если номер телефона относится к России (префикс «+7»), то значение можно передать без префикса (номер «+7 925 1234567» можно передать как «9251234567»). Максимальная длина строки – 64 символа.
{% endhint %}
### Дополнительные настройки
* **Заполнять наименование из контрагента** - при установленном флаге в чек будет передаваться полное наименование контрагента
* **Заполнять ИНН контрагента** - при установленном флаге в чек будет передаваться полное ИНН контрагента
{% hint style="warning" %}
В версии ФФД 1.2 при заполнении Наименования клиента обязательно должен быть заполнен ИНН. В релизе модуля добавлено соответствующее предупреждение в чек.
{% endhint %}
* **Не проверять Юр/Физ лицо** - по умолчанию происходит проверка на то, что контрагент - физическое лицо, при создании чека для юр. лица в чеке будет соответствующее предупреждение
* **Отображать результат отправки чека** - после отправки чека будет форма со списком отправленных чеков
* **Отправлять чеки без подтверждения** - форма со списком созданных чеков к отправке не будет отображаться, созданные чеки будут сразу отправляться в АТОЛ Онлайн
* **Не отправлять чеки с предупреждениями** - если по чеку есть предупреждения перед отправкой, чек не будет отправлен
* **Заполнять внутренний идентификатор из УИД документа основания** - при выключенной настройке внутренний идентификатор для каждого нового документа чек будет генерироваться произвольно. При включенной настройке внутренний идентификатор заполняется из документа основания для чека
{% hint style="info" %}
Внутренний идентификатор документа чек используется системой АТОЛ Онлайн для проверки, был ли ранее отправлен чек или нет. Если из 1С будет отправлен чек с внутренним идентификатором, по которому чек уже был зарегистрирован ранее, то АТОЛ Онлайн не создаст новый чек, а вернет информацию о ранее созданном чеке.
Это сценарий можно воспроизвести если отправить сначала чек на отгрузку в кредит из реализации (документом основанием для чека будет реализация) и позже отправить чек на оплату кредита (документом основанием будет та же реализация) - в этом случае второй чек не отправится.
Мы рекомендуем не включать эту настройки без осознанной необходимости передавать во внутренний идентификатор УИД документа основания.
{% endhint %}
{% hint style="danger" %}
Контроль предупреждений происходит только при отправке чеков из документов. При непосредственной отправке чека из формы самого документа контроли не сработают.
{% endhint %}
* **Выводить информацию о платежном агенте** - при включенной настройке в документе АТОЛ Чек для каждой строки в Объектах расчета появится возможность заполнить информацию об агенте и поставщике. При необходимости можно настроить автоматическое заполнение данных об агенте в чеке (подробнее в разделе [Данные об агенте в чеке](https://cases.zetasoft.ru/atol/otpravka-cheka-iz-1c-v-atol-onlain/dannye-ob-agente-v-cheke))
* **Тестовый режим** - необходимо включить при работе с тестовой средой АТОЛ Онлайн
* **Отображать информацию о кассире в чеке и передавать в АТОЛ Онлайн** - при включенной настройке в чеке будет отображаться информация о кассире и появится возможность его заполнения (кассир не является обязательным полем при работе с облачной кассой)
* **Кассир по умолчанию** - значение по умолчанию для новых чеков (составной тип данных: справочник Пользователи и Строка)
* **Заполнять кассира в чеке ответственным пользователем из документа** - при включенной настройке кассир в чеке будет заполняться ответственным из документа
* **Использовать дополнительные кассы** - при включенной настройке появляется возможность добавить дополнительные кассы для организации и выбирать их в чеке (подробнее в разделе [Дополнительные кассы](https://cases.zetasoft.ru/atol/otpravka-cheka-iz-1c-v-atol-onlain/dopolnitelnye-kassy))
### Честный знак (разрешительный режим)
{% hint style="info" %}
Настройки для проверки кодов маркировки для товаров с разрешительным режимом появились в релизе 1.3.5.0
Ниже приведены настройки, которые используются в релизах типовой конфигурации (задаются в коде)
Алгоритм работы модуля с разрешительным режимом описан в разделе [#razreshitelnyi-rezhim](https://cases.zetasoft.ru/atol/markirovannyi-tovar#razreshitelnyi-rezhim "mention")
{% endhint %}
* Идентификатор ФОИВ (тег 1262) - значение "030"
* Дата нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения реквизита «значение отраслевого реквизита» (тег 1263) - значение "21.11.2023"
* Номер нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения реквизита «значение отраслевого реквизита» (тег 1264) - значение "1944"
* Флаг "Получать токен авторизации ИС МП Розница из настоек АТОЛ" - при включенном флаге появится дополнительное поле, где можно указать токен авторизации. При выключенном флаге токен получается из типового регистра сведений ДанныеКлючаСессииИСМП по Организации и типу токена "ИС МП Розница"
* Периодичность проверки площадки CDN - у Честного знака несколько площадок, при проверке площадок определяется адрес с минимальным временем ответа. В этом параметре задается периодичность для повторной проверки. Проверка происходит автоматически при отправке чеков. Также при необходимости можно выполнить проверку вручную на форме настроек
{% hint style="info" %}
Инструкция по получения токена авторизации -
{% endhint %}
### Получение настроек в АТОЛ Онлайн
* Логин, пароль, платёжный адрес (shop hostname) и group code для отправки данных можно получить из файла настроек для CMS в личном кабинете пользователя. Для этого необходимо зайти в личный кабинет пользователя. Переходим на сайт и в правом углу нажимаем “Вход в личный кабинет”
* После авторизации в личном кабинете на главной странице (раздел “Мои компании”) нажимаем кнопку “Настройки интегратора”.
* В результате будет скачан XML файл, содержащий необходимую информацию:
### Тестовые настройки
Для тестирования можно использовать параметры тестовой среды АТОЛ (также необходимо включить флаг «Тестовый режим» в форме настроек и для организации изменить ИНН) -
{% hint style="info" %}
Начиная с версии 1.3.0.0 заполнение данных тестовой среды происходит автоматически при установленном флаге "Тестовый режим" и выборе версии API.
ИНН для организации, от которой идет отправка чеков в тестовую среду, необходимо изменить вручную на ИНН АТОЛ - 5544332219 (начиная с релиза 1.3.5.0 не требуется изменение ИНН у организации в 1С для работы с тестовой средой АТОЛ Онлайн)
{% endhint %}
## **АТОЛ Онлайн Чек**
Отправка чека в АТОЛ Онлайн происходит из документа **(АТОЛ Онлайн) Чеки**
Документ **(АТОЛ Онлайн) Чек** повторяет структуру API АТОЛ Онлайн и передача данных происходит из него. При необходимости пользователь может проконтролировать данные и при необходимости отредактировать их перед отправкой. Заполнение документа (АТОЛ Онлайн) Чек из типовых документов описано ниже.
### Дополнительные реквизиты чека
На вкладке Дополнительно есть возможность заполнить дополнительные реквизиты чека
* **Дополнительный реквизит чека** - значение из этого реквизита будет передано в тег 1192 в чеке, в который рекомендуется указать фискальный признак (ФПД) ошибочного чека. Максимальная длина - 16 символов
* **Дополнительный реквизит пользователя** - значения из реквизитов Наименование (максимальная длина 64 символа) и Значение (максимальная длина 256 символов) будут переданы соответственно в теги 1085 и 1086
{% hint style="info" %}
Данные по дополнительному реквизиту пользователя не передаются для чеков коррекции
{% endhint %}
### Информация об отправленных чеках
Информация об отправленных чеках хранится в регистре сведений "Отправленные чеки АТОЛ Онлайн". Для пользователя есть несколько вариантов получить информацию об отправленном чеке:
* Признак успешной отправки, предупреждений и ошибок отправки отображается в форме списка чеков
{% hint style="warning" %}
**Ошибка в чеке** - предупреждения до передачи чека в АТОЛ Онлайн. В них выводится информация о возможных ошибках, которые необходимо проверить
**Ошибка отправки** - в результате отправки от сервиса АТОЛ Онлайн ответ с ошибкой. Текст ошибки и код ошибки выводятся в служебных сообщениях. Расшифровка кодов ошибок по ссылке - [коды ошибок АТОЛ Онлайн](https://cases.zetasoft.ru/atol/otpravka-cheka-iz-1c-v-atol-onlain/kody-oshibok-atol-onlain)
{% endhint %}
* Из формы документа нажать на кнопку "Проверить регистрацию чека". В служебных сообщениях будет отображена информация по чеку
### Контроль при отправке
В типовом функционале модуля заложен следующий контроль:
* Из документа оплаты/отгрузки нажали "Отправить чек". Система проверяет флаг "Отправлять без подтверждения".
* Если стоит - то проверяет наличие предупреждений.
* Если их нет - попытка отправить.
* Если предупреждения есть и есть флаг "Не отправлять с предупреждением" то откроется форма с записанными чеками без попытки отправить.
* В форме списка команда "Отправить чеки будет доступна и если вызвать - она вне зависимости от предупреждений отправит чек (эта команда равноценна команде из самого чека).
### Список чеков
При подтверждении отправки, проверке чеков и отображении результата отправки отображается форма списка чеков с отбором по документу, из которого происходит отправка чека.
Данные на форме:
* Признак отправки - "Отправлен"
* Признак наличия предупреждения в чеке - "Ошибка в чеке"
* Признак ошибки отправки (ответ с ошибкой от АТОЛ Онлайн) - "Ошибка отправки"
* Ссылка на документ (АТОЛ Онлайн) Чек
* Сумма чека
* Сумма документа
* Признак способа расчета:
* **full\_prepayment** – предоплата 100%. Полная предварительная оплата до момента передачи предмета расчета.
* **prepayment** – предоплата. Частичная предварительная оплата до момента передачи предмета расчета.
* **advance** – аванс.
* **full\_payment** – полный расчет. Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета.
* **partial\_payment** – частичный расчет и кредит. Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит.
* **credit** – передача в кредит. Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит.
* **credit\_payment** – оплата кредита. Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита).
* Дата отправки чека в АТОЛ Онлайн
## **Заполнение документа АТОЛ Онлайн Чек**
### Реализации
Выбор варианта отправки чека доступен в документах реализации:
При нажатии происходит заполнение документа (АТОЛ Онлайн) Чек:
* в табличную часть "Объекты расчета" переносятся товары и услуги в соответствии с выбранным признаком способа расчета
* в табличную часть "Платежи" переносится информация об оплате. Документы подбираются, опираясь на расчёты по документу
{% hint style="info" %}
В соответствии с основными настройками чек будет отправлен без предупреждения или сначала отобразится окно с созданными, но не отправленными чеками.
{% endhint %}
{% hint style="warning" %}
Если при отправке чека на отгрузку в кредит будут обнаружены зачтенные платежи по документу - то признак способа расчета будет изменен с "Кредит" на "Частичный расчёт и кредит". В качестве платежа для кредита будет всегда как минимум 1 строчка на полную или оставшуюся сумму документа с видом "Кредит".
{% endhint %}
### Документы оплаты
Выбор варианта отправки чека доступен в документах оплаты (поступление на расчетный счет, поступление наличных, операция по платежной карте):
#### Чек на предоплату
В соответствии с распределением документа оплаты будет создан один или несколько чеков с признаком способа расчёта Предоплата 100%.
#### Чек на аванс
Создает один чек на полную сумму документа оплаты, вне зависимости от распределения.
#### Чек на оплату кредита
В соответствии с распределением документа оплаты будет создан один или несколько чеков с признаком способа расчёта Оплата кредита.
{% hint style="info" %}
При ведении взаиморасчетов по документам расчета из документов оплаты, по которым не указан документ отгрузки, отправляются только чеки на аванс
{% endhint %}
### Возвраты
{% hint style="info" %}
Функционал поддерживается начиная с версии 1.2.0.0
{% endhint %}
Отправка чеков доступна из следующих документов:
* **Возврат товаров от покупателя;**
* **Расходный кассовый ордер;**
* **Оплата от покупателя платежной картой;**
* **Платежное поручение исходящее.**
В верхней части самого чека имеется реквизит "**Вид операции**", который проставляется автоматически в зависимости документа из которого сформирован чек.
В случае, если при возврате было списание средств или РКО (т.е. деньги клиенту вернулись) , эти данные также будут отображены в чеке на вкладке **Платежи.**
## Создание чеков коррекции
Чеки коррекции создаются в 1С вручную. Изначально, как и любой другой чек, можно создать его на основании документа 1С или Чека АТОЛ и изменить необходимые данные перед отправкой.
{% hint style="info" %}
Для ФФД 1.05 доступны только 2 вида операции коррекции - Коррекция прихода и Коррекция расхода, для ФФД 1.2 дополнительно доступны Коррекция возврата прихода и коррекция возврата расхода
{% endhint %}
При выборе вида операции коррекции появляется доступной вкладка Коррекция, где можно указать следующие данные:
* **Тип коррекции** - доступны 2 значения "Самостоятельная операция" и "Операция по предписанию налогового органа", передается в тег 1173
* **Номер предписания налогового органа** - номер документа основания для коррекции. Заполняется в случае, если коррекция расчета осуществляется по предписанию налогового органа об устранении выявленного нарушения законодательства Российской Федерации о применении ККТ (максимум 32 символа), передается в тег 1179
* **Дата чека** - дата совершения корректируемого расчета в формате, передается в тег 1178
## **Особенности конфигурации**
### Корректировка реализации
* Объекты расчета в чеке, создаваемом из Корректировки реализации, заполняются только данными по строкам, у которых в результате корректировки уменьшается количество . Чек создается на Возврат прихода.
* Платежи в чеке на возврат, созданном из корректировки реализации не заполняются автоматически, т.к. этих данных нет в виде документов, связанных с корректировкой реализации. В созданном чеке перед отправкой необходимо вручную заполнить вкладку платежи с указанием видов оплаты, сумм и документов (при необходимости)
