Интеграция 1С с Атол 2026: API, драйвер ККТ и риски чеков

Интеграция 1С с Атол ломается не на кнопке "Отправить чек", а раньше: в версии ФФД, реквизитах номенклатуры, настройке ОФД, сменах, кодах маркировки и правилах повторной отправки. Если в 1С продажа проведена, но чек в Атол не фискализирован, бухгалтер видит оплату, а ФНС и покупатель не получают корректный фискальный документ.

В нашей практике по Синхрон1С самый опасный сценарий выглядит так: интернет-магазин принимает оплату ночью, 1С создает заказ утром, а чек уходит в Атол только после ручной обработки. Формально проблема кажется "технической очередью", но по факту это риск по 54-ФЗ, потому что чек должен формироваться при расчете, а не когда оператор дошел до выгрузки.

Материал обновлен в мае 2026 года после проверки документации АТОЛ Онлайн v5, базы ошибок АТОЛ, материалов ФНС по ККТ/ОФД/ФФД 1.2 и инструкции 1С ITS по драйверу АТОЛ 10.x. Это технический чек-лист для владельца 1С, разработчика интеграции и бухгалтера, который будет принимать результат.

Ключевые факты

• "Атол" в интеграции с 1С означает две разные архитектуры: локальная физическая ККТ через драйвер АТОЛ 10.x или облачная фискализация через АТОЛ Онлайн API.
• Для маркированных товаров нужен контур ФФД 1.2: касса, фискальный накопитель, режим регистрации и внешнее кассовое ПО должны поддерживать работу с маркировкой.
• В АТОЛ Онлайн v5 чек отправляется как JSON на операцию sell, sell_refund, buy, buy_refund и другие; результат приходит асинхронно со статусом wait, done или fail.
• ОФД не "дополнительная опция": ФНС ведет реестр операторов фискальных данных, а АТОЛ Онлайн при подключении требует действующий договор с ОФД или его оформление.
• Кассовая смена важна даже в облачной схеме: если смена превышает 24 часа, фискальный признак для чеков не формируется, кроме отчета о закрытии смены.
• Для запусков в 2026 году отдельно проверьте ставки НДС: актуальная документация АТОЛ Онлайн API v5 уже содержит значения vat22 и vat122.
• Главная защита интеграции - не один успешный тестовый чек, а очередь повторов, уникальный external_id, хранение UUID/ФП в 1С и отдельный мониторинг ошибок.

Что выбрать: Атол Онлайн API или физическую кассу через драйвер

Для интернет-магазина, подписок, доставки и оплат без кассира обычно удобнее АТОЛ Онлайн. В этой схеме 1С или промежуточный сервис формирует JSON-чек, получает токен через getToken, отправляет документ на https://online.atol.ru/possystem/v5/<group_code>/<operation> и ждет результат по callback или запросу статуса. Драйвер ККТ на рабочем месте не нужен.

Для розничной точки с кассиром и физическим фискальным регистратором чаще остается драйвер АТОЛ 10.x. По инструкции 1С ITS драйвер состоит из интеграционной компоненты в 1С и основной поставки производителя, которая напрямую взаимодействует с оборудованием. На практике это означает зависимость от Windows, разрядности клиента 1С, USB/COM/TCP-подключения, версии драйвера, прошивки ККТ и настроек ОФД.

Если у бизнеса есть и сайт, и офлайн-касса, не стоит смешивать два потока в одну "выгрузку в Атол". Разделите источник расчета: онлайн-оплаты отправляйте в облачную кассу, офлайн-продажи - в локальную ККТ. Иначе возвраты, авансы и закрытие смены быстро превращаются в ручную сверку.

Как выглядит фискализация через АТОЛ Онлайн v5

Рабочий поток для 1С обычно такой:

1. В 1С появляется документ оплаты или реализации, по которому нужен чек.
2. Интеграция проверяет организацию, систему налогообложения, email/телефон покупателя, позиции, НДС, признаки способа и предмета расчета.
3. Сервис получает токен АТОЛ Онлайн через POST https://online.atol.ru/possystem/v5/getToken.
4. Чек отправляется на операцию sell, sell_refund, buy или buy_refund; для коррекций используются отдельные операции коррекции.
5. В запрос кладется external_id - уникальный идентификатор документа внешней системы длиной до 128 символов.
6. Если указан callback_url, АТОЛ возвращает результат обработки POST-запросом; дополнительно можно получать статус по UUID.
7. В 1С записываются UUID, статус, номер смены, номер фискального документа, фискальный признак, ссылка ОФД и текст ошибки, если чек не прошел.

В АТОЛ Онлайн v5 результат не надо считать мгновенной печатью чека. В схеме результата есть статусы wait, done, fail. При done в payload возвращаются, среди прочего, fiscal_receipt_number, shift_number, fn_number, fiscal_document_number, fiscal_document_attribute, ofd_inn, ofd_receipt_url и результаты по маркировке. Именно эти поля нужно сохранять в 1С, а не только "чек отправлен".

Минимальная практичная модель данных в 1С или промежуточной базе:

Какие реквизиты должны прийти из 1С

АТОЛ API проверяет структуру JSON, но юридическая корректность чека зависит от данных в 1С. Перед запуском выгрузки проверьте не только "товар, цена, сумма", а весь фискальный набор.

Первый тест интеграции должен включать не один простой чек, а набор из 8-10 сценариев: приход, возврат прихода, предоплата, зачет аванса, услуга без НДС, товар с НДС, маркированный товар, ошибка email/телефона, повторный external_id, недоступный callback.

ФФД 1.2 и маркировка: что проверить до запуска

ФНС отдельно указывает, что для расчетов за маркированные товары пользователи должны применять ККТ, которая обеспечивает формирование фискальных документов по ФФД 1.2. В техническом описании ФНС для ККТ с ФФД 1.2 перечислены условия: прошивка ККТ поддерживает ФФД 1.2, установлен ФН с поддержкой ФФД 1.2, при регистрации выбран режим ФФД 1.2 и установлен признак торговли маркированными товарами.

Для интеграции это означает четыре проверки:

• В реестре/карточке ККТ модель и версия ПО поддерживают ФФД 1.2.
• В 1С есть коды маркировки по позициям, а не только номенклатура и цена.
• Внешнее кассовое ПО умеет передавать реквизиты маркировки в нужном формате.
• Ошибки проверки маркировки не теряются в общем статусе "касса не ответила".

Отдельно заложите обработку ошибки [421] Истек таймаут проверки кода маркировки (КМ). В базе АТОЛ причина описана как отсутствие ответа от ИСМ в отведенное время: проблема может быть на стороне ОФД или ЦРПТ. Повтор нужно отправлять с новым external_id, а параметр ism_optional использовать осознанно: он меняет поведение при недоступности проверки маркировки и должен быть согласован с бухгалтером/ответственным за маркировку.

ОФД, смены и закрытие дня

ОФД нужен не "для галочки". ФНС принимает решения о выдаче разрешений операторам фискальных данных и ведет реестр ОФД. В АТОЛ Онлайн при подключении компании отдельным шагом идет договор с ОФД: если договор уже есть, его выбирают, если нет - оформляют через выбранного оператора.

Для 1С полезно делать ежедневный технический отчет:

Нормальная приемка интеграции заканчивается не "чек пробился", а актом сверки: за тестовый день количество чеков в 1С, АТОЛ/ОФД и отчетах бухгалтера совпадает; по каждому чеку есть фискальный признак; возвраты привязаны к исходным документам; ошибки видны ответственным без захода на сервер.

Таблица рисков при интеграции 1С и Атол

Как мы настраиваем это в Синхрон1С

Для проекта с АТОЛ мы не начинаем с кода. Сначала собираем матрицу расчетов: онлайн-оплата, наличные курьера, оплата картой на месте, возврат, частичный возврат, аванс, зачет аванса, маркированные товары, агентские продажи. После этого ясно, какие документы 1С являются источником чека и сколько фискальных сценариев реально нужно.

В типовой реализации Синхрон1С добавляет:

• регистр очереди чеков с UUID, external_id, статусом и текстом ошибки;
• проверку обязательных реквизитов до отправки в АТОЛ;
• callback-обработчик и резервный опрос статуса;
• уведомления в Telegram по fail, долгому wait, проблемам смены и ошибкам маркировки;
• отчет сверки "1С - АТОЛ - ОФД" за день;
• отдельный тестовый набор чеков перед запуском.

Стоимость такой интеграции зависит от конфигурации 1С и числа сценариев. Базовая настройка для одного потока чеков начинается от 30 000 ₽; если есть маркировка, агентские схемы, несколько организаций или сложные возвраты, сначала делаем короткий аудит базы и правил чеков.

Смотрите также

• Интеграция 1С с онлайн-кассой: все способы
• Интеграция 1С и Честный знак
• Интеграция 1С с Эвотор
• Выгрузка из 1С в Сбербанк
• Сколько стоит интеграция 1С: реальные цены 2026

Часто задаваемые вопросы

Можно ли просто поставить драйвер АТОЛ и не делать API?

Да, если речь о физической ККТ на кассовом рабочем месте. Для интернет-магазина или курьерской фискализации чаще нужен АТОЛ Онлайн API, потому что чек должен формироваться без локального Windows-драйвера и без ручного кассира.

Нужен ли ФФД 1.2 всем в 2026 году?

ФФД 1.2 критичен для расчетов за маркированные товары. Если маркировки нет, сценарий может работать на ФФД 1.05, но перед запуском надо проверить требования к вашей товарной категории, модель ККТ, ФН и версию внешнего кассового ПО.

Что делать, если чек в АТОЛ Онлайн получил fail?

Сначала прочитать код и текст ошибки. Для таймаута АТОЛ рекомендует повторить регистрацию с новым external_id в течение 24 часов; если прошло больше 24 часов, нужен чек коррекции. Для ошибок формата исправляют данные в 1С и только потом повторяют отправку.

Почему один тестовый чек не доказывает готовность интеграции?

Простой чек без маркировки, аванса, возврата и НДС проверяет только связь. В бою ошибки чаще появляются на частичных возвратах, дублях external_id, недоступном callback, сменах дольше 24 часов и кодах маркировки.

Кто должен контролировать ОФД: разработчик или бухгалтер?

Разработчик должен передать в 1С технические статусы, ссылку ОФД и фискальные реквизиты. Бухгалтер должен видеть ежедневную сверку и список чеков, где 1С, АТОЛ и ОФД расходятся. Без этого поддержка превращается в поиск по личным кабинетам.

Можно ли не хранить фискальные реквизиты в 1С?

Технически можно, но это плохая приемка. Минимум нужно хранить UUID, статус, ФН, ФД, ФП, номер смены и ссылку ОФД. Иначе спорный чек нельзя быстро связать с документом 1С.

Нужна интеграция 1С с Атол без ручной выгрузки чеков? Напишите в Telegram: @onoutnoxon - проверим вашу конфигурацию 1С, сценарии оплат, ФФД/ОФД и предложим безопасную схему запуска.

Подробнее о возможностях - на странице Синхрон1С.

Александр Руин, основатель habab.ru. AI-инструмент помог собрать черновую структуру и проверить полноту источников; выводы, технические акценты и финальный текст проверены вручную. Обновлено: 2026-05-04.

Источники

• АТОЛ Онлайн: описание протокола API v5, ФФД 1.2
• АТОЛ Онлайн: как разработать прямую интеграцию и протестировать API
• АТОЛ Онлайн: возможные ошибки и методы исправления
• 1С ITS: установка драйвера АТОЛ ККТ 10.x с передачей данных в ОФД
• ФНС: порядок применения контрольно-кассовой техники
• ФНС: реестр операторов фискальных данных
• ФНС: особенности перехода ККТ и фискальных накопителей на ФФД 1.2
• ФНС: алгоритмы работы ККТ с ФФД 1.2 при расчетах за маркированные товары
• ФНС: протокол обмена между ККТ и ОФД
• АТОЛ Онлайн: руководство пользователя, подключение ОФД и ручное формирование чеков