Robokassa и 1С: варианты интеграции, обмен данными и фискализация

Robokassa и 1С: варианты интеграции, обмен данными и фискализация

Зачем и кому нужна интеграция

Интеграция 1С и Robokassa закрывает сразу три критически важных задачи: прием онлайн-платежей, автоматизацию обмена статусами заказов и корректную фискализацию чеков по 54‑ФЗ. Для компаний, которые ведут склад, бухгалтерию и продажи в 1С (УТ, БП, ERP, Розница), связка 1C—Robokassa помогает:

• уменьшить ручные операции с оплатами и возвратами;
• синхронизировать статусы заказов из интернет-магазина или CRM;
• автоматически формировать и отправлять чеки через ОФД;
• видеть полную картину по оплатам и выручке в одном окне.

Если вы уже используете онлайн-платежи и интернет-эквайринг, интеграция ускорит обработку заказов и снизит ошибки в учете. А если только выбираете провайдера платежей, посмотрите разделы про платежи и чеки.

![Схема интеграции Robokassa и 1С: платеж, уведомление, фискализация]

Варианты интеграции 1С Robokassa

Запросы вроде 1с робокасса и интеграция 1С robokassa обычно приводят к четырем моделям подключения. Ниже — краткое сравнение.

Вариант	Кому подходит	Схема обмена	Плюсы	Минусы
Готовая robokassa обработка 1С (внешняя обработка или расширение)	1С:УТ, БП, ERP, Розница, где требуется запуск из 1С	1С формирует счет и редирект на оплату, Robokassa присылает ResultURL в 1С	Быстрый старт, минимум доработок	Нужен опубликованный веб-сервис 1С, администрирование веб-сервера
Через сайт или CMS (CommerceML)	Есть интернет-магазин, 1С — только учет	Оплата на сайте, статусы платежей тянутся в 1С вместе с заказами	Самая простая интеграция, без публичного 1С	Статусы идут через сайт, не прямой webhook в 1С
Прямое API из 1С (HTTP-запросы)	Нужна гибкая логика, нестандартные сценарии	1С сама вызывает API Robokassa, принимает webhooks	Максимальный контроль, тонкая настройка фискализации	Требуются доработки, поддержка API, логирование
Облачный коннектор-мост	Когда 1С недоступна извне	Robokassa -> облако -> 1С по защищенному каналу	Не нужен внешний доступ к 1С	Стоимость и зависимость от посредника

Совет: начинайте с готовой обработки или связки через сайт. Если нужно больше контроля над обмен статусами 1с robokassa и фискализацией, переходите к прямой работе с API.

Что нужно для старта

Перед настройкой подготовьте:

• Доступ к Robokassa: вход и личный кабинет. Если еще не подключены — смотрите страницу подключить.
• Созданный магазин в ЛК и настроенные пароли №1 и №2, алгоритм подписи SHA‑256.
• Адреса уведомлений в ЛК: ResultURL (серверное уведомление), SuccessURL и FailURL. При необходимости ограничьте IP отправителя.
• В 1С: платформа 8.3+, опубликованный HTTP-сервис или внешний веб-сервер, права на интеграцию и обмен, настроенные ставки НДС и признаки способов/предметов расчета по 54‑ФЗ.
• Определитесь с фискализацией: будет ли Robokassa фискализировать чеки или вы печатаете чеки на ККТ из 1С. Подробнее — в разделе ниже.

![Экран настроек магазина в личном кабинете Robokassa: пароли, ResultURL, SuccessURL, FailURL]

Полезные ссылки: официальный сайт, карточка ООО Робокасса.

Обмен статусами 1С—Robokassa

Ключевое место интеграции — корректный обмен статусами 1с robokassa. Процесс обычно выглядит так:

1. В 1С создается документ заказа/счета и генерируется ссылка на оплату через Robokassa.
2. Покупатель оплачивает, Robokassa отправляет серверное уведомление на ResultURL.
3. 1С проверяет подпись SHA‑256, сумму и номер, обновляет статус документа. В ответ 1С возвращает OK и номер заказа, чтобы Robokassa зафиксировала успешную доставку уведомления.
4. Покупатель видит SuccessURL или FailURL, но именно ResultURL считается источником истины для статуса оплаты.

Сопоставление статусов удобно закрепить таблично:

Robokassa	1С (рекомендуемо)	Комментарий
initiated/pending	Ожидает оплаты	Счет сформирован, оплаты нет
success/paid	Оплачено	Уведомление принято, подпись корректна
canceled/failed	Отменено	Оплата не прошла или отменена
refund/chargeback	Возврат	Создавайте документ возврата и сторнируйте чек
partial_refund	Частичный возврат	Отражайте сумму частично, корректируйте чек

Практические советы:

• Идентификатором связки используйте InvId из Robokassa и внутренний номер документа 1С.
• Делайте идемпотентную обработку уведомлений: если уведомление пришло повторно, не дублируйте оплату.
• Логируйте сырое уведомление и результат проверки подписи.

Фискализация и чеки 1С Robokassa

Есть два основных подхода к фискализации чеков:

A. Фискализация на стороне Robokassa

• 1С при создании оплаты передает массив позиций, НДС, признак способа/предмета расчета и итоги.
• Robokassa формирует чек, отправляет в ОФД и возвращает в уведомлении фискальные реквизиты: номер фискального документа, фискальный признак, номер ФН и ссылку на чек.
• 1С записывает эти данные в документ оплаты или отдельный регистр. Это сценарий «чеки 1с robokassa» с делегированной фискализацией.

B. Фискализация на стороне 1С

• Robokassa принимает платеж, а чек выбивается вашими ККТ из 1С при поступлении оплаты.
• Важно исключить двойную фискализацию: либо Robokassa, либо ваша ККТ.

C. Гибридная модель

• Предоплата при оформлении заказа и итоговый расчет при отгрузке. Части чека фискализируются в разные моменты с корректными признаками оплаты.

Что обязательно передавать в чеке по 54‑ФЗ:

• Наименование, цена, количество, ставка НДС.
• Признак способа расчета и предмета расчета.
• Признаки агента, если есть, и коды маркировки для Честного Знака.

Подробнее о фискальных документах — раздел чеки.

Пошаговая настройка в 1С

Ниже общий порядок для конфигураций уровня УТ/ERP; точные названия пунктов могут отличаться.

1. Установка: подключите внешнюю обработку или расширение 1С для Robokassa, либо реализуйте HTTP‑сервис для приема ResultURL.
2. Платежный способ: создайте вид оплаты Robokassa, укажите MerchantLogin, пароли №1 и №2, метод подписи SHA‑256.
3. Адреса: в настройках магазина ЛК пропишите ResultURL, SuccessURL, FailURL. Если 1С принимает уведомления, опубликуйте веб-сервис и проверьте доступность извне.
4. Фискализация: выберите режим — Robokassa или ККТ 1С. В первом случае включите формирование чеков на стороне Robokassa и передачу позиций; во втором — настройте драйвер ККТ и параметры 54‑ФЗ в 1С.
5. Сопоставление налогов: настройте ставки НДС и, при необходимости, отображение без НДС.
6. Обмен статусами: проверьте, что документ оплаты/заказа в 1С обновляется при входящем ResultURL. Фиксируйте OK с номером документа в ответе.
7. Возвраты: предусмотрите сценарии возврата и частичного возврата, синхронизируйте их с чеками коррекции.

Эта последовательность покрывает сценарии robokassa обработка 1с без лишней ручной работы.

Тестирование и мониторинг

• Включите тестовый режим в ЛК и проведите оплату на небольшую сумму.
• Проверьте, что SuccessURL отображается, а уведомление на ResultURL получено и подтверждено ответом OK с номером.
• Сверьте суммы OutSum и валюту. Ошибки округления — частая причина отказа подписи.
• Убедитесь, что чеки формируются по выбранному сценарию и сохраняются ссылки на фискальные документы.
• В 1С настройте журнал регистрации и отдельный лог интеграции, чтобы видеть входящие запросы, подписи, ответы и задержки.

![Мониторинг входящих уведомлений и ответов OK в 1С]

Безопасность и соответствие 54-ФЗ

• Проверяйте подписи SHA‑256 и держите пароли в защищенном хранилище.
• Ограничьте прием ResultURL по IP и используйте HTTPS.
• Реализуйте антидубль: одна оплата — одна запись в 1С, даже если уведомление пришло повторно.
• Для 54‑ФЗ проследите корректность предметов и способов расчета, признаков агента и возвратов, чтобы исключить двойную фискализацию.
• Храните ссылку на чек и фискальные реквизиты. Это упростит ответ на запросы ФНС и покупателей.

Типичные ошибки и как их избежать

• Несовпадение суммы и валюты между 1С и Robokassa. Решение: фиксируйте валюту платежа и приводите суммы к двум знакам после запятой.
• Неверная подпись. Решение: одинаковый порядок параметров, единый алгоритм SHA‑256, корректные пароли №1 и №2.
• Уведомления не доходят до 1С. Решение: проверьте публичный адрес, SSL‑сертификат, доступность порта и белый список IP.
• Двойная фискализация. Решение: заранее выбирайте, кто выбивает чек — Robokassa или ККТ 1С; в гибриде разделяйте предоплату и окончательный расчет.
• Потеря связи статусов. Решение: используйте устойчивый идентификатор InvId + внутренний номер, ведите журнал идемпотентности.

Документация и поддержка

• Официальные спецификации и примеры — раздел API документация.
• База знаний и ответы на частые вопросы — FAQ.
• Доступ к интерфейсу управления — Личный кабинет и Вход Robokassa.
• Контакты и реквизиты — официальный сайт и карточка ООО Робокасса. Если нужна консультация по интеграции, позвоните нам — телефон.

Итоги и следующий шаг

Интеграция 1С robokassa решает ключевые задачи: автоматический обмен статусами, корректная передача позиций в чек и удобная работа с возвратами. Выберите подходящий сценарий — готовая обработка, через сайт, прямой API или облачный коннектор — и начните с тестового стенда. Когда процесс отработан, вы получите быструю оплату, прозрачную выручку и меньше ручных операций.

Готовы настроить и запустить интеграцию под ваш бизнес-процесс? Оставьте заявку на странице подключить и мы поможем подобрать оптимальную схему приема платежей и фискализации чеков с учетом ваших целей и требований 54‑ФЗ.